C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 标准库头文件 <ctime>
- 标准库头文件 <cstring>
- 标准库头文件 <set>
- 标准库头文件 <cctype>
- 标准库头文件 <cwctype>
- 标准库头文件 <utility>
- 标准库头文件 <queue>
- 标准库头文件 <complex>
- 标准库头文件 <iterator>
- 标准库头文件 <algorithm>
- 标准库头文件 <valarray>
- 标准库头文件 <numeric>
- 标准库头文件 <cmath>
- 标准库头文件 <iosfwd>
- 标准库头文件 <ios>
- 标准库头文件 <iomanip>
- 标准库头文件 <streambuf>
- 标准库头文件 <istream>
- 标准库头文件 <ostream>
- 标准库头文件 <iostream>
- 标准库头文件 <sstream>
- 标准库头文件 <clocale>
- 标准库头文件 <vector>
- 标准库头文件 <deque>
- 标准库头文件 <list>
- 标准库头文件 <map>
- 标准库头文件 <cwchar>
- 标准库头文件 <locale>
- 标准库头文件 <codecvt>
- 标准库头文件 <bitset>
- 标准库头文件 <functional>
- 标准库头文件 <stdexcept>
- 标准库头文件 <csignal>
- 标准库头文件 <csetjmp>
- 标准库头文件 <stack>
- 标准库头文件 <cassert>
- 标准库头文件 <cerrno>
- 标准库头文件 <memory>
- 标准库头文件 <typeindex>
- 标准库头文件 <type_traits>
- 标准库头文件 <chrono>
- 标准库头文件 <initializer_list>
- 标准库头文件 <tuple>
- 标准库头文件 <scoped_allocator>
- 标准库头文件 <cstdint>
- 标准库头文件 <cinttypes>
- 标准库头文件 <system_error>
- 标准库头文件 <cuchar>
- 标准库头文件 <array>
- 标准库头文件 <forward_list>
- 标准库头文件 <unordered_set>
- 标准库头文件 <unordered_map>
- 标准库头文件 <random>
- 标准库头文件 <ratio>
- 标准库头文件 <cfenv>
- 标准库头文件 <regex>
- 标准库头文件 <atomic>
- 标准库头文件 <thread>
- 标准库头文件 <mutex>
- 标准库头文件 <future>
- 标准库头文件 <condition_variable>
- 标准库头文件 <any>
- 标准库头文件 <optional>
- 标准库头文件 <variant>
- 标准库头文件 <memory_resource>
- 标准库头文件 <string_view>
- 标准库头文件 <charconv>
- 标准库头文件 <execution>
- 标准库头文件 <filesystem>
- 标准库头文件 <concepts>
- 标准库头文件 <coroutine>
- 标准库头文件 <compare>
- 标准库头文件 <version>
- 标准库头文件 <source_location>
- 标准库头文件 <format>
- 标准库头文件 <span>
- 标准库头文件 <ranges>
- 标准库头文件 <bit>
- 标准库头文件 <numbers>
- 标准库头文件 <syncstream>
- 标准库头文件 <stop_token>
- 标准库头文件 <semaphore>
- 标准库头文件 <latch>
- 标准库头文件 <barrier>
- 标准库头文件 <string>
- 标准库头文件 <cstddef>
- 标准库头文件 <limits>
- 标准库头文件 <cfloat>
- 标准库头文件 <climits>
- 标准库头文件 <cstdlib>
- 标准库头文件 <new>
- 标准库头文件 <typeinfo>
- 标准库头文件 <exception>
- 标准库头文件 <cstdarg>
- 标准库头文件 <ciso646>
- 标准库头文件 <cstdalign>
- 标准库头文件 <cstdbool>
- 标准库头文件 <fstream>
- 标准库头文件 <cstdio>
- 标准库头文件 <strstream>
- 标准库头文件 <shared_mutex>
- 标准库头文件 <ccomplex>
- 标准库头文件 <ctgmath>
- 注释
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持(基本类型、RTTI、类型特性)
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
位置:首页 > C++ 参考手册 >C++ 标准库头文件 > 标准库头文件 <tuple>
标准库头文件 <tuple>
此头文件是通用工具库的一部分。
类 | |
(C++11) |
实现固定大小的容器,它保有类型可以相异的元素 (类模板) |
在编译时获得 tuple 的大小 (类模板特化) | |
获得指定元素的类型 (类模板特化) | |
特化 std::uses_allocator 类型特征 (类模板特化) | |
常量 | |
用 tie 解包 tuple 时用来跳过元素的占位符 (常量) | |
函数 | |
创建一个 tuple 对象,其类型根据各实参类型定义 (函数模板) | |
创建左值引用的 tuple ,或将 tuple 解包为独立对象 (函数模板) | |
创建转发引用的 tuple (函数模板) | |
通过连接任意数量的元组来创建一个tuple (函数模板) | |
元组式访问指定的元素 (函数模板) | |
(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20) |
按字典顺序比较 tuple 中的值 (函数模板) |
(C++11) |
特化 std::swap 算法 (函数模板) |
(C++17) |
以一个实参的元组来调用函数 (函数模板) |
(C++17) |
以一个实参元组构造对象 (函数模板) |
概要
namespace std { // 类模板 tuple: template <class... Types> class tuple; // tuple 创建函数 inline constexpr /* 未指明 */ ignore; template <class... Types> constexpr tuple<VTypes...> make_tuple(Types&&...); template <class... Types> constexpr tuple<Types...> forward_as_tuple(Types&&...) noexcept; template<class... Types> constexpr tuple<Types&...> tie(Types&...) noexcept; template <class... Tuples> constexpr tuple<CTypes...> tuple_cat(Tuples&&...); // 以实参 tuple 调用函数 template <class F, class Tuple> constexpr decltype(auto) apply(F&& f, Tuple&& t); template <class T, class Tuple> constexpr T make_from_tuple(Tuple&& t); // tuple 辅助类: template <class T> class tuple_size; // 未予定义 template <class T> class tuple_size<const T>; template <class T> class tuple_size<volatile T>; template <class T> class tuple_size<const volatile T>; template <class... Types> class tuple_size<tuple<Types...> >; template <size_t I, class T> class tuple_element; // 未予定义 template <size_t I, class T> class tuple_element<I, const T>; template <size_t I, class T> class tuple_element<I, volatile T>; template <size_t I, class T> class tuple_element<I, const volatile T>; template <size_t I, class... Types> class tuple_element<I, tuple<Types...> >; // 元素访问: template <size_t I, class... Types> constexpr tuple_element_t<I, tuple<Types...>>& get(tuple<Types...>&) noexcept; template <size_t I, class... Types> constexpr tuple_element_t<I, tuple<Types...>>&& get(tuple<Types...>&&) noexcept; template <size_t I, class... Types> constexpr const tuple_element_t<I, tuple<Types...>>& get(const tuple<Types...>&) noexcept; template <size_t I, class... Types> constexpr const tuple_element_t<I, tuple<Types...>>&& get(const tuple<Types...>&&) noexcept; template <class T, class... Types> constexpr T& get(tuple<Types...>& t) noexcept; template <class T, class... Types> constexpr T&& get(tuple<Types...>&& t) noexcept; template <class T, class... Types> constexpr const T& get(const tuple<Types...>& t) noexcept; template <class T, class... Types> constexpr const T&& get(const tuple<Types...>&& t) noexcept; // 关系运算符: template<class... TTypes, class... UTypes> constexpr bool operator==(const tuple<TTypes...>&, const tuple<UTypes...>&); template<class... TTypes, class... UTypes> constexpr bool operator<(const tuple<TTypes...>&, const tuple<UTypes...>&); template<class... TTypes, class... UTypes> constexpr bool operator!=(const tuple<TTypes...>&, const tuple<UTypes...>&); template<class... TTypes, class... UTypes> constexpr bool operator>(const tuple<TTypes...>&, const tuple<UTypes...>&); template<class... TTypes, class... UTypes> constexpr bool operator<=(const tuple<TTypes...>&, const tuple<UTypes...>&); template<class... TTypes, class... UTypes> constexpr bool operator>=(const tuple<TTypes...>&, const tuple<UTypes...>&); // 分配器相关特征 template <class... Types, class Alloc> struct uses_allocator<tuple<Types...>, Alloc>; // 特化的算法: template <class... Types> constexpr void swap(tuple<Types...>& x, tuple<Types...>& y) noexcept(x.swap(y)); // tuple 辅助类 template <class T> constexpr size_t tuple_size_v = tuple_size<T>::value; }
类 std::tuple
template <class... Types> class tuple { public: // tuple 构造 /* 条件性-explicit */ constexpr tuple(); // 仅当 sizeof...(Types) >= 1 /* 条件性-explicit */ constexpr tuple(const Types&...); // 仅当 sizeof...(Types) >= 1 template <class... UTypes> /* 条件性-explicit */ constexpr tuple(UTypes&&...); tuple(const tuple&) = default; tuple(tuple&&) = default; template <class... UTypes> /* 条件性-explicit */ constexpr tuple(const tuple<UTypes...>&); template <class... UTypes> /* 条件性-explicit */ constexpr tuple(tuple<UTypes...>&&); // 仅当 sizeof...(Types) == 2 template <class U1, class U2> /* 条件性-explicit */ constexpr tuple(const pair<U1, U2>&); // 仅当 sizeof...(Types) == 2 template <class U1, class U2> /* 条件性-explicit */ constexpr tuple(pair<U1, U2>&&); // 分配器扩展构造函数 template <class Alloc> constexpr tuple(allocator_arg_t, const Alloc& a); template <class Alloc> /* 条件性-explicit */ constexpr tuple(allocator_arg_t, const Alloc& a, const Types&...); template <class Alloc, class... UTypes> /* 条件性-explicit */ constexpr tuple(allocator_arg_t, const Alloc& a, UTypes&&...); template <class Alloc> constexpr tuple(allocator_arg_t, const Alloc& a, const tuple&); template <class Alloc> constexpr tuple(allocator_arg_t, const Alloc& a, tuple&&); template <class Alloc, class... UTypes> /* 条件性-explicit */ constexpr tuple(allocator_arg_t, const Alloc& a, const tuple<UTypes...>&); template <class Alloc, class... UTypes> /* 条件性-explicit */ constexpr tuple(allocator_arg_t, const Alloc& a, tuple<UTypes...>&&); template <class Alloc, class U1, class U2> /* 条件性-explicit */ constexpr tuple(allocator_arg_t, const Alloc& a, const pair<U1, U2>&); template <class Alloc, class U1, class U2> /* 条件性-explicit */ constexpr tuple(allocator_arg_t, const Alloc& a, pair<U1, U2>&&); // tuple 赋值 constexpr tuple& operator=(const tuple&); constexpr tuple& operator=(tuple&&) noexcept(see below ); template <class... UTypes> constexpr tuple& operator=(const tuple<UTypes...>&); template <class... UTypes> constexpr tuple& operator=(tuple<UTypes...>&&); template <class U1, class U2> constexpr tuple& operator=(const pair<U1, U2>&); // 仅当 sizeof...(Types) == 2 template <class U1, class U2> constexpr tuple& operator=(pair<U1, U2>&&); // 仅当 sizeof...(Types) == 2 // tuple 交换 constexpr void swap(tuple&) noexcept(/* 条件性 */); };