CKTIS / C++
std::optional — hodnota, která může chybět
std::optional<T> představuje buď objekt typu T, nebo žádnou hodnotu. Umožňuje odlišit chybějící výsledek od platných hodnot, jako je 0. Před použitím operátorů * a -> ověřte, zda je hodnota přítomna.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <optional>
std::optional<T> item;
std::optional<T> empty = std::nullopt;
if (item) { /* *item; item->member; */ }std::optional<T> deklarovaný v <optional> ukládá hodnotu typu T do vlastního objektu, nebo neobsahuje žádnou hodnotu. Hodí se, když funkce nemusí vrátit výsledek, ale nepotřebujete popis chyby. Výchozí konstrukce pomocí std::optional<T> item; vytvoří prázdný stav; konstrukce z hodnoty typu T vytvoří stav obsahující hodnotu.
std::nullopt je konstanta označující nepřítomnost hodnoty a std::nullopt_t je její samostatný značkovací typ, nikoli typ uloženého výsledku. Pomocí return std::nullopt; vraťte prázdný výsledek, nebo pomocí item = std::nullopt; uloženou hodnotu odstraňte.
std::optional::operator bool je explicitní konverze, která testuje přítomnost hodnoty; funguje v if (item) podobně jako item.has_value(). Netestuje samotnou uloženou hodnotu: objekt obsahující 0 nebo false stále vrací true.
std::optional::operator* zpřístupňuje uloženou hodnotu prostřednictvím reference, zatímco std::optional::operator-> umožňuje přístup k jejím členům. Oba vyžadují přítomnost hodnoty. V C++23 má použití kteréhokoli z nich na prázdném objektu nedefinované chování; neočekávejte výjimku. Metoda value() tento stav kontroluje a při nepřítomnosti hodnoty vyhodí std::bad_optional_access.
Tento záznam se týká C++23: příznaku kompilátoru v repozitáři, bez potvrzení produkčního běhového prostředí. Odkazovaný pracovní návrh normy se aktualizuje a zahrnuje také pozdější rozšíření; celý jeho obsah nelze považovat za C++23.
Příklady
#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';
}
Výsledek
0 0 false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.