std::ftell

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Ein-/Ausgabe-Bibliothek

I/O-Manipulatoren

Print-Funktionen (C++23)

C-Style I/O

Puffer

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

Streams

Abstraktionen

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

Datei-I/O

basic_ifstream

basic_ofstream

basic_fstream

String-I/O

basic_istringstream

basic_ostringstream

basic_stringstream

Array-I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

Synchronisierte Ausgabe

basic_osyncstream (C++20)

Typen

streamoff

streamsize

fpos

Fehlerkategorie-Schnittstelle

iostream_category (C++11)

io_errc (C++11)

 

C-Style I/O

Typen und Objekte
FILE fpos_t	stdinstdoutstderr
Funktionen
Datei-Zugriff fopen freopen fclose fflush fwide setbuf setvbuf Direkte Ein-/Ausgabe fread fwrite Unformatierte Ein-/Ausgabe fgetcgetc fgets fputcputc fputs getchar gets (bis C++14) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc Formatierte Eingabe scanffscanfsscanf vscanfvfscanfvsscanf (C++11)(C++11)(C++11)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	Formatierte Ausgabe printffprintfsprintfsnprintf (C++11) vprintfvfprintfvsprintfvsnprintf (C++11)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf Dateipositionierung ftell fgetpos fseek fsetpos rewind Fehlerbehandlung clearerr feof ferror perror Operationen auf Dateien remove rename tmpfile tmpnam

 

Definiert in Header <cstdio>
long ftell( std::FILE* stream );

Gibt den aktuellen Wert des Dateipositionsindikators für den Dateistream stream zurück.

Wenn der Stream im Binärmodus geöffnet ist, ist der von dieser Funktion erhaltene Wert die Anzahl der Bytes vom Anfang der Datei.

Wenn der Stream im Textmodus geöffnet ist, ist der von dieser Funktion zurückgegebene Wert nicht spezifiziert und nur als Eingabe für std::fseek sinnvoll.

Parameter

stream

-

zu untersuchender Dateistream

Rückgabewert

Datei-Positionsindikator bei Erfolg oder -1L bei Fehlschlag. Setzt auch errno bei Fehlschlag.

Hinweise

Unter Windows kann _ftelli64 verwendet werden, um mit Dateien zu arbeiten, die größer als 2 GiB sind.

Beispiel

Demonstriert std::ftell() mit Fehlerprüfung. Schreibt dann einige Gleitkommazahlen (FP) in/aus einer Datei und liest sie.

Führen Sie diesen Code aus

#include <cstdio>
#include <cstdlib>
#include <iostream>
 
// If the condition is not met then exit the program with error message.
void check(bool condition, const char* func, int line)
{
    if (condition)
        return;
    std::perror(func);
    std::cerr << func << " failed in file " << __FILE__ << " at line # " << line - 1
              << '\n';
    std::exit(EXIT_FAILURE);
}
 
int main()
{
    // Prepare an array of FP values.
    constexpr int SIZE {5};
    double A[SIZE] = {1.1, 2.2, 3.3, 4.4, 5.5};
 
    // Write array to a file.
    const char* fname = "/tmp/test.bin";
    FILE* file = std::fopen(fname, "wb");
    check(file != NULL, "fopen()", __LINE__);
 
    const int write_count = std::fwrite(A, sizeof(double), SIZE, file);
    check(write_count == SIZE, "fwrite()", __LINE__);
 
    std::fclose(file);
 
    // Read the FP values into array B.
    double B[SIZE];
    file = std::fopen(fname, "rb");
    check(file != NULL, "fopen()", __LINE__);
 
    long pos = std::ftell(file); // position indicator at start of file
    check(pos != -1L, "ftell()", __LINE__);
    std::cout << "pos: " << pos << '\n';
 
    const int read_count = std::fread(B, sizeof(double), 1, file); // read one FP value
    check(read_count == 1, "fread()", __LINE__);
 
    pos = std::ftell(file); // position indicator after reading one FP value
    check(pos != -1L, "ftell()", __LINE__);
    std::cout << "pos: " << pos << '\n';
    std::cout << "B[0]: " << B[0] << '\n'; // print one FP value
 
    return EXIT_SUCCESS;
}

Mögliche Ausgabe

pos: 0
pos: 8
B[0]: 1.1

Siehe auch

fgetpos	holt den Dateipositionierungsindikator (function)
fseek	verschiebt den Dateipositionierungsindikator an eine bestimmte Stelle in einer Datei (function)
fsetpos	verschiebt den Dateipositionierungsindikator an eine bestimmte Stelle in einer Datei (function)
tellg	gibt den Eingabepositionsindikator zurück (public member function of std::basic_istream<CharT,Traits>)
tellp	gibt den Ausgabepositionsindikator zurück (public member function of std::basic_ostream<CharT,Traits>)
C-Dokumentation für ftell