Developer Reference

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

RegExpReplace

DEPRECATED. Performs find and replace operation.

Syntax

IppStatus ippsRegExpReplace_8u(const Ipp8u*
pSrc
, int*
pSrcLenOffset
, Ipp8u*
pDst
, int*
pDstLen
, IppRegExpFind*
pFind
, int*
pNumFind
, IppRegExpState*
pRegExpState
, IppRegExpReplaceState*
pReplaceState
);
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.
pSrcLenOffset
Pointer to length of the
pSrc
vector on input; its used length on output.
pDst
Pointer to the destination string.
pDstLen
Pointer to length of the
pDst
vector on input; its used length on output.
pFind
Array of pointers to the matching substrings.
pNumFind
Pointer to size of the array
pFind
on input, to number of matching substrings on output.
pRegExpState
Pointer to the compiled pattern structure.
pReplaceState
Pointer to the state structure for the find and replace operation.
Description
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 search through the
pSrcLen
elements of the source string
pSrc
for substrings that match the specified regular expression in accordance with the regular expression pattern that is stored in the structure
pRegExpState
. This state structure must be initialized by the
ippsRegExpInit
function beforehand. All found matches are replaced according to the replacement pattern that is stored in the structure
pReplaceState
. This structure must be initialized beforehand by the function
ippsRegExpReplaceInit
.
Initially the parameter
pNumFind
specifies the size of array
pFind
, the output parameter
pNumFind
returns the number of the matching substrings.
pFind->pFind
specifies the offset of the pointer to the matching substring, and
pFind->lenFind
- number of elements in the matching substring.
pFind
[0]
points to the substring that matches the whole regular expression,
pFind
[1]
points to the substring that matches the first grouping,
pFind
[2]
points to the substring that matches the second grouping, and so on.
The compiled regular expression pattern and/or replacement pattern can be used for different input strings in different combinations.
Return Values
ippStsNoErr
Indicates no error.
ippStsNullPtrErr
Indicates an error when one of the specified pointers is
NULL
.
ippStsSizeErr
Indicates an error when
pSrcLen
or
pDstLen
is less than or equal to zero.

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