#include <bdlsb_overflowmemoutput.h>
List of all members.
Detailed Description
This class, like bdlsb::OverflowMemOutStreamBuf, implements the output functionality of the bsl::basic_streambuf interface, using a client-supplied buffer and allocator-supplied overflow buffer if additional memory is needed. It has an interface similar to bdlsb::OverflowMemOutStreamBuf but does not inherit from bsl::streambuf. Thus, it is suitable for use as template parameter to bslx::GenericByteOutStream (but not to bslx::ByteOutStream or bslx::ByteOutStreamFormatter). Note that this class is not designed to be derived from.
See Component bdlsb_overflowmemoutput
Member Typedef Documentation
Constructor & Destructor Documentation
| bdlsb::OverflowMemOutput::OverflowMemOutput |
( |
char * |
buffer, |
|
|
bsl::size_t |
length, |
|
|
bslma::Allocator * |
basicAllocator = 0 | |
|
) |
| | |
Create an OverflowMemOutput using the specified buffer of the specified length as the initial output buffer. Optionally specify a basicAllocator used to supply memory. If basicAllocator is 0, the currently installed default allocator is used. The behavior is undefined unless buffer != 0 && length > 0. Note that this stream buffer does not assume ownership of buffer.
| bdlsb::OverflowMemOutput::~OverflowMemOutput |
( |
|
) |
|
Destroy this stream buffer.
Member Function Documentation
| pos_type bdlsb::OverflowMemOutput::pubseekoff |
( |
off_type |
offset, |
|
|
bsl::ios_base::seekdir |
way, |
|
|
bsl::ios_base::openmode |
which = bsl::ios_base::out | |
|
) |
| | |
Set the position indicator to the relative specified offset from the base position indicated by the specified way and return the resulting absolute position on success or pos_type(-1) on failure. Optionally specify which area of the stream buffer. The seek operation will fail if which does not include the flag bsl::ios_base::out or if the resulting absolute position is less than zero.
| pos_type bdlsb::OverflowMemOutput::pubseekpos |
( |
pos_type |
position, |
|
|
bsl::ios_base::openmode |
which = bsl::ios_base::out | |
|
) |
| | |
Set the position indicator to the specified position and return the resulting absolute position on success or pos_type(-1) on failure. Optionally specify which area of the stream buffer. The seekpos operation will fail if which does not include the flag bsl::ios_base::out or if position is less then zero.
| OverflowMemOutput* bdlsb::OverflowMemOutput::pubsetbuf |
( |
char * |
buffer, |
|
|
bsl::streamsize |
length | |
|
) |
| | |
Reinitialize this stream buffer to use the specified character buffer having the specified length. Return a pointer providing modifiable access to this stream buffer. This stream buffer does not support reinitialization of the internal character buffer.
| int bdlsb::OverflowMemOutput::pubsync |
( |
|
) |
|
Synchronize this stream buffer with associated character sequence. Operation has no effect. Return 0 unconditionally.
| int_type bdlsb::OverflowMemOutput::sputc |
( |
char |
c |
) |
|
Write the specified character c at the current write position and advance write position of this buffer. Return c, or traits_type::eof() if the end of the write buffer is reached.
| bsl::streamsize bdlsb::OverflowMemOutput::sputn |
( |
const char * |
source, |
|
|
bsl::streamsize |
length | |
|
) |
| | |
Write the specified length characters from the specified source to this buffer. Return the number of characters written, which is either length or the distance from the current write position to the end of the write buffer, whichever is smaller, and move the write cursor position by this amount. The behaviour is undefined unless source != 0 || length > 0.
| bsl::size_t bdlsb::OverflowMemOutput::dataLength |
( |
|
) |
const |
Return the number of bytes that have been written to this object.
| bsl::size_t bdlsb::OverflowMemOutput::dataLengthInInitialBuffer |
( |
|
) |
const |
| bsl::size_t bdlsb::OverflowMemOutput::dataLengthInOverflowBuffer |
( |
|
) |
const |
| const char* bdlsb::OverflowMemOutput::initialBuffer |
( |
|
) |
const |
Return a pointer providing non-modifiable access to the character buffer held by this stream buffer (specified at construction).
| bsl::size_t bdlsb::OverflowMemOutput::initialBufferSize |
( |
|
) |
const |
Return the size of the initial buffer held by this stream buffer.
| const char* bdlsb::OverflowMemOutput::overflowBuffer |
( |
|
) |
const |
Return a pointer providing non-modifiable access to the overflow buffer if there is one, or 0 otherwise.
| bsl::size_t bdlsb::OverflowMemOutput::overflowBufferSize |
( |
|
) |
const |
Return the size of the overflow buffer, or 0 if there is no overflow buffer.
The documentation for this class was generated from the following file:
