KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::nullopt — expliciet aangeven dat een waarde ontbreekt

Gebruik `std::nullopt` om een lege `std::optional` terug te geven of leeg te maken, zonder een ontbrekend resultaat te verwarren met een geldige waarde zoals nul.

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

Syntax

#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 is een inline constexpr-constante van het type std::nullopt_t uit <optional>, beschikbaar sinds C++17. De constructor die deze markering accepteert, maakt een lege std::optional<T> zonder een object van het type T te construeren. Gebruik return std::nullopt; als een functie std::optional<T> teruggeeft en er geen resultaat is. De constante zegt niet waarom het resultaat ontbreekt.

o == std::nullopt en !o.has_value() testen of de waarde ontbreekt. if (o) test de aanwezigheid, niet de inhoud: een opgeslagen 0, false of nullptr is nog steeds een aanwezige waarde. Gebruik *o en o-> alleen als er een waarde is. In C++23 hebben deze operatoren ongedefinieerd gedrag bij een leeg object, terwijl o.value() dan std::bad_optional_access gooit. Zowel o = std::nullopt als o.reset() vernietigt de eventuele opgeslagen waarde. Gebruik daarna geen pointers of referenties meer naar die waarde.

In les 51 levert std::numeric_limits<int> uit <limits> de grenzen van int: max() geeft de grootste en min() de kleinste representeerbare waarde. Voor drijvendekommatypen met subnormale waarden geeft min() de kleinste positieve genormaliseerde waarde; lowest() geeft de laagste eindige waarde. Het voorbeeld controleert de grens die bij het teken van b hoort voordat het a + b evalueert. Dankzij kortsluitevaluatie van && blijven de aftrekkingen zelf binnen het bereik. Een int-som buiten het bereik zou ongedefinieerd gedrag hebben.

In les 48 is std::filesystem::perms uit <filesystem> een enum class-type dat als bitmasker voor bestandsrechten dient. Een aanwezige waarde std::filesystem::perms::none betekent dat er geen rechtenbits zijn ingesteld; een lege std::optional<std::filesystem::perms> betekent dat er geen resultaat is. Dit is alleen context: het voorbeeld gebruikt dit type niet en controleert of handhaaft geen rechten.

Voorbeelden

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

Resultaat

0
no result
no result

De eerste aanroep schrijft `0`; de volgende twee schrijven elk `no result`, omdat de som buiten het bereik van `int` valt.

Gerelateerde lessen

  • C++ · Les 48 · Gevorderd · Versie: 3
  • C++ · Les 51 · Gevorderd · Versie: 3

Bronnen