Developer Reference

  • 2021
  • 01/15/2021
  • Public Content
Contents

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 are deprecated and will be removed in a future release. If you have concerns, open a ticket and provide feedback at https://supporttickets.intel.com/.
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.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.