CFile::Seek
開かれているファイルでファイル ポインターを移動します。
virtual ULONGLONG Seek(
LONGLONG lOff,
UINT nFrom
);
パラメーター
lOff
ファイル ポインターを移動するバイト数。正の値は、ファイル ポインターをファイルの終端に向かって移動します。負の値は、ファイル ポインターをファイルの先頭に向かって移動します。nFrom
シークを開始する位置。有効な値については、「解説」を参照してください。
戻り値
メソッドが正常に実行された場合は、ファイル ポインターの位置。それ以外の場合、戻り値は未定義になり、CFileException 例外へのポインターがスローされます。
解説
nFrom パラメーターとして使用できる値の一覧を次の表に示します。
値 |
説明 |
---|---|
CFile::begin |
ファイルの先頭からシークします。 |
CFile::current |
ファイル ポインターの現在の位置からシークします。 |
CFile::end |
ファイルの終端からシークします。 |
ファイルが開かれた時点では、ファイル ポインターはファイルの先頭である 0 の位置にあります。
ファイル ポインターは、ファイルの終端を越える位置にも設定できます。その場合、ファイルに書き込むまでファイルのサイズは増えません。
このメソッドの例外ハンドラーは、例外が処理された後に例外オブジェクトを削除する必要があります。
使用例
CFile cfile;
cfile.Open(_T("Seek_File.dat"), CFile::modeCreate |
CFile::modeReadWrite);
LONGLONG lOffset = 1000;
ULONGLONG lActual;
lActual = cfile.Seek(lOffset, CFile::begin);
必要条件
ヘッダー : afx.h