KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::optional::operator*: de opgeslagen waarde benaderen

`*opt` geeft een referentie naar de opgeslagen waarde. Controleer vóór het derefereren of er een waarde is: index `0` is geldig en betekent niet dat de waarde ontbreekt.

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

Syntax

// In <optional>, members of std::optional<T>:
constexpr T& operator*() & noexcept;
constexpr const T& operator*() const & noexcept;
constexpr T&& operator*() && noexcept;
constexpr const T&& operator*() const && noexcept;

// Use: *opt, with opt.has_value() == true.

std::optional::operator* is gedeclareerd in <optional> en beschikbaar sinds C++17. De expressie *opt geeft een referentie naar het object in een std::optional<T>; de aanroep zelf kopieert of verplaatst dat object niet. Dit is geen indexering en ook geen dereferentie van een ruwe pointer.

Controleer vóór het derefereren met if (opt) of opt.has_value() of er een waarde is. De contextuele conversie naar bool test de aanwezigheid, niet de opgeslagen waarde: index 0 komt door de test, maar een lege optional niet. In C++23 leidt het derefereren van een lege optional tot ongedefinieerd gedrag. Vertrouw er niet op dat de implementatie de fout detecteert. Moet afwezigheid een uitzondering opleveren, gebruik dan opt.value(): dat werpt in dat geval std::bad_optional_access op.

Alle vier de overloads zijn constexpr en noexcept. Een lvalue geeft T&, of const T& als die const is. Een rvalue geeft T&&, of const T&& als die const is. Via T& kun je het opgeslagen object wijzigen. *std::move(opt) op zichzelf verplaatst het object niet en maakt opt niet leeg.

De teruggegeven referentie verlengt de levensduur van het opgeslagen object niet. Gebruik de referentie niet na opt.reset() of nadat opt is vernietigd. Een tijdelijke optional wordt normaal vernietigd aan het einde van de volledige expressie die hem heeft gemaakt, maar het binden van een aparte referentie aan de optional zelf kan zijn levensduur verlengen.

Voorbeelden

#include <cstddef>
#include <iostream>
#include <optional>

void print_index(const std::optional<std::size_t>& index)
{
    if (index) {
        std::cout << "index: " << static_cast<unsigned long long>(*index) << '\n';
    } else {
        std::cout << "not found\n";
    }
}

int main()
{
    const std::optional<std::size_t> first{0};
    const std::optional<std::size_t> missing{std::nullopt};
    print_index(first);
    print_index(missing);
}

Resultaat

index: 0
not found

`if (index)` behandelt index `0` als een aanwezige waarde. Bij `std::nullopt` schrijft het programma `not found` zonder te derefereren.

Gerelateerde lessen

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

Bronnen