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

Remove

DEPRECATED. Removes a specified number of elements from the string.

Syntax

IppStatus ippsRemove_8u(const Ipp8u* pSrc, int srcLen, Ipp8u* pDst, int startIndex, int len);

IppStatus ippsRemove_8u_I(Ipp8u* pSrcDst, int* pSrcDstLen, int startIndex, int len);

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.

srcLen

Number of elements in the source string.

pDst

Pointer to the destination string.

pSrcDst

Pointer to the source and destination string for in-place operation.

pSrcDstLen

Pointer to the number of elements in the source and destination string for in-place operation.

startIndex

Index of the starting point.

len

Number of elements to be removed.

Description

NOTE:
This function is deprecated and will be removed in a future release. If you have concerns, open a ticket and provide feedback at https://supporttickets.intel.com/.

This function removes the len elements from a source string pSrc of length srcLen. Starting position is specified by startIndex. The result is stored in the pDst.

The in-place flavors of ippsRemove remove the len elements from the source string pSrcDst and store the result in the destination string pSrcDst.

Code example  shows how to use the function ippsRemove_8u_I.

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 one of the srcLen, len, pSrcSdtLen, startIndex is negative, or (startIndex+len) is greater than srcLen or pSrcDstLen.