CKTIS / C++
std::optional — hodnota, ktorá môže chýbať
std::optional<T> predstavuje buď objekt typu T, alebo žiadnu hodnotu. Umožňuje odlíšiť chýbajúci výsledok od platných hodnôt, ako je 0. Pred použitím operátorov * a -> overte, či je hodnota prítomná.
Verzia: 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> deklarovaný v <optional> ukladá hodnotu typu T do vlastného objektu alebo neobsahuje žiadnu hodnotu. Je užitočný, keď funkcia nemusí vrátiť výsledok, ale nepotrebujete opis chyby. Predvolená konštrukcia pomocou std::optional<T> item; vytvorí prázdny stav; konštrukcia z hodnoty typu T vytvorí stav obsahujúci hodnotu.
std::nullopt je konštanta označujúca neprítomnosť hodnoty a std::nullopt_t je jej samostatný značkovací typ, nie typ uloženého výsledku. Pomocou return std::nullopt; vráťte prázdny výsledok alebo pomocou item = std::nullopt; odstráňte uloženú hodnotu.
std::optional::operator bool je explicitná konverzia, ktorá testuje prítomnosť hodnoty; funguje v if (item) podobne ako item.has_value(). Netestuje samotnú uloženú hodnotu: objekt obsahujúci 0 alebo false stále vráti true.
std::optional::operator* sprístupňuje uloženú hodnotu prostredníctvom referencie, zatiaľ čo std::optional::operator-> umožňuje prístup k jej členom. Oba vyžadujú prítomnosť hodnoty. V C++23 má použitie ktoréhokoľvek z nich na prázdnom objekte nedefinované správanie; neočakávajte výnimku. Metóda value() tento stav kontroluje a pri neprítomnosti hodnoty vyhodí std::bad_optional_access.
Tento záznam sa týka C++23: príznaku kompilátora v repozitári, bez potvrdenia produkčného runtime prostredia. Odkazovaný pracovný návrh normy sa aktualizuje a zahŕňa aj neskoršie rozšírenia; celý jeho obsah nemožno považovať za C++23.
Prí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ýsledok
0 0 false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.