std::isalnum

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Строки

Строки с завершающим нулём

Однобайтовые строки

Многобайтовые строки

Широкие строки

Классы

basic_string

basic_string_view (C++17)

char_traits

 

Однобайтовые строки с завершающим нулём

Функции
Манипуляции с символами
isalnum isalpha islower isupper isdigit isxdigit isblank (C++11)	iscntrl isgraph isspace isprint ispunct tolower toupper
Преобразование в числовые форматы
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
Манипуляции со строками
strcpy strncpy strxfrm	strcat strncat
Проверка строки
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
Манипуляции с памятью
memchr memcmp memset	memcpy memmove
Разное
strerror

 

<tbody> </tbody>

Определено в заголовочном файле <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)         // неправильно
                      // [](int c){ return std::isalnum(c); }           // неправильно
                      // [](char c){ return std::isalnum(c); }          // неправильно
                         [](unsigned char c){ return std::isalnum(c); } // правильно
                        );
}

Пример

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

Запустить этот код

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

int main()
{
    unsigned char c = '\xdf'; // Немецкая буква ß в ISO-8859-1

    std::cout << "isalnum(\'\\xdf\', локаль C по умолчанию) возвращает "
              << std::boolalpha << static_cast<bool>(std::isalnum(c)) << '\n';

    if (std::setlocale(LC_ALL, "de_DE.iso88591"))
        std::cout << "isalnum(\'\\xdf\', локаль ISO-8859-1) возвращает "
                  << static_cast<bool>(std::isalnum(c)) << '\n';

}

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

isalnum('\xdf', локаль C по умолчанию) возвращает false
isalnum('\xdf', локаль ISO-8859-1) возвращает 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