std::basic_ostream<CharT,Traits>::seekp
提供: cppreference.com
< cpp | io | basic ostream
| basic_ostream& seekp( pos_type pos ); |
(1) | |
| basic_ostream& seekp( off_type off, std::ios_base::seekdir dir ); |
(2) | |
現在紐付けられている streambuf オブジェクトの出力位置指示子を設定します。
|
(実際に出力を行わないことを除いて) UnformattedOutputFunction として動作します。 sentry オブジェクトの構築および確認の後、 |
(C++11以上) |
1) rdbuf()->pubseekpos(pos, std::ios_base::out) を呼ぶことによって、絶対 (ファイルの先頭からの相対) 位置
pos に出力位置指示子を設定します。 呼び出しが (pos_type)-1 を返した場合は setstate(failbit) を実行します。2) rdbuf()->pubseekoff(off, dir, std::ios_base::out) を呼ぶことによって、
dir からの相対オフセット off に出力位置指示子を設定します。 | エラーを報告しません。 | (C++14未満) |
| 呼び出しが (pos_type)-1 を返した場合は setstate(failbit) を実行します。 | (C++14以上) |
目次 |
[編集] 引数
| pos | - | 出力位置指示子を設定する絶対位置 | ||||||||
| off | - | 出力位置指示子を設定する相対位置 | ||||||||
| dir | - | 相対オフセットを適用するベースの位置を定義します。 以下の定数のいずれかを指定できます。
|
[編集] 戻り値
*this。
[編集] 例外
2)
| rdbuf()->pubseekoff() が例外を投げない限り例外を投げません。 | (C++14未満) |
| 失敗した場合は exceptions() & failbit != 0 であれば std::ios_base::failure を投げるかもしれません。 | (C++14以上) |
[編集] 例
Run this code
#include <sstream> #include <iostream> int main() { std::ostringstream os("hello, world"); os.seekp(7); os << 'W'; os.seekp(0, std::ios_base::end); os << '!'; os.seekp(0); os << 'H'; std::cout << os.str() << '\n'; }
出力:
Hello, World!
[編集] 関連項目
| 出力位置指示子を返します (パブリックメンバ関数) | |
| 入力位置指示子を返します ( std::basic_istream<CharT,Traits>のパブリックメンバ関数)
| |
| 入力位置指示子を設定します ( std::basic_istream<CharT,Traits>のパブリックメンバ関数)
|
