std::toupper(std::locale) - cppreference.com (original) (raw)

| | | | | --------------------------------------------------------------------- | | | | template< class CharT >CharT toupper( CharT ch, const locale& loc ); | | |

Converts the character ch to uppercase if possible, using the conversion rules specified by the given locale's std::ctype facet.

Contents

[edit] Parameters

ch - character
loc - locale

[edit] Return value

Returns the uppercase form of ch if one is listed in the locale, otherwise returns ch unchanged.

[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::toupper.

[edit] Possible implementation

[edit] Example

Possible output:

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

[edit] See also