BALL::RegularExpression Class Reference
[Miscellaneous]

#include <BALL/DATATYPE/regularExpression.h>


Public Member Functions
Constructors and Destructors
	RegularExpression ()
	Default constructor.
	RegularExpression (const RegularExpression &regular_expression)
	Copy constructor.
	RegularExpression (const String &pattern, bool wildcard_pattern=false)
virtual	~RegularExpression ()
	Destructor.
virtual void	clear ()
	Reset the object attributes to their default values.
void	destroy ()
	Destroy the instance.
Assignment
RegularExpression &	operator= (const RegularExpression &expression)
	Assignment operator.
void	set (const RegularExpression &regular_expression)
	Assign from another instance.
void	set (const String &pattern, bool wildcard_pattern=false)
	Assign from a string.
void	get (RegularExpression &regular_expression) const
	Assign to another instance.
Predicates
bool	isEmpty () const
bool	operator== (const RegularExpression &regular_expression) const
bool	operator!= (const RegularExpression &regular_expression) const
bool	operator< (const RegularExpression &regular_expression) const
bool	operator<= (const RegularExpression &regular_expression) const
bool	operator>= (const RegularExpression &regular_expression) const
bool	operator> (const RegularExpression &regular_expression) const
Debugging and Diagnostics
virtual bool	isValid () const
virtual void	dump (std::ostream &s=std::cout, Size depth=0) const
Static Public Attributes
String constants
static const String	ALPHA
static const String	ALPHANUMERIC
static const String	REAL
static const String	IDENTIFIER
static const String	INTEGER
static const String	HEXADECIMAL_INTEGER
static const String	LOWERCASE
static const String	NON_ALPHA
static const String	NON_ALPHANUMERIC
static const String	NON_NUMERIC
static const String	NON_WHITESPACE
static const String	UPPERCASE
static const String	WHITESPACE
Private Member Functions
void	compilePattern_ ()
void	toExtendedRegularExpression_ ()
Private Attributes
regex_t	regex_
String	pattern_
bool	valid_pattern_
Friends
Storers
BALL_EXPORT friend std::ostream &	operator<< (std::ostream &s, const RegularExpression &regular_expression)
BALL_EXPORT friend std::istream &	operator>> (std::istream &s, RegularExpression &regular_expression)
Accessors
const String &	getPattern () const
	Get the expression pattern.
Size	countSubexpressions () const
	Count subexpressions.
bool	match (const String &text, Index from=0, int execute_flags=0) const throw (Exception::NullPointer, Exception::IndexUnderflow, Exception::IndexOverflow)
bool	match (const Substring &text, Index from=0, int execute_flags=0) const throw (Substring::InvalidSubstring, Exception::IndexUnderflow, Exception::IndexOverflow)
bool	match (const char *text, int execute_flags=0) const throw (Exception::NullPointer)
bool	find (const String &text, Substring &found, Index from=0, int execute_flags=0) const throw (Exception::IndexUnderflow, Exception::IndexOverflow)
bool	find (const String &text, vector< Substring > &subexpressions, Index from=0, int execute_flags=0) const throw (Exception::IndexUnderflow, Exception::IndexOverflow)
static bool	match (const char text, const char pattern, int compile_flags=0\|REG_EXTENDED\|REG_NOSUB, int execute_flags=0) throw (Exception::NullPointer)

Detailed Description

Regular expression class

Constructor & Destructor Documentation

BALL::RegularExpression::RegularExpression ( )

Default constructor.

BALL::RegularExpression::RegularExpression ( const RegularExpression & regular_expression )

Copy constructor.

BALL::RegularExpression::RegularExpression	(	const String &	pattern,
		bool	wildcard_pattern = `false`
	)

virtual BALL::RegularExpression::~RegularExpression ( ) [virtual]

Destructor.

Member Function Documentation

virtual void BALL::RegularExpression::clear ( ) [virtual]

Reset the object attributes to their default values.

void BALL::RegularExpression::compilePattern_ ( ) [private]

Size BALL::RegularExpression::countSubexpressions ( ) const

Count subexpressions.

void BALL::RegularExpression::destroy ( )

Destroy the instance.

virtual void BALL::RegularExpression::dump	(	std::ostream &	s = `std::cout`,
		Size	depth = `0`
	)			const `[virtual]`

Dump this instance to an ostream depth is normaly just used for internal use.

Parameters:

	s	the ostream, default is the standard output
	depth	the indentation depth of the output

bool BALL::RegularExpression::find	(	const String &	text,
		vector< Substring > &	subexpressions,
		Index	from = `0`,
		int	execute_flags = `0`
	)			const throw (Exception::IndexUnderflow, Exception::IndexOverflow)

Find this expression in a string

Parameters:

	text	to process
	subexpressions	the results are stored here
	from	index in the string to start the matching
	execute_flags	?????

