templateengine Class Reference

#include <templateengine.h>

Inherits object.

Public Member Functions
	templateengine ()
virtual	~templateengine ()
void	setVariableStart (const char *delimiter)
void	setVariableEnd (const char *delimiter)
void	setQuotedVariableStart (const char *delimiter)
void	setQuotedVariableEnd (const char *delimiter)
void	setDoubleQuotedVariableStart (const char *delimiter)
void	setDoubleQuotedVariableEnd (const char *delimiter)
void	setEscapeCharacter (char esc)
void	setBlockStartStart (const char *delimiter)
void	setBlockStartEnd (const char *delimiter)
void	setBlockEndStart (const char *delimiter)
void	setBlockEndEnd (const char *delimiter)
void	setIncludeStart (const char *delimiter)
void	setIncludeEnd (const char *delimiter)
const char *	getVariableStart ()
const char *	getVariableEnd ()
const char *	getQuotedVariableStart ()
const char *	getQuotedVariableEnd ()
const char *	getDoubleQuotedVariableStart ()
const char *	getDoubleQuotedVariableEnd ()
char	getEscapeCharacter ()
const char *	getBlockStartStart ()
const char *	getBlockStartEnd ()
const char *	getBlockEndStart ()
const char *	getBlockEndEnd ()
const char *	getIncludeStart ()
const char *	getIncludeEnd ()
bool	parse (output *out, const char *filename, fileparser *fileparsers, dictionary< const char *, const char * > *vars)
bool	parse (output *out, const char *filename, blockparser *blockparsers, dictionary< const char *, const char * > *vars)
bool	parse (output *out, const char *block, uint64_t blocklength, blockparser *blockparsers, dictionary< const char *, const char * > *vars)
const char *	getError ()
Public Member Functions inherited from object
virtual	~object ()

Detailed Description

The templateengine class provides a framework for registering user-defined methods to parse and perform replacements in marked-up files or strings.

Constructor & Destructor Documentation

templateengine()

templateengine::templateengine

(

)

Creates an instance of the templateengine class.

~templateengine()

virtual templateengine::~templateengine ( )

virtual

Deletes this instance of the templateengine class.

Member Function Documentation

getBlockEndEnd()

const char * templateengine::getBlockEndEnd

(

)

Returns the delimiter that the parse() methods look for at the end of a block-end.

The default is " -->".

For example, by defaults, blocks are delimited like:

... block ...

getBlockEndStart()

const char * templateengine::getBlockEndStart

(

)

Returns the delimiter that the parse() methods look for at the beginning of a block-end.

The default is "<!-- end ".

For example, by defaults, blocks are delimited like:

... block ...

getBlockStartEnd()

const char * templateengine::getBlockStartEnd

(

)

Returns the delimiter that the parse() methods look for at the end of a block-start.

The default is " -->".

For example, by defaults, blocks are delimited like:

... block ...

getBlockStartStart()

const char * templateengine::getBlockStartStart

(

)

Returns the delimiter that the parse() methods look for at beginning of a block-start.

The default is "<!-- start ".

For example, by defaults, blocks are delimited like:

... block ...

getDoubleQuotedVariableEnd()

const char * templateengine::getDoubleQuotedVariableEnd

(

)

Returns the delimiter that the parse() methods look for at the end of a variable whos value's double-quotes shall be escaped.

The default is ")".

For example, by defaults, variables are delimited like:

getDoubleQuotedVariableStart()

const char * templateengine::getDoubleQuotedVariableStart

(

)

Returns the delimiter that the parse() methods look for at the beginning of a variable whos value's double-quotes shall be escaped.

The default is "$dq(".

For example, by defaults, variables are delimited like:

getError()

const char * templateengine::getError

(

)

Returns the error that occurred if a parse() method returned false.

getEscapeCharacter()

char templateengine::getEscapeCharacter

(

)

Returns the escape character. Defaults to backslash.

getIncludeEnd()

const char * templateengine::getIncludeEnd

(

)

Returns the delimiter that the parse() methods look for at the end of an include.

The default is " -->".

For example, by defaults, blocks are delimited like:

getIncludeStart()

const char * templateengine::getIncludeStart

(

)

Returns the delimiter that the parse() methods look for at the beginning of an include.

The default is "<!-- include ".

For example, by defaults, blocks are delimited like:

getQuotedVariableEnd()

const char * templateengine::getQuotedVariableEnd

(

)

Returns the delimiter that the parse() methods look for at the end of a variable whos value's single-quotes shall be escaped.

The default is ")".

For example, by defaults, variables are delimited like:

getQuotedVariableStart()

const char * templateengine::getQuotedVariableStart

(

)

Returns the delimiter that the parse() methods look for at the beginning of a variable whos value's single-quotes shall be escaped.

The default is "$q(".

For example, by defaults, variables are delimited like:

getVariableEnd()

const char * templateengine::getVariableEnd

(

)

Returns the delimiter that the parse() methods look for at the end of a variable.

The default is ")".

For example, by defaults, variables are delimited like:

getVariableStart()

const char * templateengine::getVariableStart

(

)

