std::strstreambuf:: seekpos

Reposiciona std::basic_streambuf::gptr y/o std::basic_streambuf::pptr , si es posible, a la posición indicada por sp .

Si std::ios_base::in está establecido en which , intenta reposicionar gptr() (el siguiente puntero en el área de obtención). Si std::ios_base::out está establecido en which , intenta reposicionar pptr() (el siguiente puntero en el área de escritura). Si ningún bit está establecido en which , la operación falla.

Cada puntero siguiente se reposiciona de la siguiente manera:

• Si el siguiente puntero es nulo, la operación falla.
• De lo contrario, el nuevo desplazamiento newoff (de tipo off_type ) se determina llamando a sp. offset ( ) . Si newoff es negativo, está fuera de los límites del búfer o es inválido, la operación falla.
• De lo contrario, el siguiente puntero se asigna como si fuera mediante gptr ( ) = eback ( ) + newoff o pptr ( ) = pbase ( ) + newoff .

Parámetros

Valor de retorno

El desplazamiento resultante convertido a pos_type en caso de éxito o pos_type ( off_type ( - 1 ) ) en caso de fallo.

Notas

seekpos() es llamado por std::basic_streambuf::pubseekpos() , que es llamado por las versiones de un solo argumento de std::basic_istream::seekg() y std::basic_ostream::seekp() .

Ejemplo

#include <cstring>
#include <iostream>
#include <strstream>
struct mybuf : std::strstreambuf
{
    mybuf(const char* str) : std::strstreambuf(str, std::strlen(str)) {}
    pos_type seekpos(pos_type sp, std::ios_base::openmode which)
    {
        std::cout << "Before seekpos(" << sp << "), size of the get area is "
                  << egptr() - eback() << " with "
                  << egptr() - gptr() << " read positions available.\n";
        pos_type rc = std::strstreambuf::seekpos(sp, which);
        std::cout << "seekpos() returns " << rc << ".\nAfter the call, "
                  << "size of the get area is "
                  << egptr() - eback() << " with "
                  << egptr() - gptr() << " read positions available.\n";
        return rc;
    }
};
int main()
{
    mybuf buf("12345");
    std::iostream stream(&buf);
    stream.seekg(2);
}

Before seekpos(2), size of the get area is 5 with 5 read positions available.
seekpos() returns 2.
After the call, size of the get area is 5 with 3 read positions available.

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

Véase también