Espacios de nombres
Variantes

    std::copysign, std::copysignf, std::copysignl

    De cppreference.com
     
    C++
    Apoyo de compiladores
    Implementaciones independientes y albergadas
    Lenguaje
    Biblioteca estándar
    Encabezados de la biblioteca estándar
    Requisitos denominados
    Macros de prueba de característica (C++20)
    Biblioteca de apoyo del lenguaje
    Biblioteca de conceptos (C++20)
    Biblioteca de diagnósticos
    Biblioteca de gestión de memoria
    Biblioteca de metaprogramación (C++11)
    Biblioteca de servicios generales
    Biblioteca de contenedores
    Biblioteca de iteradores
    Biblioteca de rangos (C++20)
    Biblioteca de algoritmos
    Biblioteca de cadenas
    Biblioteca de procesamiento de texto
    Biblioteca numérica
    Biblioteca de fecha y hora
    Biblioteca de entrada/salida
    Biblioteca del sistema de archivos (C++17)
    Biblioteca de apoyo de concurrencia (C++11)
    Biblioteca de apoyo de ejecución (C++26)
    Especificaciones técnicas
    Índice de símbolos
    Bibliotecas externas
     
    Biblioteca numérica
    Funciones matemáticas comunes
    Funciones matemáticas especiales (C++17)
    Constantes matemáticas (C++20)
    Algoritmos básicos de álgebra lineal (C++26)
    Entorno de punto flotante (C++11)
    Números complejos
    Arrays numéricos
    Generación de números pseudoaleatorios
    Operaciones de factores
    (C++17)
    (C++17)
    Interpolaciones
    (C++20)
    (C++20)
    Saturación aritmética
    (C++26)
    (C++26)
    (C++26)
    (C++26)
    (C++26)

    Operaciones numéricas genéricas
    (C++11)
    (C++23)
    (C++17)
    (C++17)
    (C++17)
    (C++17)
    (C++17)
    (C++17)
    Operaciones de bits
    (C++20)
    (C++23)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
     
    Funciones matemáticas comunes
    Funciones
    Operaciones básicas
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    (C++11)(C++11)(C++11)
    Funciones exponenciales
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    Funciones de potencias
    (C++11)
    (C++11)
    Funciones trigonométricas e hiperbólicas
    (C++11)
    (C++11)
    (C++11)
    Funciones de error y gamma
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    Operaciones de punto flotante del entero más cercano
    (C++11)(C++11)(C++11)
    (C++11)
    (C++11)
    (C++11)(C++11)(C++11)
    Funciones de manipulación de punto flotante
    (C++11)(C++11)
    (C++11)
    (C++11)
    (C++11)(C++11)
    (C++11)
    Clasificación/comparación
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    Constantes de macro
    (C++11)(C++11)(C++11)(C++11)(C++11)
     
    <tbody> </tbody>
    Definido en el archivo de encabezado <cmath>
    float copysign ( float mag, float sgn );
    		 (1) (desde C++11)
    (constexpr since C++23)
    float copysignf( float mag, float sgn );
    		 (2) (desde C++11)
    (constexpr since C++23)
    double copysign ( double mag, double sgn );
    		 (3) (desde C++11)
    (constexpr since C++23)
    long double copysign ( long double mag, long double sgn );
    		 (4) (desde C++11)
    (constexpr since C++23)
    long double copysignl( long double mag, long double sgn );
    		 (5) (desde C++11)
    (constexpr since C++23)
    Promovido copysign ( Aritmético1 mag, Aritmético2 sgn );
    		 (6) (desde C++11)
    (constexpr since C++23)
    1-5) Compone un valor de punto flotante con la magnitud de mag y el signo de sgn.
    6) Un conjunto de sobrecargas o una función de plantilla para todas las combinaciones de argumentos de tipo aritmético no cubiertas por (1-5). Si cualquier argumento es de 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 es siempre double.

    Parámetros

    mag, sgn - Valores de punto flotante.

    Valor de retorno

    See More

    Si no ocurren errores, se devuelve el valor de punto flotante con la magnitud de mag y el signo de sgn.

    Si mag es NaN, entonces se devuelve NaN con el signo de sgn.

    Si sgn es -0, el resultado solo es negativo si la implementación admite el cero con signo de forma consistente en las operaciones aritméticas.

    Manejo de errores

    Esta función no está sujeta a ninguno de los errores especificados en math_errhandling.

    Si la implementación admite la aritmética de punto flotante de la IEEE (IEC 60559):

    • El valor devuelto es exacto (nunca se genera FE_INEXACT) e independiente del modo de redondeo actual.

    Notas

    std::copysign es la única manera portátil de manipular el signo de un valor NaN (también puede usarse signbit para examinar el signo de un NaN).

    Ejemplo

    Ejecuta este código
    #include <iostream>
#include <cmath>

int main()
{
    std::cout << std::showpos
              << "copysign(1.0,+2.0) = " << std::copysign(1.0,+2.0) << '\n'
              << "copysign(1.0,-2.0) = " << std::copysign(1.0,-2.0) << '\n'
              << "copysign(inf,-2.0) = " << std::copysign(INFINITY,-2.0) << '\n'
              << "copysign(NaN,-2.0) = " << std::copysign(NAN,-2.0) << '\n';
}

    Salida: 

    copysign(1.0,+2.0) = 1
copysign(1.0,-2.0) = -1
copysign(inf,-2.0) = -inf
copysign(NaN,-2.0) = -nan

    Véase también

    (C++11)(C++11)
    		 Valor absoluto de un valor de punto flotante (|x|)
    (función) [editar]
    (C++11)
    		 Comprueba si el número dado es negativo
    (función) [editar]
    Documentación de C para copysign