std::data

Определено в заголовке `<array>`
Определено в заголовке `<deque>`
Определено в заголовке `<forward_list>`
Определено в заголовке `<iterator>`
Определено в заголовке `<list>`
Определено в заголовке `<map>`
Определено в заголовке `<regex>`
Определено в заголовке `<set>`
Определено в заголовке `<string>`		(с C++20)
Определено в заголовке `<string_view>`
Определено в заголовке `<unordered_map>`
Определено в заголовке `<unordered_set>`
Определено в заголовке `<vector>`
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	-	список инициализации

Значение результата

Указатель на блок памяти, содержащий элементы диапазона.

Исключения

1) Может выбросить исключения, определённые реализацией.

Примечания

Перегрузка для std::initializer_list необходима, так как у неё нет функции-члена data.

Макрокоманда проверки наличия функции	Значение	Std	Функция
`__cpp_lib_nonmember_container_access`	201411L	(C++17)	`std::size()`, `std::data()`, и `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]; // storage for a C-style string
    std::strcpy(a, std::data(s));
//  [s.data(), s.data() + s.size()] is guaranteed to be an NTBS since C++11
 
    std::cout << a;
}

Вывод:

Hello world!

См. также

ranges::data (C++20)	получает указатель на начало непрерывного диапазона (объект точки кастомизации)
ranges::cdata (C++20)	получает указатель на начало только для чтения непрерывного диапазона (объект точки кастомизации)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/iterator/data