std::strstreambuf::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::strstreambuf

Öffentliche Memberfunktionen

strstreambuf::strstreambuf

strstreambuf::~strstreambuf

strstreambuf::freeze

strstreambuf::str

strstreambuf::pcount

Geschützte Memberfunktionen

strstreambuf::underflow

strstreambuf::pbackfail

strstreambuf::overflow

strstreambuf::setbuf

strstreambuf::seekoff

strstreambuf::seekpos

 

protected: virtual pos_type seekpos( pos_type sp,                           std::ios_base::openmode welche =                               std::ios_base::in | std::ios_base::out );		(veraltet in C++98) (entfernt in C++26)

Positioniert std::basic_streambuf::gptr und/oder std::basic_streambuf::pptr, falls möglich, an die von sp angegebene Position.

Wenn std::ios_base::in in which gesetzt ist, wird versucht, gptr() (den nächsten Zeiger im Lese-Bereich) neu zu positionieren. Wenn std::ios_base::out in which gesetzt ist, wird versucht, pptr() (den nächsten Zeiger im Schreib-Bereich) neu zu positionieren. Wenn keiner der Bits in which gesetzt ist, schlägt die Operation fehl.

Jeder nächste Zeiger wird wie folgt neu positioniert:

• Wenn der nächste Zeiger null ist, schlägt die Operation fehl.
• Andernfalls wird der neue Offset newoff (vom Typ off_type) durch Aufruf von sp.offset() bestimmt. Wenn newoff negativ ist, außerhalb des Puffers liegt oder ungültig ist, schlägt die Operation fehl.
• Andernfalls wird der nächste Zeiger zugewiesen, als ob durch gptr() = eback() + newoff oder pptr() = pbase() + newoff.

Parameter

sp	-	Stream-Position, wie z. B. eine, die von seekoff() oder seekpos() erhalten wurde
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

Der resultierende Offset, konvertiert zu pos_type bei Erfolg oder pos_type(off_type(-1)) bei Fehler.

Hinweise

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.

Beispiel

Führen Sie diesen Code aus

#include <cstring>
#include <iostream>
#include <strstream>
 
struct mybuf : std::strstreambuf
{
    mybuf(const char* str) : std::strstreambuf(str, std::strlen(str)) {}
 
    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::strstreambuf::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";
 
        return rc;
    }
};
 
int main()
{
    mybuf buf("12345");
    std::iostream stream(&buf);
    stream.seekg(2);
}

Ausgabe

Before seekpos(2), size of the get area is 5 with 5 read positions available.
seekpos() returns 2.
After the call, size of the get area is 5 with 3 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 ungültige Stream-Position bei Fehler	pos_type(off_type(-1)) wird bei Fehler zurückgegeben.

Siehe auch

seekoff [virtuell]	positioniert den nächsten Zeiger in der Eingabesequenz, Ausgabesequenz oder beidem neu, unter Verwendung relativer Adressierung (virtuelle geschützte Memberfunktion)
seekpos [virtuell]	positioniert den nächsten Zeiger in der Eingabesequenz, Ausgabesequenz oder beidem neu, unter Verwendung absoluter Adressierung (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
seekpos [virtuell]	positioniert den nächsten Zeiger in der Eingabesequenz, Ausgabesequenz oder beidem neu, unter Verwendung absoluter Adressierung (virtual protected member function of std::basic_stringbuf<CharT,Traits,Allocator>)
seekpos [virtuell]	positioniert die Dateiposition neu, unter Verwendung absoluter Adressierung (virtual protected member function of std::basic_filebuf<CharT,Traits>)