virtual P6R::P6ERR P6R::p6IRegex::match ( const P6CHAR *  pMatch, P6REGEXMODIFIER  modifiers  )

pure virtual

Does the compiled regular expression recognize the entire pMatch input string ? This function will try to match the ENTIRE input string, not part of it.

Thus, in Perl, this would be the same as a regex of the form \Apattern\z (\A matches start of string and \z matches the end of a string). Thus there is no need to place these type of meta characters around the entire string.

Meaningful modifiers: { P6MODIFIER_INSENSITIVE, P6MODIFIER_FASTGREEDY }

Note, that the 'compile' function must be called before this function. If the component was created with the trace option then the evalution steps will be detailed logged.

Parameters

pMatch	[ in ] The narrow string to test against the compiled regular expression
modifiers	[ in ] A bit mask that defines how the regex engine performs the match

Returns

Success	P6R::eOk
Failure	P6R::eNotInitialized	A successful call to initialize was not made before this call.
	P6R::eInvalidArg	pMatch is NULL.
	P6R::eAccessFault	The compile function has not be successfully called.
	P6R::eNoMemory	Insufficent memory to process the regex.
	P6R::eFail	The regular expression does match the pMatch string.