| ||||||||||||||||||||||
| Range primitives | |||||||
| |||||||
| Range concepts | |||||||||||||||||||
| |||||||||||||||||||
| Range factories | |||||||||
| |||||||||
| Range adaptors | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Helper items | |||||||||||||||||
| |||||||||||||||||
Defined in header <ranges> | ||
Defined in header <iterator> | ||
inlinenamespace/*unspecified*/{ inlineconstexpr/*unspecified*/ cdata=/*unspecified*/; | (since C++20) (customization point object) | |
Call signature | ||
template<class T> requires/* see below */ | (since C++20) | |
Returns a pointer to the first elementof constant type(since C++23) of a contiguous range denoted by aconst-qualified(until C++23) argument.
Let
A call to The return type is equivalent tostd::remove_reference_t<ranges::range_reference_t<CT>>*. | (until C++23) |
If the argument is an lvalue orranges::enable_borrowed_range<std::remove_cv_t<T>> istrue, then a call to The return type is equivalent tostd::remove_reference_t<ranges::range_const_reference_t<T>>*. In all other cases, a call to | (since C++23) |
Ifranges::cdata(t) is valid, then it returns a pointer to an objectof constant type(since C++23).
The nameranges::cdata denotes acustomization point object, which is a constfunction object of aliteralsemiregular class type. SeeCustomizationPointObject for details.
#include <cstring>#include <iostream>#include <ranges>#include <string> int main(){std::string src{"hello world!\n"}; // std::ranges::cdata(src)[0] = 'H'; // error, src.data() is treated as read-only std::ranges::data(src)[0]='H';// OK, src.data() is a non-const storage char dst[20];// storage for a C-style stringstd::strcpy(dst, std::ranges::cdata(src));// [data(src), data(src) + size(src)] is guaranteed to be an NTBS std::cout<< dst;}
Output:
Hello world!
(C++20) | obtains a pointer to the beginning of a contiguous range (customization point object)[edit] |
(C++17) | obtains the pointer to the underlying array (function template)[edit] |
