Functions to determine the category of wide characters. More...

Functions
constexpr auto	iswalnum (wint_t ch) noexcept -> int
	Checks if the given wide character is an alphanumeric character, i.e. either a number (0123456789), an uppercase letter (ABCDEFGHIJKLMNOPQRSTUVWXYZ), a lowercase letter (abcdefghijklmnopqrstuvwxyz) or any alphanumeric character specific to the current locale.

constexpr auto	iswalpha (wint_t ch) noexcept -> int
	Checks if the given wide character is an alphabetic character, i.e. either an uppercase letter (ABCDEFGHIJKLMNOPQRSTUVWXYZ), a lowercase letter (abcdefghijklmnopqrstuvwxyz) or any alphabetic character specific to the current locale.

constexpr auto	iswblank (wint_t ch) noexcept -> int
	Checks if the given wide character is classified as blank character (that is, a whitespace character used to separate words in a sentence) by the current C locale. In the default C locale, only space (0x20) and horizontal tab (0x09) are blank characters.

constexpr auto	iswcntrl (wint_t ch) noexcept -> int
	Checks if the given wide character is a control character, i.e. codes 0x00-0x1F and 0x7F and any control characters specific to the current locale.

constexpr auto	iswdigit (wint_t ch) noexcept -> int
	Checks if the given wide character corresponds (if narrowed) to one of the ten decimal digit characters 0123456789.