Returns the delimiter that the parse() methods look for at the beginning of a variable.

The default is "$(".

For example, by defaults, variables are delimited like:

parse() [1/3]

bool templateengine::parse	(	output *	out,
		const char *	block,
		uint64_t	blocklength,
		blockparser *	blockparsers,
		dictionary< const char *, const char * > *	vars )

Parses "length" characters of "block" and writes the out to "out". For each variable encountered, values from "vars" are substituted. For each nested block encountered, the block is looked up in "blockparsers" and the appropriate block parser method is called. The block parser method is passed "req", "resp", the name, data and character length of the block, "out" and "data" from the blockparser entry.

If a block is encountered but no block parser method is registered for it, it is parsed using "vars".

Returns false if a block parser method returns false and true otherwise.

parse() [2/3]

bool templateengine::parse	(	output *	out,
		const char *	filename,
		blockparser *	blockparsers,
		dictionary< const char *, const char * > *	vars )

Parses the file at "filename" and writes the out to "out". For each variable encountered, values from "vars" are substituted. For each block encountered, the block is looked up in "blockparsers" and the appropriate block parser method is called. The block parser method is passed "req", "resp", "out", the name, data and character length of the block and "data" from the blockparser entry.

If a block is encountered but no block parser method is registered for it, it is parsed using "vars".

Returns false if a block parser method returns false and true otherwise.

parse() [3/3]

bool templateengine::parse	(	output *	out,
		const char *	filename,
		fileparser *	fileparsers,
		dictionary< const char *, const char * > *	vars )

Looks up "filename" in "fileparsers", and calls the appropriate file parser method.

For each variable encountered in "filename", values from "vars" are substitued.

Returns true on success and false if the file parser method returns false or if no fileparser was found.

setBlockEndEnd()

void templateengine::setBlockEndEnd

(

const char *

delimiter

)

Sets the delimiter that the parse() methods look for at the end of a block-end to "delimiter".

Defaults to " -->".

For example, by defaults, blocks are delimited like:

... block ...

setBlockEndStart()

void templateengine::setBlockEndStart

(

const char *

delimiter

)

Sets the delimiter that the parse() methods look for at the beginning of a block-end to "delimiter".

Defaults to "<!-- end ".

For example, by defaults, blocks are delimited like:

... block ...

setBlockStartEnd()

void templateengine::setBlockStartEnd

(

const char *

delimiter

)

Sets the delimiter that the parse() methods look for at the end of a block-start to "delimiter".

Defaults to " -->".

For example, by defaults, blocks are delimited like:

... block ...

setBlockStartStart()

void templateengine::setBlockStartStart

(

const char *

delimiter

)

Sets the delimiter that the parse() methods look for at beginning of a block-start to "delimiter".

Defaults to "<!-- start ".

For example, by defaults, blocks are delimited like:

... block ...

setDoubleQuotedVariableEnd()

void templateengine::setDoubleQuotedVariableEnd

(

const char *

delimiter

)

Sets the delimiter that the parse() methods look for at the end of a variable whos value's double-quotes shall be escaped to "delimiter".

Defaults to ")".

For example, by defaults, variables are delimited like:

setDoubleQuotedVariableStart()

void templateengine::setDoubleQuotedVariableStart

(

const char *

delimiter

)

Sets the delimiter that the parse() methods look for at the beginning of a variable whos value's double-quotes shall be escaped to "delimiter".

Defaults to "$dq(".

For example, by defaults, variables are delimited like:

setEscapeCharacter()

void templateengine::setEscapeCharacter

(

char

esc

)

Sets the escape character. Defaults to backslash.

setIncludeEnd()

void templateengine::setIncludeEnd

(

const char *

delimiter

)

Sets the delimiter that the parse() methods look for at the end of an include to "delimiter".

Defaults to " -->".

For example, by defaults, blocks are delimited like:

setIncludeStart()

void templateengine::setIncludeStart

(

const char *

delimiter

)

Sets the delimiter that the parse() methods look for at the beginning of an include to "delimiter".

Defaults to "<!-- include ".

For example, by defaults, blocks are delimited like:

setQuotedVariableEnd()

void templateengine::setQuotedVariableEnd

(

const char *

delimiter

)

Sets the delimiter that the parse() methods look for at the end of a variable whos value's single-quotes shall be escaped to "delimiter".

Defaults to ")".

For example, by defaults, variables are delimited like:

setQuotedVariableStart()

void templateengine::setQuotedVariableStart

(

const char *

delimiter

)

Sets the delimiter that the parse() methods look for at the beginning of a variable whos value's single-quotes shall be escaped to "delimiter".

Defaults to "$q(".

For example, by defaults, variables are delimited like:

setVariableEnd()

void templateengine::setVariableEnd

(

const char *

delimiter

)

Sets the delimiter that the parse() methods look for at the end of a variable to "delimiter".

Defaults to ")".

For example, by defaults, variables are delimited like:

setVariableStart()

void templateengine::setVariableStart

(

const char *

delimiter

)

Sets the delimiter that the parse() methods look for at the beginning of a variable to "delimiter".

Defaults to "$(".

For example, by defaults, variables are delimited like: