Null-terminated wide strings

A null-terminated wide string is a sequence of valid wide characters, ending with a null-character.

Functions

Defined in header `<wctype.h>`
Character classification
iswalnum (C95)	checks if a wide character is alphanumeric (function)
iswalpha (C95)	checks if a wide character is alphabetic (function)
iswlower (C95)	checks if a wide character is an lowercase character (function)
iswupper (C95)	checks if a wide character is an uppercase character (function)
iswdigit (C95)	checks if a wide character is a digit (function)
iswxdigit (C95)	checks if a wide character is a hexadecimal character (function)
iswcntrl (C95)	checks if a wide character is a control character (function)
iswgraph (C95)	checks if a wide character is a graphical character (function)
iswspace (C95)	checks if a wide character is a space character (function)
iswblank (C99)	checks if a wide character is a blank character (function)
iswprint (C95)	checks if a wide character is a printing character (function)
iswpunct (C95)	checks if a wide character is a punctuation character (function)
iswctype (C95)	classifies a wide character according to the specified `LC_CTYPE` category (function)
wctype (C95)	looks up a character classification category in the current C locale (function)
Character manipulation
Defined in header `<wctype.h>`
towlower (C95)	converts a wide character to lowercase (function)
towupper (C95)	converts a wide character to uppercase (function)
towctrans (C95)	performs character mapping according to the specified LC_CTYPE mapping category (function)
wctrans (C95)	looks up a character mapping category in the current C locale (function)

ASCII values			characters	`iscntrl` `iswcntrl`	`isprint` `iswprint`	`isspace` `iswspace`	`isblank` `iswblank`	`isgraph` `iswgraph`	`ispunct` `iswpunct`	`isalnum` `iswalnum`	`isalpha` `iswalpha`	`isupper` `iswupper`	`islower` `iswlower`	`isdigit` `iswdigit`	`isxdigit` `iswxdigit`
decimal	hexadecimal	octal	characters	`iscntrl` `iswcntrl`	`isprint` `iswprint`	`isspace` `iswspace`	`isblank` `iswblank`	`isgraph` `iswgraph`	`ispunct` `iswpunct`	`isalnum` `iswalnum`	`isalpha` `iswalpha`	`isupper` `iswupper`	`islower` `iswlower`	`isdigit` `iswdigit`	`isxdigit` `iswxdigit`
0–8	`\x0`–`\x8`	`\0`–`\10`	control codes (`NUL`, etc.)	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
9	`\x9`	`\11`	tab (`\t`)	`≠0`	`0`	`≠0`	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
10–13	`\xA`–`\xD`	`\12`–`\15`	whitespaces (`\n`, `\v`, `\f`, `\r`)	`≠0`	`0`	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
14–31	`\xE`–`\x1F`	`\16`–`\37`	control codes	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
32	`\x20`	`\40`	space	`0`	`≠0`	`≠0`	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
33–47	`\x21`–`\x2F`	`\41`–`\57`	`!"#$%&'()*+,-./`	`0`	`≠0`	`0`	`0`	`≠0`	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`
48–57	`\x30`–`\x39`	`\60`–`\71`	`0123456789`	`0`	`≠0`	`0`	`0`	`≠0`	`0`	`≠0`	`0`	`0`	`0`	`≠0`	`≠0`
58–64	`\x3A`–`\x40`	`\72`–`\100`	`:;<=>?@`	`0`	`≠0`	`0`	`0`	`≠0`	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`
65–70	`\x41`–`\x46`	`\101`–`\106`	`ABCDEF`	`0`	`≠0`	`0`	`0`	`≠0`	`0`	`≠0`	`≠0`	`≠0`	`0`	`0`	`≠0`
71–90	`\x47`–`\x5A`	`\107`–`\132`	`GHIJKLMNOP` `QRSTUVWXYZ`	`0`	`≠0`	`0`	`0`	`≠0`	`0`	`≠0`	`≠0`	`≠0`	`0`	`0`	`0`
91–96	`\x5B`–`\x60`	`\133`–`\140`	[\]^_`	`0`	`≠0`	`0`	`0`	`≠0`	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`
97–102	`\x61`–`\x66`	`\141`–`\146`	`abcdef`	`0`	`≠0`	`0`	`0`	`≠0`	`0`	`≠0`	`≠0`	`0`	`≠0`	`0`	`≠0`
103–122	`\x67`–`\x7A`	`\147`–`\172`	`ghijklmnop` `qrstuvwxyz`	`0`	`≠0`	`0`	`0`	`≠0`	`0`	`≠0`	`≠0`	`0`	`≠0`	`0`	`0`
123–126	`\x7B`–`\x7E`	`\172`–`\176`	`{\|}~`	`0`	`≠0`	`0`	`0`	`≠0`	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`
127	`\x7F`	`\177`	backspace character (`DEL`)	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`

