NAME
wctype.h —
wide-character classification and mapping
utilities
SYNOPSIS
#include
<wctype.h>
DESCRIPTION
[CX] Some of the functionality described on this reference page extends the ISO C standard. Applications shall define the appropriate feature test macro (see XSH V2_chap02(3) ) to enable the visibility of these symbols in this header.
The <wctype.h> header shall define the following types:
- wint_t
- As described in <wchar.h> .
- wctrans_t
- A scalar type that can hold values which represent locale-specific character mappings.
- wctype_t
- As described in <wchar.h> .
[CX] The <wctype.h> header shall define the locale_t type as described in <locale.h>.
The <wctype.h> header shall define the following macro:
For all functions described in this header that accept an argument of type wint_t, the value is representable as a wchar_t or equals the value of WEOF. If this argument has any other value, the behavior is undefined.
The behavior of these functions shall be affected by the LC_CTYPE category of the current locale.
[CX] Inclusion of the <wctype.h> header may make visible all symbols from the headers <ctype.h>, <stdarg.h>, <stddef.h>, <stdio.h>, <stdlib.h>, <string.h>, <time.h>, and <wchar.h>.
The following shall be declared as functions and may also be defined as macros. Function prototypes shall be provided for use with ISO C standard compilers.
int iswalnum(wint_t); [CX] int iswalnum_l(wint_t, locale_t); int iswalpha(wint_t); [CX] int iswalpha_l(wint_t, locale_t); int iswblank(wint_t); [CX] int iswblank_l(wint_t, locale_t); int iswcntrl(wint_t); [CX] int iswcntrl_l(wint_t, locale_t); int iswctype(wint_t, wctype_t); [CX] int iswctype_l(wint_t, wctype_t, locale_t); int iswdigit(wint_t); [CX] int iswdigit_l(wint_t, locale_t); int iswgraph(wint_t); [CX] int iswgraph_l(wint_t, locale_t); int iswlower(wint_t); [CX] int iswlower_l(wint_t, locale_t); int iswprint(wint_t); [CX] int iswprint_l(wint_t, locale_t); int iswpunct(wint_t); [CX] int iswpunct_l(wint_t, locale_t); int iswspace(wint_t); [CX] int iswspace_l(wint_t, locale_t); int iswupper(wint_t); [CX] int iswupper_l(wint_t, locale_t); int iswxdigit(wint_t); [CX] int iswxdigit_l(wint_t, locale_t); wint_t towctrans(wint_t, wctrans_t); [CX] wint_t towctrans_l(wint_t, wctrans_t, locale_t); wint_t towlower(wint_t); [CX] wint_t towlower_l(wint_t, locale_t); wint_t towupper(wint_t); [CX] wint_t towupper_l(wint_t, locale_t); wctrans_t wctrans(const char *); [CX] wctrans_t wctrans_l(const char *, locale_t); wctype_t wctype(const char *); [CX] wctype_t wctype_l(const char *, locale_t);
APPLICATION USAGE
None.
RATIONALE
None.
FUTURE DIRECTIONS
None.
SEE ALSO
<ctype.h>, <locale.h> , <stdarg.h>, <stddef.h> , <stdio.h>, <stdlib.h>, <string.h>, <time.h>, <wchar.h>
XSH V2_chap02(3), iswalnum(3), iswalpha(3), iswblank(3), iswcntrl(3), iswctype(3), iswdigit(3), iswgraph(3), iswlower(3), iswprint(3), iswpunct(3), iswspace(3), iswupper(3), iswxdigit(3), setlocale(3), towctrans(3), towlower(3), towupper(3), wctrans(3), wctype(3)
CHANGE HISTORY
First released in Issue 5. Derived from the ISO/IEC 9899/AMD1:1995 (“ISO C90, Amendment 1”) (E).
Issue 6
The iswblank(3) function is added for alignment with the ISO/IEC 9899:1999 (“ISO C99”) standard.
Issue 7
SD5-XBD-ERN-6 is applied.
The *_l () functions are added from The Open Group Technical Standard, 2006, Extended API Set Part 4.
This reference page is clarified with respect to macros and symbolic constants.