The Open Group Base Specifications Issue 7
IEEE Std 1003.1, 2013 Edition
Copyright © 2001-2013 The IEEE and The Open Group

#### 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 The Compilation Environment ) 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:

> WEOF
>   As described in <wchar.h>.

> 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);

The following sections are informative.

#### 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 The Compilation Environment, iswalnum, iswalpha, iswblank, iswcntrl, iswctype, iswdigit, iswgraph, iswlower, iswprint, iswpunct, iswspace, iswupper, iswxdigit, setlocale, towctrans, towlower, towupper, wctrans, wctype

#### CHANGE HISTORY

> First released in Issue 5. Derived from the ISO/IEC 9899:1990/Amendment 1:1995 (E).

#### Issue 6

> The iswblank() function is added for alignment with the ISO/IEC 9899:1999 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.

End of informative text.

return to top of page

UNIX ® is a registered Trademark of The Open Group.
POSIX ® is a registered Trademark of The IEEE.
Copyright © 2001-2013 The IEEE and The Open Group, All Rights Reserved
[ Main Index | XBD | XSH | XCU | XRAT ]