Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/string/wide/towupper"

From cppreference.com
< cpp‎ | string‎ | wide
m (typo strings->string)
m (tt)
 
(13 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
{{cpp/title|towupper}}
 
{{cpp/title|towupper}}
−
{{cpp/string/wide/sidebar}}
+
{{cpp/string/wide/navbar}}
−
{{ddcl | header=cwctype |
+
{{ddcl|header=cwctype|
−
wint_t towupper( wint_t ch );
+
std::wint_t towupper( std::wint_t ch );
 
}}
 
}}
 
Converts the given wide character to uppercase, if possible.
 
Converts the given wide character to uppercase, if possible.
 +
 +
{{cpp/string/wide/wint_t args}}
  
 
===Parameters===
 
===Parameters===
−
{{param list begin}}
+
{{par begin}}
−
{{param list item | ch | wide character to be converted}}
+
{{par|ch|wide character to be converted}}
−
{{param list end}}
+
{{par end}}
  
 
===Return value===
 
===Return value===
−
 
+
Uppercase version of {{c|ch}} or unmodified {{c|ch}} if no uppercase version is listed in the current C locale.
−
uppercase version of {{tt|ch}} or unmodified {{tt|ch}} if no uppercase version is listed in the current C locale.
+
  
 
===Notes===
 
===Notes===
−
===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}}.
−
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 {{cpp|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===
 
===See also===
−
{{dcl list begin}}
+
{{dsc begin}}
−
{{dcl list template | cpp/string/wide/dcl list towlower}}
+
{{dsc inc|cpp/string/wide/dsc towlower}}
−
{{dcl list template | cpp/locale/dcl list toupper}}
+
{{dsc inc|cpp/locale/dsc toupper}}
−
{{dcl list template | cpp/string/narrow/dcl list toupper}}
+
{{dsc inc|cpp/string/byte/dsc toupper}}
−
{{dcl list end}}
+
{{dsc see c|c/string/wide/towupper}}
 +
{{dsc end}}
 +
 
 +
{{langlinks|de|es|fr|it|ja|pt|ru|zh}}

Latest revision as of 16:00, 18 June 2023

 
C++
 
Strings library
 
Null-terminated wide strings
 
Defined in header <cwctype>
std::wint_t towupper( std::wint_t ch );

Converts the given wide character to uppercase, if possible.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined.

Contents

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

ISO 30112 specifies which pairs of Unicode characters are included in this mapping.

[edit] Example

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

Run this 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

[edit] See also

 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 for towupper
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/string/wide/towupper&oldid=153744"