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

CKTIS / C++

std::nullopt — výslovné vyjádření chybějící hodnoty

Pomocí `std::nullopt` vrať nebo vyprázdni `std::optional`, aniž bys zaměnil chybějící výsledek za platnou hodnotu, například nulu.

Verze: ISO C++23; implementation support may vary

Syntaxe

#include <optional>

std::optional<int> no_result() {
    return std::nullopt;
}

void clear(std::optional<int>& result) {
    result = std::nullopt;
}

bool is_empty(const std::optional<int>& result) {
    return result == std::nullopt;
}

std::nullopt je konstanta inline constexpr typu std::nullopt_t z hlavičky <optional>, dostupná od C++17. Konstruktor přijímající tuto značku vytvoří prázdný std::optional<T>, aniž by vytvořil objekt typu T. Použij return std::nullopt;, pokud funkce vrací std::optional<T> a nemá žádný výsledek. Konstanta sama neříká, proč výsledek chybí.

o == std::nullopt a !o.has_value() zjišťují, zda hodnota chybí. if (o) testuje přítomnost, nikoli obsah: uložené 0, false nebo nullptr je pořád přítomná hodnota. Operátory *o a o-> používej jen tehdy, když hodnota existuje. V C++23 mají tyto operátory u prázdného objektu nedefinované chování, zatímco o.value() vyvolá výjimku std::bad_optional_access. Jak o = std::nullopt, tak o.reset() zničí případnou uloženou hodnotu. Ukazatele a reference na tuto hodnotu už potom nepoužívej.

V lekci 51 poskytuje std::numeric_limits<int> z <limits> meze typu int: max() vrací největší a min() nejmenší reprezentovatelnou hodnotu. U typů s plovoucí řádovou čárkou se subnormálními hodnotami vrací min() nejmenší kladnou normalizovanou hodnotu; lowest() vrací nejmenší konečnou hodnotu. Příklad ověří mez odpovídající znaménku b před vyhodnocením a + b. Díky zkrácenému vyhodnocování && zůstanou v rozsahu i samotná odčítání. Součet typu int mimo rozsah by měl nedefinované chování.

V lekci 48 je std::filesystem::perms z <filesystem> výčtový typ enum class používaný jako bitová maska oprávnění k souborům. Přítomná hodnota std::filesystem::perms::none znamená, že není nastaven žádný bit oprávnění; prázdný std::optional<std::filesystem::perms> znamená, že výsledek chybí. Jde jen o kontext: příklad tento typ nepoužívá a oprávnění nekontroluje ani nevynucuje.

Příklady

#include <iostream>
#include <limits>
#include <optional>

std::optional<int> checked_add(int a, int b) {
    using Limits = std::numeric_limits<int>;
    if ((b > 0 && a > Limits::max() - b) ||
        (b < 0 && a < Limits::min() - b)) {
        return std::nullopt;
    }
    return a + b;
}

int main() {
    const auto print = [](std::optional<int> result) {
        if (result) {
            std::cout << *result << '\n';
        } else {
            std::cout << "no result\n";
        }
    };

    print(checked_add(7, -7));
    print(checked_add(std::numeric_limits<int>::max(), 1));
    print(checked_add(std::numeric_limits<int>::min(), -1));
}

Výsledek

0
no result
no result

První volání vypíše `0`; další dvě vypíšou každé `no result`, protože součet je mimo rozsah typu `int`.

Související lekce

  • C++ · Lekce 48 · Pokročilá · Verze: 3
  • C++ · Lekce 51 · Pokročilá · Verze: 3

Zdroje