std::isspace

 

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 isspace( int ch );

現在インストールされているCロケールによって分類される空白文字かどうかを確認します。デフォルトのロケールでは、空白文字は以下の通りです。

• スペース (0x20, ' ')
• フォームフィード (0x0c, '\f')
• ラインフィード (0x0a, '\n')
• キャリッジリターン (0x0d, '\r')
• 水平タブ (0x09, '\t')
• 垂直タブ (0x0b, '\v')

chの値がunsigned charとして表現できないか、またはEOFと等しくない場合、動作は未定義です。

パラメータ

文字

-

分類する文字

戻り値

文字が空白文字の場合はゼロ以外の値、それ以外の場合はゼロを返します。

注意

<cctype> の他のすべての関数と同様に、引数の値が unsigned char として表現可能でもなく、EOF と等しくもない場合、std::isspace の動作は未定義です。これらの関数をプレーンな char（または signed char）で安全に使用するには、まず引数を unsigned char に変換する必要があります。

bool my_isspace(char ch)
{
    return std::isspace(static_cast<unsigned char>(ch));
}

同様に、イテレータの値型がcharまたはsigned charである場合、標準アルゴリズムで直接使用しないでください。代わりに、まず値をunsigned charに変換してください。

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

例

このコードを実行

#include <cctype>
#include <climits>
#include <iomanip>
#include <iostream>
 
int main(void)
{
    std::cout << std::hex << std::setfill('0') << std::uppercase;
    for (int ch{}; ch <= UCHAR_MAX; ++ch)
        if (std::isspace(ch))
            std::cout << std::setw(2) << ch << ' ';
    std::cout << '\n';
}

出力

09 0A 0B 0C 0D 20

関連項目

isspace(std::locale)	ロケールによって文字が空白文字に分類されるかチェックする (関数テンプレート)
iswspace	ワイド文字が空白文字であるかチェックする (関数)
C のドキュメント (isspace)

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