std::any - Man Page

A type-safe container of any type.

Synopsis

Public Member Functions

constexpr any () noexcept
Default constructor, creates an empty object.
template<typename _Tp , typename _VTp  = _Decay_if_not_any<_Tp>, typename _Mgr  = _Manager<_VTp>, enable_if_t< is_copy_constructible_v< _VTp > &&!__is_in_place_type_v< _VTp >, bool >  = true> any (_Tp &&__value)
Construct with a copy of __value as the contained object.
any (any &&__other) noexcept
Move constructor, transfer the state from __other.
any (const any &__other)
Copy constructor, copies the state of __other.
template<typename _Tp , typename... _Args, typename _VTp  = decay_t<_Tp>, typename _Mgr  = _Manager<_VTp>, __any_constructible_t< _VTp, _Args &&... >  = false> any (in_place_type_t< _Tp >, _Args &&... __args)
Construct with an object created from __args as the contained object.
template<typename _Tp , typename _Up , typename... _Args, typename _VTp  = decay_t<_Tp>, typename _Mgr  = _Manager<_VTp>, __any_constructible_t< _VTp, initializer_list< _Up > &, _Args &&... >  = false> any (in_place_type_t< _Tp >, initializer_list< _Up > __il, _Args &&... __args)
Construct with an object created from __il and __args as the contained object.
~any ()
Destructor, calls reset()
template<typename _Tp , typename... _Args> __emplace_t< decay_t< _Tp >, _Args... > emplace (_Args &&... __args)
Emplace with an object created from __args as the contained object.
template<typename _Tp , typename _Up , typename... _Args> __emplace_t< decay_t< _Tp >, initializer_list< _Up > &, _Args &&... > emplace (initializer_list< _Up > __il, _Args &&... __args)
Emplace with an object created from __il and __args as the contained object.
bool has_value () const noexcept
Reports whether there is a contained object or not.
template<typename _Tp > enable_if_t< is_copy_constructible< _Decay_if_not_any< _Tp > >::value, any & > operator= (_Tp &&__rhs)
Store a copy of __rhs as the contained object.
any & operator= (any &&__rhs) noexcept
Move assignment operator.
any & operator= (const any &__rhs)
Copy the state of another object.
void reset () noexcept
If not empty, destroy the contained object.
void swap (any &__rhs) noexcept
Exchange state with another object.
const type_info & type () const noexcept
The typeid of the contained object, or typeid(void) if empty.

Detailed Description

A type-safe container of any type.

An any object's state is either empty or it stores a contained object of CopyConstructible type.

Since

C++17

Definition at line 80 of file any.

Constructor & Destructor Documentation

constexpr std::any::any () [inline], [constexpr], [noexcept]

Default constructor, creates an empty object.

Definition at line 153 of file any.

std::any::any (const any & __other) [inline]

Copy constructor, copies the state of __other.

Definition at line 156 of file any.

std::any::any (any && __other) [inline], [noexcept]

Move constructor, transfer the state from __other.

Postcondition

!__other.has_value() (this postcondition is a GNU extension)

Definition at line 173 of file any.

template<typename _Tp , typename _VTp  = _Decay_if_not_any<_Tp>, typename _Mgr  = _Manager<_VTp>, enable_if_t< is_copy_constructible_v< _VTp > &&!__is_in_place_type_v< _VTp >, bool >  = true> std::any::any (_Tp && __value) [inline]

Construct with a copy of __value as the contained object.

Definition at line 190 of file any.

template<typename _Tp , typename... _Args, typename _VTp  = decay_t<_Tp>, typename _Mgr  = _Manager<_VTp>, __any_constructible_t< _VTp, _Args &&... >  = false> std::any::any (in_place_type_t< _Tp >, _Args &&... __args) [inline], [explicit]

Construct with an object created from __args as the contained object.

Definition at line 201 of file any.

template<typename _Tp , typename _Up , typename... _Args, typename _VTp  = decay_t<_Tp>, typename _Mgr  = _Manager<_VTp>, __any_constructible_t< _VTp, initializer_list< _Up > &, _Args &&... >  = false> std::any::any (in_place_type_t< _Tp >, initializer_list< _Up > __il, _Args &&... __args) [inline], [explicit]

Construct with an object created from __il and __args as the contained object.

Definition at line 214 of file any.

std::any::~any () [inline]

Destructor, calls reset()

Definition at line 221 of file any.

Member Function Documentation

template<typename _Tp , typename... _Args> __emplace_t< decay_t< _Tp >, _Args... > std::any::emplace (_Args &&... __args) [inline]

Emplace with an object created from __args as the contained object.

Definition at line 265 of file any.

template<typename _Tp , typename _Up , typename... _Args> __emplace_t< decay_t< _Tp >, initializer_list< _Up > &, _Args &&... > std::any::emplace (initializer_list< _Up > __il, _Args &&... __args) [inline]

Emplace with an object created from __il and __args as the contained object.

Definition at line 276 of file any.

bool std::any::has_value () const [inline], [noexcept]

Reports whether there is a contained object or not.

Definition at line 328 of file any.

template<typename _Tp > enable_if_t< is_copy_constructible< _Decay_if_not_any< _Tp > >::value, any & > std::any::operator= (_Tp && __rhs) [inline]

Store a copy of __rhs as the contained object.

Definition at line 256 of file any.

any & std::any::operator= (any && __rhs) [inline], [noexcept]

Move assignment operator.

Postcondition

!__rhs.has_value() (not guaranteed for other implementations)

Definition at line 239 of file any.

any & std::any::operator= (const any & __rhs) [inline]

Copy the state of another object.

Definition at line 227 of file any.

void std::any::reset () [inline], [noexcept]

If not empty, destroy the contained object.

Definition at line 286 of file any.

void std::any::swap (any & __rhs) [inline], [noexcept]

Exchange state with another object.

Definition at line 296 of file any.

const type_info & std::any::type () const [inline], [noexcept]

The typeid of the contained object, or typeid(void) if empty.

Definition at line 332 of file any.

Author

Generated automatically by Doxygen for libstdc++ from the source code.

Info

Wed Sep 7 2022 libstdc++