WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

_Imaginary — optionale imaginäre Typen

_Imaginary bezeichnet einen Typ, der einen rein imaginären Wert enthält. Die Unterstützung ist optional: Allein die Auswahl des C23-Modus garantiert nicht, dass der Typ verfügbar ist.

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

Syntax

float _Imaginary name;
double _Imaginary name;
long double _Imaginary name;

Anhang G.2 des Entwurfs N3096 beschreibt float _Imaginary, double _Imaginary und long double _Imaginary. Anders als _Complex stellen diese Typen nur einen Imaginärteil dar, nicht ein Paar aus Real- und Imaginärteil.

Prüfe vor der Verwendung, ob die Implementierung den Typ unterstützt. Leite die Unterstützung nicht aus einem C23-Compiler-Flag ab; das Verhalten in einer Produktionslaufzeit wurde nicht bestätigt.

Das Beispiel bindet <complex.h> bedingungslos ein. C23 erlaubt Implementierungen ohne Unterstützung für komplexe Zahlen, diesen Header wegzulassen. Wenn die Direktive #include keinen Header bezeichnet, den die Implementierung verarbeiten kann, verlangt C23 eine Diagnosemeldung, aber keinen Abbruch der Übersetzung vor der Prüfung von _Imaginary_I. Das Beispiel ist nicht auf Implementierungen portierbar, die den Header weglassen. Nach erfolgreicher Einbindung des Headers erzeugt das Beispiel bei definiertem Makro _Imaginary_I einen imaginären Wert und wandelt ihn in _Complex um, um beide Komponenten auszugeben. Ist das Makro nicht definiert, gibt das Beispiel imaginary types unavailable aus, statt _Imaginary zu verwenden.

Beispiele

#include <complex.h>
#include <stdio.h>

int main(void)
{
#ifdef _Imaginary_I
    double _Imaginary y = 3.0 * _Imaginary_I;
    double _Complex z = y;
    printf("%.0f %.0f\n", creal(z), cimag(z));
#else
    puts("imaginary types unavailable");
#endif
    return 0;
}

Ergebnis

imaginary types unavailable

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