Partager via


basic_filebuf::seekoff

Tente de modifier les positions actuelles pour les flux de données contrôlés.

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

Paramètres

  • _Off
    La position à chercher relativement à _Way.

  • _Way
    Le point de départ pour les opérations décalage. Voir seekdir pour des valeurs possibles.

  • _Which
    Spécifie le mode pour la position du pointeur. La valeur par défaut est de vous permettre de modifier et lire les positions.

Valeur de retour

Retourne la nouvelle position ou une position de flux invalide.

Notes

La fonction membre virtuelle protégée s'efforce de modifier les positions actuelles pour les flux de données contrôlés. Pour un objet de la classe basic_filebuf<Elem, Tr>, une position du flux peut être représenté par un objet de type fpos_t, qui enregistre un décalage et toute information d'état nécessaires pour analyser un large flux de données. Le décalage zéro indique le premier élément du flux de données. (Un objet de type pos_type stocke au moins un objet fpos_t .)

Pour un fichier ouvert pour la lecture et l'écriture, les deux flux de sortie et d'entrée sont positionnés en tandem. Pour basculer entre l'insertion et l'extraction, vous devez faire appel soit à pubseekoff ou à pubseekpos. Les appels à pubseekoff (et par conséquent à seekoff) ont plusieurs limitations pour les flux de texte, flux binaire, et les large lux de données.

Si le pointeur de fichier fp est un pointeur null, la fonction échoue. Sinon, il tente de modifier la position du flux en appelant fseek(fp, _Off, _Way). Si la fonction réussit et la position résultante fposn peut être déterminée en appelant fgetpos(fp, &fposn), la fonction réussit. Si la fonction réussit, elle retourne une valeur de type pos_type contenant fposn. Sinon, elle retourne une position de flux invalide.

Configuration requise

En-tête: <fstream>

Espace de noms : std

Voir aussi

Référence

basic_filebuf, classe

iostream, programmation

iostreams, conventions