An implementation of RFC-iCalendar CAL-QUERY. More...

#include </home/doug/src/SoftwareAndServices/libSaSiCalendar/cal_query.hpp>

Inheritance diagram for SoftwareAndServices::Library::iCalendar::cal_query:

Collaboration diagram for SoftwareAndServices::Library::iCalendar::cal_query:

Public Types
enum	quote_errors { NO_END_QUOTE_e = 1, NO_DATA_PROVIDED_e, UNKNOWN_BACKSLASH_ESCAPE_e, NO_TERM_FOUND_e }
	These are C++ objects that can be thrown as errors. More...

Public Member Functions
	cal_query ()
	cal_query Constructor. More...

	cal_query (const char selectClause, const char fromClause=NULL, const char *whereClause=NULL)
	cal_query Constructor. More...

virtual	~cal_query ()
	cal_query Destructor. More...

virtual InstanceCount_t	decInstance () const
	Decrement the instance. More...

const char *	From () const

bool	From (const char *fromClause)

const char *	get () const

const value *	getData () const
	Get the pointer to the data being stored. More...

virtual InstanceCount_t	getInstance () const

Tokens_t	getType () const
	Get the type of data being stored. More...

const char *	getXValueType () const
	Get the type of data being stored. More...

virtual InstanceCount_t	incInstance () const
	Increment the instance. More...

void	operator delete (void *data)
	This class uses instance counting, this entry point overloads the default delete() operator in order to correctly track the instance. More...

bool	parse (Parse &in, component *errors)
	#Parse a cal_query More...

bool	parse (const char in, component errors)
	#Parse a cal_query More...

const char *	Select () const

bool	Select (const char *selectClause)

void	setData (void *DataPtr)
	Set the data to the data being stored. More...

void	setType (Tokens_t Token)
	Set the type of data being stored. More...

void	setXValueType (const char *xValType)
	Set the type of data being stored - non-standard types only. More...

virtual bool	sprint (String *Results) const
	Print the object in RFC-iCalendar format. More...

const char *	Where () const

bool	Where (const char *whereClause)

Static Public Member Functions
static char *	addQuotes (const char *text)
	Add quotes to the value. More...

static char *	escape (const char *text)
	Escape a value and return an RFC-iCalendar value encoded. More...

static char *	removeQuotes (const char *text)
	Remove quotes from a user supplied value so that the raw data can be stored. More...

static bool	sprintTokensAsText (String *Results, Tokens_t token)
	Called by text2token() to get the token name as a String. More...

static char *	unescape (const char text, const char term)
	Un-escape a value and return what a user originally entered. More...

Static Public Attributes
static const char **	tokenStrings
	A list of strings for the names of tokens. More...

Detailed Description

An implementation of RFC-iCalendar CAL-QUERY.

Definition at line 78 of file cal_query.hpp.

Member Enumeration Documentation

◆ quote_errors

enum SoftwareAndServices::Library::iCalendar::BaseValueType::quote_errors

inherited

These are C++ objects that can be thrown as errors.

Definition at line 204 of file BaseValueType.hpp.

Constructor & Destructor Documentation

◆ cal_query() [1/2]

SoftwareAndServices::Library::iCalendar::cal_query::cal_query ( )

cal_query Constructor.

◆ cal_query() [2/2]

SoftwareAndServices::Library::iCalendar::cal_query::cal_query	(	const char *	selectClause,
		const char *	fromClause = `NULL`,
		const char *	whereClause = `NULL`
	)

cal_query Constructor.

Parameters

selectClause	The SELECT part of the cal_query.
fromClause	The FROM part of the cal_query.
whereClause	The WHERE clause of the cal_query.

◆ ~cal_query()

virtual SoftwareAndServices::Library::iCalendar::cal_query::~cal_query ( )

virtual

cal_query Destructor.

Member Function Documentation

◆ addQuotes()

static char* SoftwareAndServices::Library::iCalendar::BaseValueType::addQuotes ( const char * text )

