WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::nullopt — einen fehlenden Wert explizit angeben

Mit `std::nullopt` gibst du ein leeres `std::optional` zurück oder leerst es, ohne ein fehlendes Ergebnis mit einem gültigen Wert wie null zu verwechseln.

Version: ISO C++23; implementation support may vary

Syntax

#include <optional>

std::optional<int> no_result() {
    return std::nullopt;
}

void clear(std::optional<int>& result) {
    result = std::nullopt;
}

bool is_empty(const std::optional<int>& result) {
    return result == std::nullopt;
}

std::nullopt ist eine inline constexpr-Konstante vom Typ std::nullopt_t aus <optional> und seit C++17 verfügbar. Der Konstruktor, der diesen Marker annimmt, erzeugt ein leeres std::optional<T>, ohne ein T zu konstruieren. Verwende return std::nullopt;, wenn eine Funktion std::optional<T> zurückgibt und kein Ergebnis vorliegt. Warum das Ergebnis fehlt, sagt die Konstante nicht.

o == std::nullopt und !o.has_value() prüfen, ob der Wert fehlt. if (o) prüft, ob ein Wert vorhanden ist, nicht welchen Inhalt er hat: Auch ein gespeichertes 0, false oder nullptr ist ein Wert. Verwende *o und o-> nur bei vorhandenem Wert. Bei einem leeren Optional haben diese Operatoren in C++23 undefiniertes Verhalten; o.value() löst dagegen std::bad_optional_access aus. Sowohl o = std::nullopt als auch o.reset() zerstören den gegebenenfalls enthaltenen Wert. Verwende Zeiger oder Referenzen auf diesen Wert danach nicht mehr.

In Lektion 51 liefert std::numeric_limits<int> aus <limits> die Grenzen von int: max() ist der größte und min() der kleinste darstellbare Wert. Bei Gleitkommatypen mit subnormalen Werten liefert min() den kleinsten positiven normalisierten Wert; lowest() liefert den kleinsten endlichen Wert. Das Beispiel prüft vor a + b die zum Vorzeichen von b passende Grenze. Durch die Kurzschlussauswertung von && bleiben die Subtraktionen selbst im Wertebereich. Eine int-Summe außerhalb des Wertebereichs hätte undefiniertes Verhalten.

In Lektion 48 ist std::filesystem::perms aus <filesystem> ein enum class-Typ, der als Bitmaske für Dateiberechtigungen dient. Ein vorhandenes std::filesystem::perms::none bedeutet, dass keine Berechtigungsbits gesetzt sind; ein leeres std::optional<std::filesystem::perms> bedeutet, dass kein Ergebnis vorliegt. Das ist nur Kontext: Das Beispiel verwendet diesen Typ nicht und prüft oder erzwingt keine Berechtigungen.

Beispiele

#include <iostream>
#include <limits>
#include <optional>

std::optional<int> checked_add(int a, int b) {
    using Limits = std::numeric_limits<int>;
    if ((b > 0 && a > Limits::max() - b) ||
        (b < 0 && a < Limits::min() - b)) {
        return std::nullopt;
    }
    return a + b;
}

int main() {
    const auto print = [](std::optional<int> result) {
        if (result) {
            std::cout << *result << '\n';
        } else {
            std::cout << "no result\n";
        }
    };

    print(checked_add(7, -7));
    print(checked_add(std::numeric_limits<int>::max(), 1));
    print(checked_add(std::numeric_limits<int>::min(), -1));
}

Ergebnis

0
no result
no result

Der erste Aufruf gibt `0` aus. Die beiden folgenden geben jeweils `no result` aus, weil die Summe außerhalb des Wertebereichs von `int` liegt.

Zugehörige Lektionen

  • C++ · Lektion 48 · Fortgeschritten · Version: 3
  • C++ · Lektion 51 · Fortgeschritten · Version: 3

Quellen