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

NAME
     std::list::insert_range - std::list::insert_range

Synopsis
	template< container-compatible-range<T> R >	      (since C++23)
	iterator insert_range( const_iterator pos, R&& rg );

	Inserts, in non-reversing order, copies of elements in rg before pos.

	No iterators or references are invalidated.

	Each iterator in the range rg is dereferenced exactly once.

	The behavior is undefined if rg overlaps with the container.

Parameters
	pos   -   iterator before which the content will be inserted (pos may be
     the end()
		iterator)
	rg   -	a container compatible range, that is, an input_range whose ele-
     ments are
		convertible to T

Type requirements
	-
	T must be EmplaceConstructible into list from *ranges::begin(rg). Other-
     wise, the
	behavior is undefined.

Return value
	An iterator that points at the copy of the first element  inserted  into
     list or at
	pos if rg is empty.

Notes
	    Feature-test macro	     Value    Std		    Feature
	__cpp_lib_containers_ranges  202202L  (C++23)  Ranges-aware construction
     and insertion

Example
     // Run this code

      #include <algorithm>
      #include <cassert>
      #include <iterator>
      #include <list>
      #include <vector>

      int main()
      {
	  auto container = std::list{1, 2, 3, 4};
	  auto pos = std::next(container.begin(), 2);
	  assert(*pos == 3);
	  const auto rg = std::vector{-1, -2, -3};

      #ifdef __cpp_lib_containers_ranges
	  container.insert_range(pos, rg);
      #else
	  container.insert(pos, rg.cbegin(), rg.cend());
      #endif
	  assert(std::ranges::equal(container, std::list{1, 2, -1,  -2,  -3,  3,
     4}));
      }

See also
	insert	      inserts elements
		      (public member function)
	prepend_range adds a range of elements to the beginning
	(C++23)       (public member function)
	append_range  adds a range of elements to the end
	(C++23)       (public member function)

http://cppreference.com 	   2024.06.10	      std::list::insert_range(3)
home | help