geos::Span< T > Class Template Reference

Lightweight non-owning wrapper over a contiguous range of elements. More...

#include <Span.hpp>

Public Types
using	element_type = T
	Type of range element.
using	value_type = std::remove_cv_t< T >
	Type of underlying value.
using	size_type = std::size_t
	Type used for indexing the range.
using	difference_type = std::ptrdiff_t
	Type used for indexing the range.

Public Member Functions
constexpr	Span () noexcept=default
	Construct an empty span.
	Span (T *const ptr, size_type const size) noexcept
	Construct a span from pointer and size. More...
template<typename ITER >
constexpr	Span (ITER const begin, ITER const end) noexcept
	Construct a span from pair of iterators. More...
template<int N>
constexpr	Span (T(&arr)[N]) noexcept
	Construct a span from a c-array. More...
template<typename R , typename std::enable_if_t< traits::is_range_like< R > > * = nullptr>
constexpr	Span (R const &range)
	Construct a span from a range-like object (anything that has begin() and end()). More...
constexpr size_type	size () const noexcept
constexpr size_type	size_bytes () const noexcept
constexpr bool	empty () const noexcept
constexpr T *	data () const noexcept
constexpr T *	begin () const noexcept
constexpr T *	end () const noexcept
constexpr std::reverse_iterator< T * >	rbegin () const noexcept
constexpr std::reverse_iterator< T * >	rend () const noexcept
T &	front () const
T &	back () const
T &	operator[] (size_type const i) const
Span< element_type >	first (size_type const count) const
Span< element_type >	last (size_type const count) const
Span< element_type >	subspan (size_type const offset, size_type const count) const

Detailed Description

template<typename T>
class geos::Span< T >

Lightweight non-owning wrapper over a contiguous range of elements.

Template Parameters

T	type of range element

This is a simplified version of C++17's std::span<> that doesn't support compile-time extents.

Definition at line 41 of file Span.hpp.

Constructor & Destructor Documentation

Span() [1/4]

template<typename T >

geos::Span< T >::Span ( T *const  ptr, size_type const  size  )

inlinenoexcept

Construct a span from pointer and size.

Parameters

ptr	pointer to beginning of contiguous range
size	number of elements

Definition at line 67 of file Span.hpp.

Span() [2/4]

template<typename T >

template<typename ITER >

constexpr geos::Span< T >::Span ( ITER const  begin, ITER const  end  )

inlineconstexprnoexcept

Construct a span from pair of iterators.

Template Parameters

ITER	type of iterators

Parameters

begin	iterator to start of the range
end	iterator to end of the range

Definition at line 79 of file Span.hpp.

Span() [3/4]

template<typename T >

template<int N>

constexpr geos::Span< T >::Span ( T(&)  arr[N] )

inlineconstexprnoexcept

Construct a span from a c-array.

Template Parameters

N	compile-time size of array

Parameters

arr	reference to array

Definition at line 89 of file Span.hpp.

Span() [4/4]

template<typename T >

template<typename R , typename std::enable_if_t< traits::is_range_like< R > > * = nullptr>

constexpr geos::Span< T >::Span ( R const &  range )

inlineconstexpr

Construct a span from a range-like object (anything that has begin() and end()).

Template Parameters

R	the range type

Parameters

range

reference to the range

Note

The user must guarantee that the range is contiguous in memory.

Definition at line 100 of file Span.hpp.

Member Function Documentation

back()

template<typename T >

T& geos::Span< T >::back ( ) const

inline

Returns

reference to the last element

Precondition

!empty()

Definition at line 182 of file Span.hpp.

begin()

template<typename T >

constexpr T* geos::Span< T >::begin ( ) const

inlineconstexprnoexcept

Returns

iterator to start of the range

Definition at line 139 of file Span.hpp.

data()

template<typename T >

constexpr T* geos::Span< T >::data ( ) const

inlineconstexprnoexcept

Returns

raw pointer to the data

Definition at line 131 of file Span.hpp.

empty()

template<typename T >

constexpr bool geos::Span< T >::empty ( ) const

inlineconstexprnoexcept

Returns

true iff range is empty

Definition at line 123 of file Span.hpp.

end()

template<typename T >

constexpr T* geos::Span< T >::end ( ) const

inlineconstexprnoexcept

Returns

iterator past-the-end of the range

Definition at line 147 of file Span.hpp.

first()

template<typename T >

Span< element_type > geos::Span< T >::first ( size_type const  count ) const

inline

Returns

a new span of count starting elements

Parameters

count

Definition at line 203 of file Span.hpp.

front()

template<typename T >

T& geos::Span< T >::front ( ) const

inline

Returns

reference to the first element

Precondition

!empty()

Definition at line 172 of file Span.hpp.

last()

template<typename T >

Span< element_type > geos::Span< T >::last ( size_type const  count ) const

inline

Returns

a new span of count trailing elements

Parameters

count

number of elements

Definition at line 213 of file Span.hpp.

operator[]()

template<typename T >

T& geos::Span< T >::operator[] ( size_type const  i ) const

inline

Returns

reference to i-th element

Parameters

i	element index

Precondition

0 <= i < size()

Definition at line 193 of file Span.hpp.

rbegin()

template<typename T >

constexpr std::reverse_iterator< T * > geos::Span< T >::rbegin ( ) const

inlineconstexprnoexcept

Returns

reverse iterator to start or the range

Definition at line 155 of file Span.hpp.

rend()

template<typename T >

constexpr std::reverse_iterator< T * > geos::Span< T >::rend ( ) const

inlineconstexprnoexcept

Returns

reverse iterator to end of the range

Definition at line 163 of file Span.hpp.

size()

template<typename T >

constexpr size_type geos::Span< T >::size ( ) const

inlineconstexprnoexcept

Returns

size of the range

Definition at line 107 of file Span.hpp.

size_bytes()

template<typename T >

constexpr size_type geos::Span< T >::size_bytes ( ) const

inlineconstexprnoexcept

Returns

size of the range in bytes

Definition at line 115 of file Span.hpp.

subspan()

template<typename T >

Span< element_type > geos::Span< T >::subspan ( size_type const  offset, size_type const  count  ) const

inline

Returns

a new span of count elements starting at offset

Parameters

offset	starting index
count	number of elements

Definition at line 224 of file Span.hpp.

---

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

• coreComponents/common/Span.hpp