std::basic_streambuf<CharT,Traits>::pubseekpos, std::basic_streambuf<CharT,Traits>::seekpos

pos_type pubseekpos( pos_type pos,
                     std::ios_base::openmode which = std::ios_base::in | std::ios_base::out );

(1)

protected:
virtual pos_type seekpos( pos_type pos,
                          std::ios_base::openmode which = std::ios_base::in | std::ios_base::out );

(2)

Устанавливает указатель позиции входной и/или выходной последовательности в абсолютную позицию.

1) Вызывает seekpos(pos, which) наиболее производного класса.

2) Версия этой функции в базовом классе не имеет эффекта. Производные классы могут переопределить эту функцию, чтобы разрешить абсолютное позиционирование указателя позиции.

Параметры

pos - абсолютная позиция для установки указателя позиции

which

определяет, какую из входной и/или выходной последовательностей затронуть. Может быть одной или комбинацией следующих констант:

Константа	Описание
`in`	влияет на входную последовательность
`out`	влияет на выходную последовательность

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

1) Возвращаемое значение seekpos(pos, which).

2) Результирующая абсолютная позиция, как определено указателем позиции. Версия базового класса возвращает pos_type(off_type(-1)).

Пример

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

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

DR	Применимо к	Поведение, как опубликовано	Правильное поведение
LWG 55	C++98	версия базового класса `seekpos` возвращала неопределённую недопустимую позицию потока	возвращает `pos_type(off_type(-1))`

См. также

pubseekoff	вызывает `seekoff()` (публичный член-функция)
seekpos [virtual]	перемещает позицию файла, используя абсолютную адресацию (виртуальная защищённая член-функция `std::basic_filebuf<CharT,Traits>`)
seekpos [virtual]	перемещает указатель следующего символа в последовательности ввода, последовательности вывода или в обеих, используя абсолютную адресацию (виртуальная защищённая член-функция `std::basic_stringbuf<CharT,Traits,Allocator>`)
seekpos [virtual]	перемещает указатель следующего символа в последовательности ввода, последовательности вывода или в обеих, используя абсолютную адресацию (виртуальная защищённая член-функция `std::strstreambuf`)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/io/basic_streambuf/pubseekpos