“cpp/string/basic string/clear”的版本间的差异

来自cppreference.com
< cpp‎ | string‎ | basic string
小
小
 
第1行： 第1行：
 
{{cpp/string/basic_string/title|clear}}
 
{{cpp/string/basic_string/title|clear}}
 
{{cpp/string/basic_string/navbar}}
 
{{cpp/string/basic_string/navbar}}
−
{{ddcl|notes={{mark noexcept since c++11}}<br>{{mark constexpr since c++20}}|1=
+
{{|noexceptc++11constexprc++20|
 
void clear();
 
void clear();
 
}}
 
}}
第25行： 第25行：
 
|code=
 
|code=
 
#include <cassert>
 
#include <cassert>
 +
 
#include <string>
 
#include <string>
  
第33行： 第34行：
  
 
     s.clear();
 
     s.clear();
−
    assert(s.capacity() == capacity); // <- 不保证
 
 
     assert(s.empty());
 
     assert(s.empty());
 
     assert(s.size() == 0);
 
     assert(s.size() == 0);
 +
 
}
 
}
 +
 
|output=
 
|output=
 +
 
}}
 
}}
  

2024年10月21日 (一) 04:00的最后版本

 
C++
 
字符串库
 
std::basic_string
 
void clear();
 (C++11 起为 noexcept)
(C++20 起为 constexpr)

如同通过执行 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

[编辑] 参阅

 移除字符
(公开成员函数) [编辑]
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/string/basic_string/clear&oldid=95170”