Intel® Integrated Performance Primitives Developer Guide and Reference

ID 790148
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

FindC, FindRevC

DEPRECATED. Look for the first occurrence of the specified element within the source string.

Syntax

IppStatus ippsFindC_8u(const Ipp8u* pSrc, int len, Ipp8u valFind, int* pIndex);

IppStatus ippsFindC_Z_8u(const Ipp8u* pSrcZ, Ipp8u valFind, int* pIndex);

IppStatus ippsFindRevC_8u(const Ipp8u* pSrc, int len, Ipp8u valFind, 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 source zero-ended string.

len

Number of elements in the source string.

valFind

Value of the specified element.

pIndex

Pointer to the result index.

Description

NOTE:
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/.

Functions ippsFindC and ippsFindRevC are declared in the ippch.h file. These functions search through the source string pSrc for the first occurrence of the specified element with the value valFind. The position of this element is stored in pIndex. If no matching element is found, then pIndex is set to -1. The function flavor ippsFindC_Z operates with the zero-ended source string. The function ippsFindRevC searches the source string in the reverse direction. The search is case-sensitive.

Code example  shows how to use the function ippsFindC_Z_8u.

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 is negative.