Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

_mm_round_ps

Microsoft Specific

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

__m128 _mm_round_ps( 
   __m128 a,
   const int cntrl 
);
[in] a

A 128-bit parameter that contains four 32-bit floating point values.

[in] cntrl

A constant that specifies control fields for the rounding operation.

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

r0 := RND(a0)
r1 := RND(a1)
r2 := RND(a2)
r3 := RND(a3)

Intrinsic

Architecture

_mm_round_ps

x86, x64

Header file <smmintrin.h>

r0-r3, a0-a3, and b0-b3 are the sequentially ordered 32-bit components of return value r and parameters a and b, respectively. r0, a0, and b0 are the least significant 32 bits.

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 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.

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

int main ()
{
    __m128 a;
    const int cntrl = _MM_FROUND_FLOOR;

    a.m128_f32[0] = 9.9375;
    a.m128_f32[1] = 5964.125;
    a.m128_f32[2] = -237.875;
    a.m128_f32[3] = -0.125;

    __m128 res = _mm_round_ps(a, cntrl);

    printf_s("Original a: %f\t%f\t%f\t%f\n",
                a.m128_f32[0], a.m128_f32[1], a.m128_f32[2], a.m128_f32[3]);
    printf_s("Result res: %f\t%f\t%f\t%f\n",
                res.m128_f32[0], res.m128_f32[1], res.m128_f32[2], res.m128_f32[3]);
    return 0;
}
Original a: 9.937500 5964.125000 -237.875000 -0.125000 Result res: 9.000000 5964.000000 -238.000000 -1.000000
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.