staticinherited

Add quotes to the value.

Caller MUST free results.

Parameters

text	The text to be de-quoted.

Returns: The de-quoted data.

◆ decInstance()

virtual InstanceCount_t SoftwareAndServices::Library::Common::instance< BaseValueType >::decInstance ( ) const

inlinevirtualinherited

Decrement the instance.

Returns: The instance count, after decrementing it.

Reimplemented in SoftwareAndServices::Library::iCalendar::date_time.

Definition at line 129 of file instance.hpp.

◆ escape()

static char* SoftwareAndServices::Library::iCalendar::BaseValueType::escape ( const char * text )

staticinherited

Escape a value and return an RFC-iCalendar value encoded.

Caller MUST free results.

Parameters

text	the text to escape.

Returns: The escaped string.

◆ From() [1/2]

const char* SoftwareAndServices::Library::iCalendar::cal_query::From ( ) const

Returns: Get the FROM part of the cal_query.

◆ From() [2/2]

bool SoftwareAndServices::Library::iCalendar::cal_query::From ( const char * fromClause )

Parameters

fromClause Set the FROM part of the cal_query.

Returns: TRUE when set and parsed correctly.

◆ get()

const char* SoftwareAndServices::Library::iCalendar::cal_query::get ( ) const

Returns: The cal_query string in RFC-iCalendar format.

◆ getData()

const value* SoftwareAndServices::Library::iCalendar::BaseValueType::getData ( ) const

inherited

Get the pointer to the data being stored.

Returns: Pointer to the data being stored.

◆ getInstance()

virtual InstanceCount_t SoftwareAndServices::Library::Common::instance< BaseValueType >::getInstance ( ) const

inlinevirtualinherited

Returns: The current instance count.

Definition at line 118 of file instance.hpp.

◆ getType()

Tokens_t SoftwareAndServices::Library::iCalendar::BaseValueType::getType ( ) const

inherited

Get the type of data being stored.

If it returns Unknown_t, call getXType()

Returns: The type of data being stored.

See also: getXValueType()

◆ getXValueType()

const char* SoftwareAndServices::Library::iCalendar::BaseValueType::getXValueType ( ) const

inherited

Get the type of data being stored.

If it returns NULL, call getType()

Returns: The type of data being stored as a string.

See also: geXValueType()

◆ incInstance()

virtual InstanceCount_t SoftwareAndServices::Library::Common::instance< BaseValueType >::incInstance ( ) const

inlinevirtualinherited

Increment the instance.

Returns: The instance value, after incrementing it.

Reimplemented in SoftwareAndServices::Library::iCalendar::date_time.

Definition at line 109 of file instance.hpp.

◆ operator delete()

void SoftwareAndServices::Library::iCalendar::BaseValueType::operator delete ( void * data )

inherited

This class uses instance counting, this entry point overloads the default delete() operator in order to correctly track the instance.

◆ parse() [1/2]

bool SoftwareAndServices::Library::iCalendar::cal_query::parse	(	Parse &	in,
		component *	errors
	)

#Parse a cal_query

Parameters

in	An open Parse object.
errors	Were any errors may be saved.

Returns: TRUE when parsed successfully.

◆ parse() [2/2]

bool SoftwareAndServices::Library::iCalendar::cal_query::parse	(	const char *	in,
		component *	errors
	)

#Parse a cal_query

Parameters

in	A pointer to a cal_query string.
errors	Were any errors may be saved.

Returns: TRUE when parsed successfully.

◆ removeQuotes()

static char* SoftwareAndServices::Library::iCalendar::BaseValueType::removeQuotes ( const char * text )

staticinherited

Remove quotes from a user supplied value so that the raw data can be stored.

Caller MUST free results.

Parameters

text	The text to be de-quoted. No harm if it does not already contain quotes.

Returns: The de-quoted data.

◆ Select() [1/2]

const char* SoftwareAndServices::Library::iCalendar::cal_query::Select ( ) const

