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

Removes the last character from the string.

Equivalent to erase ( end ( ) - 1 ) . The behavior is undefined if the string is empty.

Parameters

(none)

Return value

(none)

Complexity

Constant.

Exceptions

Throws nothing.

Notes

In libstdc++, pop_back() is not available in C++98 mode.

Example

#include <cassert>
#include <iomanip>
#include <iostream>
#include <string>
 
int main()
{
    std::string str("Short string!");
    std::cout << "Before: " << std::quoted(str) << '\n';
    assert(str.size() == 13);
 
    str.pop_back();
    std::cout << "After:  " << std::quoted(str) << '\n';
    assert(str.size() == 12);
 
    str.clear();
//  str.pop_back(); // undefined behavior
}

Before: "Short string!"
After:  "Short string"

Defect reports

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

See also