Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri