CKTIS / C++
std::optional — vrednost, ki je lahko odsotna
std::optional<T> predstavlja objekt tipa T ali odsotnost vrednosti. Tako lahko manjkajoč rezultat ločite od veljavnih vrednosti, kot je 0. Pred uporabo operatorjev * in -> preverite, ali je vrednost prisotna.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <optional>
std::optional<T> item;
std::optional<T> empty = std::nullopt;
if (item) { /* *item; item->member; */ }std::optional<T>, deklariran v <optional>, shrani vrednost tipa T v svojem objektu ali pa ne vsebuje nobene vrednosti. Uporaben je, kadar funkcija morda ne vrne rezultata, vendar ne potrebujete opisa napake. Privzeta konstrukcija z std::optional<T> item; ustvari prazno stanje; konstrukcija iz vrednosti tipa T ustvari stanje, ki vsebuje vrednost.
std::nullopt je konstanta, ki označuje odsotnost vrednosti, std::nullopt_t pa je njen posebni označevalni tip, ne tip shranjenega rezultata. Uporabite return std::nullopt; za vrnitev praznega rezultata ali item = std::nullopt; za odstranitev shranjene vrednosti.
std::optional::operator bool je izrecna pretvorba, ki preverja prisotnost vrednosti; deluje v if (item), podobno kot item.has_value(). Ne preverja same shranjene vrednosti: objekt, ki vsebuje 0 ali false, še vedno vrne true.
std::optional::operator* omogoča dostop do shranjene vrednosti prek reference, std::optional::operator-> pa omogoča dostop do njenih članov. Oba zahtevata, da je vrednost prisotna. V C++23 uporaba katerega koli od njiju na praznem objektu povzroči nedefinirano vedenje; ne pričakujte izjeme. Metoda value() preveri to stanje in sproži std::bad_optional_access, kadar vrednost ni prisotna.
Ta vnos se nanaša na C++23: zastavico prevajalnika v repozitoriju, brez potrditve produkcijskega izvajalnega okolja. Povezani delovni osnutek se posodablja in vključuje tudi poznejše razširitve; njegove celotne vsebine ne smemo obravnavati kot C++23.
Primeri
#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';
}
Rezultat
0 0 false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.