std::basic_ostream<CharT,Traits>::seekp - cppreference.com (original) (raw)
| basic_ostream& seekp( pos_type pos ); | (1) | | | --------------------------------------- | --- | | | | (2) | | |
Sets the output position indicator of the current associated streambuf object.
| Behaves as UnformattedOutputFunction (except without actually performing output). After constructing and checking the sentry object, | (since C++11) |
|---|
if fail() != true, sets the output position indicator to absolute (relative to the beginning of the file) value pos by calling rdbuf()->pubseekpos(pos, std::ios_base::out). In case of failure, calls setstate(std::ios_base::failbit).
if fail() != true, sets the output position indicator to offset off relative to dir by calling rdbuf()->pubseekoff(off, dir, std::ios_base::out). In case of failure, calls setstate(std::ios_base::failbit).
[edit] Parameters
| pos | - | absolute position to set the output position indicator to |
|---|---|---|
| off | - | relative position (positive or negative) to set the output position indicator to |
| dir | - | defines base position to apply the relative offset to. It can be one of the following constants: Constant Explanation beg the beginning of a stream end the ending of a stream cur the current position of stream position indicator |
[edit] Return value
*this
[edit] Exceptions
1,2) May throw std::ios_base::failure in case of failure, if exceptions() & failbit != 0.
[edit] Example
[edit] Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 129 | C++98 | there was no way to indicate a failure | sets failbit on failure |
| LWG 136 | C++98 | seekp could set the input stream | only sets the output stream |
| LWG 537 | C++98 | 1. the type of pos was pos_type&2. the type of off was off_type& | 1. corrected to pos_type2. corrected to off_type |
| LWG 2341 | C++98 | the resolution of LWG issue 129 for overload (2) was removed | restored |
[edit] See also
| | returns the output position indicator (public member function) [edit] | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | returns the input position indicator (public member function of std::basic_istream<CharT,Traits>) [edit] | | | sets the input position indicator (public member function of std::basic_istream<CharT,Traits>) [edit] |