Main Page   Namespace List   Class Hierarchy   Compound List   File List   Namespace Members   Compound Members  

gov::cca::PrintfPort Class Reference

UNADOPTED Standard: A just-print-it port. More...

#include <PrintfPort.h>

Inheritance diagram for gov::cca::PrintfPort:

Inheritance graph
[legend]
Collaboration diagram for gov::cca::PrintfPort:

Collaboration graph
[legend]
List of all members.

Public Methods

virtual ~PrintfPort ()
 obligatory vdtor. More...

virtual void p (char *fmt,...)=0
 Output a string on out device ... More...

virtual void p (char const *fmt,...)=0
 Output a string on out device ... More...

virtual void pn (char *fmt,...)=0
 Output a string on out device with added
...
More...


virtual void pn (const char *fmt,...)=0
 Output a string on out device with added
...
More...


virtual void e (char *fmt,...)=0
 Output a string on err device ... More...

virtual void e (const char *fmt,...)=0
 Output a string on err device ... More...

virtual void en (char *fmt,...)=0
 Output a string on err device with added
...
More...


virtual void en (const char *fmt,...)=0
 Output a string on err device with added
...
More...


virtual void l (char *fmt,...)=0
 Output a string on log device ... More...

virtual void l (const char *fmt,...)=0
 Output a string on log device ... More...

virtual void ln (char *fmt,...)=0
 Output a string on log device with added
...
More...


virtual void ln (const char *fmt,...)=0
 Output a string on log device with added
...
More...



Detailed Description

UNADOPTED Standard: A just-print-it port.

Tremendously useful.

The framework implementation of this port is very likely to do things such as direct the out, error, and log channels to files or gui windows under the covers.

These are intended for debugging and control information, not bulk data transfer. The design, or lack thereof, is to be expected from C coders hacking in c++. The clued world is invited to do better, define a cerr/cout/clog port, etc.

We contemplate 3 devices (at least for prototyping purposes)

The OUT device "p" is likely to be used to communicate back to UI's from 'special' components.

The ERROR device "e" is likely to be echoed to a user but not otherwise interpretted.

The LOG device is likely to be directed to a logging service or raw file and not seen by anybody ever.

It is good practice for components implementing this interface to return immediately (minimizing cost) if noone is listening even though the component insists on talking.

The const versions of the member functions exist to shut up the Solaris compilers.

C++ cout stream fascists should look elsewhere for a port to their liking.


Constructor & Destructor Documentation

virtual gov::cca::PrintfPort::~PrintfPort   [inline, virtual]
 

obligatory vdtor.

00044 {}


Member Function Documentation

virtual void gov::cca::PrintfPort::p char *    fmt,
...   
[pure virtual]
 

Output a string on out device ...

ala printf

virtual void gov::cca::PrintfPort::p char const *    fmt,
...   
[pure virtual]
 

Output a string on out device ...

ala printf

virtual void gov::cca::PrintfPort::pn char *    fmt,
...   
[pure virtual]
 

Output a string on out device with added
...

ala printf

virtual void gov::cca::PrintfPort::pn const char *    fmt,
...   
[pure virtual]
 

Output a string on out device with added
...

ala printf

virtual void gov::cca::PrintfPort::e char *    fmt,
...   
[pure virtual]
 

Output a string on err device ...

ala printf

virtual void gov::cca::PrintfPort::e const char *    fmt,
...   
[pure virtual]
 

Output a string on err device ...

ala printf

virtual void gov::cca::PrintfPort::en char *    fmt,
...   
[pure virtual]
 

Output a string on err device with added
...

ala printf

virtual void gov::cca::PrintfPort::en const char *    fmt,
...   
[pure virtual]
 

Output a string on err device with added
...

ala printf

virtual void gov::cca::PrintfPort::l char *    fmt,
...   
[pure virtual]
 

Output a string on log device ...

ala printf

virtual void gov::cca::PrintfPort::l const char *    fmt,
...   
[pure virtual]
 

Output a string on log device ...

ala printf

virtual void gov::cca::PrintfPort::ln char *    fmt,
...   
[pure virtual]
 

Output a string on log device with added
...

ala printf

virtual void gov::cca::PrintfPort::ln const char *    fmt,
...   
[pure virtual]
 

Output a string on log device with added
...

ala printf


The documentation for this class was generated from the following file:
Generated on Tue Aug 20 14:30:32 2002 for CCA Specification/Proposals by doxygen1.2.14 written by Dimitri van Heesch, © 1997-2002