constexpr auto	iswgraph (wint_t ch) noexcept -> int
	Checks if the given wide character has a graphical representation, i.e. it is either a number (0123456789), an uppercase letter (ABCDEFGHIJKLMNOPQRSTUVWXYZ), a lowercase letter (abcdefghijklmnopqrstuvwxyz), a punctuation character(!"#$%&'()*+,-./:;<=>?@[]^_`{\|}~) or any graphical character specific to the current C locale.

constexpr auto	iswlower (wint_t ch) noexcept -> int
	Checks if the given wide character is a lowercase letter, i.e. one of abcdefghijklmnopqrstuvwxyz or any lowercase letter specific to the current locale.

constexpr auto	iswprint (wint_t ch) noexcept -> int
	Checks if the given wide character can be printed, i.e. it is either a number (0123456789), an uppercase letter (ABCDEFGHIJKLMNOPQRSTUVWXYZ), a lowercase letter (abcdefghijklmnopqrstuvwxyz), a punctuation character(!"#$%&'()*+,-./:;<=>?@[]^_`{\|}~), space or any printable character specific to the current C locale.

constexpr auto	iswpunct (wint_t ch) noexcept -> int
	Checks if the given wide character is a punctuation character, i.e. it is one of !"#$%&'()*+,-./:;<=>?@[]^_`{\|}~ or any punctuation character specific to the current locale.

constexpr auto	iswspace (wint_t ch) noexcept -> int
	Checks if the given wide character is a wide whitespace character as classified by the currently installed C locale.

constexpr auto	iswupper (wint_t ch) noexcept -> int
	Checks if the given wide character is an uppercase letter, i.e. one of ABCDEFGHIJKLMNOPQRSTUVWXYZ or any uppercase letter specific to the current locale.

constexpr auto	iswxdigit (wint_t ch) noexcept -> int
	Checks if the given wide character corresponds (if narrowed) to a hexadecimal numeric character, i.e. one of 0123456789abcdefABCDEF.

constexpr auto	towlower (wint_t ch) noexcept -> wint_t
	Converts the given wide character to lowercase, if possible.

constexpr auto	towupper (wint_t ch) noexcept -> wint_t
	Converts the given wide character to uppercase, if possible.

Detailed Description

Functions to determine the category of wide characters.

Function Documentation

◆ iswalnum()

auto iswalnum ( wint_t ch ) -> int

nodiscardconstexprnoexcept

Checks if the given wide character is an alphanumeric character, i.e. either a number (0123456789), an uppercase letter (ABCDEFGHIJKLMNOPQRSTUVWXYZ), a lowercase letter (abcdefghijklmnopqrstuvwxyz) or any alphanumeric character specific to the current locale.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined.

https://en.cppreference.com/w/cpp/string/wide/iswalnum

◆ iswalpha()

auto iswalpha ( wint_t ch ) -> int

nodiscardconstexprnoexcept

Checks if the given wide character is an alphabetic character, i.e. either an uppercase letter (ABCDEFGHIJKLMNOPQRSTUVWXYZ), a lowercase letter (abcdefghijklmnopqrstuvwxyz) or any alphabetic character specific to the current locale.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined.

https://en.cppreference.com/w/cpp/string/wide/iswalpha

◆ iswblank()

auto iswblank ( wint_t ch ) -> int

nodiscardconstexprnoexcept

Checks if the given wide character is classified as blank character (that is, a whitespace character used to separate words in a sentence) by the current C locale. In the default C locale, only space (0x20) and horizontal tab (0x09) are blank characters.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined.

https://en.cppreference.com/w/cpp/string/wide/iswblank

◆ iswcntrl()

auto iswcntrl ( wint_t ch ) -> int

nodiscardconstexprnoexcept

Checks if the given wide character is a control character, i.e. codes 0x00-0x1F and 0x7F and any control characters specific to the current locale.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined.

https://en.cppreference.com/w/cpp/string/byte/iscntrl

◆ iswdigit()

auto iswdigit ( wint_t ch ) -> int

nodiscardconstexprnoexcept

Checks if the given wide character corresponds (if narrowed) to one of the ten decimal digit characters 0123456789.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined.

https://en.cppreference.com/w/cpp/string/wide/iswdigit

◆ iswgraph()

auto iswgraph ( wint_t ch ) -> int

nodiscardconstexprnoexcept

Checks if the given wide character has a graphical representation, i.e. it is either a number (0123456789), an uppercase letter (ABCDEFGHIJKLMNOPQRSTUVWXYZ), a lowercase letter (abcdefghijklmnopqrstuvwxyz), a punctuation character(!"#$%&'()*+,-./:;<=>?@[]^_`{|}~) or any graphical character specific to the current C locale.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined.

https://en.cppreference.com/w/cpp/string/wide/iswgraph

◆ iswlower()

auto iswlower ( wint_t ch ) -> int

nodiscardconstexprnoexcept

Checks if the given wide character is a lowercase letter, i.e. one of abcdefghijklmnopqrstuvwxyz or any lowercase letter specific to the current locale.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined.

https://en.cppreference.com/w/cpp/string/wide/iswlower

◆ iswprint()

auto iswprint ( wint_t ch ) -> int

nodiscardconstexprnoexcept

Checks if the given wide character can be printed, i.e. it is either a number (0123456789), an uppercase letter (ABCDEFGHIJKLMNOPQRSTUVWXYZ), a lowercase letter (abcdefghijklmnopqrstuvwxyz), a punctuation character(!"#$%&'()*+,-./:;<=>?@[]^_`{|}~), space or any printable character specific to the current C locale.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined.

https://en.cppreference.com/w/cpp/string/wide/iswprint

◆ iswpunct()

auto iswpunct ( wint_t ch ) -> int

nodiscardconstexprnoexcept

Checks if the given wide character is a punctuation character, i.e. it is one of !"#$%&'()*+,-./:;<=>?@[]^_`{|}~ or any punctuation character specific to the current locale.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined.

https://en.cppreference.com/w/cpp/string/wide/iswpunct

◆ iswspace()

auto iswspace ( wint_t ch ) -> int

nodiscardconstexprnoexcept

Checks if the given wide character is a wide whitespace character as classified by the currently installed C locale.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined. In the default locale, the whitespace characters are the following:

- space (0x20)
- form feed (0x0c)
- line feed (0x0a)
- carriage return (0x0d)
- horizontal tab (0x09)
- vertical tab (0x0b)

https://en.cppreference.com/w/cpp/string/wide/iswspace

◆ iswupper()

auto iswupper ( wint_t ch ) -> int

nodiscardconstexprnoexcept

Checks if the given wide character is an uppercase letter, i.e. one of ABCDEFGHIJKLMNOPQRSTUVWXYZ or any uppercase letter specific to the current locale.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined.

https://en.cppreference.com/w/cpp/string/wide/iswupper

◆ iswxdigit()

auto iswxdigit ( wint_t ch ) -> int

nodiscardconstexprnoexcept

Checks if the given wide character corresponds (if narrowed) to a hexadecimal numeric character, i.e. one of 0123456789abcdefABCDEF.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined.

https://en.cppreference.com/w/cpp/string/wide/iswxdigit

◆ towlower()

auto towlower ( wint_t ch ) -> wint_t

nodiscardconstexprnoexcept

Converts the given wide character to lowercase, if possible.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined.

https://en.cppreference.com/w/cpp/string/wide/towlower

◆ towupper()

auto towupper ( wint_t ch ) -> wint_t

nodiscardconstexprnoexcept

Converts the given wide character to uppercase, if possible.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined.

https://en.cppreference.com/w/cpp/string/wide/towupper