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

FreeBSD Manual Pages

  
 
  

home | help
std::deque::pop_front(3)      C++ Standard Libary     std::deque::pop_front(3)

NAME
       std::deque::pop_front - std::deque::pop_front

Synopsis
	  void pop_front();

	  Removes the first element of the container. If there are no elements
       in the
	  container, the behavior is undefined.

	  Iterators  and  references to	the erased element are invalidated. It
       is
	  unspecified whether the past-the-end iterator	is invalidated if  the
       (until C++11)
	  element is the last element in the container.	Other references and
	  iterators are	not affected.
	  Iterators  and  references to	the erased element are invalidated. If
       the
	  element is the last  element	in  the	 container,  the  past-the-end
       (since C++11)
	  iterator is also invalidated.	Other references and iterators are not
	  affected.

Parameters
	  (none)

Return value
	  (none)

Complexity
	  Constant.

Exceptions
	  Does not throw.

Example
       // Run this code

	#include <deque>
	#include <iostream>

	int main()
	{
	    std::deque<char> chars{'A',	'B', 'C', 'D'};

	    for	(; !chars.empty(); chars.pop_front())
	    {
		std::cout << "chars.front(): '"	<< chars.front() << "'\n";
	    }
	}

Output:
	chars.front(): 'A'
	chars.front(): 'B'
	chars.front(): 'C'
	chars.front(): 'D'

See also
	  pop_back   removes the last element
		     (public member function)
	  push_front inserts an	element	to the beginning
		     (public member function)
	  front	     access the	first element
		     (public member function)

http://cppreference.com		  2022.07.31	      std::deque::pop_front(3)

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

home | help