Find a sub-string (case-insensative).
This method returns a pointer to the first occurance of searchFor in searchIn, and if found returns a pointer to it's position in the searched string. searchIn must be smaller than cchMax characters.
- Parameters:
-
| searchIn | [in] A pointer to the string to search. |
| searchFor | [in] A pointer to the string to searhc for. |
| cchMax | [in] The maximum number of characters to search. P6SAFE_MAX_CCH can be used if the input size is unknown. |
| ppRetptr | [out] The address of a P6R::P6CHAR pointer in which will be placed a pointer to the first occurance of the sub-string if found. |
- Returns:
Success | P6R::eOk | The search was processed without error. If *ppRetptr is not NULL, then a match was found, otherwise a match was not found. |
Failure | P6R::eInvalidArg | searchIn, searchFor, or ppRetptr is NULL or cchMax is zero |
P6R::eNotFound | searchFor was not found in searchIn |
P6R::eTooBig | searchIn is longer than cchMax characters. |