std::towupper

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Textverarbeitungsbibliothek

Lokalisierungsbibliothek

Reguläre Ausdrücke-Bibliothek (C++11)

Formatierungsbibliothek (C++20)

Dienstprogramme für Null-terminierte Sequenzen

Byte-Zeichenketten

Multibyte-Zeichenketten

Wide-Zeichenketten

Primitive numerische Konvertierungen

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

Textkodierungserkennung

text_encoding (C++26)

 

Null-terminierte breite Zeichenketten

Funktionen
Zeichenklassifizierung
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit wctype	iswblank (C++11) iswctype iswcntrl iswgraph iswspace iswprint iswpunct
Zeichenmanipulation
towlower towupper	towctrans wctrans
Konvertierungen in numerische Formate
wcstolwcstoll (C++11)   wcstofwcstodwcstold (C++11)(C++11)	wcstoulwcstoull (C++11) wcstoimaxwcstouimax (C++11)(C++11)
Stringmanipulation
wcslen wcscmp wcscoll wcsncmp wcschr wcsrchr	wcspbrk wcsspn wcscspn wcsstr wcstok
Stringuntersuchung
wcscpy wcsncpy wcsxfrm	wcscat wcsncat
Array-Manipulation
wmemcpy wmemmove wmemcmp	wmemchr wmemset
Typen wctrans_t wctype_t wint_t	Makros WCHAR_MIN WCHAR_MAX WEOF

 

Definiert in Header <cwctype>
std::wint_t towupper( std::wint_t ch );

Konvertiert das gegebene breite Zeichen in Großbuchstaben, falls möglich.

Wenn der Wert von ch weder als wchar_t darstellbar ist noch gleich dem Wert des Makros WEOF ist, ist das Verhalten undefiniert.

Parameter

ch

-

zu konvertierendes breites Zeichen

Rückgabewert

Großbuchstaben-Version von ch oder unverändertes ch, wenn keine Großbuchstaben-Version in der aktuellen C-Locale aufgeführt ist.

Hinweise

Nur 1:1-Zeichenzuordnungen können von dieser Funktion durchgeführt werden, z. B. ist die Großbuchstabenform von 'ß' (mit einigen Ausnahmen) der zweistellige String "SS", was nicht mit std::towupper erreicht werden kann.

ISO 30112 legt fest, welche Paare von Unicode-Zeichen in diese Zuordnung einbezogen werden.

Beispiel

Der lateinische Buchstabe 'ſ' (U+017F) ist die alternative Kleinbuchstabenform von 'S' (U+0053).

Führen Sie diesen Code aus

#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';
}

Ausgabe

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

Siehe auch

towlower	wandelt ein breites Zeichen in Kleinbuchstaben um (Funktion)
toupper(std::locale)	konvertiert ein Zeichen mit dem ctype-Facet einer Locale in Großbuchstaben (Funktionstemplate)
toupper	konvertiert ein Zeichen in Großbuchstaben (Funktion)
C-Dokumentation für towupper