rint(3)

NOMBRE
nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl - redondean al entero más cercano

BIBLIOTECA
Biblioteca Matemática (libm, -lm)

SINOPSIS
#include <math.h>

double nearbyint(double x);
float nearbyintf(float x);
long double nearbyintl(long double x);

double rint(double x);
float rintf(float x);
long double rintl(long double x);

    Requisitos de Macros de Prueba de Características para glibc (véase feature_test_macros(7)):

nearbyint(), nearbyintf(), nearbyintl():
    _POSIX_C_SOURCE >= 200112L || _ISOC99_SOURCE

rint():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || _XOPEN_SOURCE >= 500
        || /* Desde glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

rintf(), rintl():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Desde glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPCIÓN
Las funciones nearbyint(), nearbyintf() y nearbyintl() redondean su argumento a un valor entero en formato de coma flotante, utilizando la dirección de redondeo actual (véase fesetround(3)) y sin generar la excepción inexact. Cuando la dirección de redondeo actual es al entero más cercano, estas funciones redondean los casos intermedios al entero par de acuerdo con la norma IEEE-754.

Las funciones rint(), rintf() y rintl() hacen lo mismo, pero generarán la excepción inexact (FE_INEXACT. Se puede comprobar mediante fetestexcept(3)) cuando el valor del resultado difiere del del argumento.

VALOR DEVUELTO
Estas funciones devuelven el valor del entero redondeado.

Si x es entero, +0, -0, NaN o infinito, se devuelve x tal cual.

ERRORES
No suceden errores.

ATRIBUTOS
Para obtener una explicación de los términos usados en esta sección, véase attributes(7).
Interfaz | Atributo | Valor
nearbyint(), nearbyintf(), nearbyintl(), rint(), rintf(), rintl() | Seguridad del hilo | Multi-hilo seguro

ESTÁNDARES
C11, POSIX.1-2008.

HISTORIAL
C99, POSIX.1-2001.

SUSv2 y POSIX.1-2001 contienen información sobre desbordamiento (que podría establecer errno en ERANGE o generar una excepción FE_OVERFLOW). En la práctica, el resultado no puede desbordarse en ningún equipo actual, por lo que esta gestión de errores carecía de sentido. Concretamente, el desbordamiento solo puede ocurrir cuando el valor máximo del exponente es menor que el número de bits de la mantisa. Para los números de coma flotante de 32 y 64 bits del estándar IEEE-754, el valor máximo del exponente es 127 (1023, respectivamente), y el número de bits de la mantisa, incluyendo el bit implícito, es 24 (53, respectivamente). Esto se eliminó en POSIX.1-2008.

Si se desea almacenar el valor redondeado en un tipo entero, probablemente sea mejor usar una de las funciones descritas en lrint(3).

VÉASE TAMBIÉN
ceil(3), floor(3), lrint(3), round(3), trunc(3)

TRADUCCIÓN
La traducción al español de esta página del manual fue creada por Miguel Pérez Ibars <mpi79470@alu.um.es> y Marcos Fouces <marcos@debian.org>

Esta traducción es documentación libre; lea la GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.

Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org.