Scroll to navigation

std::basic_streambuf::pubseekoff,(3) C++ Standard Libary std::basic_streambuf::pubseekoff,(3)

NAME

std::basic_streambuf::pubseekoff, - std::basic_streambuf::pubseekoff,

Synopsis


pos_type pubseekoff( off_type off, std::ios_base::seekdir dir,
std::ios_base::openmode which = ios_base::in | (1)
ios_base::out );
protected:


virtual pos_type seekoff( off_type off, std::ios_base::seekdir dir, (2)


std::ios_base::openmode which = ios_base::in |
ios_base::out );


Sets the position indicator of the input and/or output sequence relative to some
other position.


1) Calls seekoff(off, dir, which) of the most derived class.
2) The base class version of this function has no effect. The derived classes may
override this function to allow relative positioning of the position indicator.

Parameters


off - relative position to set the position indicator to.
defines base position to apply the relative offset to. It can be one of the
following constants:


dir - Constant Explanation
beg the beginning of a stream
end the ending of a stream
cur the current position of stream position indicator
defines which of the input and/or output sequences to affect. It can be one
or a combination of the following constants:
which -
Constant Explanation
in affect the input sequence
out affect the output sequence

Note


Not all combinations of parameters may be valid, see the derived versions of seekoff
for details.

Return value


1) The return value of seekoff(off, dir, which)
2) The resulting absolute position as defined by the position indicator. The base
class version returns pos_type(off_type(-1)).

Example


This section is incomplete
Reason: no example


Defect reports


The following behavior-changing defect reports were applied retroactively to
previously published C++ standards.


DR Applied to Behavior as published Correct behavior
the base class version of seekoff
LWG 55 C++98 returned returns pos_type(off_type(-1))
an undefined invalid stream
position

See also


pubseekpos invokes seekpos()
(public member function)
seekoff repositions the file position, using relative addressing
[virtual] (virtual protected member function of std::basic_filebuf<CharT,Traits>)


repositions the next pointer in the input sequence, output sequence, or
seekoff both, using relative addressing
[virtual] (virtual protected member function of
std::basic_stringbuf<CharT,Traits,Allocator>)
seekoff repositions the next pointer in the input sequence, output sequence, or
[virtual] both, using relative addressing
(virtual protected member function of std::strstreambuf)

Category:


* Todo no example

2024.06.10 http://cppreference.com