Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

copysign — funzione matematica C23

`copysign(x, y)` di `<math.h>` restituisce la magnitudine di `x` con il segno di `y`; se `x` è NaN, il risultato è un NaN con il segno di `y`. Se uno dei valori è unsigned, C23 rende implementation-defined l’eventuale segno del risultato.

Versione: C23

Sintassi

double copysign(double x, double y);

copysign(x, y) di <math.h> restituisce la magnitudine di x con il segno di y; se x è NaN, il risultato è un NaN con il segno di y. Se uno dei valori è unsigned, C23 rende implementation-defined l’eventuale segno del risultato.

L’esempio trasferisce il segno di -0.0 a 3.5, ottenendo -3.5, e quello di -1.0 allo zero. -3.5 1 usa signbit per mostrare lo zero negativo che un confronto ordinario con zero non distingue.

Non sostituire la funzione con una moltiplicazione: il bit di segno conta anche per zero e NaN. Con zero con segno ma aritmetica incoerente per −0, l’implementazione dovrebbe considerare positivo lo zero; sotto Annex F/IEC 60559 non solleva eccezioni neppure per signaling NaN ed è indipendente dall’arrotondamento.

Esempi

#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;
}

Risultato

-3.5 1

L’esempio trasferisce il segno di `-0.0` a `3.5`, ottenendo `-3.5`, e quello di `-1.0` allo zero. `-3.5 1` usa `signbit` per mostrare lo zero negativo che un confronto ordinario con zero non distingue.

Fonti