Spec-Zone.ru › C++

std::array<T,N>::operator[]

reference operator[]( size_type pos );
(1) (с C++11)
(constexpr с C++17)
const_reference operator[]( size_type pos ) const;
(2) (с C++11)
(constexpr с C++14)

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

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

(до C++26)

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

  • Если реализация работает в режиме усиленной проверки, происходит нарушение контракта.
  • Если реализация не работает в режиме усиленной проверки, поведение не определено.
(с C++26)

Параметры

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

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

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

Сложность

Постоянная.

Примечания

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

Пример

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

#include <array>
#include <iostream>

int main()
{
    std::array<int, 4> 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/array/operator_at

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API