bool BALL::RegularExpression::find	(	const String &	text,
		Substring &	found,
		Index	from = `0`,
		int	execute_flags = `0`
	)			const throw (Exception::IndexUnderflow, Exception::IndexOverflow)

Find this expression in a string

Parameters:

	from	index in the string to start the matching
	found	the result is stored as a substring here
	execute_flags	?????

void BALL::RegularExpression::get ( RegularExpression & regular_expression ) const

Assign to another instance.

const String& BALL::RegularExpression::getPattern ( ) const

Get the expression pattern.

bool BALL::RegularExpression::isEmpty ( ) const

Test if expression is empty.

virtual bool BALL::RegularExpression::isValid ( ) const [virtual]

Test if instance is valid.

bool BALL::RegularExpression::match	(	const char *	text,
		int	execute_flags = `0`
	)			const throw (Exception::NullPointer)

Match a C-String with this regular expression.

Parameters:

	text	to process
	execute_flags	?????

bool BALL::RegularExpression::match	(	const Substring &	text,
		Index	from = `0`,
		int	execute_flags = `0`
	)			const throw (Substring::InvalidSubstring, Exception::IndexUnderflow, Exception::IndexOverflow)

Match a substring with this regular expression.

Parameters:

	text	to process
	from	index in the substring to start the matching
	execute_flags	?????

bool BALL::RegularExpression::match	(	const String &	text,
		Index	from = `0`,
		int	execute_flags = `0`
	)			const throw (Exception::NullPointer, Exception::IndexUnderflow, Exception::IndexOverflow)

Match a text with this regular expression.

Parameters:

	text	to process
	from	index in the string to start the matching
	execute_flags	?????

static bool BALL::RegularExpression::match	(	const char *	text,
		const char *	pattern,
		int	compile_flags = `0\|REG_EXTENDED\|REG_NOSUB`,
		int	execute_flags = `0`
	)			throw (Exception::NullPointer) `[static]`

Match a text with a given pattern.

Parameters:

	text	to process
	pattern	to compare with
	compile_flags	?????
	execute_flags	?????

Exceptions:

NullPointer if text or pattern are NULL

bool BALL::RegularExpression::operator!= ( const RegularExpression & regular_expression ) const

Inequality operator

bool BALL::RegularExpression::operator< ( const RegularExpression & regular_expression ) const

Less operator

bool BALL::RegularExpression::operator<= ( const RegularExpression & regular_expression ) const

Less or equal operator

RegularExpression& BALL::RegularExpression::operator= ( const RegularExpression & expression )

Assignment operator.

bool BALL::RegularExpression::operator== ( const RegularExpression & regular_expression ) const

Equality operator

bool BALL::RegularExpression::operator> ( const RegularExpression & regular_expression ) const

Greater operator

bool BALL::RegularExpression::operator>= ( const RegularExpression & regular_expression ) const

Greater or equal operator

void BALL::RegularExpression::set	(	const String &	pattern,
		bool	wildcard_pattern = `false`
	)

Assign from a string.

void BALL::RegularExpression::set ( const RegularExpression & regular_expression )

Assign from another instance.

void BALL::RegularExpression::toExtendedRegularExpression_ ( ) [private]

Friends And Related Function Documentation

BALL_EXPORT friend std::ostream& operator<<	(	std::ostream &	s,
		const RegularExpression &	regular_expression
	)			`[friend]`

output operator

BALL_EXPORT friend std::istream& operator>>	(	std::istream &	s,
		RegularExpression &	regular_expression
	)			`[friend]`

input operator

Member Data Documentation

const String BALL::RegularExpression::ALPHA [static]

alphabetic letters.

const String BALL::RegularExpression::ALPHANUMERIC [static]

alphanumeric letters

const String BALL::RegularExpression::HEXADECIMAL_INTEGER [static]

hexadecimal and integer characters

const String BALL::RegularExpression::IDENTIFIER [static]

identifier characters

const String BALL::RegularExpression::INTEGER [static]

integer characters

const String BALL::RegularExpression::LOWERCASE [static]

lowercase letters

const String BALL::RegularExpression::NON_ALPHA [static]

non alphabetic characters

const String BALL::RegularExpression::NON_ALPHANUMERIC [static]

non alphanumeric characters

const String BALL::RegularExpression::NON_NUMERIC [static]

non numeric characters

const String BALL::RegularExpression::NON_WHITESPACE [static]

non whitespace charcters

String BALL::RegularExpression::pattern_ [private]

const String BALL::RegularExpression::REAL [static]

real numbers

regex_t BALL::RegularExpression::regex_ [private]

const String BALL::RegularExpression::UPPERCASE [static]

uppercase letters.

bool BALL::RegularExpression::valid_pattern_ [private]

const String BALL::RegularExpression::WHITESPACE [static]

whitespace characters.

BALL::RegularExpression Class Reference [Miscellaneous]

Public Member Functions

Static Public Attributes

Private Member Functions

Private Attributes

Friends

Accessors

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation

BALL::RegularExpression Class Reference
[Miscellaneous]