_mm_round_pd

Microsoft Specific

Emits the Streaming SIMD Extensions 4 (SSE4) instruction roundpd. This instruction rounds a 64-bit value by using the specified rounding control.

__m128d _mm_round_pd( 
   __m128d a,
   const int cntrl 
);

Parameters

• [in] a
  A 128-bit parameter that contains two 64-bit floating point values.

• [in] cntrl
  A constant that specifies control fields for the rounding operation.

Return value

A 128-bit parameter. The result can be expressed with the following equations:.

r0 := RND(a0)
r1 := RND(a1)

Requirements

Intrinsic	Architecture
_mm_round_pd	x86, x64

Header file <smmintrin.h>

Remarks

r0 and a0 are the low order 64 bits of return value r and parameter a. r1 and a1 are the high order 64 bits of return value r and parameter a.

The rounding function uses the cntrl parameter to determine how to compute a new value. The following table indicates what rounding mode will be used.

Rounding mode	Value	Description
_MM_FROUND_TO_NEAREST_INT	0x0	Round to nearest (even).
_MM_FROUND_TO_NEG_INF	0x1	Round down (toward -∞).
_MM_FROUND_TO_POS_INF	0x2	Round up (toward +∞).
_MM_FROUND_TO_ZERO	0x3	Round toward zero (truncate).
_MM_FROUND_CUR_DIRECTION	0x4	Use current MXCSR setting.

This table shows how cntrl determines whether an exception should be signaled when a SNaN is detected.

Precision exception handling	Value	Description
_MM_FROUND_RAISE_EXC	0x0	Signal precision exception on Signaling Not a Number (SNaN).
_MM_FROUND_NO_EXC	0x8	Do not signal precision exception on SNaN.

The following macros are also available to combine the above two fields:

Rounding mode and precision exception handling	Value
_MM_FROUND_NINT	MM_FROUND_TO_NEAREST_INT | _MM_FROUND_RAISE_EXC
_MM_FROUND_FLOOR	_MM_FROUND_TO_NEG_INF | _MM_FROUND_RAISE_EXC
_MM_FROUND_CEIL	_MM_FROUND_TO_POS_INF | _MM_FROUND_RAISE_EXC
_MM_FROUND_TRUNC	_MM_FROUND_TO_ZERO | _MM_FROUND_RAISE_EXC
_MM_FROUND_RINT	_MM_FROUND_CUR_DIRECTION | _MM_FROUND_RAISE_EXC
_MM_FROUND_NEARBYINT	_MM_FROUND_CUR_DIRECTION | _MM_FROUND_NO_EXC

Before you use this intrinsic, software must ensure that the underlying processor supports the instruction.

Example

#include <stdio.h>
#include <smmintrin.h>

int main ()
{
    __m128d a;
    const int cntrl = _MM_FROUND_NINT;

    a.m128d_f64[0] = 127.5;
    a.m128d_f64[1] = -315.125;

    __m128d res = _mm_round_pd(a, cntrl);

    printf_s("Original a: %f\t%f\n", a.m128d_f64[0], a.m128d_f64[1]);
    printf_s("Result res: %f\t%f\n", res.m128d_f64[0], res.m128d_f64[1]);

    return 0;
}

Original a: 127.500000  -315.125000
Result res: 128.000000  -315.000000

See Also

Reference

Compiler Intrinsics