Wrapper around C++11 regular expressions with some additional prefix-handling. The prefix-handling is loosely oriented on PCRE regular expressions and provides a simple means of tuning the expressions. More...

Classes
struct	meta
	Functor wrapper for testing meta-characters. More...

Public Types
typedef std::smatch	results_type
	Type for matches. More...

Public Member Functions
	regExpCxx ()
	Default construct. More...

	regExpCxx (const regExpCxx &rgx)
	Copy construct. More...

	regExpCxx (regExpCxx &&rgx) noexcept
	Move construct. More...

	regExpCxx (const char *pattern, const bool ignoreCase=false)
	Construct from character array, optionally ignore case. More...

	regExpCxx (const std::string &pattern, const bool ignoreCase=false)
	Construct from string, optionally ignore case. More...

	~regExpCxx ()=default
	Destructor. More...

bool	empty () const noexcept
	True if expression is empty. More...

bool	exists () const noexcept
	True if expression is non-empty. More...

bool	negated () const noexcept
	True if pattern matching is negated. More...

bool	negate (bool on) noexcept
	Change pattern negation, return previous value. More...

unsigned	ngroups () const

bool	nocase () const

bool	clear ()
	Clear expression. More...

void	swap (regExpCxx &rgx)
	Swap contents. More...

bool	set (const char *pattern, bool ignoreCase=false)
	Compile pattern into a regular expression, optionally ignore case. More...

bool	set (const std::string &pattern, bool ignoreCase=false)
	Compile pattern into a regular expression, optionally ignore case. More...

std::string::size_type	find (const std::string &text) const
	Find position within the text. More...

bool	match (const std::string &text) const
	True if the regex matches the entire text. More...

bool	match (const std::string &text, results_type &matches) const
	True if the regex matches the text, set the matches. More...

bool	search (const std::string &text) const
	Return true if the regex was found within the text. More...

bool	operator() (const std::string &text) const
	Perform match on text. More...

void	operator= (const regExpCxx &rgx)
	Copy assignment. More...

void	operator= (regExpCxx &&rgx)
	Move assignment. More...

void	operator= (const char *pattern)
	Assign and compile pattern from a character array. More...

void	operator= (const std::string &pattern)
	Assign and compile pattern from string. More...

Static Public Member Functions
static bool	is_meta (const char c) noexcept
	Test if character is a regex meta-character. More...

static bool	is_meta (const std::string &str, const char quote='\\')
	Test if string contains any (unquoted) meta-characters. More...

Static Public Attributes
static int	grammar
	The default grammar (extended \| ECMAScript). More...

Detailed Description

Wrapper around C++11 regular expressions with some additional prefix-handling. The prefix-handling is loosely oriented on PCRE regular expressions and provides a simple means of tuning the expressions.

The prefixes are detected as (?...) at the beginning of the regular expression. Any unknown/unsupported prefixes are silently ignored.

"(?!i)" : one or more embedded pattern-match modifiers for the entire pattern.
the 'i' indicates ignore-case
the '!' (exclamation) indicates negated (inverted) matching

Note: Uses either POSIX extended regular expressions or modified ECMAScript regular expression grammar

Since ECMAScript grammar may not work correctly on all installations, the current default is to use extended regular expressions.

The C++11 regular expressions may be broken on some compilers. For example, gcc 4.8 is known to fail. For these systems the POSIX implementation or alternative must be used.

Warning: This class should not be used directly. Use the Foam::regExp typedef instead.

Source files

Definition at line 82 of file regExpCxx.H.

Member Typedef Documentation

◆ results_type

typedef std::smatch results_type

Type for matches.

Definition at line 114 of file regExpCxx.H.

Constructor & Destructor Documentation

◆ regExpCxx() [1/5]

regExpCxx ( )

inline

Default construct.

Definition at line 82 of file regExpCxxI.H.

◆ regExpCxx() [2/5]

regExpCxx ( const regExpCxx & rgx )

inline

Copy construct.

Definition at line 89 of file regExpCxxI.H.

◆ regExpCxx() [3/5]

regExpCxx ( regExpCxx && rgx )

inlinenoexcept

Move construct.

Definition at line 96 of file regExpCxxI.H.

◆ regExpCxx() [4/5]

regExpCxx	(	const char *	pattern,
		const bool	ignoreCase = `false`
	)

inlineexplicit

Construct from character array, optionally ignore case.

Definition at line 105 of file regExpCxxI.H.

References regExpCxx::set().

Here is the call graph for this function:

◆ regExpCxx() [5/5]

regExpCxx	(	const std::string &	pattern,
		const bool	ignoreCase = `false`
	)

inlineexplicit

Construct from string, optionally ignore case.

Definition at line 118 of file regExpCxxI.H.

References regExpCxx::set().

Here is the call graph for this function:

◆ ~regExpCxx()

~regExpCxx ( )

default

Destructor.

Member Function Documentation

◆ is_meta() [1/2]

bool is_meta ( const char c )

inlinestaticnoexcept

Test if character is a regex meta-character.

Returns

True if character is one of the following:

any character: '.'
quantifiers: '*', '+', '?'
grouping: '(', '|', ')'
range: '[', ']'

Note: Regex bounds '{', '}' are not considered

Definition at line 42 of file regExpCxxI.H.

Referenced by wordRe::compile(), regExpPosix::is_meta(), and regExpCxx::meta::operator()().

