---

Deprecated Locale Utilities Functions

A function identified as deprecated has been superseded and may become unsupported in the future.

Deprecated in Mac OS X v10.5

LocaleGetRegionLanguageName

Obtains the localized language name for a region. (Deprecated in Mac OS X v10.5.)

OSStatus LocaleGetRegionLanguageName (
   RegionCode region,
   Str255 languageName
);

Parameters

region

A Mac OS RegionCode value, specifying the region for which you are requesting a localized language name.

languageName

A Pascal string. On return, the string contains the name of the language corresponding to the region specified in the region parameter. The language name is produced in its own language and in the appropriate Mac OS encoding for that region.

Return Value

A result code. The LocaleGetRegionLanguageName function returns paramErr if languageName is NULL or if region is invalid (

Discussion

For a particular Mac OS region code, the LocaleGetRegionLanguageName function returns the name of the corresponding language in that language and in the non-Unicode Mac OS text encoding used for that region.

Note that, in some languages, the name for a language or locale may have several different grammatical forms, where the correct form depends on the usage or context. For example, Swedish uses different forms of a language name depending on whether the name is applied to a collation order, to text break rules, or to keyboard layouts. However, the Locale Utilities functions only return one form of a language or locale name—typically that name which would be used for the language name alone. Therefore, this name may not be the correct form for some usages in some languages.

Special Considerations

This function can move memory in Carbon and Mac OS 9.

Availability

• Available in CarbonLib 1.0 and later when running Mac OS 9 or later.
• Available in Mac OS X 10.0 and later.
• Deprecated in Mac OS X v10.5.
• Not available to 64-bit applications.

Declared In

MacLocales.h

---