std::deque<T,Allocator>::operator[]

reference operator[]( size_type pos );	(1)
const_reference operator[]( size_type pos ) const;	(2)

Возвращает ссылку на элемент в указанной позиции pos. Проверка границ не выполняется, если только реализация не использует усиленные проверки(начиная с C++26).

Если pos < size() равно false, поведение не определено.

(до C++26)

Если pos < size() равно false:

Если реализация использует усиленные проверки, происходит нарушение контракта.
Если реализация не использует усиленные проверки, поведение не определено.

(начиная с C++26)

Параметры

pos

позиция возвращаемого элемента

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

Ссылка на запрошенный элемент.

Сложность

Постоянная.

Примечания

В отличие от std::map::operator[], этот оператор никогда не вставляет новый элемент в контейнер. Доступ к несуществующему элементу с помощью этого оператора приводит к неопределённому поведению, если только реализация не использует усиленные проверки(начиная с C++26).

Пример

В следующем коде operator[] используется для чтения и записи в std::deque<int>:

#include <deque>
#include <iostream>

int main()
{
    std::deque<int> numbers{2, 4, 6, 8};
    
    std::cout << "Second element: " << numbers[1] << '\n';
    
    numbers[0] = 5;
    
    std::cout << "All numbers:";
    for (auto i : numbers)
        std::cout << ' ' << i;
    std::cout << '\n';
}

Вывод:

Second element: 4
All numbers: 5 4 6 8

См. также

at	доступ к указанному элементу с проверкой границ (открытая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/deque/operator_at