std::isalpha

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

检查给定字符是否为当前安装的 C 本地环境分类为字母字符。默认本地环境中,下列字符为字母:

  • uppercase letters ABCDEFGHIJKLMNOPQRSTUVWXYZ
  • lowercase letters abcdefghijklmnopqrstuvwxyz

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

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

参数

ch - 要分类的字符

返回值

若字符为字母字符则为非零值,否则为零。

注意

同所有其他来自 <cctype> 的函数,若参数值既不能表示为 unsigned char 又不等于 EOFstd::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)         // 错误
                      // [](int c){ return std::isalpha(c); }           // 错误
                      // [](char c){ return std::isalpha(c); }          // 错误
                         [](unsigned char c){ return std::isalpha(c); } // 正确
                        );
}

示例

演示以不同的本地环境( OS 限定)使用 isalpha() 。

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

输出:

isalpha('\xdf', default C locale) returned false
isalpha('\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