Spec-Zone.ru › C++

std::isupper

Определено в заголовке <cctype>
int isupper( int ch );

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

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

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

Параметры

ch - символ для классификации

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

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

Примечания

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

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

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

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

См. также

isupper(std::locale)
проверяет, является ли символ заглавной буквой в соответствии с локалью
(шаблон функции)
iswupper
проверяет, является ли широкий символ заглавной буквой
(функция)
C документация для isupper
ASCII values символы

iscntrl
iswcntrl

isprint
iswprint

isspace
iswspace

isblank
iswblank

isgraph
iswgraph

ispunct
iswpunct

isalnum
iswalnum

isalpha
iswalpha

isupper
iswupper

islower
iswlower

isdigit
iswdigit

isxdigit
iswxdigit

десятичное шестнадцатеричное восьмеричное
0–8 \x0–\x8 \0–\10 коды управления (NUL, и т.д.) ≠0 0 0 0 0 0 0 0 0 0 0 0
9 \x9 \11 табуляция (\t) ≠0 0 ≠0 ≠0 0 0 0 0 0 0 0 0
10–13 \xA–\xD \12–\15 пробелы (\n, \v, \f, \r) ≠0 0 ≠0 0 0 0 0 0 0 0 0 0
14–31 \xE–\x1F \16–\37 коды управления ≠0 0 0 0 0 0 0 0 0 0 0 0
32 \x20 \40 пробел 0 ≠0 ≠0 ≠0 0 0 0 0 0 0 0 0
33–47 \x21–\x2F \41–\57 !"#$%&'()*+,-./ 0 ≠0 0 0 ≠0 ≠0 0 0 0 0 0 0
48–57 \x30–\x39 \60–\71 0123456789 0 ≠0 0 0 ≠0 0 ≠0 0 0 0 ≠0 ≠0
58–64 \x3A–\x40 \72–\100 :;<=>?@ 0 ≠0 0 0 ≠0 ≠0 0 0 0 0 0 0
65–70 \x41–\x46 \101–\106 ABCDEF 0 ≠0 0 0 ≠0 0 ≠0 ≠0 ≠0 0 0 ≠0
END_OF_DOCUMENT_MARKER
71–90 \x47–\x5A \107–\132 GHIJKLMNOP
QRSTUVWXYZ
0 ≠0 0 0 ≠0 0 ≠0 ≠0 ≠0 0 0 0
91–96 \x5B–\x60 \133–\140 [\]^_` 0 ≠0 0 0 ≠0 ≠0 0 0 0 0 0 0
97–102 \x61–\x66 \141–\146 abcdef 0 ≠0 0 0 ≠0 0 ≠0 ≠0 0 ≠0 0 ≠0
103–122 \x67–\x7A \147–\172 ghijklmnop
qrstuvwxyz
0 ≠0 0 0 ≠0 0 ≠0 ≠0 0 ≠0 0 0
123–126 \x7B–\x7E \172–\176 {|}~ 0 ≠0 0 0 ≠0 ≠0 0 0 0 0 0 0
127 \x7F \177 backspace character (DEL) ≠0 0 0 0 0 0 0 0 0 0 0 0

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/byte/isupper

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API