View source for cpp/string/wide/towupper

{{cpp/title|towupper}}
{{cpp/string/wide/navbar}}
{{ddcl|header=cwctype|
std::wint_t towupper( std::wint_t ch );
}}
Converts the given wide character to uppercase, if possible.

{{cpp/string/wide/wint_t args}}

===Parameters===
{{par begin}}
{{par|ch|wide character to be converted}}
{{par end}}

===Return value===
Uppercase version of {{c|ch}} or unmodified {{c|ch}} if no uppercase version is listed in the current C locale.

===Notes===
Only 1:1 character mapping can be performed by this function, e.g. the uppercase form of {{c/core|'ß'}} is (with some exceptions) the two-character string {{c/core|"SS"}}, which cannot be obtained by {{tt|std::towupper}}.

[https://www.open-std.org/JTC1/SC35/WG5/docs/30112d10.pdf ISO 30112] specifies which pairs of Unicode characters are included in this mapping.

===Example===
{{example
|The latin {{enwiki|Long s|letter 'ſ' (U+017F)}} is the alternative lowercase form of {{c/core|'S'}} (U+0053).
|code=
#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) = 0x17f
in Unicode locale, towupper(0x17f) = 0x53
}}

===See also===
{{dsc begin}}
{{dsc inc|cpp/string/wide/dsc towlower}}
{{dsc inc|cpp/locale/dsc toupper}}
{{dsc inc|cpp/string/byte/dsc toupper}}
{{dsc see c|c/string/wide/towupper}}
{{dsc end}}

{{langlinks|de|es|fr|it|ja|pt|ru|zh}}