fsetpos
ストリームの位置インジケーターを設定します。
構文
int fsetpos(
FILE *stream,
const fpos_t *pos
);
パラメーター
stream
FILE 構造体へのポインター。
pos
位置インジケーターのストレージ。
戻り値
正常に終了した場合、fsetpos は 0 を返します。 失敗した場合、関数は 0 以外の値を返し、 errno を次のいずれかのマニフェスト定数 (ERRNO で定義) に設定します。H): EBADF。つまり、ファイルにアクセスできないか、 stream が指すオブジェクトが有効なファイル構造ではないか、 EINVAL。つまり、 stream または pos の無効な値が渡されたことを意味します。 無効なパラメーターが渡された場合、これらの関数は、 Parameter 検証で説明されているように、無効なパラメーター ハンドラーを呼び出します。
リターン コードの詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。
解説
fsetpos関数は、streamのファイル位置インジケーターを pos の値に設定します。これは、streamに対するfgetposの前の呼び出しで取得されます。 この関数は、ファイルの終わりインジケーターをクリアし、streamに対するungetcの影響を元に戻します。 fsetposの呼び出し後、streamに対する次の操作は入力または出力のいずれかになります。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。
要件
| 機能 | 必須ヘッダー |
|---|---|
fsetpos |
<stdio.h> |
互換性の詳細については、「 Compatibility」を参照してください。
例
fgetpos の例を参照してください。