dwww Home | Manual pages | Find package

std::any(3cxx)                                                  std::any(3cxx)

NAME
       std::any - 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>, typename  =
           _Require<__not_<__is_in_place_type<_VTp>>,
           is_copy_constructible<_VTp>>> 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

Constructor & Destructor Documentation
   constexpr std::any::any () [inline],  [constexpr],  [noexcept]
       Default constructor, creates an empty object.

   std::any::any (const any & __other) [inline]
       Copy constructor, copies the state of __other.

   std::any::any (any && __other) [inline],  [noexcept]
       Move constructor, transfer the state from __other.

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

   template<typename _Tp , typename _VTp  = _Decay_if_not_any<_Tp>, typename
       _Mgr  = _Manager<_VTp>, typename  =
       _Require<__not_<__is_in_place_type<_VTp>>,
       is_copy_constructible<_VTp>>> std::any::any (_Tp && __value) [inline]
       Construct with a copy of __value as the contained object.

   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.

   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.

   std::any::~any () [inline]
       Destructor, calls reset()

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.

   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.

   bool std::any::has_value () const [inline],  [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&> std::any::operator= (_Tp && __rhs) [inline]
       Store a copy of __rhs as the contained object.

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

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

   any& std::any::operator= (const any & __rhs) [inline]
       Copy the state of another object.

   void std::any::reset () [inline],  [noexcept]
       If not empty, destroy the contained object.

   void std::any::swap (any & __rhs) [inline],  [noexcept]
       Exchange state with another object.

   const type_info& std::any::type () const [inline],  [noexcept]
       The typeid of the contained object, or typeid(void) if empty.

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

libstdc++                       Sat May 13 2023                 std::any(3cxx)

Generated by dwww version 1.14 on Thu Jan 23 21:18:49 CET 2025.