Standard library header - cppreference.com (original) (raw)

This header is part of the general utility library.

[edit] Synopsis

#include #include   namespace std { // swap template constexpr void swap(T& a, T& b) noexcept(/* see description /); template<class T, size_t N> constexpr void swap(T (&a)[N], T (&b)[N]) noexcept(is_nothrow_swappable_v);   // exchange template<class T, class U = T> constexpr T exchange(T& obj, U&& new_val);   // forward/move template constexpr T&& forward(remove_reference_t& t) noexcept; template constexpr T&& forward(remove_reference_t&& t) noexcept; template<class T, class U> constexpr / see description / forward_like(U&& x) noexcept; template constexpr remove_reference_t&& move(T&&) noexcept; template constexpr conditional_t< !is_nothrow_move_constructible_v && is_copy_constructible_v, const T&, T&&> move_if_noexcept(T& x) noexcept;   // as_const template constexpr add_const_t& as_const(T& t) noexcept; template void as_const(const T&&) = delete;   // declval template add_rvalue_reference_t declval() noexcept; // as unevaluated operand   // integer comparison functions template<class T, class U> constexpr bool cmp_equal(T t, U u) noexcept; template<class T, class U> constexpr bool cmp_not_equal(T t, U u) noexcept;   template<class T, class U> constexpr bool cmp_less(T t, U u) noexcept; template<class T, class U> constexpr bool cmp_greater(T t, U u) noexcept; template<class T, class U> constexpr bool cmp_less_equal(T t, U u) noexcept; template<class T, class U> constexpr bool cmp_greater_equal(T t, U u) noexcept;   template<class R, class T> constexpr bool in_range(T t) noexcept;   // to_underlying template constexpr underlying_type_t to_underlying(T value) noexcept;   // unreachable [[noreturn]] void unreachable();   // compile-time integer sequences template<class T, T...> struct integer_sequence; template<size_t... I> using index_sequence = integer_sequence<size_t, I...>;   template<class T, T N> using make_integer_sequence = integer_sequence<T, /* see description */>; template using make_index_sequence = make_integer_sequence<size_t, N>;   template<class... T> using index_sequence_for = make_index_sequence<sizeof...(T)>;   // class template pair template<class T1, class T2> struct pair;   // pair specialized algorithms template<class T1, class T2> constexpr bool operator==(const pair<T1, T2>&, const pair<T1, T2>&); template<class T1, class T2> constexpr common_comparison_category_t</*synth-three-way-result*/, /synth-three-way-result/> operator<=>(const pair<T1, T2>&, const pair<T1, T2>&);   template<class T1, class T2> constexpr void swap(pair<T1, T2>& x, pair<T1, T2>& y) noexcept(noexcept(x.swap(y)));   template<class T1, class T2> constexpr / see description */ make_pair(T1&&, T2&&);   // tuple-like access to pair template struct tuple_size; template<size_t I, class T> struct tuple_element;   template<class T1, class T2> struct tuple_size<pair<T1, T2>>; template<size_t I, class T1, class T2> struct tuple_element<I, pair<T1, T2>>;   template<size_t I, class T1, class T2> constexpr tuple_element_t<I, pair<T1, T2>>& get(pair<T1, T2>&) noexcept; template<size_t I, class T1, class T2> constexpr tuple_element_t<I, pair<T1, T2>>&& get(pair<T1, T2>&&) noexcept; template<size_t I, class T1, class T2> constexpr const tuple_element_t<I, pair<T1, T2>>& get(const pair<T1, T2>&) noexcept; template<size_t I, class T1, class T2> constexpr const tuple_element_t<I, pair<T1, T2>>&& get(const pair<T1, T2>&&) noexcept; template<class T1, class T2> constexpr T1& get(pair<T1, T2>& p) noexcept; template<class T1, class T2> constexpr const T1& get(const pair<T1, T2>& p) noexcept; template<class T1, class T2> constexpr T1&& get(pair<T1, T2>&& p) noexcept; template<class T1, class T2> constexpr const T1&& get(const pair<T1, T2>&& p) noexcept; template<class T2, class T1> constexpr T2& get(pair<T1, T2>& p) noexcept; template<class T2, class T1> constexpr const T2& get(const pair<T1, T2>& p) noexcept; template<class T2, class T1> constexpr T2&& get(pair<T1, T2>&& p) noexcept; template<class T2, class T1> constexpr const T2&& get(const pair<T1, T2>&& p) noexcept;   // pair piecewise construction struct piecewise_construct_t { explicit piecewise_construct_t() = default; }; inline constexpr piecewise_construct_t piecewise_construct{}; template<class... Types> class tuple; // defined in   // in-place construction struct in_place_t { explicit in_place_t() = default; }; inline constexpr in_place_t in_place{};   template struct in_place_type_t { explicit in_place_type_t() = default; }; template inline constexpr in_place_type_t in_place_type{};   template struct in_place_index_t { explicit in_place_index_t() = default; }; template inline constexpr in_place_index_t in_place_index{};   // nontype argument tag template struct nontype_t { explicit nontype_t() = default; }; template inline constexpr nontype_t nontype{}; }   // deprecated namespace std::rel_ops { template bool operator!=(const T&, const T&); template bool operator> (const T&, const T&); template bool operator<=(const T&, const T&); template bool operator>=(const T&, const T&); }

[edit] Class template std::integer_sequence

namespace std { template<class T, T... I> struct integer_sequence { using value_type = T; static constexpr size_t size() noexcept { return sizeof...(I); } }; }

[edit] Class template std::pair

namespace std { template<class T1, class T2> struct pair { using first_type = T1; using second_type = T2;   T1 first; T2 second;   pair(const pair&) = default; pair(pair&&) = default; constexpr explicit(/* see description /) pair(); constexpr explicit(/ see description /) pair(const T1& x, const T2& y); template constexpr explicit(/ see description /) pair(U1&& x, U2&& y); template<class U1, class U2> constexpr explicit(/ see description /) pair(const pair<U1, U2>& p); template<class U1, class U2> constexpr explicit(/ see description /) pair(pair<U1, U2>&& p); template<class... Args1, class... Args2> constexpr pair(piecewise_construct_t, tuple<Args1...> first_args, tuple<Args2...> second_args);   constexpr pair& operator=(const pair& p); template<class U1, class U2> constexpr pair& operator=(const pair<U1, U2>& p); constexpr pair& operator=(pair&& p) noexcept(/ see description /); template<class U1, class U2> constexpr pair& operator=(pair<U1, U2>&& p);   constexpr void swap(pair& p) noexcept(/ see description */); };   template<class T1, class T2> pair(T1, T2) -> pair<T1, T2>; }

[edit] See also