qx::generic_span< T, traits_t > Class Template Reference

Same as std::span, but may be used with containers with forward iterators. More...

#include <generic_span.h>

Classes
class	iterator

Public Member Functions
template<class container_t >
	generic_span (container_t &container) noexcept
	generic_span object constructor More...
template<class container_t >
	generic_span (container_t &container, function_type< reference(qualified_type< container_value< container_t >> &)> valueAdapter) noexcept
	generic_span object constructor More...
template<class container_t >
generic_span &	operator= (container_t &container) noexcept
	operator= More...
bool	empty () const noexcept
	Check if span is empty. More...
iterator	begin () const noexcept
	Return iterator to beginning. More...
iterator	end () const noexcept
	Return iterator to end. More...
iterator	cbegin () const noexcept
	Return const iterator to beginning. More...
iterator	cend () const noexcept
	Return const iterator to end. More...

Detailed Description

template<class T, class traits_t = default_generic_span_traits>
class qx::generic_span< T, traits_t >

Same as std::span, but may be used with containers with forward iterators.

The class can be used to use any container to iterate over its elements Useful when used in virtual methods Does not own the container The container should not be changed until the end of the iteration May be much slower then std::span when the size of sbo is smaller then sizeof 2 iterators of this container (libcpp: 16, ligcxx: 16, MSVC: 56)

Template Parameters

T	- container value type

Author

Khrapov

Date

20.11.2022

Definition at line 40 of file generic_span.h.

Constructor & Destructor Documentation

generic_span() [1/2]

template<class T , class traits_t >

template<class container_t >

qx::generic_span< T, traits_t >::generic_span ( container_t &  container )

inlinenoexcept

generic_span object constructor

Template Parameters

container_t

- any container, which adapter satisfies forward iterator concept

Parameters

container

- container instance. container must not be edited until adapter death

Definition at line 82 of file generic_span.inl.

generic_span() [2/2]

template<class T , class traits_t >

template<class container_t >

qx::generic_span< T, traits_t >::generic_span ( container_t &  container, function_type< reference(qualified_type< container_value< container_t >> &)>  valueAdapter  )

inlinenoexcept

generic_span object constructor

Template Parameters

container_t

- any container, which adapter satisfies forward iterator concept

Parameters

container	- container instance. container must not be edited until adapter death
valueAdapter	- function which transforms Container::value_type to T*

Definition at line 103 of file generic_span.inl.

Member Function Documentation

begin()

template<class T , class traits_t >

generic_span< T, traits_t >::iterator qx::generic_span< T, traits_t >::begin

inlinenoexcept

Return iterator to beginning.

Return values

-	iterator to beginning

Definition at line 125 of file generic_span.inl.

cbegin()

template<class T , class traits_t >

generic_span< T, traits_t >::iterator qx::generic_span< T, traits_t >::cbegin

inlinenoexcept

Return const iterator to beginning.

Return values

-	const iterator to beginning

Definition at line 137 of file generic_span.inl.

cend()

template<class T , class traits_t >

generic_span< T, traits_t >::iterator qx::generic_span< T, traits_t >::cend

inlinenoexcept

Return const iterator to end.

Return values

-	const iterator to end

Definition at line 143 of file generic_span.inl.

empty()

template<class T , class traits_t >

bool qx::generic_span< T, traits_t >::empty

inlinenoexcept

Check if span is empty.

Return values

-	true if empty

Definition at line 119 of file generic_span.inl.

end()

template<class T , class traits_t >

generic_span< T, traits_t >::iterator qx::generic_span< T, traits_t >::end

inlinenoexcept

Return iterator to end.

Return values

-	iterator to end

Definition at line 131 of file generic_span.inl.

operator=()

template<class T , class traits_t = default_generic_span_traits>

template<class container_t >

generic_span& qx::generic_span< T, traits_t >::operator= ( container_t &  container )

noexcept

operator=

Template Parameters

container_t

- any container, which adapter satisfies forward iterator concept

Parameters

container

- container instance. container must not be edited until adapter death

Return values

-	this object reference

---

The documentation for this class was generated from the following files:

• include/qx/patterns/generic_span.h
• include/qx/patterns/generic_span.inl