std::experimental::optional::swap

 

C++

Language

Standard library headers

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Experimental libraries

Experimental standard libraries

optional (library fundamentals TS)

any (library fundamentals TS)

basic_string_view (library fundamentals TS)

Polymorphic allocator library (library fundamentals TS)

Filesystem library (filesystem TS)

 

std::experimental::optional

Member functions

optional::optional

optional::~optional

optional::operator=

Observers

optional::operator->optional::operator*

optional::operator bool

optional::value

optional::value_or

Modifiers

optional::emplace

optional::swap

Non-member functions

operator==operator<

make_optional

swap

Helper classes

hash

 

void swap( optional& other );		(library fundamentals TS)

Swaps the contents with those of other.

• If none of *this and other are in engaged states, the function has no effect.

• If only one of *this and other is in engaged state (let's call this object in and the other un), the contained value of un is initialized by moving the contained value of in, followed by destruction of the contained value of in. in is in disengaged state and un is in engaged state afterwards.

• If both *this and other have engaged states, the contained values are exchanged by calling swap(**this, *other).

Parameters

other

-

the optional object to exchange the contents with

Return value

(none)

Exceptions

noexcept specification:  

noexcept(is_nothrow_move_constructible<T>::value &&
           noexcept(swap(declval<T&>(), declval<T&>())))

In the case of thrown exception, the states of the contained values of *this and other are determined by the exception safety guarantees of swap of type T or T's move constructor, whichever is called. For both *this and other, if the object was in engaged state, it is left in engaged state, and the other way round.

See also

std::swap(std::experimental::optional)

specializes the std::swap algorithm (function)