std::isalpha

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏(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 的值不可表示为 unsignedchar 且不等于 EOF 则行为未定义。

参数

ch

-

要分类的字符

返回值

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

注解

同所有其他来自 <cctype> 的函数，若实参值既不能表示为 unsignedchar 又不等于 EOF 则 std::isalpha 的行为未定义。为了以单纯的 char（或 signedchar）安全使用此函数，首先要将实参转换为 unsignedchar：

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

类似地，迭代器的值类型为 char 或 signedchar 时，不应直接将它们用于标准算法。而是要首先转换值为 unsignedchar：

int count_alphas(conststd::string& s){returnstd::count_if(s.begin(), s.end(), // static_cast<int(*)(int)>(std::isalpha) // 错误// [](int c){ return std::isalpha(c); } // 错误// [](char c){ return std::isalpha(c); } // 错误[](unsignedchar c){return std::isalpha(c);}// 正确);}

示例

演示以不同的本地环境（OS 限定）使用 std::isalpha。

运行此代码

#include <cctype> #include <clocale>#include <iostream>   int main(){unsignedchar c ='\xdf';// ISO-8859-1 中的德文字母 ß   std::cout<<"isalpha(\'\\xdf\', 默认 C 本地环境) 返回 "<<std::boolalpha<<(bool)std::isalpha(c)<<'\n';   std::setlocale(LC_ALL, "de_DE.iso88591");std::cout<<"isalpha(\'\\xdf\', ISO-8859-1 本地环境) 返回 "<<std::boolalpha<<(bool)std::isalpha(c)<<'\n';   }

可能的输出：

isalpha('\xdf', 默认 C 本地环境) 返回 false isalpha('\xdf', ISO-8859-1 本地环境) 返回 true

参阅

isalpha(std::locale)	检查字符是否被本地环境分类为字母 (函数模板)
iswalpha	检查宽字符是否为字母 (函数)
isalpha 的 C 文档

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