_lseek, _lseeki64

Move um ponteiro de arquivo no local especificado.

long _lseek(
   int fd,
   long offset,
   int origin 
);
__int64 _lseeki64(
   int fd,
   __int64 offset,
   int origin 
);

Parâmetros

• fd
  Descritor de arquivo se referindo a um arquivo aberto.

• deslocamento
  Número de bytes do origem.

• origem
  Posição inicial.

Valor de retorno

_lseekRetorna o deslocamento, em bytes, do que a nova posição do início do arquivo._lseeki64Retorna o deslocamento em um inteiro de 64 bits.A função retornará –1L para indicar um erro.Se passado um parâmetro inválido, como, por exemplo, um descritor de arquivo inválido ou o valor de origem é inválida ou a posição especificada pelo deslocamento é antes do início do arquivo, o manipulador de parâmetro inválido é invocado, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, essas funções definir errno para EBADF e retornar-1 L.Em dispositivos incapazes de busca (como, por exemplo, terminais e impressoras), o valor de retorno é indefinido.

Para obter mais informações sobre esses e outros códigos de erro, consulte _doserrno, errno, _sys_errlist e _sys_nerr.

Comentários

O _lseek função move o ponteiro de arquivo associado fd para um novo local é deslocamento bytes de origem.A próxima operação no arquivo ocorre no novo local.O origem o argumento deve ser uma das constantes a seguir, que são definidas em stdio. h.

• SEEK_SET
  Início do arquivo.

• SEEK_CUR
  Posição atual do ponteiro do arquivo.

• SEEK_END
  Fim do arquivo.

Você pode usar _lseek para reposicionar o ponteiro em qualquer lugar em um arquivo ou além do fim do arquivo.

Requisitos

Para obter mais informações de compatibilidade, consulte compatibilidade na introdução.

Bibliotecas

Todas as versões da bibliotecas de tempo de execução c.

Exemplo

// crt_lseek.c
/* This program first opens a file named lseek.txt.
 * It then uses _lseek to find the beginning of the file,
 * to find the current position in the file, and to find
 * the end of the file.
 */

#include <io.h>
#include <fcntl.h>
#include <stdlib.h>
#include <stdio.h>
#include <share.h>

int main( void )
{
   int fh;
   long pos;               /* Position of file pointer */
   char buffer[10];

   _sopen_s( &fh, "crt_lseek.c_input", _O_RDONLY, _SH_DENYNO, 0 );

   /* Seek the beginning of the file: */
   pos = _lseek( fh, 0L, SEEK_SET );
   if( pos == -1L )
      perror( "_lseek to beginning failed" );
   else
      printf( "Position for beginning of file seek = %ld\n", pos );

   /* Move file pointer a little */
    _read( fh, buffer, 10 );

   /* Find current position: */
   pos = _lseek( fh, 0L, SEEK_CUR );
   if( pos == -1L )
      perror( "_lseek to current position failed" );
   else
      printf( "Position for current position seek = %ld\n", pos );

   /* Set the end of the file: */
   pos = _lseek( fh, 0L, SEEK_END );
   if( pos == -1L )
      perror( "_lseek to end failed" );
   else
      printf( "Position for end of file seek = %ld\n", pos );

   _close( fh );
}

Entrada: crt_lseek.c_input

Line one.
Line two.
Line three.
Line four.
Line five.

Saída

Position for beginning of file seek = 0
Position for current position seek = 10
Position for end of file seek = 57

Consulte também

Referência

Nível baixo e/S

fseek, _fseeki64

_tell, _telli64