Share via


basic_stringbuf::seekoff

La función virtual protegida de miembro intenta modificar los cargos actuales para las secuencias controladas.

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

Parámetros

  • _Off
    La posición a buscar _Wayen relación con.Para obtener más información, vea basic_stringbuf::off_type.

  • _Way
    El punto inicial para las operaciones de desplazamiento.Vea ios_base::seekdir por valores posibles.

  • _Mode
    Especifica el modo de la posición del puntero.El valor predeterminado es permitir modificar las posiciones de lectura y escritura.Para obtener más información, vea ios_base::openmode.

Valor devuelto

Devuelve la nueva posición o una posición no válida de la secuencia.

Comentarios

Para un objeto de clase basic_stringbuf<Elem, Tr, Alloc>, una posición de la secuencia consta pensar en un desplazamiento de la secuencia.El desplazamiento cero designa el primer elemento de la secuencia controlada.

se determina la nueva posición como sigue:

  • Si == ios_base::begde _Way , la nueva posición es el principio de la secuencia más _Off.

  • Si == ios_base::curde _Way , la nueva posición es la secuencia actual colocar más _Off.

  • Si == ios_base::endde _Way , la nueva posición es el final de la secuencia más _Off.

Si _Mode & ios_base::in es cero, la función modifica la posición siguiente para leer en el búfer de entrada.Si _Mode & ios_base::out es cero, la función modifica la posición siguiente para escribir en el búfer de salida.Para que una secuencia resulta afectada, su búfer debe existir.Para que una operación de posición termina correctamente, la posición resultante de la secuencia debe mentir dentro de la secuencia controlada.Si la función afecta a ambas posiciones de la secuencia, _Way debe ser ios_base::beg o ios_base::end y las dos secuencias se colocan en el mismo elemento.Si no (o si ninguna de las dos posiciones es afectadas), la operación de posición falla.

Si la función tiene éxito en modificar o ambas posiciones de la secuencia, devuelve la posición resultante de la secuencia.Si no, se produce un error y devuelve una posición no válida de la secuencia.

Requisitos

encabezado: <sstream>

espacio de nombres: std

Vea también

Referencia

basic_stringbuf Class

programación iostream

convenciones de iostreams