Visible to Intel only — GUID: GUID-FFFA02DA-FCA3-47EC-ADBC-1FCCACEF9ACD
Visible to Intel only — GUID: GUID-FFFA02DA-FCA3-47EC-ADBC-1FCCACEF9ACD
Find, FindRev
DEPRECATED. Look for the first occurrence of the substring matching the specified string.
Syntax
IppStatus ippsFind_8u(const Ipp8u* pSrc, int len, const Ipp8u* pFind, int lenFind, int* pIndex);
IppStatus ippsFind_Z_8u(const Ipp8u* pSrcZ, const Ipp8u* pFindZ, int* pIndex);
IppStatus ippsFindRev_8u(const Ipp8u* pSrc, int len, const Ipp8u* pFind, int lenFind, int* pIndex);
Include Files
ippch.h
Domain Dependencies
Headers: ippcore.h, ippvm.h, ipps.h
Libraries: ippcore.lib, ippvm.lib, ipps.lib
Parameters
pSrc |
Pointer to the source string. |
pSrcZ |
Pointer to the zero-ended source string. |
len |
Number of elements in the source string. |
pFind |
Pointer to the reference string. |
pFindZ |
Pointer to the zero-ended reference string. |
lenFind |
Number of elements in the reference string. |
pIndex |
Pointer to the result index. |
Description
These functions search through the source string pSrc for a substring of elements that match the specified reference string pFind. Starting point of the first occurrence of the matching substring is stored in pIndex. If no matching substring is found, then pIndex is set to -1.
The function flavor ippsFind_Z operates with the zero-ended source and reference strings. The function ippsFindRev searches the source string in the reverse direction. The search is case-sensitive.
Return Values
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
Indicates an error condition if at least one of the specified pointers is NULL. |
ippStsLengthErr |
Indicates an error condition if len or lenFind is negative. |
Example
The code example below shows how to use the function ippsFind_8u.
Ipp8u string[] = "abracadabra"; */ ----------- 0123456789a */ Ipp8u substring[] = "abra"; Ipp8u any_of [] = "ftr"; int index; ippsFind_8u( string, sizeof (string) - 1, substring, sizeof (substring) - 1, &index ); printf ( "ippsFind_8u returned index = %d.\n", index ); ippsFindC_Z_8u( string, " c ", &index ); printf ( "ippsFind_Z_8u returned index = %d.\n", index ); ippsFindRevCAny_8u( string, sizeof (string) - 1, any_of , sizeof ( any_of ) - 1, &index ); printf ( "ippsFindRevCAny_8u returned index = %d.\n", index ); Output: ippsFind_8u returned index = 0. ippsFind_Z_8u returned index = 4. ippsFindRevCAny_8u returned index = 9.