Locale-sensitive interfaces

The z/OS® XL C/C++ runtime library provides many interfaces to manipulate and access locales. You can use these interfaces to write internationalized C programs. The following list summarizes all the z/OS XL C/C++ library functions which affect or are affected by the current locale.

Selecting locale

Changing the characteristics of the user's cultural environment by changing the current locale: setlocale()

Querying locale

Retrieving the locale information that characterizes the user's cultural environment:

Monetary and numeric formatting conventions:

localeconv()

Date and time formatting conventions:

localdtconv()

User-specified information:

nl_langinfo()

Encoding of the variant part of the portable character set:

getsyntx()

Character set identifier:

csid(), wcsid()

Classification of characters:

Single-byte characters:

isalnum(), isalpha(), isblank(), iscntrl(), isdigit(), isgraph(), islower(), isprint(), ispunct(), isspace(), isupper(), isxdigit()

Wide characters:

iswalnum(), iswalpha(), iswblank(), iswcntrl(), iswdigit(), iswgraph(), iswlower(), iswprint(), iswpunct(), iswspace(), iswupper(), iswxdigit(), wctype(), iswctype()

Character case mapping:

Single-byte characters:

tolower(), toupper()

Wide characters:

towlower(), towupper()

Multibyte character and multibyte string conversion:

mblen(), mbrlen(), mbtowc(), mbrtowc(), wctomb(), wcrtomb(), mbstowcs(), mbsrtowcs(), wcstombs(), wcsrtombs(), mbsinit(), wctob(), mbrtoc16(), mbrtoc32(), c16rtomb(), c32rtomb()

String conversions to arithmetic:

strtod(), wcstod(), strtol(), wcstol(), strtoul(), wcstoul(), atof(), atoi(), atol()

String collating:

strcoll(), strxfrm(), wcscoll(), wcsxfrm()

Character display width:

wcswidth(), wcwidth()

Date, time, and monetary formatting:

strftime(), strptime(), wcsftime(), mktime(), ctime(), gmtime(), localtime() strfmon()

Formatted input/output:

printf() (and family of functions), scanf() (and family of functions), vswprintf(), swprintf(), swscanf(), snprintf(), vsnprintf()

Processing regular expressions:

regcomp(), regexec()

Wide character unformatted input/output:

fgetwc(), fgetws(), fputwc(), fputws(), getwc(), getwchar(), putwc(), putwchar(), ungetwc()

Response matching:

rpmatch()

Collating elements:

ismccollel(), strtocoll(), colltostr(), collequiv(), collrange(), collorder(), cclass(), maxcoll(), getmccoll(), getwmccoll()