命名空间
变体
操作

std::isalpha

来自 cppreference.cn
< cpp‎ | string‎ | byte
定义于头文件 <cctype>
int isalpha( int ch );

检查给定的字符是否为字母字符,根据当前安装的 C 本地环境进行分类。在默认的本地环境中,以下字符是字母字符

  • 大写字母 ABCDEFGHIJKLMNOPQRSTUVWXYZ
  • 小写字母 abcdefghijklmnopqrstuvwxyz

"C" 以外的本地环境中,字母字符是 std::isupper()std::islower() 返回非零值的字符,或者本地环境认为的任何其他字母字符。在任何情况下,std::iscntrl()std::isdigit()std::ispunct()std::isspace() 对于此字符将返回零。

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

目录

[编辑] 参数

ch - 要分类的字符

[编辑] 返回值

如果字符是字母字符,则为非零值,否则为零。

[编辑] 注意

<cctype> 中的所有其他函数一样,如果参数的值既不能表示为 unsigned char 也不等于 EOF,则 std::isalpha 的行为是未定义的。为了安全地将这些函数与普通 char(或 signed char)一起使用,应首先将参数转换为 unsigned char

bool my_isalpha(char ch)
{
    return std::isalpha(static_cast<unsigned char>(ch));
}

同样,当迭代器的值类型为 charsigned char 时,不应直接将它们与标准算法一起使用。相反,首先将值转换为 unsigned char

int count_alphas(const std::string& s)
{
    return std::count_if(s.begin(), s.end(),
                      // static_cast<int(*)(int)>(std::isalpha)         // wrong
                      // [](int c){ return std::isalpha(c); }           // wrong
                      // [](char c){ return std::isalpha(c); }          // wrong
                         [](unsigned char c){ return std::isalpha(c); } // correct
                        );
}

[编辑] 示例

演示了 std::isalpha 在不同本地环境(操作系统特定)下的用法。

#include <cctype>
#include <clocale>
#include <iostream>
 
int main()
{
    unsigned char c = '\xdf'; // German letter ß in ISO-8859-1
 
    std::cout << "isalpha(\'\\xdf\', default C locale) returned "
              << std::boolalpha << !!std::isalpha(c) << '\n';
 
    std::setlocale(LC_ALL, "de_DE.iso88591");
    std::cout << "isalpha(\'\\xdf\', ISO-8859-1 locale) returned "
              << static_cast<bool>(std::isalpha(c)) << '\n';
 
}

可能的输出

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

[编辑] 参见

检查字符是否被本地环境分类为字母
(函数模板) [编辑]
检查宽字符是否为字母
(函数) [编辑]
C 文档 for isalpha
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