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

> C++ Atlas: `cppatlas.com/w/cpp/container/deque/operator_at` | Source: https://en.cppreference.com/w/cpp/container/deque/operator_at | Domain: Containers | Standards: C++98

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

## Official Specification Summary (cppreference)

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

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. Accessing a nonexistent element through this operator is undefined behavior.

### Example

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

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

Output:

```text
Second element: 4
All numbers: 5 4 6 8
```

### See also

- [`at`](https://en.cppreference.com/w/cpp/container/deque/at): access specified element with bounds checking (public member function)

---
Attribution: content from https://en.cppreference.com/w/cpp/container/deque/operator_at (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.