std::array::front

 

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>

reference front();		(до C++17)
constexpr reference front();		(начиная с C++17)
const_reference front() const;		(до C++14)
constexpr const_reference front() const;		(начиная с C++14)

Возвращает ссылку на первый элемент в контейнере.

Вызов front от пустого контейнера не определён.

Параметры

(нет)

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

Ссылка на первый элемент

Сложность

Константная

Примечания

Для контейнера c, выражение c.front() - эквивалентно *c.begin().

Пример

Следующий код использует front для отображения первого элемента std::array<char, 6>:

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

#include <array>
#include <iostream>
 
int main()
{
    std::array<char, 6> letters {'o', 'm', 'g', 'w', 't', 'f'};
 
    if (!letters.empty()) {
        std::cout << "Первый символ - '" << letters.front() << "'.\n";
    }  
}

Вывод:

Первый символ - 'o'.

См. также

back (C++11)

предоставляет доступ к последнему элементу (public функция-элемент)