| constexpr T& value() &; constexpr const T & value() const &; |
(1) | (library fundamentals TS) |
| constexpr T&& value() &&; constexpr const T&& value() const &&; |
(2) | (library fundamentals TS) |
Returns the contained value.
1) Equivalent to
return bool(*this) ? *val : throw bad_optional_access();.2) Equivalent to
return bool(*this) ? std::move(*val) : throw bad_optional_access();.Parameters
(none)
Return value
A reference to the contained value.
Exceptions
std::experimental::bad_optional_access if *this does not contain a value.
Notes
The dereference operator operator*() does not check if this optional contains a value, which may be more efficient than value().
Example
#include <experimental/optional>
#include <iostream>
int main()
{
std::experimental::optional<int> opt = {};
try
{
int n = opt.value();
}
catch (const std::logic_error& e)
{
std::cout << e.what() << '\n';
}
}optional<T>::value: not engagedSee also
| returns the contained value if available, another value otherwise (public member function) | |
| accesses the contained value (public member function) | |
| (library fundamentals TS) |
exception indicating checked access to an optional that doesn't contain a value (class) |
Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.