std::isalpha

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

テキスト処理ライブラリ

ローカライズライブラリ

正規表現ライブラリ (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と等しくない場合は、動作は未定義です。

パラメータ

文字

-

分類する文字

戻り値

文字がアルファベット文字の場合はゼロ以外の値、それ以外の場合はゼロ。

注記

<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依存）。

このコードを実行

#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ドキュメント （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
10進数	16進数	8進数
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