##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::towupper

From cppreference.com
< cpp‎ | string‎ | wide

Defined in header `<cwctype>` |  |
std::wint_t towupper( std::wint_t ch ); |  |

Converts the given wide character to uppercase, if possible.

### [edit] Parameters

ch | - | wide character to be converted

### [edit] Return value

Uppercase version of `ch` or unmodified `ch` if no uppercase version is listed in the current C locale.

### [edit] Notes

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 by std::towupper.

### [edit] Example

The latin letter 'ſ' (U+017F) is the alternative lowercase form of 'S' (U+0053)

Run this code

    #include <iostream>
    #include <cwctype>
    #include <clocale>

    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(" << (std::wint_t)c << ") = "
                  << std::towupper(c) << '\n';
        std::setlocale(LC_ALL, "en_US.utf8");
        std::cout << "in Unicode locale, towupper(" << (std::wint_t)c << ") = "
                  << std::towupper(c) << '\n';
    }

Output:

    in the default locale, towupper(0x17f) = 0x17f
    in Unicode locale, towupper(0x17f) = 0x53

### [edit] See also

towlower | converts a wide character to lowercase (function) [edit]
toupper(std::locale) | converts a character to uppercase using the ctype facet of a locale (function template) [edit]
toupper | converts a character to uppercase (function) [edit]
C documentation for towupper

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/string/wide/towupper&oldid=59108"