std::isalnum

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

字符串库

空终止字符串

字节字符串

多字节字符串

宽字符串

类

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
strcat
strncat
strxfrm
字符串检验
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
内存操作
memchr
memcmp
memset
memcpy
memmove
杂项
strerror

 

定义于头文件 <cctype>
int isalnum( int ch );

检查给定字符是否为当前 C 本地环境分类为字母数字字符。默认本地环境中，下列字符为字母数字：

• 数字（ 0123456789 ）
• 大写字母（ ABCDEFGHIJKLMNOPQRSTUVWXYZ ）
• 小写字母（ abcdefghijklmnopqrstuvwxyz ）

若 ch 的值不能表示为 unsigned char 且不等于 EOF 则行为未定义。

参数

ch

-

要分类的字符

返回值

若字符为字母数字字符，则为非零值，否则为 0 。

注意

同所有其他来自 <cctype> 的函数，若参数值既不能表示为 unsigned char 又不等于 EOF 则 std::isalnum 的行为未定义。为了以简单的 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); } // 正确
                        );
}

示例

演示以不同本地环境（ OS 限定）使用 isalnum() 。

运行此代码

#include <iostream>
#include <cctype>
#include <clocale>
 
int main()
{
    unsigned char c = '\xdf'; // ISO-8859-1 中的德文字母 ß 
 
    std::cout << "isalnum(\'\\xdf\', default C locale) returned "
               << std::boolalpha << (bool)std::isalnum(c) << '\n';
 
    if(std::setlocale(LC_ALL, "de_DE.iso88591"))
        std::cout << "isalnum(\'\\xdf\', ISO-8859-1 locale) returned "
                  << std::boolalpha << (bool)std::isalnum(c) << '\n';
 
}

可能的输出：

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

参阅

isalnum(std::locale)	检查字符是否被本地环境分类为字母或数字 (函数模板)
iswalnum	检查宽字符是否为字母数字 (函数)

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	space	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