fsetpos
將資料流位置指示器。
int fsetpos(
FILE *stream,
const fpos_t *pos
);
參數
stream
指向 FILE 結構的指標。pos
位置指示器儲存區。
傳回值
如果成功,fsetpos 會傳回 0。 如果失敗,則函式會傳回非零的值並將 errno 設定為下列資訊清單常數之一 (定義於 ERRNO.H): EBADF,表示檔案無法存取或物件的 stream 不是有效的檔案結構;或 EINVAL,表示 stream 或 pos 指定了無效的值傳遞。 如果傳入無效的參數,這些函式會呼叫無效參數處理常式,如 參數驗證 所述。
如需有關這些回傳碼和其他回傳碼的詳細資訊,請參閱 _doserrno、errno、_sys_errlist 和 _sys_nerr。
備註
fsetpos 函式會將 stream 的檔案位置指標到 pos的值*,* 在 fgetpos 的先前的呼叫取得物件的 stream*。函式清除檔案結尾指示器並移除 ungetc 作用為 stream。*在呼叫 fsetpos之後,可能會將 stream 的下一個作業或輸出。
需求
功能 |
必要的標頭 |
---|---|
fsetpos |
<stdio.h> |
如需其他相容性資訊,請參閱<簡介>中的相容性。
範例
請參閱 fgetpos 的範例。
.NET Framework 對等用法
System::IO::FileStream::Position