std::basic_istream<CharT,Traits>::seekg

basic_istream& seekg( pos_type pos );

basic_istream& seekg( off_type off, std::ios_base::seekdir dir );

Устанавливает индикатор позиции ввода текущего связанного объекта streambuf.

Прежде чем выполнять какие-либо действия, seekg сбрасывает eofbit.

seekg ведёт себя как Неформатированная функция ввода, за исключением того, что gcount() не затрагивается. После создания и проверки объекта sentry

Параметры

Возвращаемое значение

*this

Исключения

failure, если произошла ошибка (флаг состояния ошибки не равен goodbit) и для этого состояния установлено exceptions().

Если внутренняя операция выбрасывает исключение, оно перехватывается и устанавливается badbit. Если для badbit установлено exceptions(), исключение выбрасывается повторно.

Примечания

seekg(n) не обязательно эквивалентно seekg(n, ios::beg). std::basic_ifstream, например, требует, чтобы абсолютная позиция n была получена из tellg().

Пример

#include <iostream>
#include <sstream>
#include <string>

int main()
{
    std::string str = "Hello, world";
    std::istringstream in(str);
    std::string word1, word2;
    
    in >> word1;
    in.seekg(0); // rewind
    in >> word2;
    
    std::cout << "word1 = " << word1 << '\n'
              << "word2 = " << word2 << '\n';
}

word1 = Hello,
word2 = Hello,

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также