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);

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

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