std::isupper

int isupper( int ch );

Проверяет, является ли заданный символ символом верхнего регистра согласно классификации текущей установленной локали C. В локали "C" по умолчанию функция std::isupper возвращает ненулевое значение только для букв верхнего регистра (ABCDEFGHIJKLMNOPQRSTUVWXYZ).

Если std::isupper возвращает ненулевое значение, гарантируется, что std::iscntrl, std::isdigit, std::ispunct и std::isspace возвращают ноль для того же символа в той же локали C.

Поведение не определено, если значение ch не представимо типом unsignedchar и не равно EOF.

Параметры

Возвращаемое значение

Ненулевое значение, если символ является буквой верхнего регистра, в противном случае — ноль.

Примечания

Как и для всех остальных функций из <cctype>, поведение std::isupper не определено, если значение аргумента не представимо типом unsignedchar и не равно EOF. Чтобы безопасно использовать эти функции с обычными символами char (или signedchar), аргумент следует сначала преобразовать к типу unsignedchar:

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

Аналогично, их не следует напрямую использовать со стандартными алгоритмами, если тип значения итератора — char или signedchar. Вместо этого сначала преобразуйте значение к типу unsignedchar:

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

Пример

#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

См. также