std:: isupper

Prüft, ob das gegebene Zeichen ein Großbuchstabe ist, wie von der aktuell installierten C-Locale klassifiziert. In der Standard- "C" -Locale gibt std::isupper nur für Großbuchstaben ( ABCDEFGHIJKLMNOPQRSTUVWXYZ ) einen Wert ungleich Null zurück.

Wenn std::isupper einen Wert ungleich Null zurückgibt, ist garantiert, dass std::iscntrl , std::isdigit , std::ispunct und std::isspace für dasselbe Zeichen in derselben C-Locale Null zurückgeben.

Das Verhalten ist undefiniert, wenn der Wert von ch nicht als unsigned char darstellbar ist und nicht gleich EOF ist.

Parameter

Rückgabewert

Nicht-Null-Wert, falls das Zeichen ein Großbuchstabe ist, andernfalls Null.

Hinweise

Wie alle anderen Funktionen aus <cctype> ist das Verhalten von std::isupper undefiniert, wenn der Wert des Arguments weder als unsigned char darstellbar noch gleich EOF ist. Um diese Funktionen sicher mit einfachen char s (oder signed char s) zu verwenden, sollte das Argument zunächst in unsigned char konvertiert werden:

bool my_isupper(char ch)
{
    return std::isupper(static_cast<unsigned char>(ch));
}

Ebenso sollten sie nicht direkt mit Standardalgorithmen verwendet werden, wenn der Werttyp des Iterators char oder signed char ist. Konvertieren Sie stattdessen den Wert zunächst zu unsigned char :

int count_uppers(const std::string& s)
{
    return std::count_if(s.begin(), s.end(),
                      // static_cast<int(*)(int)>(std::isupper)         // falsch
                      // [](int c){ return std::isupper(c); }           // falsch
                      // [](char c){ return std::isupper(c); }          // falsch
                         [](unsigned char c){ return std::isupper(c); } // korrekt
                        );
}

Beispiel

#include <cctype>
#include <clocale>
#include <iostream>
int main()
{
    unsigned char c = '\xc6'; // letter Æ in ISO-8859-1
    std::cout << "isupper(\'\\xc6\', default C locale) returned "
              << std::boolalpha << (bool)std::isupper(c) << '\n';
    std::setlocale(LC_ALL, "en_GB.iso88591");
    std::cout << "isupper(\'\\xc6\', ISO-8859-1 locale) returned "
              << std::boolalpha << (bool)std::isupper(c) << '\n';
}

isupper('\xc6', default C locale) returned false
isupper('\xc6', ISO-8859-1 locale) returned true

Siehe auch