Defined in header `<wchar.h>`
Conversions to numeric formats
wcstolwcstoll (C95)(C99)	converts a wide string to an integer value (function)
wcstoulwcstoull (C95)(C99)	converts a wide string to an unsigned integer value (function)
wcstofwcstodwcstold (C99)(C95)(C99)	converts a wide string to a floating-point value (function)
Defined in header `<inttypes.h>`
wcstoimaxwcstoumax (C99)(C99)	converts a wide string to `intmax_t` or `uintmax_t` (function)

Defined in header `<wchar.h>`
String manipulation
wcscpywcscpy_s (C95)(C11)	copies one wide string to another (function)
wcsncpywcsncpy_s (C95)(C11)	copies a certain amount of wide characters from one string to another (function)
wcscatwcscat_s (C95)(C11)	appends a copy of one wide string to another (function)
wcsncatwcsncat_s (C95)(C11)	appends a certain amount of wide characters from one wide string to another (function)
wcsxfrm (C95)	transform a wide string so that wcscmp would produce the same result as wcscoll (function)
String examination
Defined in header `<wchar.h>`
wcslenwcsnlen_s (C95)(C11)	returns the length of a wide string (function)
wcscmp (C95)	compares two wide strings (function)
wcsncmp (C95)	compares a certain amount of characters from two wide strings (function)
wcscoll (C95)	compares two wide strings in accordance to the current locale (function)
wcschr (C95)	finds the first occurrence of a wide character in a wide string (function)
wcsrchr (C95)	finds the last occurrence of a wide character in a wide string (function)
wcsspn (C95)	returns the length of the maximum initial segment that consists of only the wide characters found in another wide string (function)
wcscspn (C95)	returns the length of the maximum initial segment that consists of only the wide chars not found in another wide string (function)
wcspbrk (C95)	finds the first location of any wide character in one wide string, in another wide string (function)
wcsstr (C95)	finds the first occurrence of a wide string within another wide string (function)
wcstokwcstok_s (C95)(C11)	finds the next token in a wide string (function)

Defined in header `<wchar.h>`
Wide character array manipulation
wmemcpywmemcpy_s (C95)(C11)	copies a certain amount of wide characters between two non-overlapping arrays (function)
wmemmovewmemmove_s (C95)(C11)	copies a certain amount of wide characters between two, possibly overlapping, arrays (function)
wmemcmp (C95)	compares a certain amount of wide characters from two arrays (function)
wmemchr (C95)	finds the first occurrence of a wide character in a wide character array (function)
wmemset (C95)	copies the given wide character to every position in a wide character array (function)

Types

Defined in header `<stddef.h>`
Defined in header `<stdlib.h>`
Defined in header `<wchar.h>`
wchar_t	integer type that can hold any valid wide character (typedef)
Defined in header `<wchar.h>`
Defined in header `<wctype.h>`
wint_t (C95)	integer type that can hold any valid wide character and at least one more value (typedef)
Defined in header `<wctype.h>`
wctrans_t (C95)	scalar type that holds locale-specific character mapping (typedef)
wctype_t (C95)	scalar type that holds locale-specific character classification (typedef)

Macros

Defined in header `<wchar.h>`
Defined in header `<wctype.h>`
WEOF (C95)	a non-character value of type wint_t used to indicate errors (macro constant)
Defined in header `<wchar.h>`
Defined in header `<stdint.h>`
WCHAR_MIN (C95)	the smallest valid value of wchar_t (macro constant)
WCHAR_MAX (C95)	the largest valid value of wchar_t (macro constant)

References

C11 standard (ISO/IEC 9899:2011):

7.19 Common definitions <stddef.h> (p: 288)
7.29 Extended multibyte and wide character utilities <wchar.h> (p: 402-446)
7.30 Wide character classification and mapping utilities <wctype.h> (p: 447-454)
7.31.16 Extended multibyte and wide character utilities <wchar.h> (p: 456)
7.31.17 Wide character classification and mapping utilities <wctype.h> (p: 457)
K.3.3 Common definitions <stddef.h> (p: 585)
K.3.9 Extended multibyte and wide character utilities <wchar.h> (p: 627-651)

C99 standard (ISO/IEC 9899:1999):

7.17 Common definitions <stddef.h> (p: 254)
7.24 Extended multibyte and wide character utilities <wchar.h> (p: 348-392)
7.25 Wide character classification and mapping utilities <wctype.h> (p: 393-400)
7.26.12 Extended multibyte and wide character utilities <wchar.h> (p: 402)
7.26.13 Wide character classification and mapping utilities <wctype.h> (p: 402)

C89/C90 standard (ISO/IEC 9899:1990):

4.1.5 Common definitions <stddef.h>

Null-terminated wide strings

Functions

Character classification

Character manipulation

Conversions to numeric formats

String manipulation

String examination

Wide character array manipulation

Types

Macros

References

See also