共用方式為


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

另請參閱

資料流 I/O
fgetpos