NAME
uselocale - set/get the locale for the calling thread
SYNOPSIS
#include <locale.h>
locale_t uselocale(locale_t newloc);
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
uselocale():
Since glibc 2.10:
_XOPEN_SOURCE >= 700
Before glibc 2.10:
_GNU_SOURCE
DESCRIPTION
The uselocale() function sets the current locale for the calling thread, and returns the thread's previously current locale. After a successful call to uselocale(), any calls by this thread to functions that depend on the locale will operate as though the locale has been set to newloc. The newloc argument can have one of the following values: A handle returned by a call to newlocale(3) or duplocale(3) The calling thread's current locale is set to the specified locale. The special locale object handle LC_GLOBAL_LOCALE The calling thread's current locale is set to the global locale determined by setlocale(3). (locale_t) 0 The calling thread's current locale is left unchanged (and the current locale is returned as the function result).
RETURN VALUE
On success, uselocale() returns the locale handle that was set by the previous call to uselocale() in this thread, or LC_GLOBAL_HANDLE if there was no such previous call. On error, it returns (locale_t) 0, and sets errno to indicate the cause of the error.
ERRORS
EINVAL newloc does not refer to a valid locale object.
VERSIONS
The uselocale() function first appeared in version 2.3 of the GNU C library.
CONFORMING TO
POSIX.1-2008.
NOTES
Unlike setlocale(3), uselocale() does not allow selective replacement of individual locale categories. To employ a locale that differs in only a few categories from the current locale, use calls to duplocale(3) and newlocale(3) to obtain a locale object equivalent to the current locale and modify the desired categories in that object.
EXAMPLE
See newlocale(3) and duplocale(3).
SEE ALSO
locale(1), duplocale(3), freelocale(3), newlocale(3), setlocale(3), locale(5), locale(7)
COLOPHON
This page is part of release 4.09 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at https://www.kernel.org/doc/man-pages/.
More Linux Commands
manpages/frexp.3.html
frexp(3) - convert floating-point number to fractional and i
The frexp() function is used to split the number x into a normalized fraction and an exponent which is stored in exp. RETURN VALUE The frexp() function returns
manpages/randpkt.1.html
randpkt(1) - Random Packet Generator - Linux manual page....
randpkt is a small utility that creates a pcap trace file full of random packets. By creating many randomized packets of a certain type, you can test packet sni
manpages/remove_members.8.html
remove_members(8) - Remove members from a list. (Man Page)
remove_members [options] listname [addr1 ...] OPTIONS f file, file=file Remove member addresses found in the given file. If file is -, read stdin. a, ....(Man)
manpages/latin10.7.html
latin10(7) - ISO 8859-16 character set encoded in octal, dec
The ISO 8859 standard includes several 8-bit extensions to the ASCII character set (also known as ISO 646-IRV). ISO 8859-16, the Latin Alphabet No. 10 is used t
manpages/atanhl.3.html
atanhl(3) - inverse hyperbolic tangent function (Man Page)
The atanh() function calculates the inverse hyperbolic tangent of x; that is the value whose hyperbolic tangent is x. RETURN VALUE On success, these functions r
manpages/glGetPixelMapfv.3gl.html
glGetPixelMapfv(3gl) - return the specified pixel map.......
See the glPixelMap reference page for a description of the acceptable values for the map parameter. glGetPixelMap returns in values the contents of the pixel ma
manpages/optionSaveFile.3.html
optionSaveFile(3) saves the option state to a file..........
This routine will save the state of option processing to a file. The name of that file can be specified with the argument to the --save-opts option, or by appen
manpages/glutInitDisplayMode.3.html
glutInitDisplayMode(3) - sets the initial display mode......
The initial display mode is used when creating top-level windows, subwindows, and overlays to determine the OpenGL display mode for the to-be-created window or
manpages/mattrib.1.html
mattrib(1) - change MSDOS file attribute flags (Man Page)...
Mattrib is used to change MS-DOS file attribute flags. It has the following syntax: mattrib [-a|+a] [-h|+h] [-r|+r] [-s|+s] [-/] [-p] [-X] msdosfile [ msdosfile
manpages/fstatvfs.2.html
fstatvfs(2) - get file system statistics - Linux man page...
The function statvfs() returns information about a mounted filesystem. path is the pathname of any file within the mounted filesystem. buf is a pointer to a sta
manpages/glNormal3bv.3gl.html
glNormal3bv(3gl) - set the current normal vector (Man Page)
The current normal is set to the given coordinates whenever glNormal is issued. Byte, short, or integer arguments are converted to floating-point with a linear
manpages/tc-cbq-details.8.html
tc-cbq-details(8) - Class Based Queueing - Linux man page...
tc-cbq-details.8 - Class Based Queueing is a classful qdisc that implements a rich linksharing hierarchy of classes. It contains shaping elements as well as pri
