CKTIS / C++
static_cast — expliciete typeconversie
static_cast<T>(expression) converteert een expressie expliciet naar T volgens de conversieregels van de taal. De compiler controleert of de conversie is toegestaan, maar garandeert niet dat de waarde behouden blijft of dat een downcast binnen een klassenhiërarchie geldig is.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
static_cast<T>(expression)static_cast<T>(expression) vraagt om een expliciete conversie naar T. Het ondersteunt onder andere numerieke conversies, conversies van enumeraties en initialisatie met geschikte explicit-constructors of conversiefuncties. static_cast kan const of volatile niet verwijderen van het type waarnaar een pointer wijst of een referentie verwijst. Bij een conversie naar een waarde kunnen kwalificaties op het hoogste niveau wel wegvallen. Zo is static_cast<int*>(p) geldig als p het type int* const heeft: de resulterende pointerwaarde heeft geen const op het hoogste niveau, terwijl het type waarnaar de pointer wijst onveranderd blijft.
Een conversie naar een lvalue-referentie levert een lvalue op; naar een rvalue-referentie naar een object levert deze een xvalue op. In andere gevallen levert de conversie een prvalue op, behalve dat een rvalue-referentie naar een functie een lvalue oplevert. Een conversie naar void verwerpt de waarde van de expressie, maar niet de uitvoering ervan.
Een toegestane conversie van een basisklasse naar een afgeleide klasse controleert tijdens runtime niet het werkelijke type van het object. Een onjuist object leidt tot ongedefinieerd gedrag; een nullpointer omzetten levert een nullpointer op. Een downcast via een virtuele basisklasse is verboden.
Bij conversie van een drijvendekommagetal naar int wordt het fractionele deel richting nul afgekapt. Als de afgekapt waarde niet in int past, is het gedrag ongedefinieerd. In het voorbeeld voorkomt het omzetten van total vóór de deling een gehele deling. Het achteraf omzetten van het resultaat van total / count kan het verloren fractionele deel niet terughalen.
Voorbeelden
#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';
}
Resultaat
3.5 -3
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.