Namespaces
Variants

    std::ranges::cdata

    来自 zh.cppreference.net
     
    C++
     
    范围库
    范围适配器
     
    定义于头文件 <ranges>
    定义于头文件 <iterator> 
    inline namespace /*unspecified*/ {
    inline constexpr /*unspecified*/ cdata = /*unspecified*/;
}
    		(从 C++20 开始)
    (定制点对象)
    调用签名
    		 
    template< class T >
    requires /* see below */
constexpr /* see below */ cdata( T&& t );
    		(从 C++20 开始)

    返回指向连续范围首元素的指针，该元素具有常量类型(从 C++23 开始)，该范围由const 限定(至 C++23)参数指定。

    令 CT 为

    • const std::remove_reference_t<T>& 若参数为左值（即 T 为左值引用类型），
    • const T 否则。

    对 ranges::cdata 的调用表达式等价于 ranges::data(static_cast<CT&&>(t))。

    返回类型等价于 std::remove_reference_t<ranges::range_reference_t<CT>>*。

    		(至 C++23)

    若参数为左值或 ranges::enable_borrowed_range<std::remove_cv_t<T>> 为 true，则对 ranges::cdata 的调用表达式等价于:

    返回类型等价于 std::remove_reference_t<ranges::range_const_reference_t<T>>*。

    在所有其它情况下，对 ranges::cdata 的调用为非良构，这可能导致在模板实例化的直接上下文中出现替换失败。

    		(从 C++23 开始)

    若 ranges::cdata(t) 合法，则它返回指向常量类型(从 C++23 开始)对象的指针。

    定制点对象

    名称 ranges::cdata 表示一个 定制点对象 ，这是一个常量 函数对象 ，具有 字面量 类型的 semiregular 类类型。详情请参阅 定制点对象 。

    示例

    运行此代码 
    #include <cstring>
#include <iostream>
#include <ranges>
#include <string>
int main()
{
    std::string src {"hello world!\n"};
//  std::ranges::cdata(src)[0] = 'H'; // 错误：src.data() 被视为只读
    std::ranges::data(src)[0] = 'H'; // 正确：src.data() 是非常量存储
    char dst[20]; // C风格字符串的存储空间
    std::strcpy(dst, std::ranges::cdata(src));
    // 保证 [data(src), data(src) + size(src)] 是 NTBS（空终止字节字符串）
    std::cout << dst;
}

    输出： 

    Hello world!

    参见

    (C++20)
    		 获取指向连续范围起始的指针
    (定制点对象)
    (C++17)
    		 获取指向底层数组的指针
    (函数模板)