Null-terminated wide strings
From cppreference.com
A null-terminated wide string is a sequence of valid wide characters, ending with a null-character.
Functions
Character classification | |
Defined in header
<wctype.h> | |
(C95) |
checks if a wide character is alphanumeric (function) |
(C95) |
checks if a wide character is alphabetic (function) |
(C95) |
checks if a wide character is an lowercase character (function) |
(C95) |
checks if a wide character is an uppercase character (function) |
(C95) |
checks if a wide character is a digit (function) |
(C95) |
checks if a character is a hexadecimal character (function) |
(C95) |
checks if a wide character is a control character (function) |
(C95) |
checks if a wide character is a graphical character (function) |
(C95) |
checks if a wide character is a space character (function) |
(C99) |
checks if a wide character is a blank character (function) |
(C95) |
checks if a wide character is a printing character (function) |
(C95) |
checks if a wide character is a punctuation character (function) |
(C95) |
classifies a wide character according to the specified LC_CTYPE category (function) |
(C95) |
looks up a character classification category in the current C locale (function) |
Character manipulation | |
Defined in header
<wctype.h> | |
(C95) |
converts a wide character to lowercase (function) |
(C95) |
converts a wide character to uppercase (function) |
(C95) |
performs character mapping according to the specified LC_CTYPE mapping category (function) |
(C95) |
looks up a character mapping category in the current C locale (function) |
ASCII values | characters | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
decimal | hexadecimal | octal | |||||||||||||
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
|
Conversions to numeric formats | |
Defined in header
<wchar.h> | |
(C95)(C99) |
converts a wide string to an integer value (function) |
(C95)(C99) |
converts a wide string to an unsigned integer value (function) |
(C99)(C95)(C99) |
converts a wide string to a floating-point value (function) |
Defined in header
<inttypes.h> | |
(C99)(C99) |
converts a wide string to intmax_t or uintmax_t (function) |
String manipulation | |
Defined in header
<wchar.h> | |
(C95)(C11) |
copies one wide string to another (function) |
(C95)(C11) |
copies a certain amount of wide characters from one string to another (function) |
(C95)(C11) |
appends a copy of one wide string to another (function) |
(C95)(C11) |
appends a certain amount of wide characters from one wide string to another (function) |
(C95) |
transform a wide string so that wcscmp would produce the same result as wcscoll (function) |
String examination | |
Defined in header
<wchar.h> | |
(C95)(C11) |
returns the length of a wide string (function) |
(C95) |
compares two wide strings (function) |
(C95) |
compares a certain amount of characters from two wide strings (function) |
(C95) |
compares two wide strings in accordance to the current locale (function) |
(C95) |
finds the first occurrence of a wide character in a wide string (function) |
(C95) |
finds the last occurrence of a wide character in a wide string (function) |
(C95) |
returns the length of the maximum initial segment that consists of only the wide characters found in another wide string (function) |
(C95) |
returns the length of the maximum initial segment that consists of only the wide chars not found in another wide string (function) |
(C95) |
finds the first location of any wide character in one wide string, in another wide string (function) |
(C95) |
finds the first occurrence of a wide string within another wide string (function) |
(C95)(C11) |
finds the next token in a wide string (function) |
Wide character array manipulation | |
Defined in header
<wchar.h> | |
(C95)(C11) |
copies a certain amount of wide characters between two non-overlapping arrays (function) |
(C95)(C11) |
copies a certain amount of wide characters between two, possibly overlapping, arrays (function) |
(C95) |
compares a certain amount of wide characters from two arrays (function) |
(C95) |
finds the first occurrence of a wide character in a wide character array (function) |
(C95) |
copies the given wide character to every position in a wide character array (function) |
Types
Defined in header
<wchar.h> | |
wchar_t
|
integer type that can hold any valid wide character (C++ keyword) |
Defined in header
<wctype.h> | |
wint_t (C95)
|
integer type that can hold any valid wide character and at least one more value |
wctrans_t (C95)
|
scalar type that holds locale-specific character mapping |
wctype_t (C95)
|
scalar type that holds locale-specific character classification |
Macros
Defined in header
<wchar.h> | |
WEOF (C95) |
a non-character value of type wint_t used to indicate errors (macro constant) |
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>