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

MulPerm

Multiply the elements of two vectors stored in Perm format.

Syntax

Case 1: Not-in-place operation

IppStatus ippsMulPerm_32f(const Ipp32f* pSrc1, const Ipp32f* pSrc2, Ipp32f* pDst, int len);

IppStatus ippsMulPerm_64f(const Ipp64f* pSrc1, const Ipp64f* pSrc2, Ipp64f* pDst, int len);

Case 2: In-place operation

IppStatus ippsMulPerm_32f_I(const Ipp32f* pSrc, Ipp32f* pSrcDst, int len);

IppStatus ippsMulPerm_64f_I(const Ipp64f* pSrc, Ipp64f* pSrcDst, int len);

Include Files

ipps.h

Domain Dependencies

Headers: ippcore.h, ippvm.h

Libraries: ippcore.lib, ippvm.lib

Parameters

pSrc1, pSrc2

Pointers to the vectors whose elements are to be multiplied together.

pDst

Pointer to the destination vector which stores the result of the multiplication pSrc1[n] * pSrc2[n].

pSrc

Pointer to the vector whose elements are to be multiplied by the elements of pSrcDst in-place.

pSrcDst

Pointer to the source and destination vector (for the in-place operation).

len

Number of elements in the vector.

Description

This function multiplies the elements of the vector pSrc1 by the elements of the vector pSrc2, and stores the result in pDst.

The in-place flavors of ippsMulPerm multiply the elements of the vector pSrc by the elements of the vector pSrcDst, and store the result in pSrcDst.

The function multiplies the packed data according to their packed format. The data in Perm packed formats include several real values, the rest are complex. Thus, the function performs several real multiplication operations on real elements and complex multiplication operations on complex data. Such kind of packed data multiplication is usually used for signals filtering with the FFT transform when the element-wise multiplication is performed in the frequency domain.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error when the pSrcDst, pDst, pSrc1, pSrc2, or pSrc pointer is NULL.

ippStsSizeErr

Indicates an error when len is less than or equal to 0.