Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::optional — hodnota, ktorá môže chýbať

std::optional<T> predstavuje buď objekt typu T, alebo žiadnu hodnotu. Umožňuje odlíšiť chýbajúci výsledok od platných hodnôt, ako je 0. Pred použitím operátorov * a -> overte, či je hodnota prítomná.

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

Syntax

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

std::optional<T> deklarovaný v <optional> ukladá hodnotu typu T do vlastného objektu alebo neobsahuje žiadnu hodnotu. Je užitočný, keď funkcia nemusí vrátiť výsledok, ale nepotrebujete opis chyby. Predvolená konštrukcia pomocou std::optional<T> item; vytvorí prázdny stav; konštrukcia z hodnoty typu T vytvorí stav obsahujúci hodnotu.

std::nullopt je konštanta označujúca neprítomnosť hodnoty a std::nullopt_t je jej samostatný značkovací typ, nie typ uloženého výsledku. Pomocou return std::nullopt; vráťte prázdny výsledok alebo pomocou item = std::nullopt; odstráňte uloženú hodnotu.

std::optional::operator bool je explicitná konverzia, ktorá testuje prítomnosť hodnoty; funguje v if (item) podobne ako item.has_value(). Netestuje samotnú uloženú hodnotu: objekt obsahujúci 0 alebo false stále vráti true.

std::optional::operator* sprístupňuje uloženú hodnotu prostredníctvom referencie, zatiaľ čo std::optional::operator-> umožňuje prístup k jej členom. Oba vyžadujú prítomnosť hodnoty. V C++23 má použitie ktoréhokoľvek z nich na prázdnom objekte nedefinované správanie; neočakávajte výnimku. Metóda value() tento stav kontroluje a pri neprítomnosti hodnoty vyhodí std::bad_optional_access.

Tento záznam sa týka C++23: príznaku kompilátora v repozitári, bez potvrdenia produkčného runtime prostredia. Odkazovaný pracovný návrh normy sa aktualizuje a zahŕňa aj neskoršie rozšírenia; celý jeho obsah nemožno považovať za C++23.

Prí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ýsledok

0 0
false

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje