std::array::end, std::array::cend

 

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> <tbody class="t-dcl-rev "> </tbody><tbody> </tbody>

iterator end() noexcept;		(до C++17)
constexpr iterator end() noexcept;		(начиная с C++17)
const_iterator end() const noexcept;		(до C++17)
constexpr const_iterator end() const noexcept;		(начиная с C++17)
const_iterator cend() const noexcept;		(до C++17)
constexpr const_iterator cend() const noexcept;		(начиная с C++17)

Возвращает итератор на элемент, следующий за последним элементом array.

Этот элемент существует лишь условно, попытка доступа к нему приведёт к неопределённому поведению.

Параметры

(нет)

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

Итератор на элемент, следующий за последним элементом.

Сложность

Константная

Пример

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

#include <array>
#include <iostream>
#include <algorithm>
#include <iomanip>

int main()
{
    std::cout << std::boolalpha;

    std::array<int, 0> empty;
    std::cout << "1) "
              << (empty.begin() == empty.end()) << ' '     // true
              << (empty.cbegin() == empty.cend()) << '\n'; // true
    // *(empty.begin()) = 42; // => неопределенное поведение при запуске


    std::array<int, 4> numbers{5, 2, 3, 4};
    std::cout << "2) "
              << (numbers.begin() == numbers.end()) << ' '    // false
              << (numbers.cbegin() == numbers.cend()) << '\n' // false
              << "3) "
              << *(numbers.begin()) << ' '    // 5
              << *(numbers.cbegin()) << '\n'; // 5

    *numbers.begin() = 1;
    std::cout << "4) " << *(numbers.begin()) << '\n'; // 1
    // *(numbers.cbegin()) = 42; // ошибка компиляции: 
                                 // нельзя присвоить переменной только для чтения

    // распечатаем все элементы
    std::cout << "5) ";
    std::for_each(numbers.cbegin(), numbers.cend(), [](int x) {
       std::cout << x << ' ';
    });
    std::cout << '\n';


    constexpr std::array constants{'A', 'B', 'C'};
    static_assert(constants.begin() != constants.end());   // OK
    static_assert(constants.cbegin() != constants.cend()); // OK
    static_assert(*constants.begin() == 'A');              // OK
    static_assert(*constants.cbegin() == 'A');             // OK
    // *constants.begin() = 'Z'; // ошибка компиляции: 
                                 // нельзя присвоить переменной только для чтения
}

Вывод:

1) true true
2) false false
3) 5 5
4) 1
5) 1 2 3 4

См. также

begin cbegin (C++11)

возвращает итератор на начало (public функция-элемент)