std::iscntrl

 

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

現在設定されている C のロケールによる分類において、指定された文字が制御文字かどうか調べます。 デフォルトの "C" ロケールでは、制御文字はコード 0x00-0x1F および 0x7F の文字です。

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

引数

ch

-

分類する文字

戻り値

文字が制御文字であれば非ゼロの値、そうでなければゼロ。

ノート

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

bool my_iscntrl(char ch){return std::iscntrl(static_cast<unsignedchar>(ch));}

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

int count_cntrls(conststd::string& s){returnstd::count_if(s.begin(), s.end(), // static_cast<int(*)(int)>(std::iscntrl) // wrong// [](int c){ return std::iscntrl(c); } // wrong// [](char c){ return std::iscntrl(c); } // wrong[](unsignedchar c){return std::iscntrl(c);}// correct);}

例

Run this code

#include <iostream>#include <cctype>#include <clocale>   int main(){unsignedchar c ='\x94';// the control code CCH in ISO-8859-1   std::cout<<"iscntrl(\'\\x94\', default C locale) returned "<<std::boolalpha<<(bool)std::iscntrl(c)<<'\n';   std::setlocale(LC_ALL, "en_GB.iso88591");std::cout<<"iscntrl(\'\\x94\', ISO-8859-1 locale) returned "<<std::boolalpha<<(bool)std::iscntrl(c)<<'\n';   }

出力:

iscntrl('\x94', default C locale) returned false iscntrl('\x94', ISO-8859-1 locale) returned true

関連項目

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