std::fdim, std::fdimf, std::fdiml
De cppreference.com
<tbody>
</tbody>
| Definido en el archivo de encabezado <cmath>
|
||
float fdim ( float x, float y ); |
(1) | (desde C++11) (constexpr since C++23) |
float fdimf( float x, float y ); |
(2) | (desde C++11) (constexpr since C++23) |
double fdim ( double x, double y ); |
(3) | (desde C++11) (constexpr since C++23) |
long double fdim ( long double x, long double y ); |
(4) | (desde C++11) (constexpr since C++23) |
long double fdiml( long double x, long double y ); |
(5) | (desde C++11) (constexpr since C++23) |
Promovido fdim ( Aritmético1 x, Aritmético2 y ); |
(6) | (desde C++11) (constexpr since C++23) |
1-5) Devuelve la diferencia positiva entre
x e y, es decir, si x>y, devuelve x-y, de lo contrario (si x≤y), devuelve +0.6) Un conjunto de sobrecargas o una plantilla de función para todas las combinaciones de los argumentos de tipo aritmético no cubiertas por (1-5). Si algún argumento tiene tipo entero, se convierte a
double. Si cualquier argumento es long double, entonces el tipo de retorno Promovido también es long double, de lo contrario el tipo de retorno siempre es double.Parámetros
| x, y | - | Valores de tipos de punto flotante o tipos enteros. |
Valor de retorno
Si tiene éxito, devuelve la diferencia positiva entre entre x e y.
Si se produce un error de rango debido a desbordamiento, se devuelve HUGE_VAL, +HUGE_VALF, o +HUGE_VALL.
Si se produce un error de rango debido a subdesbordamiento, se devuelve el valor correcto (después del redondeo).
Manejo de errores
Los errores se informan como se especifica en math_errhandling.
Si la implementación admite la aritmética de punto flotante IEEE (IEC 60559):
- Si cualquiera de los argumentos es NaN, se devuelve NaN.
Notas
Equivalente a std::fmax(x-y, 0), excepto por los requerimientos de manejo de NaN.
Ejemplo
Ejecuta este código
#include <iostream>
#include <cmath>
#include <cerrno>
#include <cstring>
#include <cfenv>
#ifndef __GNUC__
#pragma STDC FENV_ACCESS ON
#endif
int main()
{
std::cout << "fdim(4, 1) = " << std::fdim(4, 1)
<< " fdim(1, 4) = " << std::fdim(1, 4) << '\n'
<< "fdim(4,-1) = " << std::fdim(4, -1)
<< " fdim(1,-4) = " << std::fdim(1, -4) << '\n';
// manejo de errores
errno = 0;
std::feclearexcept(FE_ALL_EXCEPT);
std::cout << "fdim(1e308, -1e308) = " << std::fdim(1e308, -1e308) << '\n';
if (errno == ERANGE)
std::cout << " errno == ERANGE: " << std::strerror(errno) << '\n';
if (std::fetestexcept(FE_OVERFLOW))
std::cout << " Se generó FE_OVERFLOW\n";
}
Salida:
fdim(4, 1) = 3 fdim(1, 4) = 0
fdim(4,-1) = 5 fdim(1,-4) = 5
fdim(1e308, -1e308) = inf
errno == ERANGE: Resultado numérico fuera de rango
Se generó FE_OVERFLOW
Véase también
(C++11) |
Calcula el valor absoluto de un valor entero (|x|) (función) |
(C++11)(C++11)(C++11) |
El mayor de dos valores de punto flotante (función) |
Documentación de C para fdim
| |