span.h File Reference

#include <algorithm>
#include <cassert>
#include <cstddef>
#include <cstdint>
#include <span>
#include <type_traits>

Include dependency graph for span.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	Span< C >
	A Span is an object that can refer to a contiguous sequence of objects. More...
struct	Span< C >::is_Span_int< T >
struct	Span< C >::is_Span_int< Span< T > >
struct	Span< C >::is_Span< T >

Concepts
concept	BasicByte

Macros
#define	CONSTEXPR_IF_NOT_DEBUG   constexpr
#define	ASSERT_IF_DEBUG(x)
#define	SPAN_ATTR_LIFETIMEBOUND

Functions
template<typename T , typename EndOrSize >
	Span (T *, EndOrSize) -> Span< T >
template<typename T , std::size_t N>
	Span (T(&)[N]) -> Span< T >
template<typename T >
	Span (T &&) -> Span< std::enable_if_t< !std::is_lvalue_reference_v< T >, const std::remove_pointer_t< decltype(std::declval< T && >().data())> > >
template<typename T >
	Span (T &) -> Span< std::remove_pointer_t< decltype(std::declval< T & >().data())> >
template<typename T >
T &	SpanPopBack (Span< T > &span)
	Pop the last element off a span, and return a reference to that element. More...
const std::byte *	BytePtr (const void *data)
	Convert a data pointer to a std::byte data pointer. More...
std::byte *	BytePtr (void *data)
template<typename T >
Span< const std::byte >	AsBytes (Span< T > s) noexcept
template<typename T >
Span< std::byte >	AsWritableBytes (Span< T > s) noexcept
template<typename V >
Span< const std::byte >	MakeByteSpan (V &&v) noexcept
template<typename V >
Span< std::byte >	MakeWritableByteSpan (V &&v) noexcept
uint8_t *	UCharCast (char *c)
uint8_t *	UCharCast (uint8_t *c)
uint8_t *	UCharCast (signed char *c)
uint8_t *	UCharCast (std::byte *c)
const uint8_t *	UCharCast (const char *c)
const uint8_t *	UCharCast (const uint8_t *c)
const uint8_t *	UCharCast (const signed char *c)
const uint8_t *	UCharCast (const std::byte *c)
template<typename T >
constexpr auto	UCharSpanCast (Span< T > s) -> Span< typename std::remove_pointer< decltype(UCharCast(s.data()))>::type >
template<typename V >
constexpr auto	MakeUCharSpan (V &&v) -> decltype(UCharSpanCast(Span{std::forward< V >(v)}))
	Like the Span constructor, but for (const) uint8_t member types only. More...

Macro Definition Documentation

ASSERT_IF_DEBUG

#define ASSERT_IF_DEBUG

(

x

)

Definition at line 20 of file span.h.

CONSTEXPR_IF_NOT_DEBUG

#define CONSTEXPR_IF_NOT_DEBUG   constexpr

Definition at line 19 of file span.h.

SPAN_ATTR_LIFETIMEBOUND

#define SPAN_ATTR_LIFETIMEBOUND

Definition at line 30 of file span.h.

Function Documentation

AsBytes()

template<typename T >

Span< const std::byte > AsBytes ( Span< T >  s )

noexcept

Definition at line 295 of file span.h.

Here is the call graph for this function:

Here is the caller graph for this function:

AsWritableBytes()

template<typename T >

Span< std::byte > AsWritableBytes ( Span< T >  s )

noexcept

Definition at line 298 of file span.h.

Here is the call graph for this function:

Here is the caller graph for this function:

BytePtr() [1/2]

const std::byte * BytePtr ( const void *  data )

inline

Convert a data pointer to a std::byte data pointer.

Where possible, please use the safer AsBytes helpers.

Definition at line 287 of file span.h.

Here is the call graph for this function:

Here is the caller graph for this function:

BytePtr() [2/2]

std::byte * BytePtr ( void *  data )

inline

Definition at line 290 of file span.h.

Here is the call graph for this function:

MakeByteSpan()

template<typename V >

Span< const std::byte > MakeByteSpan ( V &&  v )

noexcept

Definition at line 302 of file span.h.

Here is the call graph for this function:

Here is the caller graph for this function:

MakeUCharSpan()

template<typename V >

constexpr auto MakeUCharSpan ( V &&  v ) -> decltype(UCharSpanCast(Span{std::forward<V>(v)}))

constexpr

Like the Span constructor, but for (const) uint8_t member types only.

Only works for (un)signed char containers.

Definition at line 350 of file span.h.

Here is the caller graph for this function:

MakeWritableByteSpan()

template<typename V >

Span< std::byte > MakeWritableByteSpan ( V &&  v )

noexcept

Definition at line 305 of file span.h.

Here is the call graph for this function:

Here is the caller graph for this function:

Span() [1/4]

template<typename T >

Span

(

T &&

)

-> Span< std::enable_if_t< !std::is_lvalue_reference_v< T >, const std::remove_pointer_t< decltype(std::declval< T && >().data())> > >

Span() [2/4]

template<typename T >

Span

(

T &

)

-> Span< std::remove_pointer_t< decltype(std::declval< T & >().data())> >

Span() [3/4]

template<typename T , typename EndOrSize >

Span	(	T *	,
		EndOrSize
	)		-> Span< T >

Here is the caller graph for this function:

Span() [4/4]

template<typename T , std::size_t N>

Span

(

T(&)

[N]

)

-> Span< T >

SpanPopBack()

template<typename T >

T & SpanPopBack

(

Span< T > &

span

)

Pop the last element off a span, and return a reference to that element.

Definition at line 277 of file span.h.

Here is the call graph for this function:

UCharCast() [1/8]

uint8_t * UCharCast ( char *  c )

inline

Definition at line 310 of file span.h.

Here is the caller graph for this function:

UCharCast() [2/8]

const uint8_t * UCharCast ( const char *  c )

inline

Definition at line 322 of file span.h.

UCharCast() [3/8]

const uint8_t * UCharCast ( const signed char *  c )

inline

Definition at line 328 of file span.h.

UCharCast() [4/8]

const uint8_t * UCharCast ( const std::byte *  c )

inline

Definition at line 331 of file span.h.

UCharCast() [5/8]

const uint8_t * UCharCast ( const uint8_t *  c )

inline

Definition at line 325 of file span.h.

UCharCast() [6/8]

uint8_t * UCharCast ( signed char *  c )

inline

Definition at line 316 of file span.h.

UCharCast() [7/8]

uint8_t * UCharCast ( std::byte *  c )

inline

Definition at line 319 of file span.h.

UCharCast() [8/8]

uint8_t * UCharCast ( uint8_t *  c )

inline

Definition at line 313 of file span.h.

UCharSpanCast()

template<typename T >

constexpr auto UCharSpanCast ( Span< T >  s ) -> Span<typename std::remove_pointer<decltype(UCharCast(s.data()))>::type>

constexpr

Definition at line 340 of file span.h.

Here is the call graph for this function: