Поделиться через


CFile::Seek

Перемещает указатель файла в открытом файле.

virtual ULONGLONG Seek(
   LONGLONG lOff,
   UINT nFrom 
);

Параметры

  • lOff
    Число байт, чтобы переместить указатель файла.Положительные значения указателя файла перемещаются в конец файла; отрицательные значения перемещения указателя файла к началу файла.

  • nFrom
    Положение поиска.См. раздел примeчаний для возможных значений.

Возвращаемое значение

Позиция указателя файла, если метод был выполнен успешно; в противном случае возвращаемое значение не определено; в противном случае вызывается исключение 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

См. также

Ссылки

Класс CFile

Диаграмма иерархии