Spec-Zone.ru › C++

std::isalnum

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

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

  • цифры (0123456789)
  • прописные буквы (ABCDEFGHIJKLMNOPQRSTUVWXYZ)
  • строчные буквы (abcdefghijklmnopqrstuvwxyz)

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

Параметры

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

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

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

Примечания

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

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

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

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
END_OF_DOCUMENT_MARKER
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/isalnum

Spec-Zone.ru

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