fsetpos

  • [アーティクル]

ストリームの位置インジケーターを設定します。

構文

int fsetpos(
   FILE *stream,
   const fpos_t *pos
);

パラメーター

stream
FILE 構造体へのポインター。

pos
位置インジケーターのストレージ。

戻り値

正常に終了した場合、fsetpos は 0 を返します。 失敗した場合、関数は 0 以外の値を返し、 errno 次のいずれかのマニフェスト定数 (ERRNO で定義されています。H): EBADF(ファイルにアクセスできないか、参照先のオブジェクトが stream 有効なファイル構造ではないことを意味します)。または EINVAL、無効な値 stream が pos 渡されたことを意味します。 無効なパラメーターが渡された場合、「パラメーターの検証」で説明されているように、これらの関数は無効なパラメーター ハンドラーを呼び出します。

リターン コードの詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。

解説

この関数は fsetpos 、前の呼び出しで取得された値に対 stream する posファイル位置インジケーターを fgetpos 設定します stream。 この関数は、ファイルの終わりインジケーターをクリアし、の影響 ungetc を元に stream戻します。 呼び出し fsetposの後、次の stream 操作は入力または出力のいずれかになります。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

必要条件

機能 必須ヘッダー
fsetpos <stdio.h>

互換性の詳細については、「 Compatibility」を参照してください。

例

fgetpos の例を参照してください。

関連項目

ストリーム入出力
fgetpos