fsetpos

  • [アーティクル]

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

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

パラメーター

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

  • pos
    位置インジケーターを格納する記憶領域。

戻り値

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

戻り値の詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。

解説

fsetpos 関数は、stream のファイル位置インジケーターを pos の値に設定します。これは、stream に対して前回呼び出した fgetpos で取得した値です。この関数は、EOF (EOF: end-of-file) インジケーターを消去し、stream に対する ungetc の実行結果を無効にします。fsetpos 呼び出しの後、stream には、次の操作として入力と出力のいずれも行うことができます。

必要条件

機能

必須ヘッダー

fsetpos

<stdio.h>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

使用例

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

同等の .NET Framework 関数

System::IO::FileStream::Position

参照

参照

ストリーム入出力

fgetpos