isisw ルーチン

解説

これらのルーチンは、文字が指定条件を満たしているかどうかをテストします。

ルーチンは is 、-1 () から (EOF0xFF) までの整数引数に対して UCHAR_MAX 意味のある結果を生成します。 int 型の引数が必要です。

注意事項

ルーチンの is 場合、型 char の引数を渡すと、予期しない結果が生じる可能性があります。 0x7F よりも大きい値を持つ char 型の SBCS または MBCS の 1 バイト文字は負になります。 char が渡されると、コンパイラではその値を signed int または signed long に変換することがあります。 この値は、コンパイラによって符号拡張されることがあり、予想外の結果になることがあります。

ルーチンは isw 、-1 (WEOF) から0xFFFFまでの整数値に対して意味のある結果を生成します。 データ型は wint_t<WCHAR.H>unsigned short. ワイド文字またはワイド文字のファイル末尾 (WEOF) の値を保持できます。

出力値は、ロケールの LC_CTYPE カテゴリ設定の設定によって影響を受けます。 詳細については、setlocaleを参照してください。 _l サフィックスが付いていないこれらの関数のバージョンでは、このロケールに依存する動作に現在のロケールを使用します。_l サフィックスが付いているバージョンは、渡されたロケール パラメーターを代わりに使用する点を除いて同じです。

"C" ロケールでは、ルーチンの is テスト条件は次のとおりです。

isalnum
英数字 (A - Z、a - z、または 0 - 9)。

isalpha
英字 (A - Z または a - z)。

__isascii
ASCII 文字 (0x00 - 0x7F)。

isblank
水平タブまたは空白文字 (0x09 または 0x20)。

iscntrl
制御文字 (0x00 - 0x1F または 0x7F)。

__iscsym
文字、アンダースコア、または数字。

__iscsymf
文字またはアンダースコア。

isdigit
10 進数 (0 - 9)。

isgraph
スペース (0x20) を除く印刷可能な文字。

islower
小文字 (a - z)。

isprint
空白を含む印刷できる文字 (0x20 - 0x7E)。

ispunct
区切り記号。

isspace
空白文字 (0x09 - 0x0D または 0x20)。

isupper
大文字 (A - Z)。

isxdigit
16 進数字 (A - F、a - f、または 0 - 9)。

ルーチンの isw 場合、指定された条件のテストの結果はロケールに依存しません。 関数の isw テスト条件は次のとおりです。

iswalnum
iswalpha または iswdigit

iswalpha
iswcntrliswdigitiswpunct、または iswspace がいずれも 0 になる実装定義セットに含まれる任意のワイド文字。 iswalpha は、iswupper または iswlower が 0 以外の値になるワイド文字に対してのみ、0 以外の値を返します。

iswascii
ASCII 文字のワイド文字表現 (0x0000 - 0x007F)。

iswblank
標準の空白文字に対応するワイド文字、または iswalnum が false になるワイド文字の実装定義セットに含まれるワイド文字。 標準の空白文字は、スペース (L' ') と水平タブ (L'\t') です。

iswcntrl
制御ワイド文字。

__iswcsym
isalnum が true である任意のワイド文字または '_' 文字。

__iswcsymf
iswalpha が true である任意のワイド文字または '_' 文字。

iswctype
文字には、desc 引数で指定されたプロパティがあります。 引数の desc 有効な値ごとに、次の iswctype表に示すように、同等のワイド文字分類ルーチンがあります。

iswiswctype(c, desc)テスト ルーチンに対する等価性

引数の desc iswctype(c, desc) での同等機能
_ALPHA iswalpha(c)
_ALPHA | _DIGIT iswalnum(c)
_BLANK iswblank(c)
_CONTROL iswcntrl(c)
_DIGIT iswdigit(c)
_ALPHA | _DIGIT | _PUNCT iswgraph(c)
_LOWER iswlower(c)
_ALPHA | _BLANK | _DIGIT | _PUNCT iswprint(c)
_PUNCT iswpunct(c)
_BLANK iswblank(c)
_SPACE iswspace(c)
_UPPER iswupper(c)
_HEX iswxdigit(c)

iswdigit
10 進数字に対応するワイド文字。

iswgraph
スペースワイド文字 () を除く印刷可能なワイド文字。L' '

iswlower
小文字、または iswcntrliswdigitiswpunctiswspace がいずれも 0 になるワイド文字の実装定義セットに含まれる文字。 iswlower は、小文字に対応するワイド文字に対してのみ、0 以外の値を返します。

