Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for an old version of boost. Click here for the latest Boost documentation.
PrevUpHomeNext

Class template basic_text_ostream_backend

boost::log::sinks::basic_text_ostream_backend — An implementation of a text output stream logging sink backend.

Synopsis

// In header: <boost/log/sinks/text_ostream_backend.hpp>

template<typename CharT> 
class basic_text_ostream_backend : public basic_formatted_sink_backend< CharT, combine_requirements< synchronized_feeding, flushing >::type >
{
public:
  // types
  typedef base_type::char_type            char_type;    // Character type. 
  typedef base_type::string_type          string_type;  // String type to be used as a message text holder. 
  typedef std::basic_ostream< char_type > stream_type;  // Output stream type. 

  // construct/copy/destruct
  basic_text_ostream_backend();
  ~basic_text_ostream_backend();

  // public member functions
  void add_stream(shared_ptr< stream_type > const &);
  void remove_stream(shared_ptr< stream_type > const &);
  void auto_flush(bool = true);
  void consume(record_view const &, string_type const &);
  void flush();
};

Description

The sink backend puts formatted log records to one or more text streams.

basic_text_ostream_backend public construct/copy/destruct

  1. basic_text_ostream_backend();

    Constructor. No streams attached to the constructed backend, auto flush feature disabled.

  2. ~basic_text_ostream_backend();

    Destructor

basic_text_ostream_backend public member functions

  1. void add_stream(shared_ptr< stream_type > const & strm);

    The method adds a new stream to the sink.

    Parameters:

    strm

    Pointer to the stream. Must not be NULL.

  2. void remove_stream(shared_ptr< stream_type > const & strm);

    The method removes a stream from the sink. If the stream is not attached to the sink, the method has no effect.

    Parameters:

    strm

    Pointer to the stream. Must not be NULL.

  3. void auto_flush(bool f = true);

    Sets the flag to automatically flush buffers of all attached streams after each log record

  4. void consume(record_view const & rec, string_type const & formatted_message);

    The method writes the message to the sink

  5. void flush();

    The method flushes the associated streams


PrevUpHomeNext