_tell, _telli64

Artigo
02/25/2013

Obtém a posição do ponteiro do arquivo.

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

Parâmetros

handle
Referindo-se para abrir o arquivo do descritor de arquivo.

Valor de retorno

A posição atual do ponteiro do arquivo.Incapaz de busca de dispositivos, o valor de retorno é indefinido.

Um valor de retorno de –1L indica um erro.Se handle é um descritor de arquivo inválido, 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.

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

Comentários

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

Requisitos

Rotina	Cabeçalho necessário
_tell, _telli64	<io.h>

Para obter 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 );
}