# std::basic_string<CharT,Traits,Allocator>::operator[]

> C++ Atlas: `cppatlas.com/w/cpp/string/basic_string/operator_at` | Source: https://en.cppreference.com/w/cpp/string/basic_string/operator_at | Domain: Strings | Standards: C++11, C++20

Returns a reference to the character at specified location pos if pos < size(), or a reference to CharT() if pos == size().

## Official Specification Summary (cppreference)

```cpp
CharT& operator[]( size_type pos ); // (1) (constexpr since C++20)
const CharT& operator[]( size_type pos ) const; // (2) (constexpr since C++20)
```

Returns a reference to the character at specified location `pos` if `pos < size()`, or a reference to `CharT()` if `pos == size()`. No bounds checking is performed.

If `pos > size()`, the behavior is undefined.

For overload (1), if `pos == size()`, the behavior is undefined if the object referred by the returned reference is modified to any value other than `CharT()` (since C++11).

### Parameters

- `pos` - position of the character to return

### Return value

Reference to the requested element if `pos < size()`, or a reference to `CharT()` if `pos == size()`.

### Complexity

Constant.

### Example

```cpp
#include <iostream>
#include <string>

int main()
{
    const std::string e("Exemplar");
    for (unsigned i = e.length() - 1; i != 0; i /= 2)
        std::cout << e[i];
    std::cout << '\n';

    const char* c = &e[0];
    std::cout << c << '\n'; // print as a C string

    // Change the last character of s into a 'y'
    std::string s("Exemplar ");
    s[s.size() - 1] = 'y'; // equivalent to s.back() = 'y';
    std::cout << s << '\n';
}
```

Output:

```text
rmx
Exemplar
Exemplary
```

### Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

| DR | Applied to | Behavior as published | Correct behavior |
| --- | --- | --- | --- |
| LWG 259 | C++98 | non-const overload could return const lvalue `data()[pos]`, which was ill-formed | changed to return `*(begin() + pos)` |
| LWG 2475 | C++11 | if `pos == size()`, the behavior of modifying the object referred by the returned reference was undefined | well-defined if modified to `CharT()` |

### See also

- [`at`](https://en.cppreference.com/w/cpp/string/basic_string/at): accesses the specified character with bounds checking (public member function)
- [`front`](https://en.cppreference.com/w/cpp/string/basic_string/front) (DR*): accesses the first character (public member function)
- [`back`](https://en.cppreference.com/w/cpp/string/basic_string/back) (DR*): accesses the last character (public member function)
- [`operator[]`](https://en.cppreference.com/w/cpp/string/basic_string_view/operator_at): accesses the specified character (public member function of `std::basic_string_view<CharT,Traits>`)

---
Attribution: content from https://en.cppreference.com/w/cpp/string/basic_string/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.