CKTIS / C++
std::optional — vrijednost koja može nedostajati
std::optional<T> predstavlja objekt tipa T ili odsutnost vrijednosti. Omogućuje razlikovanje nedostajućeg rezultata od valjanih vrijednosti poput 0. Prije upotrebe operatora * i -> provjerite je li vrijednost prisutna.
Verzija: 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 u <optional>, pohranjuje vrijednost tipa T u vlastitom objektu ili ne sadrži nijednu vrijednost. Koristan je kada funkcija možda neće vratiti rezultat, ali vam nije potreban opis pogreške. Zadana konstrukcija s std::optional<T> item; stvara prazno stanje; konstrukcija iz vrijednosti tipa T stvara stanje koje sadrži vrijednost.
std::nullopt je konstanta koja označava odsutnost vrijednosti, a std::nullopt_t njezin je zaseban označni tip, a ne tip pohranjenog rezultata. Upotrijebite return std::nullopt; za vraćanje praznog rezultata ili item = std::nullopt; za uklanjanje pohranjene vrijednosti.
std::optional::operator bool eksplicitna je pretvorba koja provjerava prisutnost vrijednosti; radi u if (item), slično kao item.has_value(). Ne provjerava samu pohranjenu vrijednost: objekt koji sadrži 0 ili false i dalje daje true.
std::optional::operator* daje pristup pohranjenoj vrijednosti putem reference, dok std::optional::operator-> omogućuje pristup njezinim članovima. Oba zahtijevaju da vrijednost bude prisutna. U C++23 njihova upotreba na praznom objektu ima nedefinirano ponašanje; nemojte očekivati iznimku. Metoda value() provjerava to stanje i baca std::bad_optional_access kada vrijednost nije prisutna.
Ovaj se unos odnosi na C++23: zastavicu prevoditelja u repozitoriju, bez potvrde produkcijskog okruženja izvođenja. Povezani radni nacrt ažurira se i uključuje kasnija proširenja; cijeli njegov sadržaj ne treba smatrati C++23.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.