UniCreateLocaleObject

UniCreateLocaleObject

UniCreateLocaleObject(localeSpecType, localeSpec, result)

This function creates a locale object.

Parameters

localeSpecType - integer - input

Specifies the type of value of localeSpec.

localeSpec - PVOID - input

The specific type or locale token as defined by localeSpecType.

result - LocaleObject - output

The locale object for use.

Constants

The constants for use for localeSpecType:

• UNI_TOKEN_POINTER
• UNI_MBS_STRING_POINTER
• UNI_UCS_STRING_POINTER

Returns

An integer with values of:

• ULS_INVALID
• ULS_NOMEMORY
• ULS_SUCCESS
• ULS_UNSUPPORTED

Calling conversion

Cdecl32

Example Code

integer      localeSpecType;
PVOID        localeSpec;
LocaleObject localeObj;
integer      rc;
...
rc = UniCreateLocaleObject(localeSpecType, localeSpec, localeObj);
...

Related Functions

UniFreeLocaleObject

Notes

UniCreateLocaleObject create the locale object for the locale specified by localeSpec. The LocaleObject contains all the data and methods necessary to perform locale specific operations or accept the localeObj. Upon successful creation, all categories are created and initialized.

When localeSpec is a character string (multi-byte or UCS), it identifies the locale to be used for initialization. The locale name UNIV is reserved and refers to the definitions provide default behavior for functions.

If localeSpec is NULL, the locale name UNIV is used.

When localeSpec is a locale token as indicated by localeSpecType, the token identifies the locale to be initialized.

If localeSpec is an empty character string (multi-byte or UCS), the locale object is initialized using the settings in the locale environment variables.

Not completed.

OS Version Introduced

OS/2 Warp