CKTIS / C
copysign — funkcja matematyczna C23
`copysign(x, y)` z `<math.h>` zwraca wartość o module `x` i znaku `y`; gdy `x` jest NaN, wynikiem jest NaN ze znakiem `y`. C23 stanowi, że przy wartości bez znaku w którymkolwiek argumencie znak wyniku, jeśli istnieje, jest zależny od implementacji.
Wersja: C23
Składnia
double copysign(double x, double y);copysign(x, y) z <math.h> zwraca wartość o module x i znaku y; gdy x jest NaN, wynikiem jest NaN ze znakiem y. C23 stanowi, że przy wartości bez znaku w którymkolwiek argumencie znak wyniku, jeśli istnieje, jest zależny od implementacji.
Przykład przenosi znak -0.0 na 3.5, otrzymując -3.5, oraz znak -1.0 na zero. Wynik -3.5 1 używa signbit, by wykazać ujemne zero, którego zwykłe porównanie z zerem nie odróżnia.
Nie zastępuj tej funkcji mnożeniem: ważny jest bit znaku, także dla zera i NaN. Implementacja z zerem ze znakiem, lecz niespójną arytmetyką zera, powinna uważać znak zera za dodatni; w Annex F/IEC 60559 funkcja nie zgłasza wyjątków nawet dla sygnalizującego NaN i nie zależy od trybu zaokrąglania.
Przykłady
#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;
}
Wynik
-3.5 1
Przykład przenosi znak `-0.0` na `3.5`, otrzymując `-3.5`, oraz znak `-1.0` na zero. Wynik `-3.5 1` używa `signbit`, by wykazać ujemne zero, którego zwykłe porównanie z zerem nie odróżnia.