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.