Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

copysign — função matemática C23

`copysign(x, y)` de `<math.h>` devolve a magnitude de `x` com o sinal de `y`; se `x` for NaN, resulta um NaN com o sinal de `y`. Se qualquer valor for unsigned, C23 torna o eventual sinal do resultado definido pela implementação.

Versão: C23

Sintaxe

double copysign(double x, double y);

copysign(x, y) de <math.h> devolve a magnitude de x com o sinal de y; se x for NaN, resulta um NaN com o sinal de y. Se qualquer valor for unsigned, C23 torna o eventual sinal do resultado definido pela implementação.

O exemplo transfere o sinal de -0.0 para 3.5, obtendo -3.5, e o de -1.0 para zero. -3.5 1 usa signbit para revelar o zero negativo que uma comparação normal com zero não distingue.

Não substituas a função por multiplicação: o bit de sinal conta também para zero e NaN. Com zero assinado mas aritmética incoerente para −0, recomenda-se que a implementação considere positivo o sinal do zero; sob Annex F/IEC 60559 não há exceções nem para NaN sinalizador e o modo de arredondamento não interfere.

Exemplos

#include <math.h>
#include <stdio.h>

int main(void) {
    double changed = copysign(3.5, -0.0);
    double negative_zero = copysign(0.0, -1.0);
    printf("%.1f %d\n", changed, signbit(negative_zero) != 0);
    return 0;
}

Resultado

-3.5 1

O exemplo transfere o sinal de `-0.0` para `3.5`, obtendo `-3.5`, e o de `-1.0` para zero. `-3.5 1` usa `signbit` para revelar o zero negativo que uma comparação normal com zero não distingue.

Fontes