ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man Pages
|
This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles. For more information about the manual page format, see the manual page for manpages(5). |
NEWLOCALE(3) BSD Library Functions Manual NEWLOCALE(3) NAME newlocale -- Create a new locale SYNOPSIS #include <xlocale.h> locale_t newlocale(int mask, const char * locale, locale_t base); DESCRIPTION Creates a new locale_t based off the locale specified by base. The cate-gories categories gories specified by mask will be replaced to correspond with the named locale. The mask is the logical OR of the following: LC_COLLATE_MASK Collation LC_CTYPE_MASK Character type LC_MESSAGES_MASK Messages LC_MONETARY_MASK Monetary LC_NUMERIC_MASK Numeric LC_TIME_MASK Time LC_ALL_MASK 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: LC_ALL, 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 LC_GLOBAL_LOCALE, the global locale is used. If mask is LC_ALL_MASK, base is ignored. In order to create a C locale_t value, use newlocale(LC_ALL_MASK, NULL, NULL). RETURN VALUES Returns a new locale_t, or NULL in case of error. New locales should be freed with freelocale(3). SEE ALSO duplocale(3), freelocale(3), querylocale(3), uselocale(3), xlocale(3) BSD March 11, 2005 BSD |