Spec-Zone.ru › C++

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()

См. также

at
доступ к указанному символу с проверкой границ
(public member function)
front
(DR*)
доступ к первому символу
(public member function)
back
(DR*)
доступ к последнему символу
(public member function)
operator[]
доступ к указанному символу
(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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API