Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::optional — wartość, która może nie istnieć

std::optional<T> reprezentuje obiekt typu T albo brak wartości. Pozwala oddzielić brak wyniku od prawidłowych wartości, takich jak 0. Przed użyciem operatorów * i -> sprawdź, czy obiekt zawiera wartość.

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

Składnia

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

std::optional<T> z nagłówka <optional> przechowuje wartość typu T wewnątrz własnego obiektu albo nie zawiera wartości. Przydaje się, gdy funkcja może nie zwrócić wyniku, ale nie potrzebujesz opisu błędu. Domyślne utworzenie std::optional<T> item; daje stan pusty; skonstruowanie z wartości T daje stan z wartością.

std::nullopt jest stałą oznaczającą brak wartości, a std::nullopt_t jest jej odrębnym typem znacznikowym, nie typem przechowywanego wyniku. Użyj return std::nullopt;, aby zwrócić pusty wynik, lub item = std::nullopt;, aby usunąć przechowywaną wartość.

std::optional::operator bool jest jawną konwersją sprawdzającą obecność wartości; działa w if (item), podobnie jak item.has_value(). Nie sprawdza samej wartości: obiekt zawierający 0 lub false nadal daje true.

std::optional::operator* udostępnia przechowywaną wartość przez referencję, a std::optional::operator-> pozwala korzystać z jej składowych. Oba wymagają obecności wartości. W C++23 użycie ich na pustym obiekcie ma niezdefiniowane zachowanie; nie oczekuj wyjątku. Metoda value() sprawdza ten stan i rzuca std::bad_optional_access, gdy wartości nie ma.

Zakres wpisu to C++23: flaga kompilatora w repozytorium, bez potwierdzenia środowiska produkcyjnego. Podlinkowany roboczy projekt standardu jest aktualizowany i obejmuje także późniejsze rozszerzenia; nie należy traktować całej jego zawartości jako C++23.

Przykłady

#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';
}

Wynik

0 0
false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła