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

void clear();

void clear() noexcept;

constexpr void clear() noexcept;

Удаляет все символы из строки, как если бы выполнено erase(begin(), end()).

Все указатели, ссылки и итераторы становятся недействительными.

Параметры

(нет)

Возвращаемое значение

(нет)

Примечания

В отличие от std::vector::clear, стандарт C++ не требует явно, чтобы capacity оставалось неизменным после вызова этой функции, но существующие реализации не изменяют ёмкость. Это означает, что они не освобождают выделенную память (см. также shrink_to_fit).

Сложность

Линейная относительно размера строки, хотя существующие реализации работают за постоянное время.

Пример

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

См. также