Namensräume
Varianten
Aktionen

std::basic_streambuf<CharT,Traits>::pubseekoff, std::basic_streambuf<CharT,Traits>::seekoff

Von cppreference.com
< cpp‎ | io‎ | basic streambuf
 
 
 
 
pos_type pubseekoff( off_type off, std::ios_base::seekdir dir,
                     std::ios_base::openmode which = ios_base::in | ios_base::out );
(1)
protected:

virtual pos_type seekoff( off_type off, std::ios_base::seekdir dir,

                          std::ios_base::openmode which = ios_base::in | ios_base::out );
(2)

Setzt die Positionsanzeige der Eingabe- und/oder Ausgabesequenz relativ zu einer anderen Position.

1) Ruft seekoff(off, dir, which) der am weitesten abgeleiteten Klasse auf.
2) Die Basisklassenversion dieser Funktion hat keine Auswirkung. Die abgeleiteten Klassen können diese Funktion überschreiben, um eine relative Positionierung der Positionsanzeige zu ermöglichen.

Inhalt

[bearbeiten] Parameter

off - relative Position, auf die die Positionsanzeige gesetzt werden soll.
dir - definiert die Basisposition, auf die der relative Offset angewendet wird. Es kann eine der folgenden Konstanten sein
Konstante Erklärung
beg der Anfang eines Streams
end das Ende eines Streams
cur die aktuelle Position des Stream-Positionsanzeigers
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

[bearbeiten] Hinweis

Nicht alle Kombinationen von Parametern sind möglicherweise gültig. Details finden Sie in den abgeleiteten Versionen von seekoff.

[bearbeiten] Rückgabewert

1) Der Rückgabewert von seekoff(off, dir, which)
2) Die resultierende absolute Position, wie sie von der Positionsanzeige definiert wird. Die Basisklassenversion gibt pos_type(off_type(-1)) zurück.

[bearbeiten] Beispiel

[bearbeiten] 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 die Basisklassenversion von seekoff gab zurück
eine undefinierte ungültige Stream-Position
gibt pos_type(off_type(-1)) zurück

[bearbeiten] Siehe auch

ruft seekpos() auf
(public member function) [bearbeiten]
[virtuell]
positioniert die Dateiposition neu, unter Verwendung relativer Adressierung
(virtuelle protected Member-Funktion von std::basic_filebuf<CharT,Traits>) [edit]
[virtuell]
positioniert den nächsten Zeiger in der Eingabesequenz, Ausgabesequenz oder beidem neu, unter Verwendung relativer Adressierung
(virtuelle protected Member-Funktion von std::basic_stringbuf<CharT,Traits,Allocator>) [edit]
[virtuell]
positioniert den nächsten Zeiger in der Eingabesequenz, Ausgabesequenz oder beidem neu, unter Verwendung relativer Adressierung
(virtuelle protected Member-Funktion von std::strstreambuf) [edit]