Partager via


_tell, _telli64

Obtient la position du pointeur de fichier.

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

Paramètres

  • handle
    Descripteurs de fichier faisant référence au fichier ouvert.

Valeur de retour

Position actuelle du pointeur de fichier. Sur des périphériques incapables d'effectuer des recherches, la valeur de retour n'est pas définie.

Une valeur de retour de -1L indique une erreur. Si handle est un descripteur de fichier invalide, le hgestionnaire de paramètre invalide est invoqué, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, ces fonctions définissent errno à EBADF et retournent -1L.

Consultez _doserrno, errno, _sys_errlist et _sys_nerr pour plus d'informations sur ceci et d'autres codes de retour.

Notes

La fonction _tell obtient la position actuelle du pointeur de fichier (le cas échéant) associé à l'argument handle. La position est exprimée comme le nombre d'octets entre le début du fichier. De la fonction _telli64, cette valeur est exprimée en tant qu'entier 64 bits.

Configuration requise

Routine

En-tête requis

_tell, _telli64

<io.h,>

Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.

Exemple

// 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 );
}

Entrée : crt_tell.txt

Line one.
Line two.

Sortie

Current file position is: 20

Voir aussi

Référence

E/S niveau bas

ftell, _ftelli64

_lseek, _lseeki64