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

Gibt eine Referenz auf das Zeichen an der angegebenen Position pos zurück. Es wird eine Grenzprüfung durchgeführt, bei ungültigem Zugriff wird eine Ausnahme vom Typ std::out_of_range geworfen.

Parameter

Rückgabewert

Referenz auf das angeforderte Zeichen.

Ausnahmen

Wirft std::out_of_range falls pos >= size ( ) .

Wenn aus irgendeinem Grund eine Exception ausgelöst wird, haben diese Funktionen keine Wirkung ( strong exception safety guarantee ).

Komplexität

Konstante.

Beispiel

#include <iostream>
#include <stdexcept>
#include <string>
int main()
{
    std::string s("message"); // für Kapazität
    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
    {
        // Dies wird eine Exception werfen, da der angeforderte Offset größer als die aktuelle Größe ist.
        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

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch