Detailed Description

Structure to hold documentation data relating to a faudes-type or -function. This class is the common base for faudes::TypeDefinition and faudes::FunctionDefinition. It supports token io as demonstrated by the follwoing example for a type defintion:

<TypeDefinition name="CoreFaudes::Generator" ctype="faudes::Generator">
 
<Documentation ref="generators.html#plain"> 
    The common 5 tuple G=(Sigma, Q, delta, Qo, Qm).
<Documentation/>
 
<Keywords> "generator" "language" </Keywords>
 
</TypeDefinition>

Technical detail: Documentation is derived from Type for the purpose of token IO. We still implement the faudes type interface to make it a fully qualified faudes data type.

Technical detail: To facilitate inheritance, token io of member data and token io of the section tags is separated.

Definition at line 1334 of file cfl_types.h.

#include <cfl_types.h>

Public Member Functions
	Documentation (void)

	Documentation (const Documentation &rOther)

virtual	~Documentation (void)

void	Clear (void)

const std::string &	Name (void) const

const std::string &	PlugIn (void) const

const std::string &	CType (void) const

const std::string &	TextDoc (void) const

const std::string &	HtmlDoc (void) const

const std::string &	Keywords (void) const

std::string	MatchKeyword (const std::string &rPattern) const

int	KeywordsSize (void) const

std::string	KeywordAt (int pos) const

bool	AutoRegistered (void) const

bool	ApplicationRegistered (void) const

virtual void	MergeDocumentation (TokenReader &rTr)

Type &	operator= (const Type &rSrc)

Type &	operator= (Type &&rSrc)

bool	operator== (const Type &rOther) const

bool	operator!= (const Type &rOther) const

Public Member Functions inherited from faudes::Type
	Type (void)

	Type (const Type &rType)

virtual	~Type (void)

virtual Type *	New (void) const

virtual Type *	NewCpy (void) const

virtual const Type *	Cast (const Type *pOther) const

virtual bool	IsDefault (void) const

virtual Type &	Copy (const Type &rSrc)

virtual Type &	Move (Type &rSrc)

Type &	operator= (const Type &rSrc)

Type &	operator= (Type &&rSrc)

virtual bool	Equal (const Type &rOther) const

bool	operator== (const Type &rOther) const

bool	operator!= (const Type &rOther) const

virtual const std::string &	TypeName (void) const

void	Write (const Type *pContext=0) const

void	Write (const std::string &pFileName, const std::string &rLabel="", const Type *pContext=0, std::ios::openmode openmode=std::ios::out\|std::ios::trunc) const

void	Write (const std::string &pFileName, std::ios::openmode openmode) const

void	Write (TokenWriter &rTw, const std::string &rLabel="", const Type *pContext=0) const

virtual void	XWrite (const std::string &pFileName, const std::string &rLabel="", const Type *pContext=0) const

void	XWrite (const Type *pContext=0) const

void	XWrite (TokenWriter &rTw, const std::string &rLabel="", const Type *pContext=0) const

std::string	ToString (const std::string &rLabel="", const Type *pContext=0) const

std::string	ToText (const std::string &rLabel="", const Type *pContext=0) const

void	DWrite (const Type *pContext=0) const

void	DWrite (const std::string &pFileName, const std::string &rLabel="", const Type *pContext=0, std::ios::openmode openmode=std::ios::out\|std::ios::trunc) const

void	DWrite (TokenWriter &rTw, const std::string &rLabel="", const Type *pContext=0) const

void	SWrite (TokenWriter &rTw) const

void	SWrite (void) const

std::string	ToSText (void) const

void	Read (const std::string &rFileName, const std::string &rLabel="", const Type *pContext=0)

void	FromString (const std::string &rString, const std::string &rLabel="", const Type *pContext=0)

void	Read (TokenReader &rTr, const std::string &rLabel="", const Type *pContext=0)

Protected Member Functions
void	Name (const std::string &name)

void	PlugIn (const std::string &plugin)

void	CType (const std::string &name)

void	TextDoc (const std::string &textdoc)

void	AutoRegistered (bool flag)

void	ApplicationRegistered (bool flag)

void	HtmlDoc (const std::string &fname)

void	AddKeyword (const std::string &rKeyword)

void	DoCopy (const Documentation &rSrc)

bool	DoEqual (const Documentation &rOther) const

virtual void	DoRead (TokenReader &rTr, const std::string &rLabel="", const Type *pContext=0)

virtual void	DoReadCore (TokenReader &rTr)

virtual void	DoWrite (TokenWriter &rTw, const std::string &rLabel="", const Type *pContext=0) const

virtual void	DoWriteCore (TokenWriter &rTw) const

Protected Member Functions inherited from faudes::Type
void	DoCopy (const Type &rSrc)

void	DoMove (Type &rSrc)

bool	DoEqual (const Type &rOther) const

virtual void	DoXWrite (TokenWriter &rTw, const std::string &rLabel="", const Type *pContext=0) const

virtual void	DoDWrite (TokenWriter &rTw, const std::string &rLabel="", const Type *pContext=0) const

virtual void	DoSWrite (TokenWriter &rTw) const

virtual const TypeDefinition *	TypeDefinitionp (void) const

virtual Token	XBeginTag (const std::string &rLabel="", const std::string &rFallbackLabel="") const

Protected Attributes
std::string	mName

std::string	mPlugIn

std::string	mCType

std::string	mTextDoc

std::string	mHtmlDoc

std::string	mKeywords

bool	mAutoRegistered

bool	mApplicationRegistered

Static Protected Attributes
static const char	mDelim = ';'

Constructor & Destructor Documentation

◆ Documentation() [1/2]

faudes::Documentation::Documentation ( void )

Constructor

Definition at line 543 of file cfl_types.cpp.

◆ Documentation() [2/2]

faudes::Documentation::Documentation ( const Documentation & rOther )

Copy constructor

Definition at line 549 of file cfl_types.cpp.

◆ ~Documentation()

virtual faudes::Documentation::~Documentation ( void )

inlinevirtual

Destructor

Definition at line 1353 of file cfl_types.h.

Member Function Documentation

◆ AddKeyword()

void faudes::Documentation::AddKeyword ( const std::string & rKeyword )

protected

Append keyword.

Parameters

rKeyword Keyword

Definition at line 608 of file cfl_types.cpp.

◆ ApplicationRegistered() [1/2]

void faudes::Documentation::ApplicationRegistered ( bool flag )

protected

Set application-registered flag.

◆ ApplicationRegistered() [2/2]

bool faudes::Documentation::ApplicationRegistered ( void ) const

Get application-registered flag.

Returns: True <> registered by application

Definition at line 596 of file cfl_types.cpp.

◆ AutoRegistered() [1/2]

void faudes::Documentation::AutoRegistered ( bool flag )

protected

Set auto-register flag.

◆ AutoRegistered() [2/2]

bool faudes::Documentation::AutoRegistered ( void ) const

Get auto-register flag.

This flag indicated that the respective type was (will be) registered by a libFAUDES static initialisation protorype.

Returns: True <> C++-automatic-registration

Definition at line 595 of file cfl_types.cpp.

◆ Clear()

void faudes::Documentation::Clear ( void )

virtual

Clear

Reimplemented from faudes::Type.

Reimplemented in faudes::LuaFunctionDefinition, faudes::FunctionDefinition, and faudes::TypeDefinition.

Definition at line 577 of file cfl_types.cpp.

◆ CType() [1/2]

void faudes::Documentation::CType ( const std::string & name )

protected

Set C++ type

Parameters

name	New ctype.

Definition at line 601 of file cfl_types.cpp.

◆ CType() [2/2]

const std::string & faudes::Documentation::CType ( void ) const

Get corresponding C++ type

Returns: CType, or "" if no such

Definition at line 591 of file cfl_types.cpp.

◆ DoCopy()

void faudes::Documentation::DoCopy ( const Documentation & rSrc )

protected

Std faudes type interface: assignment.

Parameters

rSrc	Source to copy from

Definition at line 554 of file cfl_types.cpp.

◆ DoEqual()

bool faudes::Documentation::DoEqual ( const Documentation & rOther ) const

protected

Std faudes type interface: test equality

Parameters

rOther Other object to compare with.

Returns: True on match.

Definition at line 566 of file cfl_types.cpp.

◆ DoRead()

void faudes::Documentation::DoRead	(	TokenReader &	rTr,
		const std::string &	rLabel = `""`,
		const Type *	pContext = `0`
	)

protectedvirtual

Read configuration data of this object from TokenReader.

This virtual function reads documentation from a token stream. The section defaults to Documentation. It invokes DoReadCore to do the member data token reading.

Parameters

rTr	TokenReader to read from
rLabel	Section to read
pContext	Read context to provide contextual information (ignored)

Exceptions

Exception

Token mismatch (id 50, 51, 52)
IO Error (id 1)

Reimplemented from faudes::Type.

Reimplemented in faudes::LuaFunctionDefinition, faudes::FunctionDefinition, and faudes::TypeDefinition.

Definition at line 706 of file cfl_types.cpp.

◆ DoReadCore()

void faudes::Documentation::DoReadCore ( TokenReader & rTr )

protectedvirtual

Read configuration data of this object from TokenReader.

This virtual function reads documentation member data only. It does NOT read the enclosing begin and end tokens.

Parameters

rTr	TokenReader to read from

Exceptions

Exception

Token mismatch (id 50, 51, 52)
IO Error (id 1)

