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
的範例。