fpos-Klasse
Die Klassenvorlage beschreibt ein Objekt, das alle informationen speichern kann, die zum Wiederherstellen eines beliebigen Dateipositionsindikators innerhalb eines beliebigen Datenstroms erforderlich sind. Ein Objekt der Klasse fpos<St> speichert effektiv mindestens zwei Memberobjekte:
Ein Byteoffset vom Typ streamoff
Ein Konvertierungszustand für die Verwendung durch ein Objekt der Klasse basic_filebuf vom Typ
St, in der Regelmbstate_t.
Es kann auch eine beliebige Dateiposition speichern, die von einem Objekt der Klasse basic_filebuf und vom Typ fpos_t verwendet werden kann. In einer Umgebung mit begrenzter Dateigröße werden streamoff und fpos_t jedoch manchmal synonym verwendet. In einer Umgebung ohne Streams, mit zustandsabhängiger Codierung, wird mbstate_t möglicherweise nicht verwendet. Daher kann die Anzahl der gespeicherten Memberobjekte variieren.
Syntax
template <class Statetype>
class fpos
Parameter
Statetype
Zustandsinformationen.
Konstruktoren
| Konstruktor | Beschreibung |
|---|---|
| fpos | Erstellt ein Objekt, das Informationen zu einer Position (Offset) in einem Stream enthält. |
Memberfunktionen
| Memberfunktion | Beschreibung |
|---|---|
| seekpos | Wird nur intern von der C++-Standardbibliothek verwendet. Rufen Sie diese Methode nicht aus Ihrem Code auf. |
| state | Legt den Konvertierungszustand fest oder gibt ihn zurück. |
Operatoren
| Operator | Beschreibung |
|---|---|
| operator!= | Testet Dateipositionsindikatoren auf Ungleichheit. |
| operator+ | Erhöht einen Dateipositionsindikator. |
| operator+= | Erhöht einen Dateipositionsindikator. |
| operator- | Verringert einen Dateipositionsindikator. |
| operator-= | Verringert einen Dateipositionsindikator. |
| operator== | Testet Dateipositionsindikatoren auf Gleichheit. |
| operator streamoff | Wandelt ein Objekt vom Typ fpos in ein Objekt vom Typ streamoff um. |
Anforderungen
Header:<ios>
Namespace: std
fpos::fpos
Erstellt ein Objekt, das Informationen zu einer Position (Offset) in einem Stream enthält.
fpos(streamoff _Off = 0);
fpos(Statetype _State, fpos_t _Filepos);
Parameter
_Aus
Der Offset in den Stream
_Staat
Der Startzustand des fpos-Objekts
_Filepos
Der Offset in den Stream
Hinweise
Der erste Konstruktor speichert den Offset _Off relativ zum Anfang der Datei und im anfänglichen Konvertierungszustand. Wenn _Off -1 ist, stellt das resultierende Objekt eine ungültige Datenstromposition dar.
Der zweite Konstruktor speichert einen Nulloffset und das Objekt _State.
fpos::operator!=
Testet Dateipositionsindikatoren auf Ungleichheit.
bool operator!=(const fpos<Statetype>& right) const;
Parameter
right
Der Dateipositionsindikator, gegen den verglichen werden soll
Rückgabewert
true wenn die Dateipositionsindikatoren nicht gleich sind, andernfalls false.
Hinweise
Die Memberfunktion gibt !(*this == right) zurück.
Beispiel
// fpos_op_neq.cpp
// compile with: /EHsc
#include <fstream>
#include <iostream>
int main( )
{
using namespace std;
fpos<int> pos1, pos2;
ifstream file;
char c;
// Compare two fpos object
if ( pos1 != pos2 )
cout << "File position pos1 and pos2 are not equal" << endl;
else
cout << "File position pos1 and pos2 are equal" << endl;
file.open( "fpos_op_neq.txt" );
file.seekg( 0 ); // Goes to a zero-based position in the file
pos1 = file.tellg( );
file.get( c);
cout << c << endl;
// Increment pos1
pos1 += 1;
file.get( c );
cout << c << endl;
pos1 = file.tellg( ) - fpos<int>( 2);
file.seekg( pos1 );
file.get( c );
cout << c << endl;
// Increment pos1
pos1 = pos1 + fpos<int>( 1 );
file.get(c);
cout << c << endl;
pos1 -= fpos<int>( 2 );
file.seekg( pos1 );
file.get( c );
cout << c << endl;
file.close( );
}
fpos::operator+
Erhöht einen Dateipositionsindikator.
fpos<Statetype> operator+(streamoff _Off) const;
Parameter
_Aus
Der Offset, um den der Dateipositionsindikator erhöht werden soll
Rückgabewert
Die Position in der Datei
Hinweise
Die Memberfunktion gibt fpos(*this) +=_Off zurück.
Beispiel
Ein Beispiel für die Verwendung von operator+ finden Sie unter operator!=.
fpos::operator+=
Erhöht einen Dateipositionsindikator.
fpos<Statetype>& operator+=(streamoff _Off);
Parameter
_Aus
Der Offset, um den der Dateipositionsindikator erhöht werden soll
Rückgabewert
Die Position in der Datei
Hinweise
Die Memberfunktion fügt _Off zum gespeicherten Offsetelementobjekt hinzu und gibt dann zurück *this. Beim Arbeiten mit Dateien ist das Ergebnis nur für binäre Datenströme gültig, die keine zustandsabhängige Codierung aufweisen.
Beispiel
Ein Beispiel für die Verwendung von operator+= finden Sie unter operator!=.
fpos::operator-
Verringert einen Dateipositionsindikator.
streamoff operator-(const fpos<Statetype>& right) const;
fpos<Statetype> operator-(streamoff _Off) const;
Parameter
right
Dateiposition
_Aus
Streamoffset
Rückgabewert
Die erste Memberfunktion gibt (streamoff)*this - (streamoff) right zurück. Die zweite Memberfunktion gibt fpos(*this) -= _Off zurück.
Beispiel
Ein Beispiel für die Verwendung von operator- finden Sie unter operator!=.
fpos::operator-=
Verringert einen Dateipositionsindikator.
fpos<Statetype>& operator-=(streamoff _Off);
Parameter
_Aus
Streamoffset
Rückgabewert
Die Memberfunktion gibt fpos(*this) -= _Off zurück.
Hinweise
Beim Arbeiten mit Dateien ist das Ergebnis nur für binäre Datenströme gültig, die keine zustandsabhängige Codierung aufweisen.
Beispiel
Ein Beispiel für die Verwendung von operator-= finden Sie unter operator!=.
fpos::operator==
Testet Dateipositionsindikatoren auf Gleichheit.
bool operator==(const fpos<Statetype>& right) const;
Parameter
right
Der Dateipositionsindikator, gegen den verglichen werden soll
Rückgabewert
true wenn die Dateipositionsindikatoren gleich sind; andernfalls false.
Hinweise
Die Memberfunktion gibt (streamoff)*this == (streamoff)right zurück.
Beispiel
Ein Beispiel für die Verwendung von operator+= finden Sie unter operator!=.
fpos::operator streamoff
Wandelt ein Objekt vom Typ fpos in ein Objekt vom Typ streamoff um
operator streamoff() const;
Hinweise
Die Memberfunktion gibt das gespeicherte Offset-Memberobjekt und alle zusätzlichen Offsets zurück, die als Teil des fpos_t-Memberobjekts gespeichert sind.
Beispiel
// fpos_op_streampos.cpp
// compile with: /EHsc
#include <ios>
#include <iostream>
#include <fstream>
int main( )
{
using namespace std;
streamoff s;
ofstream file( "rdbuf.txt");
fpos<mbstate_t> f = file.tellp( );
// Is equivalent to ..
// streampos f = file.tellp( );
s = f;
cout << s << endl;
}
0
fpos::seekpos
Diese Methode wird nur intern von der C++-Standardbibliothek verwendet. Rufen Sie diese Methode nicht aus Ihrem Code auf.
fpos_t seekpos() const;
fpos::state
Legt den Konvertierungszustand fest oder gibt ihn zurück.
Statetype state() const;
void state(Statetype _State);
Parameter
_Staat
Der neue Konvertierungsstatus
Rückgabewert
Der Konvertierungsstatus
Hinweise
Die erste Memberfunktion gibt den im St Memberobjekt gespeicherten Wert zurück. Die zweite Memberfunktion speichert _State im St Memberobjekt.
Beispiel
// fpos_state.cpp
// compile with: /EHsc
#include <ios>
#include <iostream>
#include <fstream>
int main() {
using namespace std;
streamoff s;
ifstream file( "fpos_state.txt" );
fpos<mbstate_t> f = file.tellg( );
char ch;
while ( !file.eof( ) )
file.get( ch );
s = f;
cout << f.state( ) << endl;
f.state( 9 );
cout << f.state( ) << endl;
}
Siehe auch
Threadsicherheit in der C++-Standardbibliothek
iostream-Programmierung
iostreams-Konventionen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für