iswprint
スペースワイド文字 (L' ') を含む印刷可能なワイド文字。

iswpunct
スペースワイド文字 (L' ') ではなく、0 以外のワイド文字ではない、印刷可能なワイド文字 iswalnum

iswspace
標準の空白文字に対応するワイド文字、または iswalnum が false になるワイド文字の実装定義セットに含まれるワイド文字。 標準の空白文字は、スペース (L' ')、フォーム フィード ()、改行 (L'\f'L'\n')、復帰 (L'\r')、水平タブ (L'\t')、垂直タブ (L'\v') です。

iswupper
大文字のワイド文字、または iswcntrliswdigitiswpunct、または iswspace がいずれも 0 になるワイド文字の実装定義セットに含まれるワイド文字。 iswupper は、大文字に対応するワイド文字に対してのみ、0 以外の値を返します。

iswxdigit
16 進数字に対応するワイド文字。

// crt_isfam.c
/* This program tests all characters between 0x0
* and 0x7F, then displays each character with abbreviations
* for the character-type codes that apply.
*/

#include <stdio.h>
#include <ctype.h>

int main( void )
{
   int ch;
   for( ch = 0; ch <= 0x7F; ch++ )
   {
      printf( "%.2x  ", ch );
      printf( " %c", isprint( ch )  ? ch   : ' ' );
      printf( "%4s", isalnum( ch )  ? "AN" : "" );
      printf( "%3s", isalpha( ch )  ? "A"  : "" );
      printf( "%3s", __isascii( ch )  ? "AS" : "" );
      printf( "%3s", iscntrl( ch )  ? "C"  : "" );
      printf( "%3s", __iscsym( ch )  ? "CS "  : "" );
      printf( "%3s", __iscsymf( ch )  ? "CSF"  : "" );
      printf( "%3s", isdigit( ch )  ? "D"  : "" );
      printf( "%3s", isgraph( ch )  ? "G"  : "" );
      printf( "%3s", islower( ch )  ? "L"  : "" );
      printf( "%3s", ispunct( ch )  ? "PU" : "" );
      printf( "%3s", isspace( ch )  ? "S"  : "" );
      printf( "%3s", isprint( ch )  ? "PR" : "" );
      printf( "%3s", isupper( ch )  ? "U"  : "" );
      printf( "%3s", isxdigit( ch ) ? "X"  : "" );
      printf( ".\n" );
   }
}

出力

