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

> C++ Atlas: `cppatlas.com/w/cpp/string/basic_string/clear` | Source: https://en.cppreference.com/w/cpp/string/basic_string/clear | Domain: Strings | Standards: C++11, C++20

Removes all characters from the string as if by executing erase(begin(), end()).

## Official Specification Summary (cppreference)

```cpp
void clear(); // (noexcept since C++11) (constexpr since C++20)
```

Removes all characters from the string as if by executing `erase(begin(), end())`.

All pointers, references, and iterators are invalidated.

### Parameters

(none)

### Return value

(none)

### Notes

Unlike for `std::vector::clear`, the C++ standard does not explicitly require that `capacity` is unchanged by this function, but existing implementations do not change capacity. This means that they do not release the allocated memory (see also `shrink_to_fit`).

### Complexity

Linear in the size of the string, although existing implementations operate in constant time.

### Example

```cpp
#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';
}
```

Possible output:

```text
true
```

### See also

- [`erase`](https://en.cppreference.com/w/cpp/string/basic_string/erase): removes characters (public member function)

---
Attribution: content from https://en.cppreference.com/w/cpp/string/basic_string/clear (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.