std::basic_string::clear

From cppreference.com
< cpp‎ | string‎ | basic string
 
 
 
std::basic_string
 
void clear();

Removes all characters from the string. The allocated memory will not be released, effectively leaving the capacity of the string unchanged. The past-the-end iterators are not invalidated.

Contents

[edit] Parameters

(none)

[edit] Return value

(none)

[edit] Exceptions

(none) (until C++11)
noexcept specification:  
noexcept
  
(since C++11)

[edit] Complexity

Linear in the size of the string.

[edit] Example

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


[edit] See also

removes characters
(public member function)