| Defined in header <cctype> | ||||
|---|---|---|---|---|
|
Converts the given character to uppercase according to the character conversion rules defined by the currently installed C locale.
In the default "C" locale, the following lowercase letters abcdefghijklmnopqrstuvwxyz are replaced with respective uppercase letters ABCDEFGHIJKLMNOPQRSTUVWXYZ.
Parameters
| ch | - | character to be converted. If the value of ch is not representable as unsigned char and does not equal EOF, the behavior is undefined. |
Return value
Converted character or ch if no uppercase version is defined by the current C locale.
Example
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | #include <iostream>#include <cctype>#include <clocale> int main(){ unsigned char c = '\xb8'; // the character ž in ISO-8859-15 // but ¸ (cedilla) in ISO-8859-1 std::setlocale(LC_ALL, "en_US.iso88591"); std::cout << std::hex << std::showbase; std::cout << "in iso8859-1, toupper('0xb8') gives " << std::toupper(c) << '\n'; std::setlocale(LC_ALL, "en_US.iso885915"); std::cout << "in iso8859-15, toupper('0xb8') gives " << std::toupper(c) << '\n';} |
Output:
1 2 | in iso8859-1, toupper('0xb8') gives 0xb8in iso8859-15, toupper('0xb8') gives 0xb4 |
See also
| converts a character to lowercase (function) | |
| converts a character to uppercase using the ctype facet of a locale (function template) | |
| converts a wide character to uppercase (function) | |
C documentation for toupper | |
Please login to continue.