std::array::data

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека контейнеров

Последовательные

array (C++11)

vector

vector<bool>

deque

forward_list (C++11)

list

Ассоциативные

set

multiset

map

multimap

Неупорядоченные ассоциативные

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

Адаптеры

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

Представления

span (C++20)

mdspan (C++23)

Недействительные итераторы

Таблица функций-элементов

Таблица функций, не являющихся элементами

 

std::array

Типы элементы

Функции-элементы

Доступ к элементам

array::at

array::operator[]

array::front

array::back

array::data

Итераторы

array::beginarray::cbegin

array::endarray::cend

array::rbeginarray::crbegin

array::rendarray::crend

Ёмкость

array::empty

array::size

array::max_size

Модификаторы

array::fill

array::swap

Функции, не являющиеся элементами

get

std::swap

to_array (C++20)

operator==operator!=operator<operator>operator<=operator>=operator<=> (до C++20)(до C++20)(до C++20)(до C++20)(до C++20)(C++20)

Вспомогательные классы

tuple_size

tuple_element

Принципы вывода (C++17)

 

<tbody> </tbody> <tbody class="t-dcl-rev "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev "> </tbody><tbody> </tbody>

T* data() noexcept;		(начиная с C++11) (до C++17)
constexpr T* data() noexcept;		(начиная с C++17)
const T* data() const noexcept;		(начиная с C++11) (до C++17)
constexpr const T* data() const noexcept;		(начиная с C++17)

Возвращает указатель на внутренний массив, выступающий в качестве хранилища элементов. Указатель таков, что диапазон [data(); data() + size()) всегда корректный, даже если контейнер пуст (Указатель data() в таком случае не может быть разыменован).

Параметры

(нет)

Возвращаемое значение

Указатель на внутренний массив. Для непустых контейнеров, возвращаемый указатель является равным адресу первого элемента.

Сложность

Константная.

Примечания

Если size() равен 0, не гарантируется, что data() вернёт нулевой указатель.

Пример

Запустить этот код

#include <cstddef>
#include <iostream>
#include <span>
#include <array>

void pointer_func(const int* p, std::size_t size)
{
    std::cout << "data = ";
    for (std::size_t i = 0; i < size; ++i)
        std::cout << p[i] << ' ';
    std::cout << '\n';
}

void span_func(std::span<const int> data) // Начиная с C++20
{
    std::cout << "data = ";
    for (const int e : data)
        std::cout << e << ' ';
    std::cout << '\n';
}

int main()
{
    std::array<int,4> container { 1, 2, 3, 4 };

    // Использование container.data() предпочтительнее, чем &container[0]
    pointer_func(container.data(), container.size());

    // std::span (C++20) - более безопасная альтернатива указателю и размеру по отдельности.
    span_func({container.data(), container.size()});
}

Вывод:

data = 1 2 3 4 
data = 1 2 3 4

См. также

front (C++11)	предоставляет доступ к первому элементу (public функция-элемент)
back (C++11)	предоставляет доступ к последнему элементу (public функция-элемент)
size (C++11)	возвращает количество элементов (public функция-элемент)
span (C++20)	не владеющее представление непрерывной последовательности объектов (шаблон класса)