Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła