basis::text_formable Class Reference

A base class for objects that can provide a synopsis of their current state. More...

#include <contracts.h>

Inheritance diagram for basis::text_formable:
Inheritance graph
[legend]
Collaboration diagram for basis::text_formable:
Collaboration graph
[legend]

List of all members.

Public Member Functions

virtual const char * class_name () const =0
 Returns the bare name of this class as a constant character pointer.
virtual void text_form (base_string &state_fill) const =0
 Provides a text view of all the important info owned by this object.

Detailed Description

A base class for objects that can provide a synopsis of their current state.

This helps a lot during debugging and possibly even during normal runtime, since it causes the object to divulge its internal state for viewing in hopefully readable text.

Definition at line 141 of file contracts.h.


Member Function Documentation

virtual const char* basis::text_formable::class_name (  )  const [pure virtual]

Returns the bare name of this class as a constant character pointer.

The name returned here is supposed to be just a class name and not provide any more information than that. It is especially important not to add any syntactic elements like '::' to the name, since a bare alphanumeric name is expected.

Implements basis::nameable.

Referenced by octopi::infoton::set_classifier(), octopi::security_infoton::text_form(), octopi::file_transfer_infoton::text_form(), octopi::encryption_wrapper::text_form(), octopi::encryption_infoton::text_form(), filesystem::file_time::text_form(), and manifest_chunk::text_form().

virtual void basis::text_formable::text_form ( base_string state_fill  )  const [pure virtual]

Provides a text view of all the important info owned by this object.

It is understood that there could be a large amount of information and that this function might take a relatively long time to complete.

Implemented in manifest_chunk, basis::astring, filesystem::file_time, processes::letter, processes::OS_event, processes::process_entry, structures::string_table, timely::time_locus, octopi::octopus_entity, octopi::identity_infoton, octopi::infoton, octopi::unhandled_request, octopi::encryption_infoton, octopi::encryption_wrapper, octopi::file_transfer_infoton, and octopi::security_infoton.


The documentation for this class was generated from the following file:
Generated on Sat Jan 28 04:25:24 2012 for hoople2 project by  doxygen 1.6.3