WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

signbit — Vorzeichen eines Gleitkommawerts prüfen

Das Makro signbit aus <math.h> prüft, ob ein Gleitkommawert ein negatives Vorzeichen hat, auch bei Nullen, Unendlichkeiten und NaNs. Ein Ergebnis ungleich null muss nicht 1 sein.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <math.h>
int signbit(real-floating x);

signbit ist ein Makro aus <math.h> und keine gewöhnliche Funktion. In der Syntax steht real-floating für einen reellen Gleitkommatyp wie float, double oder long double; es ist kein Typname in C.

Das Ergebnis vom Typ int ist genau dann ungleich null, wenn das Vorzeichen als negativ bestimmt wird; andernfalls ist es null. Verwende !!signbit(x), um genau 0 oder 1 zu erhalten, statt das Ergebnis mit 1 zu vergleichen.

Das unterscheidet sich von x < 0.0: Eine unterstützte negative Null hat ein negatives Vorzeichen, ist aber nicht kleiner als null. Das Makro umfasst auch Unendlichkeiten und NaNs. Eine vorzeichenlose Null wird als positiv behandelt; bei anderen vorzeichenlosen Werten ist das Ergebnis implementationsdefiniert. „Vorzeichenlos“ bezieht sich hier auf den Gleitkommawert, nicht auf den Typ unsigned int.

Beispiele

#include <math.h>
#include <stdio.h>

int main(void)
{
    printf("%d %d %d\n",
           !!signbit(-2.0),
           !!signbit(0.0),
           !!signbit(2.0));
    return 0;
}

Ergebnis

1 0 0

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen