Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::optional::operator-> — accéder à un membre de la valeur contenue

L’opérateur `->` donne accès à un membre de la valeur stockée dans `std::optional`. En C++23, vérifiez que cette valeur est présente avant de l’utiliser.

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

Syntaxe

In <optional>, std::optional<T> declares:
constexpr T* operator->() noexcept;
constexpr const T* operator->() const noexcept;

Member access: opt->member or opt->method(args...)
C++23 precondition: opt.has_value() is true when operator->() is called.

std::optional::operator-> est disponible dans <optional> depuis C++17. Dans opt->member, C++ appelle l’opérateur surchargé, puis applique l’opérateur -> intégré au pointeur renvoyé. Le résultat est de type T* pour un std::optional<T> non const, et de type const T* pour un objet const. Les deux surcharges sont constexpr et noexcept ; aucune ne copie la valeur.

En C++23, appeler cet opérateur sur un optional vide entraîne un comportement indéfini : n’attendez ni nullptr ni exception. Utilisez if (opt) ou opt.has_value() et n’accédez à la valeur que tant qu’elle est présente. if (opt) utilise l’operator bool explicite lors d’une conversion contextuelle : il vérifie la présence de la valeur, pas la valeur elle-même. Pour un accès avec vérification, opt.value() lance std::bad_optional_access en l’absence de valeur.

*opt donne une référence plutôt qu’un pointeur et exige également qu’une valeur soit présente. Le pointeur renvoyé par operator-> ne possède pas la valeur et ne prolonge pas sa durée de vie. Ne l’utilisez pas pour accéder à la valeur une fois sa durée de vie terminée, par exemple après reset() ou la destruction de l’optional.

Dans l’exemple, fs est un alias de l’espace de noms std::filesystem. Le & dans const std::optional<fs::path>& borrowedpath déclare une référence lvalue vers un type qualifié const : le paramètre ne copie pas l’optional, et -> sélectionne la surcharge const. Un chemin vide reste une valeur présente ; path::empty() ne consulte pas le système de fichiers.

Exemples

#include <filesystem>
#include <iostream>
#include <optional>
#include <utility>

namespace fs = std::filesystem;

void describe(const std::optional<fs::path>& borrowedpath)
{
    if (borrowedpath) {
        std::cout << (borrowedpath->empty() ? "empty path\n" : "nonempty path\n");
    } else {
        std::cout << "no value\n";
    }
}

int main()
{
    const std::optional<fs::path> present{std::in_place};
    const std::optional<fs::path> absent;
    describe(present);
    describe(absent);
}

Résultat

empty path
no value

Le premier appel affiche `empty path` : une valeur est présente, mais le chemin est vide. Le second affiche `no value` sans évaluer `->`.

Leçons associées

  • C++ · Leçon 48 · Avancé · Version : 3

Sources