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

来自cppreference.com
< cpp‎ | string‎ | basic string
 
 
 
std::basic_string
成员函数
元素访问
迭代器
容量
操作
basic_string::clear
搜索
常量
推导指引 (C++17)
非成员函数
I/O
比较
(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20)
数值转换
(C++11)(C++11)(C++11)
(C++11)(C++11)    
(C++11)(C++11)(C++11)
(C++11)
(C++11)
辅助类
 
void clear();
(C++11 前)
void clear() noexcept;
(C++11 起)
(C++20 前)
constexpr void clear() noexcept;
(C++20 起)

如同通过执行 erase(begin(), end()) 从 string 移除所有字符。

非法化所有指针、引用及迭代器。

参数

(无)

返回值

(无)

注解

不同于 std::vector::clear , C++ 标准不显式要求此函数不更改 capacity ,但既存实现都不更改容量。这意味着它们不释放分配的内存(参阅 shrink_to_fit )。

复杂度

与 string 大小成线性,尽管既存实现在常数时间内操作。

示例

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

参阅

移除字符
(公开成员函数)