std::basic_string<CharT,Traits,Allocator>::at

reference at( size_type pos );

constexpr reference at( size_type pos );

const_reference at( size_type pos ) const;

constexpr const_reference at( size_type pos ) const;

Возвращает ссылку на символ в указанном месте pos. Проверка границ выполняется, исключение типа std::out_of_range будет выброшено при недопустимом доступе.

Параметры

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

Ссылка на запрашиваемый символ.

Исключения

Выбрасывает std::out_of_range если pos >= size().

Если исключение будет выброшено по какой-либо причине, эти функции не оказывают никакого эффекта (гарантия сильной безопасности исключений).

Сложность

Постоянная.

Пример

#include <iostream>
#include <stdexcept>
#include <string>
 
int main()
{
    std::string s("message"); // for capacity
 
    s = "abc";
    s.at(2) = 'x'; // OK
    std::cout << s << '\n';
 
    std::cout << "string size = " << s.size() << '\n';
    std::cout << "string capacity = " << s.capacity() << '\n';
 
    try
    {
        // This will throw since the requested offset is greater than the current size.
        s.at(3) = 'x';
    }
    catch (std::out_of_range const& exc)
    {
        std::cout << exc.what() << '\n';
    }
}

abx
string size = 3
string capacity = 7
basic_string::at

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

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

См. также