_fileno

[アーティクル]
08/09/2011

ストリームに関連付けられているファイル記述子を取得します。

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 ) );
}