ctype(3C)

名称

isalpha(), isupper(), islower(), isdigit(), isxdigit(), isalnum(), isspace(), ispunct(), isprint(), isgraph(), iscntrl(), isascii() ― 文字のクラス分類

構文

#include <ctype.h>

int isalnum(int c);

int isalpha(int c);

int iscntrl(int c);

int isdigit(int c);

int isgraph(int c);

int islower(int c);

int isprint(int c);

int ispunct(int c);

int isspace(int c);

int isupper(int c);

int isxdigit(int c);

int isascii(int c);

説明

これらの関数は、直前に成功した setlocale() setlocale(3C) 参照) によって識別されるキャラクタコード化済みの整数値を、コード化文字セットの規則に準じてクラス分類します。各関数は、正常終了でゼロ以外、失敗でゼロを返します。

setlocale() への呼び出しがエラーになった場合、デフォルトの ASCII 形式の７ビットコード化済み文字セット setlocale(3C) 参照) に準じてクラス分類されます。

isascii() はすべての整数値に対して定義されます。他の関数は -1 (EOF) から 255 の範囲に対して定義されます。

これらの関数は以下の条件下ではゼロ以外を返します。それ以外はゼロです。

`isalpha(`c`)`		`c` が文字の場合
`isupper(`c`)`		`c` が大文字の場合
`islower(`c`)`		`c` が小文字の場合
`isdigit(`c`)`		`c` が 10 進数の数字の場合 (ASCII 形式の文字 [0-9])
`isxdigit(`c`)`		`c` が 16 進数の数字の場合 (ASCII 形式の文字 [0-9], [A-F] または [a-f])
`isalnum(`c`)`		`c` が英数字の場合 (アルファベットまたは数字)
`isspace(`c`)`		`c` が、表示されるテキスト内に「スペース」を生成する文字の場合 (ASCII 形式のスペース、タブ、キャリッジリターン、ニューライン、垂直タブおよびフォームフィード)
`ispunct(`c`)`		`c` が句読点文字の場合 (ASCII 形式のスペース文字、数字、文字を除く印字可能文字 (040))
`isprint(`c`)`		`c` が印字可能文字の場合
`isgraph(`c`)`		`c` が目に見える文字の場合 (ASCII 形式のスペース文字以外の印字可能文字 (040))
`iscntrl(`c`)`		`c` が制御文字の場合 (ASCII 形式の 040 未満の文字コードおよび削除文字 (0177))
`isascii(`c`)`		`c` が０から 0177 の ASCII 形式の文字コードの場合

これらの関数への引き数が関数のドメインの外部である場合、結果は不定です。

多言語化対応

ロケール

LC_CTYPE カテゴリは、文字型のクラス分類を決定します。

サポートされるコードセット

シングルバイトの文字コードセットがサポートされます。

警告

これらの関数は、ライブラリ関数および <ctype.h> ヘッダー内に定義されるマクロとして供給されます。通常はマクロバージョンが使われます。ライブラリ関数を入手するには、 #undef を使ってマクロ定義を削除するか、 ANSI-C モードでコンパイルした場合は関数名を括弧で囲むか、そのアドレスを取ってください。次の例では、 isalpha(), isdigit(), isspace() に対してライブラリ関数が使われています。

#include <ctype.h>
#undef isalpha
     ...
main()
{
    int (*ctype_func)();
        ...
    if ( isalpha(c) )
        ...
    if ( (isdigit)(c) )
        ...
    ctype_func = isspace;
        ...
}

著者

ctype() は IBM, OSF および HP で開発されました。

参照

setlocale(3C), ascii(5), thread_safety(5)

標準準拠

isalnum(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

isalpha(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

isascii(): AES, SVID2, SVID3, XPG2, XPG3, XPG4

iscntrl(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

isdigit(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

isgraph(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

islower(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

isprint(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

ispunct(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

isspace(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

isupper(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

isxdigit(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

ctype(3C)

テクニカルドキュメント

≫ 目次

≫ 索引

名称

構文

説明

多言語化対応

ロケール

サポートされるコードセット

警告

著者

参照

標準準拠

ctype(3C)

テクニカル ドキュメント

≫ 目次

≫ 索引

名称

構文

説明

多言語化対応

ロケール

サポートされるコードセット

警告

著者

参照

標準準拠

テクニカルドキュメント