00            AS  C                              .
01            AS  C                              .
02            AS  C                              .
03            AS  C                              .
04            AS  C                              .
05            AS  C                              .
06            AS  C                              .
07            AS  C                              .
08            AS  C                              .
09            AS  C                    S         .
0a            AS  C                    S         .
0b            AS  C                    S         .
0c            AS  C                    S         .
0d            AS  C                    S         .
0e            AS  C                              .
0f            AS  C                              .
10            AS  C                              .
11            AS  C                              .
12            AS  C                              .
13            AS  C                              .
14            AS  C                              .
15            AS  C                              .
16            AS  C                              .
17            AS  C                              .
18            AS  C                              .
19            AS  C                              .
1a            AS  C                              .
1b            AS  C                              .
1c            AS  C                              .
1d            AS  C                              .
1e            AS  C                              .
1f            AS  C                              .
20            AS                       S PR      .
21   !        AS              G    PU    PR      .
22   "        AS              G    PU    PR      .
23   #        AS              G    PU    PR      .
24   $        AS              G    PU    PR      .
25   %        AS              G    PU    PR      .
26   &        AS              G    PU    PR      .
27   '        AS              G    PU    PR      .
28   (        AS              G    PU    PR      .
29   )        AS              G    PU    PR      .
2a   *        AS              G    PU    PR      .
2b   +        AS              G    PU    PR      .
2c   ,        AS              G    PU    PR      .
2d   -        AS              G    PU    PR      .
2e   .        AS              G    PU    PR      .
2f   /        AS              G    PU    PR      .
30   0  AN    AS   CS      D  G          PR     X.
31   1  AN    AS   CS      D  G          PR     X.
32   2  AN    AS   CS      D  G          PR     X.
33   3  AN    AS   CS      D  G          PR     X.
34   4  AN    AS   CS      D  G          PR     X.
35   5  AN    AS   CS      D  G          PR     X.
36   6  AN    AS   CS      D  G          PR     X.
37   7  AN    AS   CS      D  G          PR     X.
38   8  AN    AS   CS      D  G          PR     X.
39   9  AN    AS   CS      D  G          PR     X.
3a   :        AS              G    PU    PR      .
3b   ;        AS              G    PU    PR      .
3c   <        AS              G    PU    PR      .
3d   =        AS              G    PU    PR      .
3e   >        AS              G    PU    PR      .
3f   ?        AS              G    PU    PR      .
40   @        AS              G    PU    PR      .
41   A  AN  A AS   CS CSF     G          PR  U  X.
42   B  AN  A AS   CS CSF     G          PR  U  X.
43   C  AN  A AS   CS CSF     G          PR  U  X.
44   D  AN  A AS   CS CSF     G          PR  U  X.
45   E  AN  A AS   CS CSF     G          PR  U  X.
46   F  AN  A AS   CS CSF     G          PR  U  X.
47   G  AN  A AS   CS CSF     G          PR  U   .
48   H  AN  A AS   CS CSF     G          PR  U   .
49   I  AN  A AS   CS CSF     G          PR  U   .
4a   J  AN  A AS   CS CSF     G          PR  U   .
4b   K  AN  A AS   CS CSF     G          PR  U   .
4c   L  AN  A AS   CS CSF     G          PR  U   .
4d   M  AN  A AS   CS CSF     G          PR  U   .
4e   N  AN  A AS   CS CSF     G          PR  U   .
4f   O  AN  A AS   CS CSF     G          PR  U   .
50   P  AN  A AS   CS CSF     G          PR  U   .
51   Q  AN  A AS   CS CSF     G          PR  U   .
52   R  AN  A AS   CS CSF     G          PR  U   .
53   S  AN  A AS   CS CSF     G          PR  U   .
54   T  AN  A AS   CS CSF     G          PR  U   .
55   U  AN  A AS   CS CSF     G          PR  U   .
56   V  AN  A AS   CS CSF     G          PR  U   .
57   W  AN  A AS   CS CSF     G          PR  U   .
58   X  AN  A AS   CS CSF     G          PR  U   .
59   Y  AN  A AS   CS CSF     G          PR  U   .
5a   Z  AN  A AS   CS CSF     G          PR  U   .
5b   [        AS              G    PU    PR      .
5c   \        AS              G    PU    PR      .
5d   ]        AS              G    PU    PR      .
5e   ^        AS              G    PU    PR      .
5f   _        AS   CS CSF     G    PU    PR      .
60   `        AS              G    PU    PR      .
61   a  AN  A AS   CS CSF     G  L       PR     X.
62   b  AN  A AS   CS CSF     G  L       PR     X.
63   c  AN  A AS   CS CSF     G  L       PR     X.
64   d  AN  A AS   CS CSF     G  L       PR     X.
65   e  AN  A AS   CS CSF     G  L       PR     X.
66   f  AN  A AS   CS CSF     G  L       PR     X.
67   g  AN  A AS   CS CSF     G  L       PR      .
68   h  AN  A AS   CS CSF     G  L       PR      .
69   i  AN  A AS   CS CSF     G  L       PR      .
6a   j  AN  A AS   CS CSF     G  L       PR      .
6b   k  AN  A AS   CS CSF     G  L       PR      .
6c   l  AN  A AS   CS CSF     G  L       PR      .
6d   m  AN  A AS   CS CSF     G  L       PR      .
6e   n  AN  A AS   CS CSF     G  L       PR      .
6f   o  AN  A AS   CS CSF     G  L       PR      .
70   p  AN  A AS   CS CSF     G  L       PR      .
71   q  AN  A AS   CS CSF     G  L       PR      .
72   r  AN  A AS   CS CSF     G  L       PR      .
73   s  AN  A AS   CS CSF     G  L       PR      .
74   t  AN  A AS   CS CSF     G  L       PR      .
75   u  AN  A AS   CS CSF     G  L       PR      .
76   v  AN  A AS   CS CSF     G  L       PR      .
77   w  AN  A AS   CS CSF     G  L       PR      .
78   x  AN  A AS   CS CSF     G  L       PR      .
79   y  AN  A AS   CS CSF     G  L       PR      .
7a   z  AN  A AS   CS CSF     G  L       PR      .
7b   {        AS              G    PU    PR      .
7c   |        AS              G    PU    PR      .
7d   }        AS              G    PU    PR      .
7e   ~        AS              G    PU    PR      .
7f            AS  C                              .

関連項目

文字分類
ロケール
setlocale, _wsetlocale
マルチバイト文字シーケンスの解釈
to 関数