std::array::operator[]

reference operator[]( size_type pos );		(until C++17)
constexpr reference operator[]( size_type pos );		(since C++17)
const_reference operator[]( size_type pos ) const;		(until C++14)
constexpr const_reference operator[]( size_type pos ) const;		(since C++14)

Returns a reference to the element at specified location pos. No bounds checking is performed.

Parameters

pos

-

position of the element to return

Return value

Reference to the requested element.

Complexity

Constant.

Notes

Unlike std::map::operator[], this operator never inserts a new element into the container.

Example

The following code uses operator[] to read from and write to a std::array<int>:

Run this code

#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';
}

Output:

Second element: 4
All numbers: 5 4 6 8

Language
Headers
Freestanding and hosted implementations
Named requirements
Language support library
Concepts library (C++20)
Diagnostics library
Utilities library
Strings library
Containers library
Algorithms library
Iterators library
Numerics library
Input/output library
Localizations library
Regular expressions library (C++11)
Atomic operations library (C++11)
Thread support library (C++11)
Filesystem library (C++17)
Technical Specifications

array (C++11)
vector
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
span (C++20)