Docs4dev
Docs
c / latest / string / wide.html

Null-terminated wide strings

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

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

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/c/string/wide