Compartilhar via


_tell, _telli64

Obter a posição do ponteiro de arquivo.

long _tell(
   int handle
);
__int64 _telli64(
   int handle 
);

Parâmetros

  • handle
    O descritor de Arquivo que faz referência ao arquivo aberto.

Valor de retorno

A posição atual do ponteiro de arquivo. Dispositivos pôde buscar, o valor de retorno será indefinido.

Um valor de retorno 1L – indica um erro. Se handle é um descritor de arquivo inválido, o manipulador inválido do parâmetro será chamado, conforme descrito em Validação do parâmetro. Se a execução for permitida continuar, esse errno definido funções a EBADF e a ser retornado -1L.

Consulte _doserrno, errno, _sys_errlist, e _sys_nerr para obter mais informações sobre esse, e outras, códigos de retorno.

Comentários

A função de _tell obtém a posição atual do ponteiro de arquivo (se houver) associado com o argumento de handle . A posição é expresso como o número de bytes do início do arquivo. Para a função de _telli64 , esse valor é expresso como um inteiro de 64 bits.

Requisitos

Rotina

Cabeçalho necessário

_tell, _telli64

<io.h>

Para informações adicionais de compatibilidade, consulte Compatibilidade na Introdução.

Exemplo

// crt_tell.c
// This program uses _tell to tell the
// file pointer position after a file read.
//

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

int main( void )
{
   int  fh;
   char buffer[500];

   if ( _sopen_s( &fh, "crt_tell.txt", _O_RDONLY, _SH_DENYNO, 0) )
   {
      char buff[50];
      _strerror_s( buff, sizeof(buff), NULL );
      printf( buff );
      exit( -1 );
   }

   if( _read( fh, buffer, 500 ) > 0 )
      printf( "Current file position is: %d\n", _tell( fh ) );
   _close( fh );
}

Entrada: crt_tell.txt

Line one.
Line two.

Saída

Current file position is: 20

Consulte também

Referência

E/S de nível inferior

ftell, _ftelli64

_lseek, _lseeki64