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
См. также
| проверяет, классифицируется ли символ как буквенно-цифровой в заданной локали (шаблон функции) |
|
| проверяет, является ли широкий символ буквенно-цифровым (функция) |
|
Документация C для isalnum |
|
| Значения ASCII | символы | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| десятичное | шестнадцатеричное | восьмеричное | |||||||||||||
| 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 |
GHIJKLMNOPQRSTUVWXYZ |
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 |
ghijklmnopqrstuvwxyz |
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