std::streamoff

 

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)

 

Definiert in Header <ios>
typedef /*implementation-defined*/ streamoff;

Der Typ std::streamoff ist ein implementierungsdefinierter vorzeichenbehafteter ganzzahliger Typ(seit C++11) von ausreichender Größe, um die maximal vom Betriebssystem unterstützte Dateigröße darzustellen. Typischerweise ist dies ein Alias für long long.(seit C++11)

Er wird verwendet, um Offsets von Stream-Positionen (Werte vom Typ std::fpos) darzustellen. Ein von -1 konstruierter std::streamoff-Wert wird auch von einigen Funktionen der I/O-Bibliothek zur Darstellung von Fehlerbedingungen verwendet.

Beziehung zu std::fpos

• die Differenz zwischen zwei std::fpos Objekten ist ein Wert vom Typ std::streamoff

• zu einem Wert vom Typ std::streamoff kann zu std::fpos addiert oder von diesem subtrahiert werden, was zu einem anderen std::fpos führt.

• ein Wert vom Typ std::fpos ist implizit in std::streamoff konvertierbar (das Konvertierungsergebnis ist der Offset vom Anfang der Datei).

• ein Wert vom Typ std::fpos ist aus einem Wert vom Typ std::streamoff konstruierbar

Siehe auch

fpos	repräsentiert die absolute Position in einem Stream oder einer Datei (Klassen-Template)
seekg	setzt den Eingabepositionsindikator (public member function of std::basic_istream<CharT,Traits>)
seekp	setzt den Ausgabepositionsindikator (public member function of std::basic_ostream<CharT,Traits>)