WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

static_cast — explizite Typumwandlung

static_cast<T>(expression) wandelt einen Ausdruck gemäß den Umwandlungsregeln der Sprache explizit in T um. Der Compiler prüft, ob die Umwandlung zulässig ist, garantiert aber weder den Erhalt des Werts noch die Gültigkeit eines Downcasts innerhalb einer Klassenhierarchie.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

static_cast<T>(expression)

static_cast<T>(expression) fordert eine explizite Umwandlung in T an. Der Operator unterstützt unter anderem numerische und Aufzählungstyp-Umwandlungen sowie Initialisierungen mit passenden explicit-Konstruktoren oder Konvertierungsfunktionen. static_cast kann weder const noch volatile von dem Typ entfernen, auf den ein Zeiger zeigt oder auf den sich eine Referenz bezieht. Bei einer Umwandlung in einen Wert können Qualifizierer auf der obersten Ebene jedoch entfallen. So ist static_cast<int*>(p) zulässig, wenn p den Typ int* const hat: Der resultierende Zeigerwert hat kein const auf der obersten Ebene, und der Typ, auf den der Zeiger zeigt, bleibt unverändert.

Eine Umwandlung in eine Lvalue-Referenz ergibt ein Lvalue; eine Umwandlung in eine Rvalue-Referenz auf ein Objekt ergibt ein Xvalue. Andernfalls entsteht ein Prvalue, außer bei einer Rvalue-Referenz auf eine Funktion, die ein Lvalue ergibt. Eine Umwandlung in void verwirft den Wert des Ausdrucks, nicht dessen Ausführung.

Ein zulässiger Cast von einer Basis- zu einer abgeleiteten Klasse prüft zur Laufzeit nicht den tatsächlichen Typ des Objekts. Ein ungeeignetes Objekt führt zu undefiniertem Verhalten; die Umwandlung eines Nullzeigers ergibt einen Nullzeiger. Ein Downcast über eine virtuelle Basisklasse ist unzulässig.

Bei der Umwandlung einer Gleitkommazahl in int wird der Nachkommateil in Richtung null abgeschnitten. Passt der abgeschnittene Wert nicht in int, ist das Verhalten undefiniert. Im Beispiel verhindert die Umwandlung von total vor der Division eine Ganzzahldivision. Wird erst das Ergebnis von total / count umgewandelt, lässt sich der verlorene Nachkommateil nicht wiederherstellen.

Beispiele

#include <iostream>

int main() {
    const int total = 7;
    const int count = 2;
    const double ratio = static_cast<double>(total) / count;
    const int truncated = static_cast<int>(-3.75);

    std::cout << ratio << '\n' << truncated << '\n';
}

Ergebnis

3.5
-3

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