Namensräume
Varianten
Aktionen

std::towlower

Von cppreference.com
< cpp‎ | string‎ | wide
 
 
 
 
Definiert in Header <cwctype>
std::wint_t towlower( std::wint_t ch );

Wandelt das gegebene breite Zeichen in Kleinbuchstaben um, 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.

Inhalt

[edit] Parameter

ch - zu konvertierendes breites Zeichen

[edit] Rückgabewert

Kleinbuchstaben-Version von ch oder unverändertes ch, wenn im aktuellen C-Locale keine Kleinbuchstaben-Version aufgeführt ist.

[edit] Hinweise

Diese Funktion kann nur 1:1-Zeichenabbildungen durchführen, z. B. hat der griechische Großbuchstabe 'Σ' zwei Kleinbuchstabenformen, abhängig von der Position im Wort: 'σ' und 'ς'. Ein Aufruf von std::towlower kann nicht verwendet werden, um in diesem Fall die korrekte Kleinbuchstabenform zu erhalten.

ISO 30112 spezifiziert, welche Unicode-Zeichenpaare in dieser Abbildung enthalten sind.

[edit] Beispiel

#include <clocale>
#include <cwctype>
#include <iostream>
 
int main()
{
    wchar_t c = L'\u0190'; // Latin capital open E ('Ɛ')
 
    std::cout << std::hex << std::showbase;
    std::cout << "in the default locale, towlower("
              << static_cast<std::wint_t>(c) << ") = "
              << std::towlower(c) << '\n';
    std::setlocale(LC_ALL, "en_US.utf8");
    std::cout << "in Unicode locale, towlower("
              << static_cast<std::wint_t>(c) << ") = "
              << std::towlower(c) << '\n';
}

Ausgabe

in the default locale, towlower(0x190) = 0x190
in Unicode locale, towlower(0x190) = 0x25b

[edit] Siehe auch

wandelt ein breites Zeichen in Großbuchstaben um
(Funktion) [bearbeiten]
konvertiert ein Zeichen mit dem ctype-Facet einer Locale in Kleinbuchstaben
(Funktionstemplate) [bearbeiten]
konvertiert ein Zeichen in Kleinbuchstaben
(Funktion) [bearbeiten]
C-Dokumentation für towlower