std::isalpha

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

文本处理库

本地化库

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

格式化库 (C++20)

空终止序列工具

字节字符串

多字节字符串

宽字符串

原生数值转换

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文本编码标识

text_encoding (C++26)

 

空终止字节字符串

函数
字符分类
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 strxfrm	strcat strncat
字符串检查
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
字符数组函数
memchr memcmp memset	memcpy memmove
杂项
strerror

 

在头文件 <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));
}

同样，当迭代器的值类型是 char 或 signed 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 在不同语言环境（OS-specific）中的使用。

运行此代码

#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

另请参阅

isalpha(std::locale)	检查字符是否被区域设置分类为字母 (函数模板)
iswalpha	检查宽字符是否为字母 (函数)
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