Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::optional — hodnota, která může chybět

std::optional<T> představuje buď objekt typu T, nebo žádnou hodnotu. Umožňuje odlišit chybějící výsledek od platných hodnot, jako je 0. Před použitím operátorů * a -> ověřte, zda je hodnota přítomna.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <optional>
std::optional<T> item;
std::optional<T> empty = std::nullopt;
if (item) { /* *item; item->member; */ }

std::optional<T> deklarovaný v <optional> ukládá hodnotu typu T do vlastního objektu, nebo neobsahuje žádnou hodnotu. Hodí se, když funkce nemusí vrátit výsledek, ale nepotřebujete popis chyby. Výchozí konstrukce pomocí std::optional<T> item; vytvoří prázdný stav; konstrukce z hodnoty typu T vytvoří stav obsahující hodnotu.

std::nullopt je konstanta označující nepřítomnost hodnoty a std::nullopt_t je její samostatný značkovací typ, nikoli typ uloženého výsledku. Pomocí return std::nullopt; vraťte prázdný výsledek, nebo pomocí item = std::nullopt; uloženou hodnotu odstraňte.

std::optional::operator bool je explicitní konverze, která testuje přítomnost hodnoty; funguje v if (item) podobně jako item.has_value(). Netestuje samotnou uloženou hodnotu: objekt obsahující 0 nebo false stále vrací true.

std::optional::operator* zpřístupňuje uloženou hodnotu prostřednictvím reference, zatímco std::optional::operator-> umožňuje přístup k jejím členům. Oba vyžadují přítomnost hodnoty. V C++23 má použití kteréhokoli z nich na prázdném objektu nedefinované chování; neočekávejte výjimku. Metoda value() tento stav kontroluje a při nepřítomnosti hodnoty vyhodí std::bad_optional_access.

Tento záznam se týká C++23: příznaku kompilátoru v repozitáři, bez potvrzení produkčního běhového prostředí. Odkazovaný pracovní návrh normy se aktualizuje a zahrnuje také pozdější rozšíření; celý jeho obsah nelze považovat za C++23.

Pří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ýsledek

0 0
false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje