| Localization library | |||||||||||||||||||||||||
| Regular expressions library(C++11) | |||||||||||||||||||||||||
| Formatting library(C++20) | |||||||||||||||||||||||||
| Null-terminated sequence utilities | |||||||||||||||||||||||||
| Byte strings | |||||||||||||||||||||||||
| Multibyte strings | |||||||||||||||||||||||||
| Wide strings | |||||||||||||||||||||||||
| Primitive numeric conversions | |||||||||||||||||||||||||
| |||||||||||||||||||||||||
| Text encoding identifications | |||||||||||||||||||||||||
| |||||||||||||||||||||||||
| Functions | ||||||||||||||||||||||||||
| Character classification | ||||||||||||||||||||||||||
| Character manipulation | ||||||||||||||||||||||||||
| ||||||||||||||||||||||||||
| Conversions to numeric formats | ||||||||||||||||||||||||||
|
| |||||||||||||||||||||||||
| String manipulation | ||||||||||||||||||||||||||
| String examination | ||||||||||||||||||||||||||
| Array manipulation | ||||||||||||||||||||||||||
Defined in header <cwctype> | ||
std::wint_t towupper(std::wint_t ch); | ||
Converts the given wide character to uppercase, if possible.
If the value ofch is neither representable as awchar_t nor equal to the value of the macroWEOF, the behavior is undefined.
Contents |
| ch | - | wide character to be converted |
Uppercase version ofch or unmodifiedch if no uppercase version is listed in the current C locale.
Only 1:1 character mapping can be performed by this function, e.g. the uppercase form of'ß' is (with some exceptions) the two-character string"SS", which cannot be obtained bystd::towupper.
ISO 30112 specifies which pairs of Unicode characters are included in this mapping.
The latinletter 'ſ' (U+017F) is the alternative lowercase form of'S' (U+0053).
#include <clocale>#include <cwctype>#include <iostream> int main(){wchar_t c= L'\u017f';// Latin small letter Long S ('ſ') std::cout<<std::hex<<std::showbase;std::cout<<"in the default locale, towupper("<<static_cast<std::wint_t>(c)<<") = "<< std::towupper(c)<<'\n'; std::setlocale(LC_ALL,"en_US.utf8");std::cout<<"in Unicode locale, towupper("<<static_cast<std::wint_t>(c)<<") = "<< std::towupper(c)<<'\n';}
Output:
in the default locale, towupper(0x17f) = 0x17fin Unicode locale, towupper(0x17f) = 0x53
| converts a wide character to lowercase (function)[edit] | |
| converts a character to uppercase using the ctype facet of a locale (function template)[edit] | |
| converts a character to uppercase (function)[edit] | |
C documentation fortowupper | |
