Collaboration diagram for Iterators:

Modules
	Iterator Tags

Classes
class	std::back_insert_iterator< _Container >

class	std::front_insert_iterator< _Container >

struct	std::input_iterator_tag

class	std::insert_iterator< _Container >

class	std::istream_iterator< _Tp, _CharT, _Traits, _Dist >

class	std::istreambuf_iterator< _CharT, _Traits >

struct	std::iterator< _Category, _Tp, _Distance, _Pointer, _Reference >

struct	std::iterator_traits< _Iterator >

struct	std::iterator_traits< _Tp * >

class	std::ostream_iterator< _Tp, _CharT, _Traits >

class	std::ostreambuf_iterator< _CharT, _Traits >

class	std::reverse_iterator< _Iterator >

Macros
#define	_GLIBCXX_MAKE_MOVE_IF_NOEXCEPT_ITERATOR(_Iter)

#define	_GLIBCXX_MAKE_MOVE_ITERATOR(_Iter)

Functions
template<bool _IsMove, typename _CharT >
__gnu_cxx::__enable_if< __is_char< _CharT >::__value, ostreambuf_iterator< _CharT > >::__type	std::__copy_move_a2 (_CharT __first, _CharT __last, ostreambuf_iterator< _CharT > __result)

template<bool _IsMove, typename _CharT >
__gnu_cxx::__enable_if< __is_char< _CharT >::__value, ostreambuf_iterator< _CharT > >::__type	std::__copy_move_a2 (const _CharT __first, const _CharT __last, ostreambuf_iterator< _CharT > __result)

template<bool _IsMove, typename _CharT >
__gnu_cxx::__enable_if< __is_char< _CharT >::__value, _CharT * >::__type	std::__copy_move_a2 (istreambuf_iterator< _CharT > __first, istreambuf_iterator< _CharT > __last, _CharT *__result)

template<typename _CharT , typename _Size >
__gnu_cxx::__enable_if< __is_char< _CharT >::__value, _CharT * >::__type	std::__copy_n_a (istreambuf_iterator< _CharT > __it, _Size __n, _CharT *__result, bool __strict)

template<typename _Iter >
constexpr iterator_traits< _Iter >::iterator_category	std::__iterator_category (const _Iter &)

template<typename _Iterator >
constexpr reverse_iterator< _Iterator >	std::__make_reverse_iterator (_Iterator __i)

template<typename _CharT , typename _Distance >
__gnu_cxx::__enable_if< __is_char< _CharT >::__value, void >::__type	std::advance (istreambuf_iterator< _CharT > &__i, _Distance __n)

template<typename _Container >
constexpr back_insert_iterator< _Container >	std::back_inserter (_Container &__x)

template<typename _CharT >
__gnu_cxx::__enable_if< __is_char< _CharT >::__value, ostreambuf_iterator< _CharT > >::__type	std::copy (istreambuf_iterator< _CharT > __first, istreambuf_iterator< _CharT > __last, ostreambuf_iterator< _CharT > __result)

template<typename _CharT >
__gnu_cxx::__enable_if< __is_char< _CharT >::__value, istreambuf_iterator< _CharT > >::__type	std::find (istreambuf_iterator< _CharT > __first, istreambuf_iterator< _CharT > __last, const _CharT &__val)

template<typename _Container >
constexpr front_insert_iterator< _Container >	std::front_inserter (_Container &__x)

template<typename _Container >
constexpr insert_iterator< _Container >	std::inserter (_Container &__x, std::__detail::__range_iter_t< _Container > __i)

template<typename _Iterator >
constexpr reverse_iterator< _Iterator >	std::make_reverse_iterator (_Iterator __i)

template<typename _IteratorL , typename _IteratorR > requires requires { { __x.base() != __y.base() } -> convertible_to<bool>; }
constexpr bool	std::operator!= (const reverse_iterator< _IteratorL > &__x, const reverse_iterator< _IteratorR > &__y)

