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

CharT& operator[]( size_type pos );	(1)	(constexpr с C++20)
const CharT& operator[]( size_type pos ) const;	(2)	(constexpr с C++20)

Возвращает ссылку на символ в указанной позиции pos, если pos < size(), или если pos == size():

Поведение не определено.	(до C++11)
Возвращает ссылку на `CharT()`; если объект, на который ссылается возвращённая ссылка, изменён на любое значение, отличное от `CharT()`, поведение не определено.	(начиная с C++11)

2) Возвращает ссылку на CharT().

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

(до C++26)

Если pos > size() равно true:

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

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

Параметры

pos

позиция возвращаемого символа

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

1) *(begin() + pos), если pos < size(), или ссылка на CharT(), если pos == size()(начиная с C++11).

2) *(begin() + pos), если pos < size(), или ссылка на CharT(), если pos == size().

Сложность

Константная.

Пример

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

Вывод:

rmx
Exemplar
Exemplary

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.

DR	Применялся к	Опубликованное поведение	Правильное поведение
LWG 259	C++98	перегрузка (1) могла возвращать константное lvalue `data()[pos]`, что приводило к ошибке компиляции	изменено на возврат `*(begin() + pos)`
LWG 2475	C++11	если `pos == size()`, поведение при изменении объекта, на который ссылалась возвращённая ссылка, было не определено	определено, если изменён на `CharT()`

См. также

at	обращается к указанному символу с проверкой границ (открытая функция-член)
front (DR*)	обращается к первому символу (открытая функция-член)
back (DR*)	обращается к последнему символу (открытая функция-член)
operator[]	обращается к указанному символу (открытая функция-член `std::basic_string_view<CharT,Traits>`)

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