std::basic_filebuf<CharT,Traits>::seekpos

 

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)

 

std::basic_filebuf

Öffentliche Memberfunktionen

basic_filebuf::basic_filebuf

basic_filebuf::~basic_filebuf

basic_filebuf::operator= (C++11)

basic_filebuf::swap (C++11)

basic_filebuf::native_handle (C++26)

basic_filebuf::is_open

basic_filebuf::open

basic_filebuf::close

Geschützte Memberfunktionen

basic_filebuf::showmanyc

basic_filebuf::underflow

basic_filebuf::uflow

basic_filebuf::pbackfail

basic_filebuf::overflow

basic_filebuf::setbuf

basic_filebuf::seekoff

basic_filebuf::seekpos

basic_filebuf::sync

basic_filebuf::imbue

Nicht-Member-Funktionen

swap(std::basic_filebuf) (C++11)

 

protected: virtual pos_type seekpos( pos_type sp,                           std::ios_base::openmode which = std::ios_base::in | std::ios_base::out );

Setzt den Dateizeiger, wenn möglich, auf die von sp angegebene Position. Wenn die zugehörige Datei nicht geöffnet ist (is_open() == false), schlägt der Vorgang sofort fehl.

Die Neupositionierung erfolgt wie folgt:

1) Wenn die Datei zum Schreiben geöffnet ist, schreibt sie den Pufferbereich und alle vom aktuell eingebetteten Locale benötigten Unshift-Sequenzen, unter Verwendung von overflow().

2) Setzt den Dateizeiger neu, als ob std::fsetpos() aufgerufen worden wäre.

3) Wenn die Datei zum Lesen geöffnet ist, aktualisiert sie bei Bedarf den Leseindexbereich.

Wenn sp nicht durch Aufrufen von seekoff() oder seekpos() auf derselben Datei erhalten wurde, ist das Verhalten undefiniert.

Parameter

sp	-	Dateiposition, die durch einen früheren Aufruf von seekoff() oder seekpos() auf derselben Datei erhalten wurde
which	-	definiert, welche der Eingabe- und/oder Ausgabesequenzen beeinflusst werden sollen. Es kann eine oder eine Kombination der folgenden Konstanten sein Konstante Erklärung in beeinflusst die Eingabesequenz out beeinflusst die Ausgabesequenz

Rückgabewert

sp bei Erfolg oder pos_type(off_type(-1)) bei Fehler.

Anmerkungen

seekpos() wird von std::basic_streambuf::pubseekpos() aufgerufen, welche von den Ein-Argument-Versionen von std::basic_istream::seekg() und std::basic_ostream::seekp() aufgerufen wird.

Viele Implementierungen aktualisieren den Leseindexbereich in seekpos() nicht, sondern delegieren dies an underflow(), das vom nächsten sgetc() aufgerufen wird.

Beispiel

Bei einigen Implementierungen wird der Leseindexbereich durch seekpos() geleert, und das zweite underflow() ist notwendig, um die Auswirkungen zu beobachten.

Führen Sie diesen Code aus

#include <fstream>
#include <iostream>
 
struct mybuf : std::filebuf
{
    pos_type seekpos(pos_type sp, std::ios_base::openmode which)
    {
        std::cout << "Before seekpos(" << sp << "), size of the get area is "
                  << egptr() - eback() << " with "
                  << egptr() - gptr() << " read positions available.\n";
 
        pos_type rc = std::filebuf::seekpos(sp, which);
 
        std::cout << "seekpos() returns " << rc << ".\nAfter the call, "
                  << "size of the get area is "
                  << egptr() - eback() << " with "
                  << egptr() - gptr() << " read positions available.\n";
// uncomment if get area is emptied by seekpos()
//        std::filebuf::underflow();
//        std::cout << "after forced underflow(), size of the get area is "
//                  << egptr() - eback() << " with "
//                  << egptr() - gptr() << " read positions available.\n";
 
        return rc;
    }
};
 
int main()
{
    mybuf buf;
    buf.open("test.txt", std::ios_base::in);
    std::istream stream(&buf);
    stream.get(); // read one char to force underflow()
    stream.seekg(2);
}

Mögliche Ausgabe

Before seekpos(2), size of the get area is 110 with 109 read positions available.
seekpos() returns 2.
After the call, size of the get area is 110 with 108 read positions available.

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 55	C++98	seekpos gab einen undefinierten Wert zurück ungültige Stream-Position bei Fehler	pos_type(off_type(-1)) wird bei Fehler zurückgegeben.
LWG 171	C++98	Die Reihenfolge der Neupositionierungsvorgänge war unklar	wurde klargestellt

Siehe auch

pubseekpos	ruft seekpos() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
seekoff [virtuell]	positioniert die Dateiposition neu, unter Verwendung relativer Adressierung (virtuelle geschützte Memberfunktion)
fseek	verschiebt den Dateipositionierungsindikator an eine bestimmte Stelle in einer Datei (function)