template<typename _Iterator >
constexpr reverse_iterator< _Iterator >	std::operator+ (typename reverse_iterator< _Iterator >::difference_type __n, const reverse_iterator< _Iterator > &__x)

template<typename _IteratorL , typename _IteratorR >
constexpr auto	std::operator- (const reverse_iterator< _IteratorL > &__x, const reverse_iterator< _IteratorR > &__y) -> decltype(__y.base() - __x.base())

template<typename _IteratorL , typename _IteratorR > requires requires { { __x.base() > __y.base() } -> convertible_to<bool>; }
constexpr bool	std::operator< (const reverse_iterator< _IteratorL > &__x, const reverse_iterator< _IteratorR > &__y)

template<typename _IteratorL , typename _IteratorR > requires requires { { __x.base() >= __y.base() } -> convertible_to<bool>; }
constexpr bool	std::operator<= (const reverse_iterator< _IteratorL > &__x, const reverse_iterator< _IteratorR > &__y)

template<three_way_comparable _Iterator>
constexpr compare_three_way_result_t< _Iterator, _Iterator >	std::operator<=> (const reverse_iterator< _Iterator > &__x, const reverse_iterator< _Iterator > &__y)

template<typename _IteratorL , three_way_comparable_with< _IteratorL > _IteratorR>
constexpr compare_three_way_result_t< _IteratorL, _IteratorR >	std::operator<=> (const reverse_iterator< _IteratorL > &__x, const reverse_iterator< _IteratorR > &__y)

template<typename _CharT , typename _Traits >
bool	std::operator== (const istreambuf_iterator< _CharT, _Traits > &__a, const istreambuf_iterator< _CharT, _Traits > &__b)

template<typename _Iterator > requires requires { { __x.base() == __y.base() } -> convertible_to<bool>; }
constexpr bool	std::operator== (const reverse_iterator< _Iterator > &__x, const reverse_iterator< _Iterator > &__y)

template<typename _IteratorL , typename _IteratorR > requires requires { { __x.base() == __y.base() } -> convertible_to<bool>; }
constexpr bool	std::operator== (const reverse_iterator< _IteratorL > &__x, const reverse_iterator< _IteratorR > &__y)

template<typename _IteratorL , typename _IteratorR > requires requires { { __x.base() < __y.base() } -> convertible_to<bool>; }
constexpr bool	std::operator> (const reverse_iterator< _IteratorL > &__x, const reverse_iterator< _IteratorR > &__y)

template<typename _IteratorL , typename _IteratorR > requires requires { { __x.base() <= __y.base() } -> convertible_to<bool>; }
constexpr bool	std::operator>= (const reverse_iterator< _IteratorL > &__x, const reverse_iterator< _IteratorR > &__y)

Variables
template<typename _Iterator1 , typename _Iterator2 >
constexpr bool	std::disable_sized_sentinel_for< reverse_iterator< _Iterator1 >, reverse_iterator< _Iterator2 > >

Detailed Description

Abstractions for uniform iterating through various underlying types.

Macro Definition Documentation

◆ _GLIBCXX_MAKE_MOVE_IF_NOEXCEPT_ITERATOR

#define _GLIBCXX_MAKE_MOVE_IF_NOEXCEPT_ITERATOR ( _Iter )

Definition at line 1846 of file bits/stl_iterator.h.

◆ _GLIBCXX_MAKE_MOVE_ITERATOR

#define _GLIBCXX_MAKE_MOVE_ITERATOR ( _Iter )

Definition at line 1845 of file bits/stl_iterator.h.

Function Documentation

◆ __copy_move_a2() [1/3]

template<bool _IsMove, typename _CharT >

__gnu_cxx::__enable_if< __is_char< _CharT >::__value, ostreambuf_iterator< _CharT > >::__type std::__copy_move_a2	(	_CharT *	__first,
		_CharT *	__last,
		ostreambuf_iterator< _CharT >	__result
	)

Definition at line 358 of file streambuf_iterator.h.

