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

CharT& at( size_type pos );

const CharT& at( size_type pos ) const;

指定された位置 pos の文字への参照を返します。境界チェックが行われ、無効なアクセスがあった場合は std::out_of_range 型の例外がスローされます。

パラメータ

戻り値

要求された文字への参照。

例外

std::out_of_range をスローする（ pos >= size ( ) の場合）。

何らかの理由で例外がスローされた場合、これらの関数は何も効果を持ちません（ strong exception safety guarantee ）。

計算量

定数。

例

#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++規格に対して遡及的に適用されました。

関連項目