basic_stringbuf::seekoff

Artikel
06/09/2015

Die Versuche der geschützten virtuellen Memberfunktion, um die aktuelle Position für die kontrollierten Streams zu ändern.

virtual pos_type seekoff(
   off_type _Off,
   ios_base::seekdir _Way,
   ios_base::openmode _Mode = ios_base::in | ios_base::out
);

Parameter

_Off
Die Position, für relativ zum _Way zu suchen. Weitere Informationen finden Sie unter basic_stringbuf::off_type.
_Way
Der Ausgangspunkt für Offsetvorgänge. Mögliche Werte finden Sie unter ios_base::seekdir.
_Mode
Gibt dem Modus für die Zeigerposition an. Der Standardwert ist, Ihnen ermöglichen, das Lesen und die Schreibpositionen zu ändern. Weitere Informationen finden Sie unter ios_base::openmode.

Rückgabewert

Gibt der neuen Position oder einer ungültigen Streamposition zurück.

Hinweise

Für ein Objekt der Klasse basic_stringbuf<Elem, Tr, Alloc>, besteht eine Streamposition rein aus einem Streamoffset. Offset null legt das erste Element der Sequenz gesteuerten fest.

Die neue Position wird bestimmt, wie folgt:

Wenn _Wayios_base::beg, == die neue Position Anfang des Streams plus _Off ist.
Wenn _Wayios_base::cur, == die neue Position der aktuellen Streamposition plus _Off ist.
Wenn _Wayios_base::end, == die neue Position das Ende eines Streams plus _Off ist.

Wenn _Mode & ios_base::in ungleich 0 ist, ändert die Funktion die folgenden Position, der Eingabepuffer Einchecken zu lesen. Wenn _Mode & ios_base::out ungleich 0 ist, ändert die Funktion die folgenden Position, in den Ausgabepuffer zu schreiben. Damit ein Stream beeinflusst werden kann, Puffer vorhanden sein muss. Damit ein positionierender Vorgang, die resultierende Streamposition muss innerhalb der gesteuerten Sequenz liegen folgt. Wenn die Funktion beide Streampositionen beeinflusst, muss _Way sein oder ios_base::beg, ios_base::end und beide Streams werden am gleichen Element positioniert. Andernfalls (oder, wenn auch die Position nicht beeinflusst wird), schlägt der Positionierungseigenschaft Vorgang aus.

Wenn die Funktion erfolgreich, mit, eine oder beide der Streampositionen zu ändern, gibt sie die resultierende Streamposition zurück. Andernfalls bleibt sie und gibt eine ungültige Streamposition zurück.