- ostream[meta header]
- std[meta namespace]
- basic_ostream[meta class]
- function[meta id-type]
basic_ostream<CharT, Traits>& seekp(pos_type pos); // (1)
basic_ostream<CharT, Traits>& seekp(off_type off, seekdir dir); // (2)ストリームバッファに対し、書き込み位置の移動を指示する。
seekpは、seek putの略称。「書き込み用の位置の移動」を意味する。
- (1) 出力ストリームの書き込み位置を
posに設定する。 - (2) 出力ストリームの書き込み位置を
dirを基準として相対位置offに設定する。
*this
本関数の処理内容は以下の通り。
sentryオブジェクトを構築する（C++11 以降のみ）。- 与えられた実引数により、以下のいずれかを実行する。
- (1)
rdbuf()->pubseekpos(pos, ios_base::out) - (2)
rdbuf()->pubseekoff(off, dir, ios_base::out)
- (1)
- 処理に失敗した場合（上記の戻り値が
-1だった場合）、setstate(failbit)を呼び出す。
以下は、off_type と seekdir を使用する例。
pos_type のみを引数に取るオーバーロードの例は、tellp を参照。
#include <iostream>
#include <sstream>
int main() {
std::ostringstream os;
os << "12345";
os.seekp(-2, std::ios_base::cur);
os << "ABC";
std::cout << os.str() << std::endl;
}- std::ostringstream[link ../../sstream/basic_ostringstream.md]
- seekp[color ff0000]
- str()[link ../../sstream/basic_ostringstream/str.md]
123ABC
basic_ostream<CharT, Traits>& seekp(pos_type pos) {
sentry s(*this);
if (!this->fail()) {
if (this->rdbuf()->pubseekpos(pos, ios_base::out) == pos_type(-1)) {
this->setstate(failbit);
}
}
return *this;
}
basic_ostream<CharT, Traits>& seekp(off_type off, seekdir dir) {
sentry s(*this);
if (!this->fail()) {
if (this->rdbuf()->pubseekoff(off, dir, ios_base::out) == pos_type(-1)) {
this->setstate(failbit);
}
}
return *this;
}- sentry[link sentry.md]
- fail[link ../../ios/basic_ios/fail.md]
- rdbuf[link ../../ios/basic_ios/rdbuf.md]
- pubseekpos[link ../../streambuf/basic_streambuf/pubseekpos.md]
- pubseekoff[link ../../streambuf/basic_streambuf/pubseekoff.md]
- setstate[link ../../ios/basic_ios/setstate.md]
- C++98