Round

Computes integer value rounded to nearest for each vector element.

Syntax

IppStatus ippsRound_32f (const Ipp32f* pSrc, Ipp32f* pDst, Ipp32s len);

IppStatus ippsRound_64f (const Ipp64f* pSrc, Ipp64f* pDst, Ipp32s len);

Parameters

pSrc	Pointer to the source vector.
pDst	Pointer to the destination vector.
len	Number of elements in the vectors.

Description

The function ippsRound is declared in the ippvm.h file. This function computes a rounded to the nearest integer value for each element of the vector pSrc, and stores the result in the corresponding element of the vector pDst. Halfway values, that is, 0.5, -1.5, and the like, are rounded off away from zero, that is, 0.5 -> 1, -1.5 -> -2, and so on.

The example below shows how to use the function ippsRound.

Return Values

ippStsNoErr	Indicates no error.
ippStsNullPtrErr	Indicates an error when pSrc or pDst pointer is NULL.
ippStsSizeErr	Indicates an error when len is less than or equal to 0.

Using ippsRound Function

IppStatus ippsRound_32f_ sample(void)

    const Ipp32f x[4] = {-1.883, -0.265, 0.176, 1.752};

    Ipp32f y[4];

    IppStatus st = ippsRound_32f ( x, y, 4 );

    printf(" ippsRound_32f:\n");

    printf(" x = %.3f %.3f %.3f %.3f \n", x[0], x[1], x[2], x[3]);

    printf(" y = %.3f %.3f %.3f %.3f \n", y[0], y[1], y[2], y[3]);

    return st;

Output results:

ippsRound_32f:

x = -1.883 -0.265 0.176 1.752

y = -2.000  0.000 0.000 2.000