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 con-
     tained 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		 Correct
     behavior
	LWG 2231 C++11	    complexity guarantee was  mistakenly      complexity
     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)
home | help