WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::optional — ein Wert, der fehlen kann

std::optional<T> steht entweder für ein Objekt vom Typ T oder für keinen Wert. So lässt sich ein fehlendes Ergebnis von gültigen Werten wie 0 unterscheiden. Prüfe vor der Verwendung der Operatoren * und ->, ob ein Wert vorhanden ist.

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

Syntax

#include <optional>
std::optional<T> item;
std::optional<T> empty = std::nullopt;
if (item) { /* *item; item->member; */ }

std::optional<T> aus dem Header <optional> speichert einen Wert vom Typ T in seinem eigenen Objekt oder enthält keinen Wert. Es ist nützlich, wenn eine Funktion möglicherweise kein Ergebnis liefert, du aber keine Fehlerbeschreibung benötigst. Die Standardkonstruktion mit std::optional<T> item; erzeugt einen leeren Zustand; die Konstruktion mit einem Wert vom Typ T erzeugt einen Zustand mit einem Wert.

std::nullopt ist die Konstante, die keinen Wert bezeichnet, und std::nullopt_t ist ihr eigener Tag-Typ, nicht der Typ des gespeicherten Ergebnisses. Verwende return std::nullopt;, um ein leeres Ergebnis zurückzugeben, oder item = std::nullopt;, um den gespeicherten Wert zu entfernen.

std::optional::operator bool ist eine explizite Konvertierung, die das Vorhandensein eines Werts prüft; sie funktioniert in if (item), ähnlich wie item.has_value(). Sie prüft nicht den gespeicherten Wert selbst: Ein Objekt mit 0 oder false ergibt weiterhin true.

std::optional::operator* stellt den gespeicherten Wert als Referenz bereit, während std::optional::operator-> den Zugriff auf seine Member ermöglicht. Für beide muss ein Wert vorhanden sein. In C++23 ist die Verwendung eines dieser Operatoren bei einem leeren Objekt undefiniertes Verhalten; erwarte keine Ausnahme. Die Methode value() prüft diesen Zustand und wirft std::bad_optional_access, wenn kein Wert vorhanden ist.

Dieser Eintrag bezieht sich auf C++23: die Compiler-Option im Repository, ohne Bestätigung der Produktionslaufzeitumgebung. Der verlinkte Arbeitsentwurf wird aktualisiert und enthält auch spätere Erweiterungen; sein gesamter Inhalt darf nicht als C++23 behandelt werden.

Beispiele

#include <iostream>
#include <optional>

struct Item {
    int count;
};

std::optional<Item> find_item(bool available) {
    if (available) {
        return Item{0};
    }
    return std::nullopt;
}

int main() {
    const auto item = find_item(true);
    if (item) {
        std::cout << item->count << ' ' << (*item).count << '\n';
    }

    const auto missing = find_item(false);
    std::cout << std::boolalpha << missing.has_value() << '\n';
}

Ergebnis

0 0
false

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