virtual P6R::P6ERR P6R::p6IWRegex::replace ( const P6WCHAR *  pSearch, P6WREGEXMODIFIER  modifiers, const P6WCHAR *  pReplace, P6WCHAR *  pResult, P6UINT32  cBuffer, P6UINT32 *  pWritten  )

pure virtual

Replace the first matching subexpressions with the pSearch string with the pReplace string.

Replace all occurrances if the P6MOD_GLOBAL flag is passed in the "modifiers" paramater. Place the resulting string in the pResult buffer passed in by the caller. 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.

Meaningful modifiers: { P6MOD_INSENSITIVE, P6MOD_FASTGREEDY, P6MOD_MULTILINE, P6MOD_GLOBAL }

Parameters

pSearch	[ in ] The wide string to test against the compiled regular expression.
modifiers	[ in ] A bit mask that defines how the regex engine performs the match
pReplace	[ in ] String to replace the matched subexpression with. This string can have back references in it (e.g., "--\1--\2"). The back references are evaluated after each match for global matches.
pResult	[ out ] Can be NULL. Buffer to write the newly constructed string into. When NULL pWritten returns the size of buffer required for replace to work properly.
cBuffer	[ in ] Number of characters in the buffer pointed to by pResult.
pWritten	[ out ] Optional can be NULL, returns the number of characters written into pResult. This parameter cannot be NULL when pResult is also NULL.

Returns

Success	P6R::eOk
Failure	P6R::eNotInitialized	A successful call to initialize was not made before this call.
	P6R::eInvalidArg	pSearch or pReplace is set to NULL. If pResult and pWritten are NULL.
	P6R::eAccessFault	The compile function has not be successfully called.
	P6R::eNoMemory	Insufficent memory to process the regex.
	P6R::eTooSmall	pResult too small for the resulting string, required size in pSize.