NEWLOCALE(3) BSD Library Functions Manual NEWLOCALE(3)

NAME
     nneewwllooccaallee - Create a new locale

SYNOPSIS
     ##iinncclluuddee <>

     localet
     nneewwllooccaallee(int mask, const char * locale, localet base);

DESCRIPTION
     Creates a new localet based off the locale specified by base.  The cate-
     gories specified by mask will be replaced to correspond with the named
     locale.

     The mask is the logical OR of the following:

     LCCOLLATEMASK   Collation

     LCCTYPEMASK     Character type

     LCMESSAGESMASK  Messages

     LCMONETARYMASK  Monetary

     LCNUMERICMASK   Numeric

     LCTIMEMASK      Time

     LCALLMASK       The logical OR of all of the above

     The locale string is typically the name of one of the directories in
     /usr/share/locale.  If locale is NULL, then the C locale is used. If
     locale is an empty string, then it will look for environment variables:
     LCALL, then LC* if the corresponding LC*MASK bit is set, then the
     LANG environment variable. If none of these are found, it will default to
     the C locale.

     If base is NULL, the current locale is used. If base is LCGLOBALLOCALE,
     the global locale is used.

     If mask is LCALLMASK, base is ignored. In order to create a C localet
     value, use nneewwllooccaallee(LCALLMASK, NULL, NULL).

RETURN VALUES
     Returns a new localet, or NULL in case of error.  New locales should be
     freed with freelocale(3).

SEE ALSO
     xlocale(3), duplocale(3), freelocale(3), querylocale(3), uselocale(3)

BSD                             March 11, 2005                             BSD