WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

copysign — mathematische C23-Funktion

`copysign(x, y)` aus `<math.h>` liefert den Betrag von `x` mit dem Vorzeichen von `y`; bei NaN als `x` entsteht NaN mit dem Vorzeichen von `y`. Ist einer der Werte vorzeichenlos, ist laut C23 das etwaige Ergebnisvorzeichen implementationsdefiniert.

Version: C23

Syntax

double copysign(double x, double y);

copysign(x, y) aus <math.h> liefert den Betrag von x mit dem Vorzeichen von y; bei NaN als x entsteht NaN mit dem Vorzeichen von y. Ist einer der Werte vorzeichenlos, ist laut C23 das etwaige Ergebnisvorzeichen implementationsdefiniert.

Das Beispiel überträgt das Vorzeichen von -0.0 auf 3.5 und erhält -3.5, außerdem das von -1.0 auf null. -3.5 1 nutzt signbit, um negative Null sichtbar zu machen, die ein gewöhnlicher Nullvergleich nicht unterscheidet.

Nicht durch Multiplikation ersetzen: Das Vorzeichenbit zählt auch bei Null und NaN. Bei vorzeichenbehafteter Null, aber inkonsistenter Negativnull-Arithmetik sollte die Implementierung Null als positiv ansehen; unter Annex F/IEC 60559 entstehen selbst bei signaling NaN keine Ausnahmen und der Rundungsmodus ist ohne Einfluss.

Beispiele

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

Ergebnis

-3.5 1

Das Beispiel überträgt das Vorzeichen von `-0.0` auf `3.5` und erhält `-3.5`, außerdem das von `-1.0` auf null. `-3.5 1` nutzt `signbit`, um negative Null sichtbar zu machen, die ein gewöhnlicher Nullvergleich nicht unterscheidet.

Quellen