fsetpos
設定資料流位置指標。
語法
int fsetpos(
FILE *stream,
const fpos_t *pos
);
參數
stream
FILE
結構的指標。
pos
位置指標儲存區。
傳回值
如果成功,fsetpos
會傳回 0。 失敗時,函式會傳回非零值,並將 設定 errno
為下列其中一個資訊清單常數(定義于 ERRNO 中。H: EBADF
,這表示無法存取檔案,或指向 的物件 stream
不是有效的檔案結構;或 EINVAL
,這表示 或 pos
傳遞了不正確值 stream
。 如果傳入不正確參數,這些函式會叫用不正確參數處理常式,如參數驗證 中所述 。
如需傳回碼的詳細資訊,請參閱 errno
、 _doserrno
_sys_errlist
和 _sys_nerr
。
備註
函式會將 fsetpos
的檔案位置指標 stream
設定為 的值 pos
,這是在 對 之前呼叫 fgetpos
中取得的 stream
。 函式會清除檔案結尾指標,並復原 對 stream
的任何影響 ungetc
。 呼叫 fsetpos
之後,上的下一個作業 stream
可能是輸入或輸出。
根據預設,此函式的全域狀態會限定于應用程式。 若要變更此行為,請參閱 CRT 中的全域狀態。
需求
函式 | 必要的標頭 |
---|---|
fsetpos |
<stdio.h> |
如需相容性詳細資訊,請參閱相容性。
範例
請參閱 的 fgetpos
範例。
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應