std::isalnum

< cpp‎ | string‎ | byte
 
C++
 
字符串库
 
空终止字节字符串
 
定义于头文件 <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


参阅

 检查字符是否被本地环境分类为字母或数字
(函数模板)
检查宽字符是否为字母数字
(函数)
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