Namespaces
Variants
Views
Actions

std::experimental::optional<T>::value_or

From cppreference.com
< cpp‎ | experimental‎ | optional
Revision as of 17:39, 16 March 2014 by P12bot (Talk | contribs)

 
 
Experimental
Technical Specification
Filesystem library (filesystem TS)
Library fundamentals (library fundamentals TS)
Library fundamentals 2 (library fundamentals TS v2)
Library fundamentals 3 (library fundamentals TS v3)
Extensions for parallelism (parallelism TS)
Extensions for parallelism 2 (parallelism TS v2)
Extensions for concurrency (concurrency TS)
Extensions for concurrency 2 (concurrency TS v2)
Concepts (concepts TS)
Ranges (ranges TS)
Reflection (reflection TS)
Mathematical special functions (special functions TR)
Experimental Non-TS
Pattern Matching
Linear Algebra
std::execution
Contracts
2D Graphics
 
 
 
template< class U >
constexpr T value_or( U&& value ) const&;
(library fundamentals TS)
template< class U >
T value_or( U&& value ) &&;
(library fundamentals TS)

Returns the contained value if *this is in engaged state, otherwise returns value.

Contents

Parameters

value - the value to exchange
Type requirements

Template:par req concept Template:par req concept

-
U&& must be convertible to T

Return value

The current value if *this is in engaged state, or value otherwise.

Exceptions

Any exception thrown by the selected constructor of T.

If an exception is thrown, the exception safety guarantee is as follows:

  • If *this was in engaged state, the contents of the contained value depend on the exception safety guarantee of T's constructor.
  • Otherwise, the state of *this does not change. The contents of value depend on the exception safety guarantee of T's constructor.

See also

returns the contained value
(public member function) [edit]