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.