CFile::Seek
Reposiciona o ponteiro do arquivo em um arquivo aberto.
virtual ULONGLONG Seek(
LONGLONG lOff,
UINT nFrom
);
Parâmetros
lOff
Número de bytes para mover o ponteiro do arquivo. Os valores positivos mover o ponteiro do arquivo para o final do arquivo; os valores negativos mover o ponteiro do arquivo para o início do arquivo.nFrom
Posição de busca. Consulte a seção comentários para valores possíveis.
Valor de retorno
A posição do ponteiro do arquivo se o método tenha êxito; caso contrário, o valor de retorno é indefinida e um ponteiro para CFileException de uma exceção é lançada.
Comentários
A tabela a seguir lista os possíveis valores para o parâmetro de nFrom .
Valor |
Descrição |
---|---|
CFile::begin |
Pesquisa do início do arquivo. |
CFile::current |
Pesquisa do local atual do ponteiro do arquivo. |
CFile::end |
Pesquisa do final do arquivo. |
Quando um arquivo é aberto, o ponteiro do arquivo está localizado em 0, o início do arquivo.
Você pode definir o ponteiro do arquivo a uma posição além de extremidade de um arquivo. Se você fizer isso, o tamanho do arquivo não aumenta até que você gravar o arquivo.
O manipulador de exceção para esse método deve excluir o objeto de exceção após a exceção é processada.
Exemplo
CFile cfile;
cfile.Open(_T("Seek_File.dat"), CFile::modeCreate |
CFile::modeReadWrite);
LONGLONG lOffset = 1000;
ULONGLONG lActual;
lActual = cfile.Seek(lOffset, CFile::begin);
Requisitos
Cabeçalho: afx.h