◆ __copy_move_a2() [2/3]

template<bool _IsMove, typename _CharT >

__gnu_cxx::__enable_if< __is_char< _CharT >::__value, ostreambuf_iterator< _CharT > >::__type std::__copy_move_a2	(	const _CharT *	__first,
		const _CharT *	__last,
		ostreambuf_iterator< _CharT >	__result
	)

Definition at line 370 of file streambuf_iterator.h.

◆ __copy_move_a2() [3/3]

template<bool _IsMove, typename _CharT >

__gnu_cxx::__enable_if< __is_char< _CharT >::__value, _CharT * >::__type std::__copy_move_a2	(	istreambuf_iterator< _CharT >	__first,
		istreambuf_iterator< _CharT >	__last,
		_CharT *	__result
	)

Definition at line 382 of file streambuf_iterator.h.

◆ __copy_n_a()

template<typename _CharT , typename _Size >

__gnu_cxx::__enable_if< __is_char< _CharT >::__value, _CharT * >::__type std::__copy_n_a	(	istreambuf_iterator< _CharT >	__it,
		_Size	__n,
		_CharT *	__result,
		bool	__strict
	)

Definition at line 417 of file streambuf_iterator.h.

◆ __iterator_category()

template<typename _Iter >

constexpr iterator_traits< _Iter >::iterator_category std::__iterator_category ( const _Iter & )

inlineconstexpr

This function is not a part of the C++ standard but is syntactic sugar for internal library use only.

Definition at line 241 of file stl_iterator_base_types.h.

Referenced by std::deque< _Tp, _Alloc >::deque(), std::vector< _Tp, _Alloc >::vector(), std::advance(), std::deque< _Tp, _Alloc >::assign(), std::vector< _Tp, _Alloc >::assign(), __gnu_cxx::copy_n(), std::distance(), __gnu_cxx::distance(), std::fill_n(), std::deque< _Tp, _Alloc >::insert(), std::vector< _Tp, _Alloc >::insert(), std::partition(), std::reverse(), std::rotate(), and __gnu_cxx::uninitialized_copy_n().

◆ __make_reverse_iterator()

template<typename _Iterator >

constexpr reverse_iterator< _Iterator > std::__make_reverse_iterator ( _Iterator __i )

inlineconstexpr

Definition at line 637 of file bits/stl_iterator.h.

◆ advance()

template<typename _CharT , typename _Distance >

__gnu_cxx::__enable_if< __is_char< _CharT >::__value, void >::__type std::advance	(	istreambuf_iterator< _CharT > &	__i,
		_Distance	__n
	)

Definition at line 477 of file streambuf_iterator.h.

◆ back_inserter()

template<typename _Container >

constexpr back_insert_iterator< _Container > std::back_inserter ( _Container & __x )

inlineconstexpr

Parameters

__x	A container of arbitrary type.

Returns: An instance of back_insert_iterator working on __x.

This wrapper function helps in creating back_insert_iterator instances. Typing the name of the iterator requires knowing the precise full type of the container, which can be tedious and impedes generic programming. Using this function lets you take advantage of automatic template parameter deduction, making the compiler match the correct types for you.

Definition at line 764 of file bits/stl_iterator.h.

Referenced by std::match_results< _Bi_iter, _Alloc >::format(), std::match_results< _Bi_iter, _Alloc >::format(), std::regex_replace(), std::regex_replace(), std::regex_replace(), and std::regex_replace().

◆ copy()

template<typename _CharT >

__gnu_cxx::__enable_if< __is_char< _CharT >::__value, ostreambuf_iterator< _CharT > >::__type std::copy	(	istreambuf_iterator< _CharT >	__first,
		istreambuf_iterator< _CharT >	__last,
		ostreambuf_iterator< _CharT >	__result
	)

Definition at line 341 of file streambuf_iterator.h.

◆ find()

template<typename _CharT >

