std::toupper(std::locale)

 

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)

 

Lokalisierungsbibliothek

Lokale und Facetten   Lokale has_facet use_facet locale Facet-Kategorie Basisklassen ctype_base codecvt_base messages_base time_base money_base ctype-Facetten ctype ctype<char> ctype_byname codecvt codecvt_byname numerische Facetten num_get num_put numpunct numpunct_byname Kollationsfacetten collate collate_byname Zeitfacetten time_get time_put time_get_byname time_put_byname

Geldfacetten money_get money_put moneypunct moneypunct_byname Nachrichtenfacetten messages messages_byname Zeichenklassifizierung und -konvertierung Zeichenklassifizierung isspace    iscntrl isupper islower    isalpha ispunct isdigit    isxdigit isalnum isblank (C++11) isprint isgraph Zeichenkonvertierungen toupper    tolower String- und Streamkonvertierungen wstring_convert (C++11/17/26*) wbuffer_convert (C++11/17/26*) Unicode-Konvertierungsfacets codecvt_utf8 (C++11/17/26*) codecvt_utf16 (C++11/17/26*) codecvt_utf8_utf16 (C++11/17/26*) codecvt_mode (C++11/17/26*) C-Bibliotheks-Lokalisierungen LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME    setlocale localeconv lconv

 

Definiert in Header <locale>
template< class CharT > CharT toupper( CharT ch, const locale& loc );

Wandelt das Zeichen ch in Großbuchstaben um, falls möglich, unter Verwendung der Konvertierungsregeln, die durch die std::ctype Facette der angegebenen Locale spezifiziert sind.

Parameter

ch	-	Zeichen
loc	-	locale

Rückgabewert

Gibt die Großbuchstabenform von ch zurück, falls eine in der Locale aufgeführt ist, andernfalls wird ch unverändert zurückgegeben.

Hinweise

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

Mögliche Implementierung

template<class CharT> CharT toupper(CharT ch, const std::locale& loc) { return std::use_facet<std::ctype<CharT>>(loc).toupper(ch); }

Beispiel

Führen Sie diesen Code aus

#include <cwctype>
#include <iostream>
#include <locale>
 
int main()
{
    wchar_t c = L'\u017f'; // Latin small letter Long S ('ſ')
 
    std::cout << std::hex << std::showbase;
 
    std::cout << "in the default locale, toupper(" << (std::wint_t)c << ") = "
              << (std::wint_t)std::toupper(c, std::locale()) << '\n';
 
    std::cout << "in Unicode locale, toupper(" << (std::wint_t)c << ") = "
              << (std::wint_t)std::toupper(c, std::locale("en_US.utf8")) << '\n';
}

Mögliche Ausgabe

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

Siehe auch

tolower(std::locale)	konvertiert ein Zeichen mit dem ctype-Facet einer Locale in Kleinbuchstaben (Funktionstemplate)
toupper	konvertiert ein Zeichen in Großbuchstaben (Funktion)
towupper	wandelt ein breites Zeichen in Großbuchstaben um (Funktion)