Here is the caller graph for this function:

◆ is_meta() [2/2]

bool is_meta	(	const std::string &	str,
		const char	quote = `'\\'`
	)

inlinestatic

Test if string contains any (unquoted) meta-characters.

Definition at line 54 of file regExpCxxI.H.

◆ empty()

bool empty ( ) const

inlinenoexcept

True if expression is empty.

Definition at line 133 of file regExpCxxI.H.

◆ exists()

bool exists ( ) const

inlinenoexcept

True if expression is non-empty.

Definition at line 139 of file regExpCxxI.H.

◆ negated()

bool negated ( ) const

inlinenoexcept

True if pattern matching is negated.

Definition at line 145 of file regExpCxxI.H.

◆ negate()

bool negate ( bool on )

inlinenoexcept

Change pattern negation, return previous value.

Definition at line 151 of file regExpCxxI.H.

◆ ngroups()

unsigned ngroups ( ) const

inline

The number of capture groups for a non-empty, non-negated expressions

Definition at line 171 of file regExpCxxI.H.

◆ nocase()

bool nocase ( ) const

inline

Definition at line 178 of file regExpCxxI.H.

◆ clear()

bool clear ( )

inline

Clear expression.

Returns: True if expression had existed prior to the clear.

Definition at line 184 of file regExpCxxI.H.

◆ swap()

void swap ( regExpCxx & rgx )

inline

Swap contents.

Definition at line 198 of file regExpCxxI.H.

◆ set() [1/2]

bool set	(	const char *	pattern,
		bool	ignoreCase = `false`
	)

inline

Compile pattern into a regular expression, optionally ignore case.

Returns: True if the pattern was compiled

Definition at line 209 of file regExpCxxI.H.

Referenced by regExpCxx::regExpCxx().

Here is the caller graph for this function:

◆ set() [2/2]

bool set	(	const std::string &	pattern,
		bool	ignoreCase = `false`
	)

inline

Compile pattern into a regular expression, optionally ignore case.

Returns: True if the pattern was compiled

Definition at line 221 of file regExpCxxI.H.

◆ find()

std::string::size_type find ( const std::string & text ) const

inline

Find position within the text.

Returns: The index where it begins or string::npos if not found

Note: does not properly work with negated regex!

Definition at line 233 of file regExpCxxI.H.

◆ match() [1/2]

bool match ( const std::string & text ) const

inline

True if the regex matches the entire text.

The begin-of-line (^) and end-of-line ($) anchors are implicit

Definition at line 289 of file regExpCxxI.H.

Referenced by keyType::match(), and STARCDsurfaceFormatCore::readInpCellTable().

Here is the caller graph for this function:

◆ match() [2/2]

bool match	(	const std::string &	text,
		results_type &	matches
	)		const

inline

True if the regex matches the text, set the matches.

The first group starts at index 1 (0 is the entire match). The begin-of-line (^) and end-of-line ($) anchors are implicit

Note: does not properly work with negated regex!

Definition at line 303 of file regExpCxxI.H.

◆ search()

bool search ( const std::string & text ) const

inline

Return true if the regex was found within the text.

Definition at line 275 of file regExpCxxI.H.

◆ operator()()

bool operator() ( const std::string & text ) const

inline

Perform match on text.

Definition at line 322 of file regExpCxxI.H.

◆ operator=() [1/4]

void operator= ( const regExpCxx & rgx )

inline

Copy assignment.

Definition at line 328 of file regExpCxxI.H.

◆ operator=() [2/4]

void operator= ( regExpCxx && rgx )

inline

Move assignment.

Definition at line 339 of file regExpCxxI.H.

References clear().

Here is the call graph for this function:

◆ operator=() [3/4]

void operator= ( const char * pattern )

inline

Assign and compile pattern from a character array.

Matching is case sensitive.

Definition at line 350 of file regExpCxxI.H.

◆ operator=() [4/4]

void operator= ( const std::string & pattern )

inline

Assign and compile pattern from string.

Matching is case sensitive.

Definition at line 356 of file regExpCxxI.H.

Member Data Documentation

◆ grammar

int grammar

static

The default grammar (extended | ECMAScript).

Definition at line 120 of file regExpCxx.H.

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

src/OpenFOAM/primitives/strings/regex/regExpCxx.H
src/OpenFOAM/primitives/strings/regex/regExpCxx.C
src/OpenFOAM/primitives/strings/regex/regExpCxxI.H

Classes

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Detailed Description

Member Typedef Documentation

◆ results_type

Constructor & Destructor Documentation

◆ regExpCxx() [1/5]

◆ regExpCxx() [2/5]

◆ regExpCxx() [3/5]

◆ regExpCxx() [4/5]

◆ regExpCxx() [5/5]

◆ ~regExpCxx()

Member Function Documentation

◆ is_meta() [1/2]

◆ is_meta() [2/2]

◆ empty()

◆ exists()

◆ negated()

◆ negate()

◆ ngroups()

◆ nocase()

◆ clear()

◆ swap()

◆ set() [1/2]

◆ set() [2/2]

◆ find()

◆ match() [1/2]

◆ match() [2/2]

◆ search()

◆ operator()()

◆ operator=() [1/4]

◆ operator=() [2/4]

◆ operator=() [3/4]

◆ operator=() [4/4]

Member Data Documentation

◆ grammar