locale.7: Add subsection on POSIX.1-2008 (originally GNU) extensions to locale API

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2014-03-07 11:43:24 +01:00
parent a6ce0ba566
commit 4aeed3697f
1 changed files with 21 additions and 0 deletions

View File

@ -205,6 +205,27 @@ struct lconv {
};
.fi
.in
.SS POSIX.1-2008 extensions to the locale API
POSIX.1-2008 standardized a number of extensions to the locale API,
based on implementations that first appeared in version 2.3
of the GNU C library.
These extensions are designed to address the problem the traditional
locale APIs do not mix well with multithreaded applications
and with applications that must deal with multiple locales.
The extensions take the form of new functions for creating and
manipulating locale objects
.RB ( newlocale (3),
.BR freelocale (3),
.BR duplocale (3),
and
.BR uselocale (3))
and various new library functions with the suffix "_l" (e.g.,
.BR toupper_l (3))
that extend the traditional locale-dependent APIs (e.g.,
.BR toupper (3))
to allow the specification of a locale object that should apply when
executing the function.
.SH CONFORMING TO
POSIX.1-2001.