std::basic_string<CharT,Traits,Allocator>::operator[]
| (1) | ||
reference operator[]( size_type pos ); |
(до C++20) | |
constexpr reference operator[]( size_type pos ); |
(с C++20) | |
| (2) | ||
const_reference operator[]( size_type pos ) const; |
(до C++20) | |
constexpr const_reference operator[]( size_type pos ) const; |
(с C++20) |
Возвращает ссылку на символ в указанном месте pos если pos < size(), или ссылку на CharT() если pos == size(). Проверка границ не выполняется.
Если pos > size(), поведение не определено.
Для перегрузки (1), если pos == size(), поведение не определено если объект, на который ссылается возвращённая ссылка, модифицируется на любое значение, отличное от CharT()(с C++11).
Параметры
| pos | - | позиция возвращаемого символа |
Значение результата
*(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 |
data()[pos] было возвращено, если pos < size(),(его тип const CharT&, что конфликтует с reference) |
изменено на*(begin() + pos) |
| LWG 2475 | C++11 | если pos == size(), поведение модификацииобъекта, на который ссылается возвращённая ссылка, было неопределённым |
определено, если изменено на CharT() |
См. также
| доступ к указанному символу с проверкой границ (public member function) |
|
|
(DR*)
|
доступ к первому символу (public member function) |
|
(DR*)
|
доступ к последнему символу (public member function) |
| доступ к указанному символу (public member function of std::basic_string_view<CharT,Traits>) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/basic_string/operator_at