Returns a reference to the character at specified locationpos. Bounds checking is performed, exception of typestd::out_of_range will be thrown on invalid access.

[edit]Parameters

[edit]Return value

Reference to the requested character.

[edit]Exceptions

Throwsstd::out_of_range ifpos>= size().

If an exception is thrown for any reason, these functions have no effect (strong exception safety guarantee).

[edit]Complexity

Constant.

[edit]Example

#include <iostream>#include <stdexcept>#include <string> int main(){std::string s("message");// for capacity     s="abc";    s.at(2)='x';// OKstd::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_rangeconst& exc){std::cout<< exc.what()<<'\n';}}

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

[edit]Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

[edit]See also

• In other languages

• Deutsch
• Español
• Français
• Italiano
• 日本語
• Polski
• Português
• Русский
• 中文