Freigeben über


basic_filebuf::seekoff

Versucht, aktuellen Positionen für die kontrollierten Streams zu ändern.

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

Parameter

  • _Off
    Die Position, für relativ zum _Way zu suchen.

  • _Way
    Der Ausgangspunkt für Offsetvorgänge. Siehe seekdir für mögliche Werte.

  • _Which
    Gibt dem Modus für die Zeigerposition an. Der Standardwert ist, Ihnen ermöglichen, das Lesen und die Schreibpositionen zu ändern.

Rückgabewert

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

Hinweise

Die geschützte Bemühungen der virtuellen Memberfunktion, aktuellen Positionen für die kontrollierten Streams zu ändern. Für ein Objekt der Klasse basic_filebuf<Elem, Tr>, kann eine Streamposition über ein Objekt vom Typ fpos_t dargestellt werden, der einen Offset und alle Zustandsinformationen speichert, die erforderlich sind, um zahlreiche Stream zu analysieren. Offset null legt das erste Element des Streams fest. (Ein Objekt des Typs pos_type Speichern mindestens ein fpos_t-Objekt.)

Eine Datei, die für das Lesen und Schreiben, werden geöffnet ist, die Eingabe und die Ausgabestreams im Tandem positioniert. Um zwischen dem Einfügen und dem Extrahieren wechseln, müssen Sie entweder pubseekoff oder pubseekpos aufrufen. Aufrufe zu pubseekoff (und somit zu seekoff) besitzen verschiedene Einschränkungen für Textstreams, Binärstreams und breite Streams.

Wenn der Dateizeiger fp ein NULL-Zeiger ist, schlägt die Funktion. Andernfalls ermittelt, er die Streamposition zu ändern, indem Sie fseek aufrufen (fp, _Off, _Way). Wenn diese Funktion erfolgreich ist und die resultierende Position fposn bestimmt werden kann, indem fgetpos(fp, &fposn) aufruft, ist die Funktion. Wenn die Funktion entspricht, gibt sie einen Wert des Typs pos_type fposn enthalten zurück. Andernfalls wird eine ungültige Streamposition zurück.

Anforderungen

Header: <fstream>

Namespace: std

Siehe auch

Referenz

basic_filebuf-Klasse

iostream-Programmierung

iostreams-Konventionen