...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
boost::interprocess::basic_vectorstream
// In header: <boost/interprocess/streams/vectorstream.hpp> template<typename CharVector, typename CharTraits> class basic_vectorstream : public std::basic_iostream< CharVector::value_type, CharTraits > { public: // types typedef CharVector vector_type; typedef std::basic_ios< typename CharVector::value_type, CharTraits >::char_type char_type; typedef std::basic_ios< char_type, CharTraits >::int_type int_type; typedef std::basic_ios< char_type, CharTraits >::pos_type pos_type; typedef std::basic_ios< char_type, CharTraits >::off_type off_type; typedef std::basic_ios< char_type, CharTraits >::traits_type traits_type; // construct/copy/destruct basic_vectorstream(std::ios_base::openmode = std::ios_base::in|std::ios_base::out); template<typename VectorParameter> basic_vectorstream(const VectorParameter &, std::ios_base::openmode = std::ios_base::in|std::ios_base::out); // public member functions basic_vectorbuf< CharVector, CharTraits > * rdbuf() const; void swap_vector(vector_type &); const vector_type & vector() const; void reserve(typename vector_type::size_type); void clear(); };
A basic_iostream class that holds a character vector specified by CharVector template parameter as its formatting buffer. The vector must have contiguous storage, like std::vector, boost::interprocess::vector or boost::interprocess::basic_string
basic_vectorstream
public
construct/copy/destructbasic_vectorstream(std::ios_base::openmode mode = std::ios_base::in|std::ios_base::out);
Constructor. Throws if vector_type default constructor throws.
template<typename VectorParameter> basic_vectorstream(const VectorParameter & param, std::ios_base::openmode mode = std::ios_base::in|std::ios_base::out);
Constructor. Throws if vector_type(const VectorParameter ¶m) throws.
basic_vectorstream
public member functionsbasic_vectorbuf< CharVector, CharTraits > * rdbuf() const;
void swap_vector(vector_type & vect);
Swaps the underlying vector with the passed vector. This function resets the read/write position in the stream. Does not throw.
const vector_type & vector() const;
Returns a const reference to the internal vector. Does not throw.
void reserve(typename vector_type::size_type size);
Calls reserve() method of the internal vector. Resets the stream to the first position. Throws if the internals vector's reserve throws.
void clear();
Calls clear() method of the internal vector. Resets the stream to the first position.