binary_io::any_ostream class final

Base classes

template<class StreamBase, template<class> class StreamErased>

class any_stream_base<detail::erased_ostream_base, detail::erased_ostream>

Implements the common interface of every any_stream.

template<class Derived>

class ostream_interface<any_ostream>

A CRTP utility which can be used to flesh out the interface of a given stream.

Buffering

void flush() noexcept

Flushes the underlying stream's buffers, if applicable.

Formatting

auto endian() const -> std::endian noexcept

Gets the current default endian format.

void endian(std::endian a_endian) noexcept

Sets the default endian format.

Modifiers

void emplace(Args && ... a_args)

Constructs the given underlying stream in-place, using the given arguments.

void reset() noexcept

Destroys the underlying buffer, if there is any.

Observers

auto get() -> S&

Attempts to get the underlying stream as the given type.

auto get() const -> const S&

Attempts to get the underlying stream as the given type.

auto get_if() -> S* noexcept

Attempts to get the underlying stream as the given type.

auto get_if() const -> const S* noexcept

Attempts to get the underlying stream as the given type.

auto has_value() const -> bool noexcept

Checks if there is an active underlying buffer.

Position

void seek_absolute(binary_io::streamoff a_pos) noexcept

Seek to an absolute position in the stream (i.e. from the beginning).

void seek_relative(binary_io::streamoff a_off) noexcept

Seek to a position in the stream relative to the current position.

auto tell() const -> binary_io::streamoff noexcept

Gets the current stream position.

Writing

void write(Args... a_args)

Writes the given values into the output stream.

void write(std::endian a_endian, Args... a_args)

Writes the given values into the output stream, with the given endian format.

void write_bytes(std::span<const std::byte> a_src)

Writes bytes into the given buffer.

Function documentation