std::pair< _T1, _T2 >(3)   Library Functions Manual   std::pair< _T1, _T2 >(3)

NAME
       std::pair< _T1, _T2 > - Struct holding two objects (or references) of
       arbitrary type.


SYNOPSIS
       #include <utility>

   Public Types
       typedef _T1 first_type
           The type of the first member.
       typedef _T2 second_type
           The type of the second member.

   Public Member Functions
       constexpr pair (const pair &)=default
           Copy constructor.
       constexpr pair (pair &&)=default
           Move constructor.
       template<typename... _Args1, typename... _Args2> constexpr pair
           (piecewise_construct_t, tuple< _Args1... >, tuple< _Args2... >)
       template<typename _U1, typename _U2> constexpr explicit
           (!_S_convertible< _U1 &, _U2 & >()) pair(pair< _U1
       template<typename _U1, typename _U2> constexpr _U2 &&constexpr explicit
           (!_S_convertible< _U1 &, _U2 & >()) pair(pair< _U1
           Converting constructor from a non-const pair<U1, U2> lvalue.
       template<typename _U1 = _T1, typename _U2 = _T2> constexpr explicit
           (!_S_convertible< _U1, _U2 >()) pair(_U1 &&
       template<typename _U1 = _T1, typename _U2 = _T2> constexpr explicit
           (!_S_convertible< _U1, _U2 >()) pair(_U1 &&__x
           Constructor accepting two values of arbitrary types.
       template<typename _U1, typename _U2> constexpr explicit
           (!_S_convertible< _U1, _U2 >()) pair(pair< _U1
       template<typename _U1, typename _U2> constexpr _U2 &constexpr explicit
           (!_S_convertible< _U1, _U2 >()) pair(pair< _U1
           Converting constructor from a non-const pair<U1, U2> rvalue.
       constexpr explicit (!_S_convertible< const _T1 &, const _T2 & >())
           pair(const type_identity_t< _T1 > &__x
           Constructor accepting lvalues of first_type and second_type.
       template<typename _U1, typename _U2> constexpr explicit
           (!_S_convertible< const _U1 &, const _U2 & >()) pair(const pair<
           _U1
       template<typename _U1, typename _U2> constexpr _U2 &&constexpr explicit
           (!_S_convertible< const _U1 &, const _U2 & >()) pair(const pair<
           _U1
           Converting constructor from a const pair<U1, U2> lvalue.
       template<typename _U1, typename _U2> constexpr explicit
           (!_S_convertible< const _U1, const _U2 >()) pair(const pair< _U1
       template<typename _U1, typename _U2> constexpr _U2 &constexpr explicit
           (!_S_convertible< const _U1, const _U2 >()) pair(const pair< _U1
           Converting constructor from a const pair<U1, U2> rvalue.
       template<__eligible_pair_like< pair > _UPair> constexpr explicit
           (!_S_convertible_from_pair_like< _UPair >()) pair(_UPair &&)=delete
       template<__eligible_pair_like< pair > _UPair> constexpr _U2 &&constexpr
           explicit (!_S_convertible_from_pair_like< _UPair >()) pair(_UPair
           &&__p)
       constexpr explicit (__not_< __and_<
           __is_implicitly_default_constructible< _T1 >,
           __is_implicitly_default_constructible< _T2 > > >()) pair()
           noexcept(is_nothrow_default_constructible_v< _T1 >
           &&is_nothrow_default_constructible_v< _T2 >)
           Default constructor.
       constexpr _U2 &&constexpr _U2 &__p noexcept (_S_nothrow_constructible<
           _U1 &, _U2 & >())
       constexpr _U2 &constexpr _U2 &&__p noexcept (_S_nothrow_constructible<
           _U1, _U2 >())
       constexpr _U2 &&__y noexcept (_S_nothrow_constructible< _U1, _U2 >())
       constexpr const _T2 &__y noexcept (_S_nothrow_constructible< const _T1
           &, const _T2 & >())
       constexpr _U2 &&constexpr _U2 &__p noexcept (_S_nothrow_constructible<
           const _U1 &, const _U2 & >())
       constexpr _U2 &constexpr _U2 &&__p noexcept (_S_nothrow_constructible<
           const _U1, const _U2 >())
       template<__eligible_pair_like< pair > _UPair> constexpr pair &
           operator= (_UPair &&__p)
       template<__eligible_pair_like< pair > _UPair> constexpr const pair &
           operator= (_UPair &&__p) const
       pair & operator= (const pair &)=delete
       constexpr const pair & operator= (const pair &__p) const
           Copy assignment operator (const).
       constexpr pair & operator= (const pair &__p)
           noexcept(_S_nothrow_assignable< const _T1 &, const _T2 & >())
           Copy assignment operator.
       template<typename _U1, typename _U2>
           requires (_S_const_assignable<const _U1&, const _U2&>())constexpr
           const pair & operator= (const pair< _U1, _U2 > &__p) const"
           Converting assignment from a const pair<U1, U2> lvalue.
       template<typename _U1, typename _U2>
           requires (_S_assignable<const _U1&, const _U2&>())constexpr pair &
           operator= (const pair< _U1, _U2 > &__p)
           noexcept(_S_nothrow_assignable< const _U1 &, const _U2 & >())"
           Converting assignment from a const pair<U1, U2> lvalue.
       constexpr const pair & operator= (pair &&__p) const
           Move assignment operator (const).
       constexpr pair & operator= (pair &&__p) noexcept(_S_nothrow_assignable<
           _T1, _T2 >())
           Move assignment operator.
       template<typename _U1, typename _U2>
           requires (_S_const_assignable<_U1, _U2>())constexpr const pair &
           operator= (pair< _U1, _U2 > &&__p) const"
           Converting assignment from a non-const pair<U1, U2> rvalue.
       template<typename _U1, typename _U2>
           requires (_S_assignable<_U1, _U2>())constexpr pair & operator=
           (pair< _U1, _U2 > &&__p) noexcept(_S_nothrow_assignable< _U1, _U2
           >())"
           Converting assignment from a non-const pair<U1, U2> rvalue.
       constexpr void swap (const pair &__p) const noexcept(__and_v<
           __is_nothrow_swappable< const _T1 >, __is_nothrow_swappable< const
           _T2 > >)
       constexpr void swap (pair &__p) noexcept(__and_<
           __is_nothrow_swappable< _T1 >, __is_nothrow_swappable< _T2 >
           >::value)
           Swap the first members and then the second members.

   Public Attributes
       _T1 first
           The first member.
       _T2 second
           The second member.

   Related Symbols
       (Note that these are not member symbols.)


           template<typename _T1, typename _T2> pair (_T1, _T2) -> pair< _T1,
               _T2 >
               Two pairs are equal iff their members are equal.
           template<typename _T1, typename _T2, typename _U1, typename _U2>
               constexpr bool operator== (const pair< _T1, _T2 > &__x, const
               pair< _U1, _U2 > &__y)
               Two pairs are equal iff their members are equal.
           template<typename _T1, typename _T2, typename _U1, typename _U2>
               constexpr common_comparison_category_t<
               __detail::__synth3way_t< _T1, _U1 >, __detail::__synth3way_t<
               _T2, _U2 > > operator<=> (const pair< _T1, _T2 > &__x, const
               pair< _U1, _U2 > &__y)
           template<typename _T1, typename _T2> constexpr enable_if< __and_<
               __is_swappable< _T1 >, __is_swappable< _T2 > >::value >::type
               swap (pair< _T1, _T2 > &__x, pair< _T1, _T2 > &__y)
               noexcept(noexcept(__x.swap(__y)))

Detailed Description
   template<typename _T1, typename _T2>
       struct std::pair< _T1, _T2 >"Struct holding two objects (or references)
       of arbitrary type.



       Template Parameters
           _T1 Type of the first member.
           _T2 Type of the second member.

       https://gcc.gnu.org/onlinedocs/libstdc++/manual/utilities.html

Member Typedef Documentation
   template<typename _T1, typename _T2> typedef _T1 std::pair< _T1, _T2
       >::first_type
       The type of the first member.

   template<typename _T1, typename _T2> typedef _T2 std::pair< _T1, _T2
       >::second_type
       The type of the second member.

Constructor & Destructor Documentation
   template<typename _T1, typename _T2> std::pair< _T1, _T2 >::pair (const
       pair< _T1, _T2 > & ) [constexpr],  [default]
       Copy constructor.

       Referenced by pair().

   template<typename _T1, typename _T2> std::pair< _T1, _T2 >::pair (pair<
       _T1, _T2 > && ) [constexpr],  [default]
       Move constructor.

Member Function Documentation
   template<typename _T1, typename _T2> template<typename _U1, typename _U2>
       _U2 &&constexpr std::pair< _T1, _T2 >::explicit (!_S_convertible< _U1
       &, _U2 & > ()) [constexpr]
       Converting constructor from a non-const pair<U1, U2> lvalue.

   template<typename _T1, typename _T2> template<typename _U1 = _T1, typename
       _U2 = _T2> std::pair< _T1, _T2 >::explicit (!_S_convertible< _U1, _U2 >
       ()) && [constexpr]
       Constructor accepting two values of arbitrary types.

   template<typename _T1, typename _T2> template<typename _U1, typename _U2>
       _U2 &constexpr std::pair< _T1, _T2 >::explicit (!_S_convertible< _U1,
       _U2 > ()) [constexpr]
       Converting constructor from a non-const pair<U1, U2> rvalue.

   template<typename _T1, typename _T2> std::pair< _T1, _T2 >::explicit
       (!_S_convertible< const _T1 &, const _T2 & > ()) const & [constexpr]
       Constructor accepting lvalues of first_type and second_type.

   template<typename _T1, typename _T2> template<typename _U1, typename _U2>
       _U2 &&constexpr std::pair< _T1, _T2 >::explicit (!_S_convertible< const
       _U1 &, const _U2 & > ()) const [constexpr]
       Converting constructor from a const pair<U1, U2> lvalue.

   template<typename _T1, typename _T2> template<typename _U1, typename _U2>
       _U2 &constexpr std::pair< _T1, _T2 >::explicit (!_S_convertible< const
       _U1, const _U2 > ()) const [constexpr]
       Converting constructor from a const pair<U1, U2> rvalue.

   template<typename _T1, typename _T2> std::pair< _T1, _T2 >::explicit
       (__not_< __and_< __is_implicitly_default_constructible< _T1 >,
       __is_implicitly_default_constructible< _T2 > > > ()) [inline],
       [constexpr],  [noexcept]
       Default constructor.

   template<typename _T1, typename _T2> const pair & std::pair< _T1, _T2
       >::operator= (const pair< _T1, _T2 > & __p) const [inline],
       [constexpr]
       Copy assignment operator (const).

   template<typename _T1, typename _T2> pair & std::pair< _T1, _T2
       >::operator= (const pair< _T1, _T2 > & __p) [inline],  [constexpr],
       [noexcept]
       Copy assignment operator.

   template<typename _T1, typename _T2> template<typename _U1, typename _U2>
       requires (_S_const_assignable<const _U1&, const _U2&>())const pair &
       std::pair< _T1, _T2 >::operator= (const pair< _U1, _U2 > & __p) const
       [inline],  [constexpr]"


       Converting assignment from a const pair<U1, U2> lvalue.

   template<typename _T1, typename _T2> template<typename _U1, typename _U2>
       requires (_S_assignable<const _U1&, const _U2&>())pair & std::pair<
       _T1, _T2 >::operator= (const pair< _U1, _U2 > & __p) [inline],
       [constexpr],  [noexcept]"


       Converting assignment from a const pair<U1, U2> lvalue.

   template<typename _T1, typename _T2> const pair & std::pair< _T1, _T2
       >::operator= (pair< _T1, _T2 > && __p) const [inline],  [constexpr]
       Move assignment operator (const).

   template<typename _T1, typename _T2> pair & std::pair< _T1, _T2
       >::operator= (pair< _T1, _T2 > && __p) [inline],  [constexpr],
       [noexcept]
       Move assignment operator.

   template<typename _T1, typename _T2> template<typename _U1, typename _U2>
       requires (_S_const_assignable<_U1, _U2>())const pair & std::pair< _T1,
       _T2 >::operator= (pair< _U1, _U2 > && __p) const [inline],
       [constexpr]"


       Converting assignment from a non-const pair<U1, U2> rvalue.

   template<typename _T1, typename _T2> template<typename _U1, typename _U2>
       requires (_S_assignable<_U1, _U2>())pair & std::pair< _T1, _T2
       >::operator= (pair< _U1, _U2 > && __p) [inline],  [constexpr],
       [noexcept]"


       Converting assignment from a non-const pair<U1, U2> rvalue.

   template<typename _T1, typename _T2> void std::pair< _T1, _T2 >::swap
       (pair< _T1, _T2 > & __p) [inline],  [constexpr],  [noexcept]
       Swap the first members and then the second members.

       Referenced by std::pair< const __iter_key_t< _InputIterator >,
       __iter_val_t< _InputIterator > >::swap(), std::sub_match< const char *
       >::swap(), and std::swap().

Member Data Documentation
   template<typename _T1, typename _T2> _T1 std::pair< _T1, _T2 >::first
       The first member.

       Referenced by __gnu_parallel::__find_template(),
       __gnu_parallel::__find_template(), std::__sample(), std::set< _Key,
       _Cmp, polymorphic_allocator< _Key > >::insert(), std::pair< const
       __iter_key_t< _InputIterator >, __iter_val_t< _InputIterator >
       >::operator<=>(), std::pair< const __iter_key_t< _InputIterator >,
       __iter_val_t< _InputIterator > >::operator==(), and std::shuffle().

   template<typename _T1, typename _T2> _T2 std::pair< _T1, _T2 >::second
       The second member.

       Referenced by std::__sample(), std::set< _Key, _Cmp,
       polymorphic_allocator< _Key > >::insert(), std::pair< const
       __iter_key_t< _InputIterator >, __iter_val_t< _InputIterator >
       >::operator<=>(), std::pair< const __iter_key_t< _InputIterator >,
       __iter_val_t< _InputIterator > >::operator==(), and std::shuffle().


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

                                   libstdc++          std::pair< _T1, _T2 >(3)