Spec-Zone.ru › C++

std::isalpha

Определено в заголовочном файле <cctype>
int isalpha( int ch );

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

  • буквы верхнего регистра ABCDEFGHIJKLMNOPQRSTUVWXYZ
  • буквы нижнего регистра abcdefghijklmnopqrstuvwxyz

В локалях, отличных от "C", буквой считается символ, для которого std::isupper() или std::islower() возвращает ненулевое значение, а также любой другой символ, который локаль считает буквой. В любом случае std::iscntrl(), std::isdigit(), std::ispunct() и std::isspace() вернут для этого символа ноль.

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

Параметры

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

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

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

Примечания

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

bool my_isalpha(char ch)
{
    return std::isalpha(static_cast<unsigned char>(ch));
}

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

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

Пример

Демонстрирует использование std::isalpha с разными локалями (зависит от ОС).

#include <cctype>
#include <clocale>
#include <iostream>
         
int main()
{
    unsigned char c = '\xdf'; // German letter ß in ISO-8859-1
 
    std::cout << "isalpha(\'\\xdf\', default C locale) returned "
              << std::boolalpha << !!std::isalpha(c) << '\n';

    std::setlocale(LC_ALL, "de_DE.iso88591");
    std::cout << "isalpha(\'\\xdf\', ISO-8859-1 locale) returned "
              << static_cast<bool>(std::isalpha(c)) << '\n';
    
}

Возможный вывод:

isalpha('\xdf', default C locale) returned false
isalpha('\xdf', ISO-8859-1 locale) returned true

См. также

isalpha(std::locale)
проверяет, классифицируется ли символ как буква в данной локали
(шаблон функции)
iswalpha
проверяет, является ли широкий символ буквой
(функция)
Документация C для isalpha
Значения ASCII символы

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
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 символ забоя (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/cpp/string/byte/isalpha

Spec-Zone.ru

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