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

void clear();

Удаляет все символы из строки, как если бы выполнялся вызов 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

См. также