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

来自cppreference.com
< cpp‎ | string‎ | basic string
小
小
 
（未显示1个用户的1个中间版本）
第1行： 第1行：
 
{{cpp/string/basic_string/title|clear}}
 
{{cpp/string/basic_string/title|clear}}
 
{{cpp/string/basic_string/navbar}}
 
{{cpp/string/basic_string/navbar}}
−
{{dcl begin}}
+
{{|=c++11|=
−
{{dcl rev multi|until1=c++11|dcl1=
+
 
void clear();
 
void clear();
−
|until2=c++20|dcl2=
 
−
void clear() noexcept;
 
−
|dcl3=
 
−
constexpr void clear() noexcept;
 
 
}}
 
}}
−
{{dcl end}}
 
  
 
 如同通过执行 {{c|erase(begin(), end())}} 从字符串中移除所有字符。
 
 如同通过执行 {{c|erase(begin(), end())}} 从字符串中移除所有字符。
第31行： 第25行：
 
|code=
 
|code=
 
#include <cassert>
 
#include <cassert>
 +
 
#include <string>
 
#include <string>
  
第39行： 第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”