Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6ISafeString::stristr ( const P6CHAR searchIn,
const P6CHAR searchFor,
P6SIZE  cchMax,
P6CHAR **  ppRetptr 
)
pure virtual

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
SuccessP6R::eOkThe search was processed without error. If *ppRetptr is not NULL, then a match was found, otherwise a match was not found.
FailureP6R::eInvalidArgsearchIn, searchFor, or ppRetptr is NULL or cchMax is zero
P6R::eNotFoundsearchFor was not found in searchIn
P6R::eTooBigsearchIn is longer than cchMax characters.