isalpha

名前

isalnum, isalpha, isascii, isblank, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, isxdigit, isalnum_l, isalpha_l, isascii_l, isblank_l, iscntrl_l, isdigit_l, isgraph_l, islower_l, isprint_l, ispunct_l, isspace_l, isupper_l, isxdigit_l - 文字を分類する

書式

#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);
int isblank(int c);

int isalnum_l(int c, locale_t locale);
int isalpha_l(int c, locale_t locale);
int isblank_l(int c, locale_t locale);
int iscntrl_l(int c, locale_t locale);
int isdigit_l(int c, locale_t locale);
int isgraph_l(int c, locale_t locale);
int islower_l(int c, locale_t locale);
int isprint_l(int c, locale_t locale);
int ispunct_l(int c, locale_t locale);
int isspace_l(int c, locale_t locale);
int isupper_l(int c, locale_t locale);
int isxdigit_l(int c, locale_t locale);

int isascii_l(int c, locale_t locale);

isascii(): isblank(): isalnum_l(), isalpha_l(), isblank_l(), iscntrl_l(), isdigit_l(), isgraph_l(), islower_l(), isprint_l(), ispunct_l(), isspace_l(), isupper_l(), isxdigit_l(): isascii_l():

説明

これらの関数は、指定したロケールに従って c を分類する。 c は unsigned char か EOF でなければならない。 "_l" が後ろに付かない関数は現在のロケールに基づいてチェックを行う。 "_l" で終わる関数は、ロケールオブジェクト locale で指定されたロケールに基づいてチェックを行う。 locale が特別なロケールオブジェクト LC_GLOBAL_LOCALE (duplocale(3) 参照) の場合や、 locale が有効なオブジェクトロケールハンドルでない場合、 これらの関数の動作は未定義である。 以下のリストでは、 "_l" が後ろに付かない関数の動作を説明する。 "_l" で終わる関数は、現在のロケールではなく、ロケールオブジェクト locale を使う点だけが異なる。

isalnum()

英字または数字であるかを調べる。 (isalpha(c) || isdigit(c)) と等価である。

isalpha()

アルファベットかどうか調べる。標準の "C" ロケールでは (isupper( c) || islower(c)) と等価である。他のロケールでは、大文字でも小文字でもない他の文字でも isalpha() が true を返すことがある。

isascii()

c が、ASCII文字セットに合致する 7ビットの unsigned char であるかを調べる。

isblank()

空白文字 (スペースかタブ) であるかを調べる。

iscntrl()

制御文字かどうかを調べる。

isdigit()

数字 (0〜9) かどうかを調べる。

isgraph()

表示可能な文字かどうかを調べる。スペースは含まれない。

islower()

小文字かどうかを調べる。

isprint()

表示可能な文字かどうかを調べる。スペースも含まれる。

ispunct()

表示可能な文字かどうかを調べる。スペースと英数字は含まれない。

isspace()

空白文字かどうかを調べる。 "C" ロケールか "POSIX" ロケールでは、空白文字とは、スペース、フォームフィード ( '\f') 、改行(newline) ('\n') 、復帰(carriage return) ( '\r') 、水平タブ ( '\t') 、垂直タブ ( '\v') である。

isupper()

大文字かどうかを調べる。

isxdigit()

16進数での数字かどうかを調べる。

 

0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F の文字であるかどうかを調べることと等価である。

返り値

文字 c が調べた文字の種類に合っていれば 0 以外を返す。 そうでなければ 0 を返す。

バージョン

isalnum_l(), isalpha_l(), isblank_l(), iscntrl_l(), isdigit_l(), isgraph_l(), islower_l(), isprint_l(), ispunct_l(), isspace_l(), isupper_l(), isxdigit_l(), isascii_l() は glibc 2.3 以降で利用可能である。

属性

この節で使用されている用語の説明については、 attributes(7) を参照。

インターフェース	属性	値
isalnum(), isalpha(), isascii(), isblank(), iscntrl(), isdigit(), isgraph(), islower(), isprint(), ispunct(), isspace(), isupper(), isxdigit()	Thread safety	MT-Safe

準拠

C89 では isalnum(), isalpha(), iscntrl(), isdigit(), isgraph(), islower(), isprint(), ispunct(), isspace(), isupper(), isxdigit() が規定されているが、 isascii() と isblank() は規定されていない。 POSIX.1-2001 でもこれらの関数は規定されており、 isascii() と isblank() も規定されている ( isascii() は XSI 拡張)。 C99 では、ここで挙げた関数のうち isascii() 以外の全てが規定されている。 POSIX.1-2008 では isascii() は廃止予定とされている。ローカライズするアプリケーションで移植性がある形では使用できない点に注意すること。 POSIX.1-2008 では isalnum_l(), isalpha_l(), isblank_l(), iscntrl_l(), isdigit_l(), isgraph_l(), islower_l(), isprint_l(), ispunct_l(), isspace_l(), isupper_l(), isxdigit_l() が規定されている。 isascii_l() は GNU 拡張である。

注意

The standards require that the argument c for these functions is either EOF or a value that is representable in the type unsigned char. If the argument c is of type char, it must be cast to unsigned char, as in the following example:

char c;
...
res = toupper((unsigned char) c);

This is necessary because char may be the equivalent of signed char, in which case a byte where the top bit is set would be sign extended when converting to int, yielding a value that is outside the range of unsigned char. ある文字がどの種類に入るかということは、現在のロケールに依存する。 たとえば、デフォルトの C ロケールでは isupper() は A のウムラウトを認識できないので、それが大文字だということがわからない。

関連項目

iswalnum(3), iswalpha(3), iswblank(3), iswcntrl(3), iswdigit(3), iswgraph(3), iswlower(3), iswprint(3), iswpunct(3), iswspace(3), iswupper(3), iswxdigit(3), newlocale(3), setlocale(3), toascii(3), tolower(3), toupper(3), uselocale(3), ascii(7), locale(7)

この文書について

この man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。