Namespaces
Variants

    std::data

    来自 zh.cppreference.net
     
    C++
     
    迭代器库
    迭代器概念
    迭代器原语
    算法概念和工具
    间接可调用概念
    通用算法要求
    (C++20)
    (C++20)
    (C++20)
    工具
    (C++20)
    迭代器适配器
    范围访问
    (C++11)(C++14)
    (C++14)(C++14)  
    (C++11)(C++14)
    (C++14)(C++14)  
    (C++17)(C++20)
    (C++17)
    (C++17)
     
    定义于头文件 <array>
    定义于头文件 <deque>
    定义于头文件 <flat_map>
     (C++23起)
    定义于头文件 <flat_set>
     (C++23起)
    定义于头文件 <forward_list>
    定义于头文件 <inplace_vector>
     (C++26起)
    定义于头文件 <iterator>
    定义于头文件 <list>
    定义于头文件 <map>
    定义于头文件 <optional>
     (C++26起)
    定义于头文件 <regex>
    定义于头文件 <set>
    定义于头文件 <span>
     (C++20起)
    定义于头文件 <stacktrace>
     (C++23起)
    定义于头文件 <string>
    定义于头文件 <string_view>
    定义于头文件 <unordered_map>
    定义于头文件 <unordered_set>
    定义于头文件 <valarray>
    定义于头文件 <vector> 
    template< class C >
constexpr auto data( C& c ) noexcept(noexcept(c.data()))
    -> decltype(c.data());
    		(1) (C++17起) 
    template< class C >
constexpr auto data( const C& c ) noexcept(noexcept(c.data()))
    -> decltype(c.data());
    		(2) (C++17起) 
    template< class T, std::size_t N >
constexpr T* data( T (&array)[N] ) noexcept;
    		(3) (C++17起)

    返回指向包含范围元素的内存块的指针。

    1,2) 返回 c.data()。
    3) 返回 array。

    参数

    c - 具有 data ( ) 成员函数的容器或视图
    array - 任意类型的数组
    il - 一个 std::initializer_list

    返回值

    1,2) c. data ( )
    3) array
    4) il. begin ( )

    异常

    1) 可能抛出实现定义的异常。

    注释

    针对 std::initializer_list 的重载是必需的，因为它没有名为 data 的成员函数。

    功能测试 宏 值 标准 功能
    __cpp_lib_nonmember_container_access 201411L (C++17) std::size() , std::data() , and std::empty()

    可能的实现

    第一版本 
    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();
}

    示例

    运行此代码 
    #include <cstring>
#include <iostream>
#include <string>
int main()
{
    std::string s{"Hello world!\n"};
    char a[20]; // 用于存储C风格字符串的空间
    std::strcpy(a, std::data(s));
// 自C++11起，[s.data(), s.data() + s.size()] 保证是一个空终止字节序列
    std::cout << a;
}

    输出： 

    Hello world!

    缺陷报告

    以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

    DR 应用于 已发布行为 正确行为
    P3016R6 C++17 1) 非成员std::data重载为std::initializer_list
    2) std::data不要求传播异常规范     		1) 移除
    2) 要求

    参见

    (C++20)
    		获取连续范围起始位置的指针
    (定制点对象)
    (C++20)
    		获取只读连续范围起始位置的指针
    (定制点对象)