Spec-Zone.ru › C++

std::isalnum

Объявлено в заголовочном файле <cctype>
int isalnum( int ch );

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

  • цифры (0123456789)
  • буквы в верхнем регистре (ABCDEFGHIJKLMNOPQRSTUVWXYZ)
  • буквы в нижнем регистре (abcdefghijklmnopqrstuvwxyz)

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

Параметры

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

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

Ненулевое значение, если символ является буквенно-цифровым, и 0 в противном случае.

Примечания

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

bool my_isalnum(char ch)
{
    return std::isalnum(static_cast<unsigned char>(ch));
}

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

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

Пример

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

#include <cctype>
#include <clocale>
#include <iostream>

int main()
{
    unsigned char c = '\xdf'; // German letter ß in ISO-8859-1

    std::cout << "isalnum(\'\\xdf\', default C locale) returned "
              << std::boolalpha << static_cast<bool>(std::isalnum(c)) << '\n';

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

}

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

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

См. также

isalnum(std::locale)
проверяет, классифицируется ли символ как буквенно-цифровой в заданной локали
(шаблон функции)
iswalnum
проверяет, является ли широкий символ буквенно-цифровым
(функция)
Документация C для isalnum
Значения 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/isalnum

Spec-Zone.ru

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