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.