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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::front_inserter - std::front_inserter

Synopsis
	  Defined in header <iterator>
	  template<		  class		      Container		     >
       (constexpr since
	  std::front_insert_iterator<Container>	front_inserter(	 Container&  c
       C++20)
	  );

	  front_inserter is a convenience function template that constructs a
	  std::front_insert_iterator for the container c with the type deduced
       from the	type
	  of the argument.

Parameters
	  c - container	that supports a	push_front operation

Return value
	  A  std::front_insert_iterator	 which	can be used to add elements to
       the beginning of
	  the container	c.

Possible implementation
	  template<class Container>
	  std::front_insert_iterator<Container>	front_inserter(	Container& c )
	  {
	      return std::front_insert_iterator<Container>(c);
	  }

Example
       // Run this code

	#include <algorithm>
	#include <deque>
	#include <iostream>
	#include <iterator>
	#include <vector>

	int main()
	{
	    std::vector<int> v{1, 2, 3,	4, 5};
	    std::deque<int> d;
	    std::copy(v.begin(), v.end(), std::front_inserter(d));
	    for	(int n : d)
		std::cout << n << ' ';
	    std::cout << '\n';
	}

Output:
	5 4 3 2	1

See also
	  front_insert_iterator	iterator adaptor for insertion at the front of
       a container
				(class template)
				creates	a  std::back_insert_iterator  of  type
       inferred	from the
	  back_inserter		argument
				(function template)
				creates	 a  std::insert_iterator  of  type in-
       ferred from the
	  inserter		argument
				(function template)

http://cppreference.com		  2024.06.10		std::front_inserter(3)

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

home | help