_fileno
取得與資料流相關聯的檔案描述項。
語法
int _fileno(
FILE *stream
);
參數
stream
FILE
結構的指標。
傳回值
_fileno
會傳回檔案描述元。 沒有傳回錯誤。 如果未 stream
指定開啟的檔案,則結果為未定義。 如果 stream 為 NULL
, _fileno
則會叫用不正確參數處理常式,如參數驗證 中所述 。 如果允許繼續執行,此函式會傳回 -1,並將 errno
設為 EINVAL
。
如需這些錯誤碼和其他錯誤碼的詳細資訊,請參閱 errno
、 _doserrno
_sys_errlist
和 _sys_nerr
。
注意
如果 stdout
或 stderr
與輸出資料流無關 (例如,在沒有主控台視窗的 Windows 應用程式中),傳回的檔案描述元是 -2。 在舊版本中,傳回的檔案描述元是 -1。 此變更可讓應用程式區分這個條件與錯誤。
備註
_fileno
常式會傳回目前與 stream
相關聯的檔案描述元。 此常式可當作函式和巨集來實作。 如需選擇任一實作的資訊,請參閱 建議在函式和宏 之間選擇。
根據預設,此函式的全域狀態會限定于應用程式。 若要變更此行為,請參閱 CRT 中的全域狀態。
需求
函式 | 必要的標頭 |
---|---|
_fileno |
<stdio.h> |
如需相容性詳細資訊,請參閱相容性。
範例
// 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 ) );
}
The file descriptor for stdin is 0
The file descriptor for stdout is 1
The file descriptor for stderr is 2
另請參閱
資料流 I/O
_fdopen
, _wfdopen
_filelength
, _filelengthi64
fopen
, _wfopen
freopen
, _wfreopen
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應