System.SysUtils.FileSeek

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

function FileSeek(Handle: THandle; Offset, Origin: Integer): Integer;
function FileSeek(Handle: THandle; const Offset: Int64; Origin: Integer): Int64;

C++

extern DELPHI_PACKAGE int __fastcall FileSeek(NativeUInt Handle, int Offset, int Origin)/* overload */;

プロパティ

種類 可視性 ソース ユニット
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

説明

読み書きのポイントを移動します。

FileSeek を使用すると,FileOpen または FileCreate で開かれたファイル内で読み書きのポイントを移動できます。Handle は,FileOpen または FileCreate によって返されたファイルハンドルです。

Offset はファイルポインタを位置付ける Origin からのバイト数を指定します。Origin はファイルの始まり,ファイルの終わり,ファイルポインタの現在位置のいずれかを示す値のコードです。



Origin アクション

0

ファイルポインタをファイルの始まりから Offset バイトの位置に設定する

1

ファイルポインタを現在位置から Offset バイトの位置に設定する

2

ファイルポインタをファイルの終わりから Offset バイトの位置に設定する



正常終了すると,FileSeek はファイルポインタの新しい位置を返します。それ以外の場合は -1 を返します。

メモ:  :ファイルハンドルを取り出したり返したりするルーチンと Delphi 言語のファイル変数(var F など)を使用するルーチンを混同しないでください。Delphi ファイル変数によって指定されるファイル内でファイルポインタを移動するには,かわりに Seek 手続きを使用します。

関連項目