Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
std::forward_list::clear(3)   C++ Standard Libary  std::forward_list::clear(3)

NAME
       std::forward_list::clear	- std::forward_list::clear

Synopsis
	  void clear() noexcept;  (since C++11)

	  Erases all elements from the container.

	  Invalidates  any  references,	 pointers,  and	iterators referring to
       contained elements.
	  Any past-the-end iterator remains valid.

Parameters
	  (none)

Return value
	  (none)

Complexity
	  Linear in the	size of	the container, i.e., the number	of elements.

Example
       // Run this code

	#include <iostream>
	#include <string_view>
	#include <forward_list>

	void print_info(std::string_view rem, const std::forward_list<int>& v)
	{
	    std::cout << rem <<	"{ ";
	    for	(const auto& value : v)
		std::cout << value << '	';
	    std::cout << "}\n";
	}

	int main()
	{
	    std::forward_list<int> container{1,	2, 3};
	    print_info("Before clear: ", container);
	    container.clear();
	    print_info("After clear: ",	container);
	}

Output:
	Before clear: {	1 2 3 }
	After clear: { }

	 Defect	reports

	  The following	behavior-changing defect reports were applied retroac-
       tively to
	  previously published C++ standards.

	     DR	   Applied to	       Behavior	as published		  Cor-
       rect behavior
	  LWG 2231 C++11      complexity guarantee was mistakenly     complex-
       ity reaffirmed as
			      omitted in C++11			      linear

See also
	  erase_after erases an	element	after an element
		      (public member function)

http://cppreference.com		  2024.06.10	   std::forward_list::clear(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::forward_list::clear&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help