_isatty
ファイル記述子が文字デバイスに関連付けられているかどうかを判定します。
構文
int _isatty( int fd );
パラメーター
fd
調べるデバイスを参照するファイル記述子。
戻り値
_isatty
は、記述子がキャラクター デバイスに関連付けられている場合、0 以外の値を返します。 それ以外の場合、_isatty
は 0 を返します。
解説
_isatty
関数では、fd
がキャラクター デバイス (端末、コンソール、プリンター、またはシリアル ポート) に関連付けられているかどうかを調べます。
この関数は、fd
パラメーターを検証します。 fd
が無効なファイル ポインターの場合は、「パラメーターの検証で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、この関数は 0 を返し、errno
を EBADF
に設定します。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。
要件
ルーチンによって返される値 | 必須ヘッダー |
---|---|
_isatty |
<io.h> |
互換性の詳細については、「 Compatibility」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。
例
// crt_isatty.c
/* This program checks to see whether
* stdout has been redirected to a file.
*/
#include <stdio.h>
#include <io.h>
int main( void )
{
if( _isatty( _fileno( stdout ) ) )
printf( "stdout has not been redirected to a file\n" );
else
printf( "stdout has been redirected to a file\n");
}
サンプル出力
stdout has not been redirected to a file