DGD::funnel Class Reference

#include <dgFunnel.h>

Inheritance diagram for DGD::funnel:

Public Types

• typedef std::ostream Parent

Public Member Functions

• funnel (std::ostream &physical_stream)

  DGD::funnel constructor.
  
  

• funnelbuf & rdbuf ()

  Get funnelbuf of this funnel.
  
  

• virtual void header ()

  This method overloads the corresponding method in DGD::channel.
  
  

Protected Member Functions

• virtual void operator() (unsigned long line, unsigned long column, unsigned long bytes)

  funnelbuf::Callback operator.
  
  

Private Attributes

• funnelbuf m_buffer

Detailed Description

There is a good chance that DGD will produce incorrect output when there are multiple DGD::channel objects associated with the single physical stream. DGD::funnel is designed to solve the multiple association problem. The main idea is to associate your channels with a single funnel which sits on top of the physical stream. The funnel synchronizes the output of all the channels, applies its own formatting (if any) and writes the resulting mix to the physical stream.

DGD::funnel can be used as a stream counter of data passed through it. It is derived from funnelbuf::Callback and serves as a callback of self funnelbuf. The empty operator()(unsigned long, unsigned long, unsigned long) can be overridden in subclasses.

Note that DGD::funnel inherits from std::ostream, so it can't be used as a plain DGD::channel. Specifically, it can't be used for the second parameter to assoc(), but it can be used for the first one.

See also:

DGD::channel

DGD::multifile_log

Member Typedef Documentation

typedef std::ostream DGD::funnel::Parent

Constructor & Destructor Documentation

DGD::funnel::funnel (  std::ostream &  physical_stream  )

DGD::funnel constructor. Funnel can be associated with a single physical stream, this the constructor receives reference to the stream. By default, character wrapping is disabled for funnels. This can be turned on in the subclass or by using funnel::rdbuf() method. See also: channelbuf funnelbuf funnel

Member Function Documentation

funnelbuf & DGD::funnel::rdbuf (   )

Get funnelbuf of this funnel.

void DGD::funnel::header (   )  [virtual]

This method overloads the corresponding method in DGD::channel. See also: channel::header();

virtual void DGD::funnel::operator() (  unsigned long  line, unsigned long  column, unsigned long  bytes )  [inline, protected, virtual]

funnelbuf::Callback operator. Empty for simple funnel, but can be overridden in subclasses. Implements DGD::funnelbuf::Callback. Reimplemented in DGD::multifile_log.

Member Data Documentation

funnelbuf DGD::funnel::m_buffer [private]

• dgFunnel.h
• dgFunnel.cpp

Generated on Thu Aug 10 16:48:31 2006 for DGD Library by 1.3