__gnu_cxx::__enable_if< __is_char< _CharT >::__value, istreambuf_iterator< _CharT > >::__type std::find	(	istreambuf_iterator< _CharT >	__first,
		istreambuf_iterator< _CharT >	__last,
		const _CharT &	__val
	)

Definition at line 437 of file streambuf_iterator.h.

◆ front_inserter()

template<typename _Container >

constexpr front_insert_iterator< _Container > std::front_inserter ( _Container & __x )

inlineconstexpr

Parameters

__x	A container of arbitrary type.

Returns: An instance of front_insert_iterator working on x.

This wrapper function helps in creating front_insert_iterator instances. Typing the name of the iterator requires knowing the precise full type of the container, which can be tedious and impedes generic programming. Using this function lets you take advantage of automatic template parameter deduction, making the compiler match the correct types for you.

Definition at line 865 of file bits/stl_iterator.h.

◆ inserter()

template<typename _Container >

constexpr insert_iterator< _Container > std::inserter	(	_Container &	__x,
		std::__detail::__range_iter_t< _Container >	__i
	)

constexpr

Parameters

__x	A container of arbitrary type.
__i	An iterator into the container.

Returns: An instance of insert_iterator working on __x.

This wrapper function helps in creating insert_iterator instances. Typing the name of the iterator requires knowing the precise full type of the container, which can be tedious and impedes generic programming. Using this function lets you take advantage of automatic template parameter deduction, making the compiler match the correct types for you.

Definition at line 999 of file bits/stl_iterator.h.

◆ make_reverse_iterator()

template<typename _Iterator >

constexpr reverse_iterator< _Iterator > std::make_reverse_iterator ( _Iterator __i )

inlineconstexpr

Generator function for reverse_iterator.

Definition at line 647 of file bits/stl_iterator.h.

◆ operator!=()

template<typename _IteratorL , typename _IteratorR >
requires requires { { __x.base() != __y.base() } -> convertible_to<bool>; }

constexpr bool std::operator!=	(	const reverse_iterator< _IteratorL > &	__x,
		const reverse_iterator< _IteratorR > &	__y
	)

constexpr

Definition at line 537 of file bits/stl_iterator.h.

◆ operator+()

template<typename _Iterator >

constexpr reverse_iterator< _Iterator > std::operator+	(	typename reverse_iterator< _Iterator >::difference_type	__n,
		const reverse_iterator< _Iterator > &	__x
	)

inlineconstexpr

Definition at line 629 of file bits/stl_iterator.h.

◆ operator-()

template<typename _IteratorL , typename _IteratorR >

constexpr auto std::operator-	(	const reverse_iterator< _IteratorL > &	__x,
		const reverse_iterator< _IteratorR > &	__y
	)		-> decltype(__y.base() - __x.base())

inlineconstexpr

Definition at line 620 of file bits/stl_iterator.h.

◆ operator<()

template<typename _IteratorL , typename _IteratorR >
requires requires { { __x.base() > __y.base() } -> convertible_to<bool>; }

constexpr bool std::operator<	(	const reverse_iterator< _IteratorL > &	__x,
		const reverse_iterator< _IteratorR > &	__y
	)

constexpr

Definition at line 544 of file bits/stl_iterator.h.

◆ operator<=()

template<typename _IteratorL , typename _IteratorR >
requires requires { { __x.base() >= __y.base() } -> convertible_to<bool>; }

constexpr bool std::operator<=	(	const reverse_iterator< _IteratorL > &	__x,
		const reverse_iterator< _IteratorR > &	__y
	)

constexpr

Definition at line 560 of file bits/stl_iterator.h.

◆ operator<=>() [1/2]

template<three_way_comparable _Iterator>

constexpr compare_three_way_result_t< _Iterator, _Iterator > std::operator<=>	(	const reverse_iterator< _Iterator > &	__x,
		const reverse_iterator< _Iterator > &	__y
	)

constexpr

Definition at line 595 of file bits/stl_iterator.h.

◆ operator<=>() [2/2]

