iscntrl、 iswcntrl、 _iscntrl_l、 _iswcntrl_l
整数が制御文字を表すかどうかを判定します。
構文
int iscntrl(
int c
);
int iswcntrl(
wint_t c
);
int _iscntrl_l(
int c,
_locale_t locale
);
int _iswcntrl_l(
wint_t c,
_locale_t locale
);
パラメーター
c
テストする整数
locale
使用するロケール。
戻り値
これらの各ルーチンでは、c が制御文字の特殊表現の場合は 0 以外の値を返します。 iscntrl は、 c が制御文字 (0x00 - 0x1Fまたは0x7F) の場合は 0 以外の値を返します。 iswcntrl が制御ワイド文字の場合、c は 0 以外の値を返します。 これらの各ルーチンは、c がテスト条件を満たしていない場合は 0 を返します。
これらの関数のうち _l サフィックスが付けられたバージョンは、現在のロケールの代わりに渡されたロケール パラメーターを使用します。 詳細については、「 Locale」を参照してください。
iscntrlと_iscntrl_lの動作は、cが EOF でない場合、または 0 から 0xFF の範囲にある場合は未定義です。 デバッグ CRT ライブラリが使用され、 c がこれらの値の 1 つでない場合、関数はアサーションを生成します。
汎用テキスト ルーチンのマップ
| TCHAR.H のルーチン | _UNICODE と _MBCS が定義されていない |
_MBCS が定義されている |
_UNICODE が定義されている |
|---|---|---|---|
_istcntrl |
iscntrl |
iscntrl |
iswcntrl |
_istcntrl_l |
_iscntrl_l |
_iscntrl_l |
_iswcntrl_l |
解説
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。
要件
| ルーチンによって返される値 | 必須ヘッダー |
|---|---|
iscntrl |
<ctype.h> |
iswcntrl |
<ctype.h> または <wchar.h> |
_iscntrl_l |
<ctype.h> |
_iswcntrl_l |
<ctype.h> または <wchar.h> |
互換性の詳細については、「 Compatibility」を参照してください。