ftell _ftelli64

Článek
03/04/2013

Načte aktuální pozici ukazatele souboru.

long ftell( 
   FILE *stream 
);
__int64 _ftelli64( 
   FILE *stream 
);

Parametry

stream
Cíl FILE struktury.

Vrácená hodnota

ftella _ftelli64 vrácení aktuální umístění souboru.Hodnota vrácená ftell a _ftelli64 nemusí odrážet fyzické offsetu pro datové proudy otevřít v textovém režimu, protože textový režim způsobí, že přeprava return–linefeed překlad.Use ftell with fseekor_ftelli64with_fseeki64 to return to file locations correctly.Chyba ftella_ftelli64 vyvolat popisovač neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno spuštění pokračovat, vrátí tyto funkce –1L a errno na jednu dvě konstanty, definované v kód chyby.H.EBADF Znamená konstanta stream argument není platný soubor hodnota ukazatele nebo otevřít soubor neodkazuje.EINVALNeplatný znamená stream byl předán argument funkce.Na zařízeních neschopen usilující o (jako například terminály a tiskárny) nebo při stream neodkazuje k otevření souboru, vrácená hodnota je undefined.

Viz _doserrno, kód chyby, _sys_errlist a _sys_nerr Další informace o těchto a jiných návratových kódů.

Poznámky

ftell a _ftelli64funkce načíst aktuální pozici ukazatele souboru (pokud existuje), spojené s stream*.* Pozice je vyjádřena jako odsazení vzhledem k počátku datového proudu.

Všimněte si, že při otevření pro přidání dat aktuální pozice v souboru je dána poslední operace I/O není kde by se vyskytnout další zápis.Například soubor otevřen pro přidávacího a byla poslední operace čtení, umístění souboru je bod, kde další operace čtení by začít, kde další zápis by spustit.(Při otevření pro přidávání umístění souboru přesunuty na konec souboru před jakoukoliv operací zápisu.) Pokud žádná operace I/O ještě došlo na soubor otevřen pro připojení, je umístění souboru začátku souboru.

V textovém režimu CTRL + Z interpretována jako znak konce souboru na vstupu.Otevřen pro čtení nebo zápis souborů fopen a všechny související rutiny kontrolu CTRL + Z na konci souboru a pokud možno jej odebrat.Je důvodem, že pomocí kombinace ftell a fseek nebo _ftelli64 a _fseeki64, přesunout do souboru, který může způsobit končí CTRL + Z ftell nebo _ftelli64 chování nesprávně poblíž konce souboru.

Tato funkce zamkne volání podprocesu během spuštění a proto podprocesu.Verze zamykání, viz _ftell_nolock.

Požadavky

Function	Požadované záhlaví	Volitelné záhlaví
ftell	<stdio.h>	<errno.h>
_ftelli64	<stdio.h>	<errno.h>

Další informace o kompatibilitě, viz Compatibility v úvodu.

Příklad

// crt_ftell.c
// This program opens a file named CRT_FTELL.C
// for reading and tries to read 100 characters. It
// then uses ftell to determine the position of the
// file pointer and displays this position.
 

#include <stdio.h>

FILE *stream;

int main( void )
{
   long position;
   char list[100];
   if( fopen_s( &stream, "crt_ftell.c", "rb" ) == 0 )
   {
      // Move the pointer by reading data: 
      fread( list, sizeof( char ), 100, stream );
      // Get position after read: 
      position = ftell( stream );
      printf( "Position after trying to read 100 bytes: %ld\n",
              position );
      fclose( stream );
   }
}