Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

copysign — fonction mathématique C23

`copysign(x, y)` de `<math.h>` renvoie la magnitude de `x` avec le signe de `y` ; si `x` est NaN, le résultat est un NaN portant le signe de `y`. Si une valeur est non signée, C23 rend le signe éventuel du résultat dépendant de l’implémentation.

Version : C23

Syntaxe

double copysign(double x, double y);

copysign(x, y) de <math.h> renvoie la magnitude de x avec le signe de y ; si x est NaN, le résultat est un NaN portant le signe de y. Si une valeur est non signée, C23 rend le signe éventuel du résultat dépendant de l’implémentation.

L’exemple transfère le signe de -0.0 à 3.5, donnant -3.5, puis celui de -1.0 à zéro. -3.5 1 emploie signbit pour révéler le zéro négatif qu’une comparaison ordinaire à zéro ne distingue pas.

Ne remplacez pas cette fonction par une multiplication : le bit de signe compte aussi pour zéro et NaN. Avec zéro signé mais arithmétique incohérente pour −0, l’implémentation devrait considérer zéro positif ; sous Annex F/IEC 60559, aucune exception, même pour un NaN signalant, et aucun effet du mode d’arrondi.

Exemples

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

Résultat

-3.5 1

L’exemple transfère le signe de `-0.0` à `3.5`, donnant `-3.5`, puis celui de `-1.0` à zéro. `-3.5 1` emploie `signbit` pour révéler le zéro négatif qu’une comparaison ordinaire à zéro ne distingue pas.

Sources