Reimplemented in faudes::LuaFunctionDefinition, faudes::FunctionDefinition, and faudes::TypeDefinition.

Definition at line 757 of file cfl_types.cpp.

◆ DoWrite()

void faudes::Documentation::DoWrite	(	TokenWriter &	rTw,
		const std::string &	rLabel = `""`,
		const Type *	pContext = `0`
	)		const

protectedvirtual

Write configuration data of this object to TokenWriter.

This virtual function writes documentation to a token stream. The section defaults to Documentation. It invokes DoWriteCore to do the actual member data writing.

Parameters

rTw	Reference to TokenWriter
rLabel	Label of section to write
pContext	Write context to provide contextual information

Exceptions

Exception

IO errors (id 2)

Reimplemented from faudes::Type.

Reimplemented in faudes::LuaFunctionDefinition, faudes::FunctionDefinition, and faudes::TypeDefinition.

Definition at line 835 of file cfl_types.cpp.

◆ DoWriteCore()

void faudes::Documentation::DoWriteCore ( TokenWriter & rTw ) const

protectedvirtual

Write configuration data of this object to TokenWriter.

This virtual function reads documentation members only. It does NOT write enclosing begin and end tokens.

Parameters

rTw	Reference to TokenWriter

Exceptions

Exception

IO errors (id 2)

Reimplemented in faudes::LuaFunctionDefinition, faudes::FunctionDefinition, and faudes::TypeDefinition.

Definition at line 860 of file cfl_types.cpp.

◆ HtmlDoc() [1/2]

void faudes::Documentation::HtmlDoc ( const std::string & fname )

protected

Set name of file pointing to the html documentation.

Parameters

fname Filename

Definition at line 603 of file cfl_types.cpp.

◆ HtmlDoc() [2/2]

const std::string & faudes::Documentation::HtmlDoc ( void ) const

Returns: Filename pointing to the html documentation.

Definition at line 593 of file cfl_types.cpp.

◆ KeywordAt()

std::string faudes::Documentation::KeywordAt ( int pos ) const

Parameters

pos	Position of keyword

Returns: Keyword at specified position (or "" if pos out of range)

Definition at line 645 of file cfl_types.cpp.

◆ Keywords()

const std::string & faudes::Documentation::Keywords ( void ) const

Returns: CSV-string containing keywords.

Definition at line 594 of file cfl_types.cpp.

◆ KeywordsSize()

int faudes::Documentation::KeywordsSize ( void ) const

Not implemented

Returns: Number of keywords.

Definition at line 669 of file cfl_types.cpp.

◆ MatchKeyword()

std::string faudes::Documentation::MatchKeyword ( const std::string & rPattern ) const

Search comma-seperated keywords for a substring. This should be extended to regular expressions in a future release.

Parameters

rPattern String-pattern.

Returns: Matching keyword or "" if no match

Definition at line 618 of file cfl_types.cpp.

◆ MergeDocumentation()

void faudes::Documentation::MergeDocumentation ( TokenReader & rTr )

virtual

Merge documentation from token stream. An exception is thrown if the current type name differs from the one in the documentation.

Parameters

rTr	TokenReader to read from.

Exceptions

Exception

Type mismatch (id )
Token mismatch (id 50, 51, 52)
IO Error (id 1)

Definition at line 684 of file cfl_types.cpp.

◆ Name() [1/2]

void faudes::Documentation::Name ( const std::string & name )

protectedvirtual

Set name.

Parameters

name New name.

Reimplemented from faudes::Type.

Definition at line 599 of file cfl_types.cpp.

◆ Name() [2/2]

const std::string & faudes::Documentation::Name ( void ) const

virtual

Get name of the entity to document (aka faudes-type or faudes-function).

Returns: Name

Reimplemented from faudes::Type.

Definition at line 589 of file cfl_types.cpp.

◆ operator!=()

bool faudes::Type::operator!= ( const Type & rOther ) const

Test equality of configuration data. See operator==(const Type&).

This operator calls DoEqual(). Re-implementation can be done via the convenience macros FAUDES_TYPE_DECLARATION and FAUDES_TYPE_IMPLEMENTATION.

Parameters

rOther Other objevt to compare with.

Returns: True on mismatch.

Definition at line 434 of file cfl_types.cpp.

◆ operator=() [1/2]

Type & faudes::Type::operator= ( const Type & rSrc )

Copy configuration data from other object. Derived classes should implement at least the signature with matching source and destination types via the DoCopy method. Additionally, one may implement variants with a base class as source, as mong as meaningul assigment is possible.

Re-implementation can be done via the convenience macros FAUDES_TYPE_DECLARATION and FAUDES_TYPE_IMPLEMENTATION.

Parameters

rSrc	Source to copy from

Returns: Reference to this object.

Definition at line 368 of file cfl_types.cpp.

◆ operator=() [2/2]

