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 wide 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
|
GHIJKLMNOPQRSTUVWXYZ
|
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
|
ghijklmnopqrstuvwxyz
|
0
|
≠0
|
0
|
0
|
≠0
|
0
|
≠0
|
≠0
|
0
|
≠0
|
0
|
0
|
| 123–126 | \x7B–\x7E
|
\173–\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
<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>
See also
| C++ documentation for
Null-terminated wide strings |