std::isgraph

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

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

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

文字列ライブラリ

ヌル終端文字列

バイト文字列

マルチバイト文字列

ワイド文字列

クラス

basic_string

basic_string_view (C++17)

char_traits

 

ヌル終端バイト文字列

関数
文字操作
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
strcat
strncat
strxfrm
文字列検査
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
メモリ操作
memchr
memcmp
memset
memcpy
memmove
その他
strerror

 

ヘッダ <cctype> で定義
int isgraph( int ch );

現在設定されている C のロケールによる分類において、指定された文字が図形文字 (図形的表現を持つ文字) かどうか調べます。 デフォルトの C ロケールでは、以下の文字が図形文字です。

• 数字 (0123456789)
• 大文字 (ABCDEFGHIJKLMNOPQRSTUVWXYZ)
• 小文字 (abcdefghijklmnopqrstuvwxyz)
• 句読点 (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~)

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

引数

ch

-

分類する文字

戻り値

文字が図形的表現を持つ文字であれば非ゼロの値、そうでなければゼロ。

ノート

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

bool my_isgraph(char ch)
{
    return std::isgraph(static_cast<unsigned char>(ch));
}

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

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

例

Run this code

#include <iostream>
#include <cctype>
#include <clocale>
 
int main()
{
    unsigned char c = '\xb6'; // the character ¶ in ISO-8859-1
 
    std::cout << "isgraph(\'\\xb6\', default C locale) returned "
               << std::boolalpha << (bool)std::isgraph(c) << '\n';
 
    std::setlocale(LC_ALL, "en_GB.iso88591");
    std::cout << "isgraph(\'\\xb6\', ISO-8859-1 locale) returned "
              << std::boolalpha << (bool)std::isgraph(c) << '\n';
}

出力:

isgraph('\xb6', default C locale) returned false
isgraph('\xb6', ISO-8859-1 locale) returned true

関連項目

isgraph(std::locale)	指定されたロケールにおいて文字が図形文字に分類されるかどうか調べます (関数テンプレート)
iswgraph	ワイド文字が図形文字かどうか調べます (関数)
isgraph の 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
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