std:: array

std::array — это контейнер, который инкапсулирует массивы фиксированного размера.

Этот контейнер является агрегатным типом с той же семантикой, что и структура, содержащая C-массив T [ N ] в качестве своего единственного нестатического члена данных. В отличие от C-массива, он не преобразуется в T * автоматически. Как агрегатный тип, он может быть инициализирован с помощью агрегатной инициализации с использованием не более N инициализаторов, преобразуемых в T : std :: array < int , 3 > a = { 1 , 2 , 3 } ; .

Структура сочетает производительность и доступность массива в стиле C с преимуществами стандартного контейнера, такими как знание собственного размера, поддержка присваивания, итераторы произвольного доступа и т.д.

std::array удовлетворяет требованиям Container и ReversibleContainer за исключением того, что конструированный по умолчанию array не является пустым и сложность обмена линейна, удовлетворяет требованиям ContiguousContainer , (начиная с C++17) и частично удовлетворяет требованиям SequenceContainer .

Существует особый случай для массива нулевой длины ( N == 0 ). В этом случае, array. begin ( ) == array. end ( ) , что является некоторым уникальным значением. Эффект от вызова front ( ) или back ( ) для массива нулевого размера не определён.

Массив также может использоваться как кортеж из N элементов одного типа.

Инвалидация итераторов

Как правило, итераторы массива никогда не инвалидируются в течение времени жизни массива. Однако следует учитывать, что во время swap итератор продолжит указывать на тот же элемент массива и, следовательно, изменит своё значение.

Параметры шаблона

Типы членов

Функции-члены

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

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

Пример

#include <algorithm>
#include <array>
#include <iostream>
#include <iterator>
#include <string>
int main()
{
    // Конструкция использует агрегатную инициализацию
    std::array<int, 3> a1{{1, 2, 3}}; // Двойные фигурные скобки требуются в C++11 до
                                      // ревизии CWG 1270 (не нужны в C++11
                                      // после ревизии и в C++14 и выше)
    std::array<int, 3> a2 = {1, 2, 3}; // Двойные скобки никогда не требуются после =
    // Поддерживаются операции с контейнерами
    std::sort(a1.begin(), a1.end());
    std::ranges::reverse_copy(a2, std::ostream_iterator<int>(std::cout, " "));
    std::cout << '\n';
    // Поддерживается цикл for по диапазону
    std::array<std::string, 2> a3{"E", "\u018E"};
    for (const auto& s : a3)
        std::cout << s << ' ';
    std::cout << '\n';
    // Руководство по выводу для создания массива (начиная с C++17)
    [[maybe_unused]] std::array a4{3.0, 1.0, 4.0}; // std::array<double, 3>
    // Поведение неинициализированных элементов такое же, как у встроенных массивов
    [[maybe_unused]] std::array<int, 2> a5; // Без инициализации списком, a5[0] и a5[1]
                                            // инициализируются по умолчанию
    [[maybe_unused]] std::array<int, 2> a6{}; // Инициализация списком, оба элемента
                                              // инициализируются значением, a6[0] = a6[1] = 0
    [[maybe_unused]] std::array<int, 2> a7{1}; // Инициализация списком, неинициализированный элемент
                                               // инициализируется значением, a7[0] = 1, a7[1] = 0
}

3 2 1
E Ǝ

Смотрите также