Returns: Get the SELECT part of the cal_query.

◆ Select() [2/2]

bool SoftwareAndServices::Library::iCalendar::cal_query::Select ( const char * selectClause )

Parameters

selectClause Set the SELECT part of the cal_query.

Returns: TRUE when set and parsed correctly.

◆ setData()

void SoftwareAndServices::Library::iCalendar::BaseValueType::setData ( void * DataPtr )

inherited

Set the data to the data being stored.

Parameters

DataPtr Pointer to the data.

◆ setType()

void SoftwareAndServices::Library::iCalendar::BaseValueType::setType ( Tokens_t Token )

inherited

Set the type of data being stored.

If the type is not a predefined one, call setXValueType()

Parameters

Token The type of data being stored.

See also: setXValueType()

◆ setXValueType()

void SoftwareAndServices::Library::iCalendar::BaseValueType::setXValueType ( const char * xValType )

inherited

Set the type of data being stored - non-standard types only.

If the type is a predefined one, call setValueType()

Parameters

xValType The type of data being stored as a string.

See also: setValueType()

◆ sprint()

virtual bool SoftwareAndServices::Library::iCalendar::cal_query::sprint ( String * Results ) const

virtual

Print the object in RFC-iCalendar format.

Parameters

Results Append the results to Results.

Returns: TRUE when data was appended.

Implements SoftwareAndServices::Library::iCalendar::BaseValueType.

◆ sprintTokensAsText()

static bool SoftwareAndServices::Library::iCalendar::BaseValueType::sprintTokensAsText	(	String *	Results,
		Tokens_t	token
	)

staticinherited

Called by text2token() to get the token name as a String.

Parameters

Results	The token name as a String.
token	The token to convert to a string.

Returns: TRUE when something appended to Results.

◆ unescape()

static char* SoftwareAndServices::Library::iCalendar::BaseValueType::unescape	(	const char *	text,
		const char *	term
	)

staticinherited

Un-escape a value and return what a user originally entered.

Caller MUST delete results when done. The string would have been encoded as an RFC-iCalendar value encoding.

Parameters

text	the text to un-escape.
term	A string to be used as the data separator. This value is passed to strpbrk().

Returns: The un-escaped string.

◆ Where() [1/2]

const char* SoftwareAndServices::Library::iCalendar::cal_query::Where ( ) const

Returns: Get the WHERE part of the cal_query.

◆ Where() [2/2]

bool SoftwareAndServices::Library::iCalendar::cal_query::Where ( const char * whereClause )

Parameters

whereClause Set the WHERE part of the cal_query.

Returns: TRUE when set and parsed correctly.

Member Data Documentation

◆ tokenStrings

const char** SoftwareAndServices::Library::iCalendar::BaseValueType::tokenStrings

staticinherited

A list of strings for the names of tokens.

The token value used as an offset into this array is the name of the token as a string.

The strings "X_COMP", "X_PROP", and "XPARAM" ARE included. Strings matching X_COMP, X_PROP, and XPARAM values are not included.

Definition at line 144 of file BaseValueType.hpp.

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

cal_query.hpp

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Detailed Description

Member Enumeration Documentation

◆ quote_errors

Constructor & Destructor Documentation

◆ cal_query() [1/2]

◆ cal_query() [2/2]

◆ ~cal_query()

Member Function Documentation

◆ addQuotes()

◆ decInstance()

◆ escape()

◆ From() [1/2]

◆ From() [2/2]

◆ get()

◆ getData()

◆ getInstance()

◆ getType()

◆ getXValueType()

◆ incInstance()

◆ operator delete()

◆ parse() [1/2]

◆ parse() [2/2]

◆ removeQuotes()

◆ Select() [1/2]

◆ Select() [2/2]

◆ setData()

◆ setType()

◆ setXValueType()

◆ sprint()

◆ sprintTokensAsText()

◆ unescape()

◆ Where() [1/2]

◆ Where() [2/2]

Member Data Documentation

◆ tokenStrings