RealToCplx
RealToCplx
Returns a complex vector constructed from the real and imaginary parts of two real vectors.
Syntax
IppStatus ippsRealToCplx_16s(const Ipp16s*
pSrcRe
, const Ipp16s*
pSrcIm
, Ipp16sc*
pDst
, int
len
);
IppStatus ippsRealToCplx_32f(const Ipp32f*
pSrcRe
, const Ipp32f*
pSrcIm
, Ipp32fc*
pDst
, int
len
);
IppStatus ippsRealToCplx_64f(const Ipp64f*
pSrcRe
, const Ipp64f*
pSrcIm
, Ipp64fc*
pDst
, int
len
);
Include Files
ipps.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
Libraries:
ippcore.lib
,
ippvm.lib
Parameters
- pSrcRe
- Pointer to the vector with real parts of complex elements.
- pSrcIm
- Pointer to the vector with imaginary parts of complex elements.
- pDst
- Pointer to the destination vector.
- len
- Number of elements in the vector.
Description
This function returns a complex vector
pDst
constructed from the real and imaginary parts of the input vectors pSrcRe
and pSrcIm
. If
pSrcRe
is NULL
, the real component of the vector is set to zero.If
pSrcIm
is NULL
, the imaginary component of the vector is set to zero.Note that the pointers cannot be both
NULL
.Return Values
- ippStsNoErr
- Indicates no error.
- ippStsNullPtrErr
- Indicates an error when thepDstpointer isNULLNULL. The pointerpSrcReorpSrcImcan beNULL.
- ippStsSizeErr
- Indicates an error whenlenis less than or equal to zero.
Example
/******************************************************************************* * Copyright 2015-2020 Intel Corporation. * * This software and the related documents are Intel copyrighted materials, and * your use of them is governed by the express license under which they were * provided to you (License). Unless the License provides otherwise, you may not * use, modify, copy, publish, distribute, disclose or transmit this software or * the related documents without Intel's prior written permission. * * This software and the related documents are provided as is, with no express * or implied warranties, other than those that are expressly stated in the * License. *******************************************************************************/ #include <stdio.h> #include "ipp.h" /* Next two defines are created to simplify code reading and understanding */ #define EXIT_MAIN exitLine: /* Label for Exit */ #define check_sts(st) if((st) != ippStsNoErr) goto exitLine; /* Go to Exit if Intel(R) Integrated Primitives (Intel(R) IPP) function returned status different from ippStsNoErr */ /* Results of ippMalloc() are not validated because Intel(R) IPP functions perform bad arguments check and will return an appropriate status */ int main() { Ipp16s pValsIm[] = { 1, -3, 5, -7, 18, -24, 35, 48 }; Ipp16s pValsRe[] = { 1, -3, 5, -7, 18, -24, 35, 48 }; Ipp16sc pOutVals[8]; IppStatus status; int i; printf("\nSource vector\n"); printf("\nRe="); for (i = 0; i < 8; i++) printf("%d ", pValsRe[i]); printf("\nIm="); for (i = 0; i < 8; i++) printf("%d ", pValsRe[i]); check_sts(status = ippsRealToCplx_16s(pValsRe, pValsIm, pOutVals, 8)); printf("\nResult values vector\n"); for (i = 0; i < 8; i++) printf("%d, %d; ", pOutVals[i].re, pOutVals[i].im); EXIT_MAIN printf("\nExit status %d (%s)\n", (int)status, ippGetStatusString(status)); return (int)status; }