Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori