名前空間
変種

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

    提供: cppreference.com
     
    C++
     
    文字列ライブラリ
     
    std::basic_string
     
    <tbody> </tbody> <tbody class="t-dcl-rev "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev "> </tbody><tbody> </tbody>
    reference at( size_type pos );
    		 (C++20未満)
    constexpr reference at( size_type pos );
    		 (C++20以上)
    const_reference at( size_type pos ) const;
    		 (C++20未満)
    constexpr const_reference at( size_type pos ) const;
    		 (C++20以上)
    See More

    指定された位置 pos の文字を指す参照を返します。 範囲チェックが行われ、無効なアクセスの場合 std::out_of_range 型の例外が投げられます。

    引数

    pos - 返す文字の位置

    戻り値

    要求された文字を指す参照。

    例外

    pos >= size() の場合 std::out_of_range を投げます。

    計算量

    一定。

    例

    Run this code
    #include <stdexcept>
#include <iostream>
#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 {
        // throw, even if capacity allowed to access element
        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

    関連項目

    		 指定された文字にアクセスします
    (パブリックメンバ関数) [edit]