Partager via


basic_streambuf::seekoff

Une méthode virtuelle protégée qui 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 ( seekoff (_Off, _Way, _Which) )..

Notes

La nouvelle position est déterminée comme suit :

  • Si _Way == ios_base::beg, la nouvelle position est le début du flux plus _Off.

  • Si _Way == ios_base::cur, la nouvelle position correspond à la position actuelle du flux plus _Off.

  • Si _Way == ios_base::end, la nouvelle position est la fin du flux plus _Off.

En général, si which & ios_base::in est différent de zéro, le flux d'entrée est affecté, et si which & ios_base::out est différente de zéro, le flux de sortie est affecté. Néanmoins, l'utilisation réelle du paramètre varie entre les mémoires tampons de flux dérivées.

Si la fonction réussit à modifier la/les position(s) du flux, elle retourne la position du flux obtenue ou une des positions du flux résultant. Sinon, elle retourne une position de flux invalide. Le comportement par défaut consiste à retourner une position du flux invalide.

Configuration requise

En-tête : <streambuf>

Espace de noms : std

Voir aussi

Référence

basic_streambuf, classe

iostream, programmation

iostreams, conventions