_fileno
ストリームに関連付けられているファイル記述子を取得します。
int _fileno(
FILE *stream
);
パラメーター
- stream
FILE 構造体へのポインター。
戻り値
_fileno は ファイル記述子を返します。 エラーの戻り値はありません。 結果は stream を開くファイルを指定する未定義です。 ストリームが NULLの場合、_fileno は パラメーターの検証"に説明されているように、無効なパラメーター ハンドラーを呼び出します。 実行の継続が許可された場合、この関数は -1 を返し、errno を EINVAL に設定します。
エラー コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。
注意
stdout または stderr が出力ストリーム (たとえば、コンソール ウィンドウでない Windows アプリケーションで) に関連付けられていない場合、返されるファイル記述子は -2 です。以前のバージョンでは、返されたファイル記述子は -1 です。この変更により、アプリケーションがエラーとこの条件を区別できるようになります。
解説
_fileno ルーチンは、現在 streamに関連付けられたファイル記述子を返します。 このルーチンを関数とマクロとして実装されます。 いずれかの実装の選択の詳細については、「関数とマクロの使い分け」を参照してください。
必要条件
関数 |
必須ヘッダー |
---|---|
_fileno |
<stdio.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// crt_fileno.c
// This program uses _fileno to obtain
// the file descriptor for some standard C streams.
//
#include <stdio.h>
int main( void )
{
printf( "The file descriptor for stdin is %d\n", _fileno( stdin ) );
printf( "The file descriptor for stdout is %d\n", _fileno( stdout ) );
printf( "The file descriptor for stderr is %d\n", _fileno( stderr ) );
}
同等の .NET Framework 関数
System::IO::FileStream::Handle