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

void clear();

如同执行 erase(begin(), end()) 一样，从字符串移除所有字符。

所有指针、引用和迭代器均会失效。

参数

(无)

返回值

(无)

注释

与 std::vector::clear 不同，C++ 标准并未明确要求此函数保持 capacity 不变，但现有实现均未改变容量。这意味着它们不会释放已分配的内存（另请参阅 shrink_to_fit ）。

复杂度

线性于字符串的大小，尽管现有实现以恒定时间运行。

示例

#include <cassert>
#include <iostream>
#include <string>
int main()
{
    std::string s{"Exemplar"};
    std::string::size_type const capacity = s.capacity();
    s.clear();
    assert(s.empty());
    assert(s.size() == 0);
    std::cout << std::boolalpha << (s.capacity() == capacity) << '\n';
}

true

参见