Type & faudes::Type::operator= ( Type && rSrc )

Copy configuration data from other object (destructive) Derived classes should implement at least the signature with matching source and destination types via the DoCopy method. Additionally, one may implement variants with a base class as source, as mong as meaningul assigment is possible.

Re-implementation can be done via the convenience macros FAUDES_TYPE_DECLARATION and FAUDES_TYPE_IMPLEMENTATION.

Parameters

rSrc	Source to copy from

Returns: Reference to this object.

Definition at line 383 of file cfl_types.cpp.

◆ operator==()

bool faudes::Type::operator== ( const Type & rOther ) const

Test equality of configuration data. The operator form of the equality test is only defined for matching types, no cast will be performed. Thus, the test will be optimistic if the type is not known at compiletime. The object name or id is not considered in the test.

This operator calls DoEqual(). Re-implementation can be done via the convenience macros FAUDES_TYPE_DECLARATION and FAUDES_TYPE_IMPLEMENTATION.

Parameters

rOther Other object to compare with.

Returns: True on match.

Definition at line 418 of file cfl_types.cpp.

◆ PlugIn() [1/2]

void faudes::Documentation::PlugIn ( const std::string & plugin )

protected

Set name of plugin

Parameters

plugin New name.

Definition at line 600 of file cfl_types.cpp.

◆ PlugIn() [2/2]

const std::string & faudes::Documentation::PlugIn ( void ) const

Get name of plugin. The plugin name defaults to CoreFaudes.

Returns: Name

Definition at line 590 of file cfl_types.cpp.

◆ TextDoc() [1/2]

void faudes::Documentation::TextDoc ( const std::string & textdoc )

protected

Set a short textual documentation.

Parameters

textdoc New textual documentation.

Definition at line 602 of file cfl_types.cpp.

◆ TextDoc() [2/2]

const std::string & faudes::Documentation::TextDoc ( void ) const

Returns: Short textual documentation.

Definition at line 592 of file cfl_types.cpp.

Member Data Documentation

◆ mApplicationRegistered

bool faudes::Documentation::mApplicationRegistered

protected

Flag to indicate application registration

Definition at line 1650 of file cfl_types.h.

◆ mAutoRegistered

bool faudes::Documentation::mAutoRegistered

protected

Flag to indicate automated registration

Definition at line 1647 of file cfl_types.h.

◆ mCType

std::string faudes::Documentation::mCType

protected

Corresponing C++ type, or "" if no such.

Definition at line 1632 of file cfl_types.h.

◆ mDelim

const char faudes::Documentation::mDelim = ';'

staticprotected

Constant characted used to seperate keywords

Definition at line 1644 of file cfl_types.h.

◆ mHtmlDoc

std::string faudes::Documentation::mHtmlDoc

protected

String containing the filename of the corresponding html-documentation.

Definition at line 1638 of file cfl_types.h.

◆ mKeywords

std::string faudes::Documentation::mKeywords

protected

Comma-seperated string containing all keywords.

Definition at line 1641 of file cfl_types.h.

◆ mName

std::string faudes::Documentation::mName

protected

Faudes name.

Definition at line 1626 of file cfl_types.h.

◆ mPlugIn

std::string faudes::Documentation::mPlugIn

protected

Faudes plugin.

Definition at line 1629 of file cfl_types.h.

◆ mTextDoc

std::string faudes::Documentation::mTextDoc

protected

String containing the text-documentation.

Definition at line 1635 of file cfl_types.h.

The documentation for this class was generated from the following files:

Detailed Description

Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Constructor & Destructor Documentation

◆ Documentation() [1/2]

◆ Documentation() [2/2]

◆ ~Documentation()

Member Function Documentation

◆ AddKeyword()

◆ ApplicationRegistered() [1/2]

◆ ApplicationRegistered() [2/2]

◆ AutoRegistered() [1/2]

◆ AutoRegistered() [2/2]

◆ Clear()

◆ CType() [1/2]

◆ CType() [2/2]

◆ DoCopy()

◆ DoEqual()

◆ DoRead()

◆ DoReadCore()

◆ DoWrite()

◆ DoWriteCore()

◆ HtmlDoc() [1/2]

◆ HtmlDoc() [2/2]

◆ KeywordAt()

◆ Keywords()

◆ KeywordsSize()

◆ MatchKeyword()

◆ MergeDocumentation()

◆ Name() [1/2]

◆ Name() [2/2]

◆ operator!=()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator==()

◆ PlugIn() [1/2]

◆ PlugIn() [2/2]

◆ TextDoc() [1/2]

◆ TextDoc() [2/2]

Member Data Documentation

◆ mApplicationRegistered

◆ mAutoRegistered

◆ mCType

◆ mDelim

◆ mHtmlDoc

◆ mKeywords

◆ mName

◆ mPlugIn

◆ mTextDoc