XLOCALE(3) BSD Library Functions Manual XLOCALE(3)

NAME
     xxllooccaallee - Extended locale support.

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

DESCRIPTION
     Include  for extended locale support.  It can be used alone or
     with the POSIX locale API in .

     The extended locale, or "xlocale" API consists of five basic routines,
     which are documented separately: duplocale(3), freelocale(3),
     newlocale(3), querylocale(3), and uselocale(3).  For each of these rou-
     tines, if a NULL localet is given, the current locale is used.

     In addition,  defines a few macros:

     -   LCGLOBALLOCALE - A special localet value that corresponds to the
         global, process-wide locale.

     -   MBCURMAX - This macro is traditionally defined as an integer con-
         taining the value of the longest multi-byte string that a single-wide
         character in the global locale can translate into.  With extended
         locales, this macro is replaced with a function that returns the
         value of the longest multi-byte string that a single-wide character
         in the current locale (per-thread or global) can translate into.

     -   MBCURMAXL(loc) - This macro is equivalent to MBCURMAX, except
         that it may be passed a specific locale directly.

CCAAVVEEAATTSS
     The POSIX setlocale(3) function only affects the global locale, so using
     it when a per-thread locale is in effect will not change locale behavior
     for that thread. However, it will change behavior for threads with no
     per-thread locale in effect.

     The routines defined in  are deprecated, and may not be fully
     consistent with the xlocale API.  Of particular note is sseettiinnvvaalliiddrruunnee(),
     which would normally modify the value in the global locale.  Since this
     value resides in a sub-structure of localet and sub-structures may be
     shared by multiple locales, sseettiinnvvaalliiddrruunnee() has been modified to make a
     copy of the sub-structure.  This prevents it from affecting other
     locales.

SEE ALSO
     localeconv(3), duplocale(3), freelocale(3), newlocale(3), querylocale(3),
     uselocale(3)

CCOONNVVEENNIIEENNCCEE FFUUNNCCTTIIOONNSS
     The xlocale API also includes "convenience functions"; functions that can
     be executed using a given locale, rather than the current locale. These
     functions all take one extra localet argument at the end of the tradi-
     tional argument list, except in the case of variable-argument functions,
     in which case the extra argument comes before the format string.  If a
     NULL localet is passed, the C locale will be used.

     For completeness, the convenience functions are listed here (organized by
     the header file that contains the original function).

     
                 iswalnuml(3), iswalphal(3), iswcntrll(3), iswctypel(3),
                 iswdigitl(3), iswgraphl(3), iswlowerl(3), iswprintl(3),
                 iswpunctl(3), iswspacel(3), iswupperl(3), iswxdigitl(3),
                 towlowerl(3), towupperl(3), wctypel(3)

        digittointl(3), isalnuml(3), isalphal(3), isblankl(3),
                 iscntrll(3), isdigitl(3), isgraphl(3), ishexnumberl(3),
                 isideograml(3), islowerl(3), isnumberl(3),
                 isphonograml(3), isprintl(3), ispunctl(3), isrunel(3),
                 isspacel(3), isspeciall(3), isupperl(3), isxdigitl(3),
                 tolowerl(3), toupperl(3)

     
                 strtoimaxl(3), strtoumaxl(3), wcstoimaxl(3),
                 wcstoumaxl(3)

     
                 nllanginfol(3)

     
                 strfmonl(3)

        asprintfl(3), fprintfl(3), fscanfl(3), printfl(3),
                 scanfl(3), snprintfl(3), sprintfl(3), sscanfl(3),
                 vasprintfl(3), vfprintfl(3), vfscanfl(3), vprintfl(3),
                 vscanfl(3), vsnprintfl(3), vsprintfl(3), vsscanfl(3)

       atofl(3), atoil(3), atoll(3), atolll(3), mblenl(3),
                 mbstowcsl(3), mbtowcl(3), strtodl(3), strtofl(3),
                 strtoll(3), strtoldl(3), strtolll(3), strtoql(3),
                 strtoull(3), strtoulll(3), strtouql(3), wcstombsl(3),
                 wctombl(3)

       strcolll(3), strxfrml(3), strcasecmpl(3), strcasestrl(3),
                 strncasecmpl(3)

         strftimel(3), strptimel(3)

        btowcl(3), fgetwcl(3), *fgetwsl(3), fputwcl(3),
                 fputwsl(3), fwprintfl(3), fwscanfl(3), getwcl(3),
                 getwcharl(3), mbrlenl(3), mbrtowcl(3), mbsinitl(3),
                 mbsnrtowcsl(3), mbsrtowcsl(3), putwcl(3), putwcharl(3),
                 swprintfl(3), swscanfl(3), ungetwcl(3), vfwprintfl(3),
                 vfwscanfl(3), vswprintfl(3), vswscanfl(3), vwprintfl(3),
                 vwscanfl(3), wcrtombl(3), wcscolll(3), wcsftimel(3),
                 wcsnrtombsl(3), wcsrtombsl(3), wcstodl(3), wcstofl(3),
                 wcstoll(3), wcstoldl(3), wcstolll(3), wcstoull(3),
                 wcstoulll(3), wcswidthl(3), wcsxfrml(3), wctobl(3),
                 wcwidthl(3), wprintfl(3), wscanfl(3)

       iswblankl(3), iswhexnumberl(3), iswideograml(3),
                 iswnumberl(3), iswphonograml(3), iswrunel(3),
                 iswspeciall(3), nextwctypel(3), towctransl(3),
                 wctransl(3)

     
                 localeconvl(3)

BSD                             March 11, 2005                             BSD