_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

Rotina

Cabeçalho necessário

_lseek

<io.h>

_lseeki64

<io.h>

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