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

FreeBSD Manual Pages

  
 
  

home | help
std::list::push_front(3)      C++ Standard Libary     std::list::push_front(3)

NAME
       std::list::push_front - std::list::push_front

Synopsis
	  void push_front( const T& value ); (1)
	  void push_front( T&& value );	     (2) (since	C++11)

	  Prepends the given element value to the beginning of the container.

	  No iterators or references are invalidated.

Parameters
	  value	- the value of the element to prepend

Return value
	  (none)

Complexity
	  Constant.

Exceptions
	  If  an  exception  is	thrown for any reason, these functions have no
       effect (strong
	  exception safety guarantee).

Example
       // Run this code

	#include <list>
	#include <iomanip>
	#include <iostream>
	#include <string>

	int main()
	{
	    std::list<std::string> letters;

	    letters.push_front("abc");
	    std::string	s{"def"};
	    letters.push_front(std::move(s));

	    std::cout << "std::list letters holds: ";
	    for	(auto&&	e : letters)
		std::cout << std::quoted(e) << ' ';

	    std::cout << "\nMoved-from string s	holds: " << std::quoted(s)  <<
       '\n';
	}

Possible output:
	std::list letters holds: "def" "abc"
	Moved-from string s holds: ""

See also
	  emplace_front	 constructs an element in-place	at the beginning
	  (C++11)	 (public member	function)
	  push_back	 adds an element to the	end
			 (public member	function)
	  pop_front	 removes the first element
			 (public member	function)
			 creates a std::front_insert_iterator of type inferred
       from the
	  front_inserter argument
			 (function template)

http://cppreference.com		  2024.06.10	      std::list::push_front(3)

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

home | help