C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持(基本类型、RTTI、类型特性)
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- std::begin, std::cbegin
- std::end, std::cend
- std::next
- std::reverse_iterator
- std::rbegin, std::crbegin
- std::indirectly_readable
- std::indirectly_writable
- std::weakly_incrementable
- std::prev
- std::move_iterator
- std::size, std::ssize
- std::empty
- std::data
- std::insert_iterator
- std::rend, std::crend
- std::incrementable
- std::input_or_output_iterator
- std::sentinel_for
- std::sized_sentinel_for, std::disable_sized_sentinel_for
- std::input_iterator
- std::output_iterator
- std::forward_iterator
- std::bidirectional_iterator
- std::random_access_iterator
- std::contiguous_iterator
- std::iterator_traits
- std::input_iterator_tag, std::output_iterator_tag, std::forward_iterator_tag, std::bidirectional_iterator_tag, std::random_access_iterator_tag, std::contiguous_iterator_tag
- std::iterator
- std::incrementable_traits
- std::indirectly_readable_traits
- std::iter_value_t, std::iter_reference_t, std::iter_difference_t, std::iter_rvalue_reference_t, std::iter_common_reference_t
- std::indirect_unary_invocable, std::indirectly_regular_unary_invocable
- std::indirect_unary_predicate
- std::indirect_binary_predicate
- std::indirect_equivalence_relation
- std::indirect_strict_weak_order
- std::indirectly_movable
- std::indirectly_movable_storable
- std::indirectly_copyable
- std::indirectly_copyable_storable
- std::indirectly_swappable
- std::indirectly_comparable
- std::permutable
- std::mergeable
- std::sortable
- std::indirect_result_t
- std::projected
- std::move_sentinel
- std::back_insert_iterator
- std::front_insert_iterator
- std::make_reverse_iterator
- std::make_move_iterator
- std::default_sentinel_t, std::default_sentinel
- std::unreachable_sentinel_t, std::unreachable_sentinel
- std::back_inserter
- std::front_inserter
- std::inserter
- std::istream_iterator
- std::ostream_iterator
- std::istreambuf_iterator
- std::ostreambuf_iterator
- std::advance
- std::distance
- 注释
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
std::data
定义于头文件 <iterator>
|
||
template <class C> constexpr auto data(C& c) -> decltype(c.data()); |
(1) | (C++17 起) |
template <class C> constexpr auto data(const C& c) -> decltype(c.data()); |
(2) | (C++17 起) |
template <class T, std::size_t N> constexpr T* data(T (&array)[N]) noexcept; |
(3) | (C++17 起) |
template <class E> constexpr const E* data(std::initializer_list<E> il) noexcept; |
(4) | (C++17 起) |
返回指向含有容器元素的内存块的指针。
1,2) 返回 c.data()
3) 返回 array
4) 返回 il.begin()
参数
c | - | 有 data() 方法的容器 |
array | - | 任意类型的数组 |
il | - | initializer_list |
返回值
指向含有容器元素的内存块的指针。
注意
除了包含于 <iterator>
,若包含下列任一头文件,则保证 std::data
可用: <array>
、 <deque>
、 <forward_list>
、 <list>
、 <map>
、 <regex>
、 <set>
、 <span>
(C++20 起) 、 <string>
、 <string_view>
、 <unordered_map>
、 <unordered_set>
及 <vector>
。
可能的实现
版本一 |
---|
template <class C> constexpr auto data(C& c) -> decltype(c.data()) { return c.data(); } |
版本二 |
template <class C> constexpr auto data(const C& c) -> decltype(c.data()) { return c.data(); } |
版本三 |
template <class T, std::size_t N> constexpr T* data(T (&array)[N]) noexcept { return array; } |
版本四 |
template <class E> constexpr const E* data(std::initializer_list<E> il) noexcept { return il.begin(); } |
示例
本节未完成 原因:暂无示例 |