template<typename _IteratorL , three_way_comparable_with< _IteratorL > _IteratorR>

constexpr compare_three_way_result_t< _IteratorL, _IteratorR > std::operator<=>	(	const reverse_iterator< _IteratorL > &	__x,
		const reverse_iterator< _IteratorR > &	__y
	)

constexpr

Definition at line 577 of file bits/stl_iterator.h.

◆ operator==() [1/3]

template<typename _CharT , typename _Traits >

bool std::operator==	(	const istreambuf_iterator< _CharT, _Traits > &	__a,
		const istreambuf_iterator< _CharT, _Traits > &	__b
	)

inline

Definition at line 236 of file streambuf_iterator.h.

◆ operator==() [2/3]

template<typename _Iterator >
requires requires { { __x.base() == __y.base() } -> convertible_to<bool>; }

constexpr bool std::operator==	(	const reverse_iterator< _Iterator > &	__x,
		const reverse_iterator< _Iterator > &	__y
	)

constexpr

Definition at line 588 of file bits/stl_iterator.h.

◆ operator==() [3/3]

template<typename _IteratorL , typename _IteratorR >
requires requires { { __x.base() == __y.base() } -> convertible_to<bool>; }

constexpr bool std::operator==	(	const reverse_iterator< _IteratorL > &	__x,
		const reverse_iterator< _IteratorR > &	__y
	)

constexpr

Parameters

__x	A reverse_iterator.
__y	A reverse_iterator.

Returns: A simple bool.

Reverse iterators forward comparisons to their underlying base() iterators.

Definition at line 529 of file bits/stl_iterator.h.

References std::reverse_iterator< _Iterator >::base().

◆ operator>()

template<typename _IteratorL , typename _IteratorR >
requires requires { { __x.base() < __y.base() } -> convertible_to<bool>; }

constexpr bool std::operator>	(	const reverse_iterator< _IteratorL > &	__x,
		const reverse_iterator< _IteratorR > &	__y
	)

constexpr

Definition at line 553 of file bits/stl_iterator.h.

◆ operator>=()

template<typename _IteratorL , typename _IteratorR >
requires requires { { __x.base() <= __y.base() } -> convertible_to<bool>; }

constexpr bool std::operator>=	(	const reverse_iterator< _IteratorL > &	__x,
		const reverse_iterator< _IteratorR > &	__y
	)

constexpr

Definition at line 569 of file bits/stl_iterator.h.

Variable Documentation

◆ disable_sized_sentinel_for< reverse_iterator< _Iterator1 >, reverse_iterator< _Iterator2 > >

template<typename _Iterator1 , typename _Iterator2 >

constexpr bool std::disable_sized_sentinel_for< reverse_iterator< _Iterator1 >, reverse_iterator< _Iterator2 > >

inlineconstexpr

Definition at line 653 of file bits/stl_iterator.h.

Modules

Classes

Macros

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ _GLIBCXX_MAKE_MOVE_IF_NOEXCEPT_ITERATOR

◆ _GLIBCXX_MAKE_MOVE_ITERATOR

Function Documentation

◆ __copy_move_a2() [1/3]

◆ __copy_move_a2() [2/3]

◆ __copy_move_a2() [3/3]

◆ __copy_n_a()

◆ __iterator_category()

◆ __make_reverse_iterator()

◆ advance()

◆ back_inserter()

◆ copy()

◆ find()

◆ front_inserter()

◆ inserter()

◆ make_reverse_iterator()

◆ operator!=()

◆ operator+()

◆ operator-()

◆ operator<()

◆ operator<=()

◆ operator<=>() [1/2]

◆ operator<=>() [2/2]

◆ operator==() [1/3]

◆ operator==() [2/3]

◆ operator==() [3/3]

◆ operator>()

◆ operator>=()

Variable Documentation

◆ disable_sized_sentinel_for< reverse_iterator< _Iterator1 >, reverse_iterator< _Iterator2 > >