CKTIS / C++
std::optional::operator* : accéder à la valeur contenue
`*opt` renvoie une référence à la valeur contenue. Vérifiez sa présence avant de déréférencer : l’indice `0` est un résultat valide, pas une valeur absente.
Version : ISO C++23; implementation support may vary
Syntaxe
// 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* est déclaré dans <optional> et disponible depuis C++17. L’expression *opt renvoie une référence à l’objet stocké dans un std::optional<T>. L’appel ne copie ni ne déplace cet objet. Il ne s’agit ni d’un accès par indice ni du déréférencement d’un pointeur brut.
Avant de déréférencer, vérifiez la présence de la valeur avec if (opt) ou opt.has_value(). La conversion contextuelle en bool teste la présence, pas le contenu : le test réussit pour l’indice 0, mais échoue si l’optional est vide. En C++23, déréférencer un optional vide entraîne un comportement indéfini. Ne comptez pas sur l’implémentation pour détecter l’erreur. Si l’absence doit déclencher une exception, utilisez opt.value(), qui lève std::bad_optional_access dans ce cas.
Les quatre surcharges sont constexpr et noexcept. Une lvalue donne T&, ou const T& si elle est const. Une rvalue donne T&&, ou const T&& si elle est const. Vous pouvez modifier l’objet stocké via T&. À lui seul, *std::move(opt) ne déplace pas cet objet et ne vide pas opt.
La référence renvoyée ne prolonge pas la durée de vie de l’objet stocké. Ne l’utilisez pas après opt.reset() ni après la destruction de opt. Un optional temporaire est normalement détruit à la fin de l’expression complète qui l’a créé, mais lier une référence distincte à l’optional lui-même peut prolonger sa durée de vie.
Exemples
#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);
}
Résultat
index: 0 not found
`if (index)` considère l’indice `0` comme présent. Pour `std::nullopt`, le programme affiche `not found` sans déréférencer.
Leçons associées
- C++ · Leçon 51 · Avancé · Version : 3