std::basic_ostream<CharT,Traits>::seekp

 

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_ostream

Globale Objekte
coutwcout	cerrwcerr	clogwclog
Memberfunktionen
basic_ostream::basic_ostream
basic_ostream::~basic_ostream
basic_ostream::operator= (C++11)
Formatierte Ausgabe
basic_ostream::operator<<
Unformatierte Ausgabe
basic_ostream::put
basic_ostream::write
Positionierung
basic_ostream::tellp
basic_ostream::seekp
Sonstiges
basic_ostream::flush
basic_ostream::swap (C++11)
Member-Klassen
basic_ostream::sentry
Nicht-Member-Funktionen
operator<<(std::basic_ostream)
print(std::ostream) (C++23)
println(std::ostream) (C++23)
vprint_unicode(std::ostream) (C++23)
vprint_nonunicode(std::ostream) (C++23)

 

basic_ostream& seekp( pos_type pos );	(1)
basic_ostream& seekp( off_type off, std::ios_base::seekdir dir );	(2)

Setzt den Ausgabepositionszeiger des zugehörigen `streambuf`-Objekts.

Verhält sich wie eine UnformattedOutputFunction (außer dass keine tatsächliche Ausgabe erfolgt). Nach der Konstruktion und Überprüfung des Sentry-Objekts,

(seit C++11)

1) wenn fail() != true, wird der Ausgabepositionszeiger auf den absoluten Wert (relativ zum Dateianfang) pos gesetzt, indem rdbuf()->pubseekpos(pos, std::ios_base::out) aufgerufen wird. Im Fehlerfall wird setstate(std::ios_base::failbit) aufgerufen.

2) wenn fail() != true, wird der Ausgabepositionszeiger auf den Offset off relativ zu dir gesetzt, indem rdbuf()->pubseekoff(off, dir, std::ios_base::out) aufgerufen wird. Im Fehlerfall wird setstate(std::ios_base::failbit) aufgerufen.

Parameter

pos	-	absolute Position, auf die der Ausgabepositionszeiger gesetzt werden soll
off	-	relative Position (positiv oder negativ), auf die der Ausgabepositionszeiger 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

Rückgabewert

*this

Ausnahmen

1,2) Kann std::ios_base::failure im Fehlerfall auslösen, wenn exceptions() & failbit != 0.

Beispiel

Führen Sie diesen Code aus

#include <iostream>
#include <sstream>
 
int main()
{
    std::ostringstream os("hello, world");
    os.seekp(7);
    os << 'W';
    os.seekp(0, std::ios_base::end);
    os << '!';
    os.seekp(0);
    os << 'H';
    std::cout << os.str() << '\n';
}

Ausgabe

Hello, World!

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 129	C++98	Es gab keine Möglichkeit, einen Fehler anzuzeigen	Setzt `failbit` im Fehlerfall
LWG 136	C++98	seekp konnte den Eingabestrom setzen	setzt nur den Ausgabestrom
LWG 537	C++98	1. der Typ von pos war pos_type& 2. der Typ von off war off_type&	1. korrigiert zu pos_type 2. korrigiert zu off_type
LWG 2341	C++98	die Lösung von LWG-Problem 129 für Überladung (2) wurde entfernt	wiederhergestellt

Siehe auch

tellp	gibt den Ausgabepositionsindikator zurück (public member function)
tellg	gibt den Eingabepositionsindikator zurück (public member function of std::basic_istream<CharT,Traits>)
seekg	setzt den Eingabepositionsindikator (public member function of std::basic_istream<CharT,Traits>)