# fegetround, fesetround

> C++ Atlas: `cppatlas.com/w/c/numeric/fenv/feround` | Source: https://en.cppreference.com/w/c/numeric/fenv/feround | Domain: Numerics | Standards: C99

1) Attempts to establish the floating-point rounding direction equal to the argument round, which is expected to be one of the floating-point rounding macros.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <fenv.h>
int fesetround( int round ); // (1) (since C99)
int fegetround(); // (2) (since C99)
```

1) Attempts to establish the floating-point rounding direction equal to the argument `round`, which is expected to be one of the floating-point rounding macros.

2) Returns the value of the floating-point rounding macro that corresponds to the current rounding direction.

### Parameters

- `round` - rounding direction, one of floating-point rounding macros

### Return value

1) `​0​` on success, non-zero otherwise.

2) the floating-point rounding macro describing the current rounding direction or a negative value if the direction cannot be determined.

### Notes

The current rounding mode, reflecting the effects of the most recent `fesetround`, can also be queried with `FLT_ROUNDS`.

### Example

```c
#include <fenv.h>
#include <math.h>
#include <stdio.h>

// #pragma STDC FENV_ACCESS ON

void show_fe_current_rounding_direction(void)
{
    printf("current rounding direction:  ");
    switch (fegetround())
    {
           case FE_TONEAREST:  printf ("FE_TONEAREST");  break;
           case FE_DOWNWARD:   printf ("FE_DOWNWARD");   break;
           case FE_UPWARD:     printf ("FE_UPWARD");     break;
           case FE_TOWARDZERO: printf ("FE_TOWARDZERO"); break;
           default:            printf ("unknown");
    };
    printf("\n");
}

int main(void)
{
    /* Default rounding direction */
    show_fe_current_rounding_direction();
    printf("+11.5 -> %+4.1f\n", rint(+11.5)); /* midway between two integers */
    printf("+12.5 -> %+4.1f\n", rint(+12.5)); /* midway between two integers */

    /* Save current rounding direction. */
    int curr_direction = fegetround();

    /* Temporarily change current rounding direction. */
    fesetround(FE_DOWNWARD);
    show_fe_current_rounding_direction();
    printf("+11.5 -> %+4.1f\n", rint(+11.5));
    printf("+12.5 -> %+4.1f\n", rint(+12.5));

    /* Restore default rounding direction. */
    fesetround(curr_direction);
    show_fe_current_rounding_direction();

    return 0;
}
```

Possible output:

```text
current rounding direction:  FE_TONEAREST
+11.5 -> +12.0
+12.5 -> +12.0
current rounding direction:  FE_DOWNWARD
+11.5 -> +11.0
+12.5 -> +12.0
current rounding direction:  FE_TONEAREST
```

### References

- C23 standard (ISO/IEC 9899:2024):

  - 7.6.3.1 The fegetround function (p: TBD)

  - 7.6.3.2 The fesetround function (p: TBD)

- C17 standard (ISO/IEC 9899:2018):

  - 7.6.3.1 The fegetround function (p: TBD)

  - 7.6.3.2 The fesetround function (p: TBD)

- C11 standard (ISO/IEC 9899:2011):

  - 7.6.3.1 The fegetround function (p: 212)

  - 7.6.3.2 The fesetround function (p: 212-213)

- C99 standard (ISO/IEC 9899:1999):

  - 7.6.3.1 The fegetround function (p: 193)

  - 7.6.3.2 The fesetround function (p: 193-194)

### See also

- [`nearbyint`](https://en.cppreference.com/w/c/numeric/math/nearbyint) (C99), [`nearbyintf`](https://en.cppreference.com/w/c/numeric/math/nearbyint) (C99), [`nearbyintl`](https://en.cppreference.com/w/c/numeric/math/nearbyint) (C99): rounds to an integer using current rounding mode (function)
- [`rint`](https://en.cppreference.com/w/c/numeric/math/rint) (C99), [`rintf`](https://en.cppreference.com/w/c/numeric/math/rint) (C99), [`rintl`](https://en.cppreference.com/w/c/numeric/math/rint) (C99), [`lrint`](https://en.cppreference.com/w/c/numeric/math/rint) (C99), [`lrintf`](https://en.cppreference.com/w/c/numeric/math/rint) (C99), [`lrintl`](https://en.cppreference.com/w/c/numeric/math/rint) (C99), [`llrint`](https://en.cppreference.com/w/c/numeric/math/rint) (C99), [`llrintf`](https://en.cppreference.com/w/c/numeric/math/rint) (C99), [`llrintl`](https://en.cppreference.com/w/c/numeric/math/rint) (C99): rounds to an integer using current rounding mode with exception if the result differs (function)
- [C++ documentation for `fegetround, fesetround`](https://en.cppreference.com/w/cpp/numeric/fenv/feround)

---
Attribution: content from https://en.cppreference.com/w/c/numeric/fenv/feround (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.