Developer Reference

  • 2020
  • 07/15/2020
  • Public Content
Contents

TrimCAny
,
TrimStartCAny
,
TrimEndCAny

DEPRECATED. Delete all occurrences of any of the specified symbols in the beginning and in the end of the source string.

Syntax

IppStatus ippsTrimCAny_8u(const Ipp8u*
pSrc
, int
srcLen
, const Ipp8u*
pTrim
, int
trimLen
, Ipp8u*
pDst
, int*
pDstLen
);
IppStatus ippsTrimStartCAny_8u(const Ipp8u*
pSrc
, int
srcLen
, const Ipp8u*
pTrim
, int
trimLen
, Ipp8u*
pDst
, int*
pDstLen
);
IppStatus ippsTrimEndCAny_8u(const Ipp8u*
pSrc
, int
srcLen
, const Ipp8u*
pTrim
, int
trimLen
, Ipp8u*
pDst
, int*
pDstLen
);
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.
pTrim
Pointer to the array containing the specified elements.
trimLen
Number of elements in the array.
pDst
Pointer to the destination string.
pDstLen
Pointer to the computed number of elements in the destination string.
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/.
The function
ippsTrimCAny
deletes all occurrences of any of the specified elements stored in the array
pTrim
if they are present either in the beginning or in the end of the source string
pSrc
, and stores the result string containing
pDstLen
elements in
pDst
. The function stops operation when it finds the first non-matching element. The functions
ippsTrimStartCAny
and
ippsTrimEndCAny
perform this operation only in the beginning or in the end of the source string
pSrc
, respectively. The operation is case-sensitive.
Code example  shows how to use the function
ippsTrimCAny_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
srcLen
or
trimLen
is negative.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804