wctype

 

C

Language

headers

Type support

Dynamic memory management

Error handling

Program utilities

Variadic function support

Date and time utilities

Strings library

Algorithms

Numerics

Input/output support

Localization support

Thread support (C11)

Atomic operations (C11)

Technical Specifications

 

Strings library

Byte strings

Multibyte strings

Wide strings

 

Null-terminated wide strings

Functions
Character manipulation
iswalnum (C95) iswalpha (C95) iswlower (C95) iswupper (C95) iswdigit (C95) iswxdigit (C95) iswblank (C99) wctype (C95) iswctype (C95)	iswcntrl (C95) iswgraph (C95) iswspace (C95) iswprint (C95) iswpunct (C95) towlower (C95) towupper (C95) wctrans (C95) towctrans (C95)
Conversions to numeric formats
wcstolwcstoll (C95)(C99) wcstoulwcstoull (C95)(C99)	wcstofwcstodwcstold (C99)(C95)(C99) wcstoimaxwcstoumax (C99)(C99)
String manipulation
wcslenwcsnlen_s (C95)(C11) wcscpywcscpy_s (C95)(C11) wcsncpywcsncpy_s (C95)(C11) wcscatwcscat_s (C95)(C11) wcsncatwcsncat_s (C95)(C11) wcsstr (C95)	wcscmp (C95) wcsncmp (C95) wcscoll (C95) wcsxfrm (C95) wcschr (C95) wcsrchr (C95) wcspbrk (C95) wcsspn (C95) wcscspn (C95) wcstokwcstok_s (C95)(C11)
Array manipulation
wmemcpywmemcpy_s (C95)(C11) wmemmovewmemmove_s (C95)(C11)	wmemcmp (C95) wmemchr (C95) wmemset (C95)

 

Defined in header <wctype.h>
wctype_t wctype( const char* str );		(since C95)

Constructs a value of type wctype_t that describes a LC_CTYPE category of wide character classification. It may be one of the standard classification categories, or a locale-specific category, such as "jkanji".

Parameters

str

-

C string holding the name of the desired category

The following values of str are supported in all C locales:

value of str	effect
"alnum"	identifies the category used by iswalnum
"alpha"	identifies the category used by iswalpha
"blank"	identifies the category used by iswblank (C99)
"cntrl"	identifies the category used by iswcntrl
"digit"	identifies the category used by iswdigit
"graph"	identifies the category used by iswgraph
"lower"	identifies the category used by iswlower
"print"	identifies the category used by iswprint
"space"	identifies the category used by iswspace
"upper"	identifies the category used by iswupper
"xdigit"	identifies the category used by iswxdigit

Return value

wctype_t object suitable for use with iswctype to classify wide characters according to the named category of the current C locale or zero if str does not name a category supported by the current C locale.

References

• C11 standard (ISO/IEC 9899:2011):

• 7.30.2.2.2 The wctype function (p: 452)

• C99 standard (ISO/IEC 9899:1999):

• 7.25.2.2.2 The wctype function (p: 398)

See also

iswctype (C95)	classifies a wide character according to the specified LC_CTYPE category (function)
C++ documentation for wctype