Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::nullopt — jawny brak wartości

Użyj `std::nullopt`, aby zwrócić lub ustawić pusty `std::optional` bez mylenia braku wyniku z poprawną wartością, taką jak zero.

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

Składnia

#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 to stała inline constexpr typu std::nullopt_t z nagłówka <optional>, dostępna od C++17. Konstruktor przyjmujący ten znacznik tworzy pusty std::optional<T>, nie konstruując obiektu T. Użyj return std::nullopt;, gdy funkcja zwraca std::optional<T>, a wyniku nie ma. Sama stała nie podaje przyczyny braku.

o == std::nullopt i !o.has_value() sprawdzają brak wartości. if (o) sprawdza obecność, nie zawartość: zapisane 0, false lub nullptr nadal oznacza, że wartość istnieje. Używaj *o i o-> tylko wtedy, gdy wartość istnieje; w C++23 dostęp tymi operatorami do pustego obiektu ma niezdefiniowane zachowanie, natomiast o.value() zgłasza std::bad_optional_access. Zarówno o = std::nullopt, jak i o.reset() niszczą ewentualną wartość; nie używaj później odwołujących się do niej wskaźników ani referencji.

W lekcji 51 std::numeric_limits<int> z <limits> udostępnia granice typu int: max() to największa, a min() najmniejsza reprezentowalna wartość. Dla typów zmiennoprzecinkowych z liczbami subnormalnymi min() oznacza najmniejszą dodatnią wartość znormalizowaną; najniższą wartość skończoną podaje lowest(). Przykład sprawdza granicę odpowiednią dla znaku b, zanim obliczy a + b. Dzięki skróconemu obliczaniu && same odejmowania mieszczą się w zakresie. Suma typu int poza zakresem miałaby niezdefiniowane zachowanie.

W lekcji 48 std::filesystem::perms z <filesystem> to typ wyliczeniowy używany jako maska bitowa uprawnień pliku. Obecna wartość std::filesystem::perms::none oznacza brak ustawionych bitów uprawnień, a pusty std::optional<std::filesystem::perms> oznacza brak wyniku. To tylko kontekst: przykład nie używa tego typu i nie sprawdza ani nie egzekwuje uprawnień.

Przykłady

#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));
}

Wynik

0
no result
no result

Pierwsze wywołanie wypisuje `0`; dwa kolejne wypisują po jednym `no result`, bo suma wykracza poza zakres `int`.

Powiązane lekcje

  • C++ · Lekcja 48 · Zaawansowany · Wersja: 3
  • C++ · Lekcja 51 · Zaawansowany · Wersja: 3

Źródła