UniCreateLocaleObject creates a locale object for the locale categories specified by LocaleSpec. The object created is an opaque object containing all the data and methods necessary to perform the language-sensitive operations of functions that accept an argument of type LocaleObject If the function is successful, all categories of the locale object are created and initialized.

When the LocaleSpec argument is a pointer to a character string (UCS character string or multibyte character string), it identifies the name of the locale to be initialized. The locale name is used to locate physical resources associated with this locale. The locale name UNIV is reserved and refers to the definitions that provide default behavior for functions.

When the LocaleSpec argument is a NULL pointer (without regard to the value of the LocaleSpecType argument), UniCreateLocaleObject creates a locale object for the UNIV locale.

When the LocaleSpec argument points to a locale token value as indicated by the value of the LocaleSpecType argument, the token identifies the locale to be initialized.

When the LocaleSpec argument is an empty multibyte or UCS character string, UniCreateLocaleObject creates a locale object based upon the settings of the locale environment variables.

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³Category       ³Precedence     ³Usage                         ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³LC_ALL         ³Highest        ³Setting LC_ALL takes          ³
³               ³               ³precedence over any other     ³
³               ³               ³locale environment variable.  ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³LC_COLLATE     ³Equal          ³Specifies collation (sorting) ³
³               ³precedence     ³rules.                        ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³LC_CTYPE       ³Equal          ³Specifies character           ³
³               ³precedence     ³classification and case       ³
³               ³               ³conversion.                   ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³LC_MESSAGES    ³Equal          ³Specifies the values for      ³
³               ³precedence     ³affirmative and negative      ³
³               ³               ³answers, and the language for ³
³               ³               ³displayed messages.           ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³LC_MONETARY    ³Equal          ³Specifies monetary formats and³
³               ³precedence     ³currency symbol.              ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³LC_NUMERIC     ³Equal          ³Specifies decimal formats.    ³
³               ³precedence     ³                              ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³LC_TIME        ³Equal          ³Specifies date and time       ³
³               ³precedence     ³formats.                      ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³LANG           ³Lowest         ³Setting LANG takes precedence ³
³               ³               ³over any undefined locale     ³
³               ³               ³environment variable.  This   ³
³               ³               ³may be used in conjunction    ³
³               ³               ³with:                         ³
³               ³               ³LC_COLLATE LC_CTYPE           ³
³               ³               ³LC_MESSAGES LC_MONETARY       ³
³               ³               ³LC_NUMERIC LC_TIME            ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

If the specified locale is valid and supported, UniCreateLocaleObject allocates memory for the new object and returns the address of the created locale object in the area pointed to by locale_object. It is the application's responsibility to free this memory with a call to UniFreeLocaleObject when the object is no longer needed. If the function fails for any reason, the contents of the area pointed to by locale_object are undefined.

The locale token provides a shorthand notation for specifying a locale. The format of the locale token is as returned by a call to UniLocaleStrToToken. The format is defined as an unsigned integer of four octets.

Examples of typical usage:

The locale environments variables are set as follows:

LANG=de_DE
LC_MONETARY=en_US

The LocaleSpec argument is an empty multibyte or UCS character string.

This example creates a locale object with all categories set to de_DE except for LC_MONETARY which has the value of en_US. The locale environment variables are set as follows:

LANG=fr_FR

The LocaleSpec argument is an empty multibyte or UCS character string.

This example creates a locale object with all categories set to fr_FR. The locale environment variables are set as follows:

LC_ALL=it_IT
LANG=fr_FR

The LocaleSpec argument is an empty multibyte or UCS character string.