std::basic_spanbuf<CharT,Traits>::seekoff

 

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_spanbuf

Öffentliche Memberfunktionen

basic_spanbuf::basic_spanbuf (C++23)

basic_spanbuf::operator= (C++23)

basic_spanbuf::swap (C++23)

basic_spanbuf::span (C++23)

Geschützte Memberfunktionen

basic_spanbuf::setbuf (C++23)

basic_spanbuf::seekoff (C++23)

basic_spanbuf::seekpos (C++23)

Nicht-Member-Funktionen

swap(std::basic_spanbuf) (C++23)

 

protected: pos_type seekoff( off_type off, std::ios_base::seekdir dir,                   std::ios_base::openmode which =                       std::ios_base::in | std::ios_base::out ) override;		(seit C++23)

Positioniert den nächsten Zeiger für den Lese- und/oder Schreibbereich, falls möglich, an die Position, die genau off Zeichen vom Anfang, Ende oder der aktuellen Position des Lese- und/oder Schreibbereichs des Puffers entspricht.

Sei n die Anzahl der CharT-Elemente im zugrunde liegenden Puffer oder ​0​, wenn kein zugrunde liegender Puffer vorhanden ist. Diese Funktion schlägt fehl, wenn

• der nächste Zeiger für den Lese- und/oder Schreibbereich, der neu positioniert werden soll, null ist und das berechnete newoff (siehe unten) nicht null ist, was auftreten kann, wenn kein zugrunde liegender Puffer vorhanden ist, oder *this nicht im von which geforderten Modus geöffnet ist, oder
• dir std::ios_base::cur ist und sowohl std::ios_base::in als auch std::ios_base::out in which gesetzt sind, oder
• das berechnete newoff nicht in off_type darstellbar ist, kleiner als null oder größer als n ist.

newoff wird wie folgt berechnet:

• Wenn dir std::ios_base::beg ist, ist newoff gleich off.
• Wenn dir std::ios_base::cur ist, ist newoff
  • pptr() - pbase() + off, wenn std::ios_base::out in which gesetzt ist, oder
  • gptr() - eback() + off, wenn std::ios_base::in in which gesetzt ist.
• Wenn dir std::ios_base::end ist, ist newoff
  • pptr() - pbase() + off, wenn std::ios_base::out, aber nicht std::ios_base::in im Öffnungsmodus von *this gesetzt ist,
  • andernfalls off + n.

Diese Funktion positioniert den nächsten Zeiger für den Lese- und/oder Schreibbereich im Erfolgsfall auf pbuf + newoff, wenn std::ios_base::in und/oder std::ios_base::out entsprechend in which gesetzt sind, wobei pbuf der Zeiger auf den Anfang des zugrunde liegenden Puffers ist oder der Nullzeigerwert, wenn kein zugrunde liegender Puffer vorhanden ist.

Parameter

off	-	relativer Positionsversatz, auf den die nächsten Zeiger gesetzt werden sollen.
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	-	legt fest, ob die Eingabesequenzen, die Ausgabesequenz oder beide betroffen sind. Es kann eine oder eine Kombination der folgenden Konstanten sein: Konstante Erklärung in beeinflusst die Eingabesequenz out beeinflusst die Ausgabesequenz

Rückgabewert

pos_type(newoff) im Erfolgsfall, pos_type(off_type(-1)) im Fehlerfall.

Siehe auch

seekoff [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>)
seekoff [virtuell]	positioniert den nächsten Zeiger in der Eingabesequenz, Ausgabesequenz oder beidem neu, unter Verwendung relativer Adressierung (virtuelle protected Member-Funktion von std::strstreambuf)