Namespaces
	C

	connections

	detail

	extras

	serialization

	strings

Classes
struct	ArrayView
	Represents a view over a contiguous array of objects, similar to std::span, and is implemented as a pointer and length. More...

struct	ArrayView< T, DYNAMIC_EXTENT >

struct	BitfieldMemberIthruJ
	A class which represents part of a bitfield (see BitfieldMemberN) More...

struct	BitfieldMemberItoJ
	A class which represents part of a bitfield (see BitfieldMemberN) More...

struct	BitfieldMemberN
	A class which represents part of a bitfield. More...

class	Connection
	Represents a type of connection. More...

class	Id
	Representes an ID number ranging from 1..N including N. More...

class	Index
	Represents an index ranging from 0..N excluding N. More...

struct	IntegerWithBits
	Helper type to get an integer of at least N bits in size. More...

struct	IntegerWithBytes
	Helper type to get an integer of at least N bytes in size. More...

struct	IntegerWithBytes< 1 >

struct	IntegerWithBytes< 2 >

struct	IntegerWithBytes< 3 >

struct	IntegerWithBytes< 4 >

struct	IntegerWithBytes< 5 >

struct	IntegerWithBytes< 6 >

struct	IntegerWithBytes< 7 >

struct	IntegerWithBytes< 8 >

class	SaturatingInt
	A class representing an integer that saturates instead of overflowing. More...

class	Serializer
	Serializes or deserializes data to/from a byte buffer. More...

class	SerializerBase
	Represents a view of a buffer of bytes of known capacity. More...

Typedefs
template<class T >
using	ConstArrayView = ArrayView< const T >

using	U8ArrayView = ArrayView< uint8_t >

using	ConstU8ArrayView = ConstArrayView< uint8_t >

using	CharArrayView = ArrayView< char >

using	ConstCharArrayView = ConstArrayView< char >

using	EmbeddedTimestamp = C::microstrain_embedded_timestamp

using	EmbeddedTimeout = C::microstrain_embedded_timeout

using	BigEndianSerializer = Serializer< serialization::Endian::big >

using	LittleEndianSerializer = Serializer< serialization::Endian::little >

Functions
template<typename T >
constexpr T	bitmaskFirstN (unsigned int nbits)
	Creates a bitmask with 1s in the first N bits, i.e. bits [0..N). More...

template<typename T >
constexpr T	bitmaskN (unsigned int bitI, unsigned int nbits)
	Creates a bitmask with N '1' bits starting at bit I. More...

template<typename T >
constexpr T	bitmaskItoJ (unsigned int bitI, unsigned int bitJ)
	Creates a bitmask with bits [bitI..bitJ) set to 1 (excludes bit J). More...

template<typename T >
constexpr T	bitmaskIthruJ (unsigned int bitI, unsigned int bitJ)
	Creates a bitmask with bits [bitI..bitJ] set to 1 (includes bit J). More...

template<typename RegType >
constexpr bool	testBit (RegType reg, unsigned int bit)
	Checks if a specific bit in a value is set. More...

template<typename RegType >
constexpr void	setBit (RegType &reg, unsigned int bit, bool value=true)
	Sets a specific bit in a variable to a specified value. More...

template<typename RegType >
constexpr RegType	getBitsN (RegType reg, unsigned int bitI, unsigned int nbits)
	Extracts a bitfield from a variable value. More...

template<typename RegType >
constexpr RegType	getBitsItoJ (RegType reg, unsigned int bitI, unsigned int bitJ)
	Extracts a bitfield from a variable value. More...

template<typename RegType >
constexpr RegType	getBitsIthruJ (RegType reg, unsigned int bitI, unsigned int bitJ)
	Extracts a bitfield from a variable value. More...

template<typename RegType >
constexpr void	setBitsN (RegType &reg, unsigned int bitI, unsigned int nbits)
	Sets a series of consecutive bits in a variable to 1. More...

template<typename RegType >
constexpr void	setBitsItoJ (RegType &reg, unsigned int bitI, unsigned int bitJ)
	Sets a series of consecutive bits in a variable to 1. More...

template<typename RegType >
constexpr void	setBitsIthruJ (RegType &reg, unsigned int bitI, unsigned int bitJ)
	Sets a series of consecutive bits in a variable to 1. More...

template<typename RegType >
constexpr void	clearBitsN (RegType &reg, unsigned int bitI, unsigned int nbits)
	Sets a series of consecutive bits in a variable to 0. More...

template<typename RegType >
constexpr void	clearBitsItoJ (RegType &reg, unsigned int bitI, unsigned int bitJ)
	Sets a series of consecutive bits in a variable to 0. More...

template<typename RegType >
constexpr void	clearBitsIthruJ (RegType &reg, unsigned int bitI, unsigned int bitJ)
	Sets a series of consecutive bits in a variable to 0. More...

template<typename RegType , typename ValType >
constexpr void	setBitsN (RegType &reg, unsigned int bitI, unsigned int nbits, ValType value)
	Writes a value to a specific set of bits in a variable as if it were a bitfield. More...

template<typename RegType , typename ValType >
constexpr void	setBitsItoJ (RegType &reg, unsigned int bitI, unsigned int bitJ, ValType value)
	Writes a value to a specific set of bits in a variable as if it were a bitfield. More...

template<typename RegType , typename ValType >
constexpr void	modifyBitsIthruJ (RegType &reg, unsigned int bitI, unsigned int bitJ, ValType value)
	Writes a value to a specific set of bits in a variable as if it were a bitfield. More...

template<class T >
constexpr T	add_sat (T x, T y) noexcept

template<class T >
constexpr T	sub_sat (T x, T y) noexcept

template<class T , class U >
constexpr T	saturate_cast (U x) noexcept
	Convert an integral value to a different integral type while preventing overflow. More...

template<class T , class U >
constexpr void	assign_sat (T &destination, U value)
	Assign an integral value to a destination variable, clamping its value to the range of the destination type. More...

template<class T , class U >
constexpr T &	accum_sat (T &counter, U amount)
	Add a value to an accumulator and prevent it from overflowing. More...

template<class T , class U >
constexpr T &	reduce_sat (T &counter, U amount)
	Subtract a value from an accumulator and prevent it from overflowing. More...

constexpr bool	operator== (Id l, Index r)

constexpr bool	operator== (Index l, Id r)

template<class Container >
auto *	indexOrNull (Container &container, Index index)

template<class Container , typename Value >
auto	indexOrDefault (Container &container, Index index, Value default_)

template<serialization::Endian E, class T >
std::enable_if< std::is_arithmetic< T >::value, size_t >::type	insert (Serializer< E > &buffer, T value)
	Inserts a numeric value to a Serializer. More...

template<serialization::Endian E, class T >
std::enable_if< std::is_arithmetic< T >::value, size_t >::type	extract (Serializer< E > &buffer, T &value)
	Reads a numeric value from a Serializer. More...

template<serialization::Endian E, class T >
std::enable_if< std::is_enum< T >::value, size_t >::type	insert (Serializer< E > &buffer, T value)
	Writes an enum to a Serializer. For this to work properly, the enum must have its underlying type specified, i.e., like `enum Foo : uint32_t { /...‍/ };` More...

template<serialization::Endian E, class T >
std::enable_if< std::is_enum< T >::value, size_t >::type	extract (Serializer< E > &buffer, T &value)
	Reads an enum from a Serializer. For this to work properly, the enum must have its underlying type specified, i.e., like `enum Foo : uint32_t { /...‍/ };` More...

template<serialization::Endian E, class T , decltype &::insert = nullptr>
std::enable_if< std::is_class< T >::value, size_t >::type	insert (microstrain::Serializer< E > &serializer, const T &object)
	Writes a class object to a Serializer. This overload is available to any class which defines a method `insert`. It shall take a Serializer reference as the sole parameter. More...

template<serialization::Endian E, class T , decltype &::extract = nullptr>
std::enable_if< std::is_class< T >::value, size_t >::type	extract (microstrain::Serializer< E > &serializer, T &object)
	Reads a class object from a Serializer. This overload is available to any class which defines a method `extract`. It shall take a Serializer reference as the sole parameter. More...

template<serialization::Endian E, class T >
size_t	insert (Serializer< E > &serializer, const T *values, size_t count)
	Writes an array to a Serializer. More...

template<serialization::Endian E, class T >
size_t	extract (Serializer< E > &serializer, T *values, size_t count)
	Reads an array from a Serializer. More...

template<serialization::Endian E, class T >
size_t	insert (Serializer< E > &serializer, microstrain::ArrayView< const T > values)
	Writes an array to a Serializer via a Span. More...

template<serialization::Endian E, class T >
size_t	extract (Serializer< E > &serializer, microstrain::ConstArrayView< T > values)
	Reads an array from a Serializer via an ArrayView. More...

template<serialization::Endian E, class T , size_t N>
size_t	insert (Serializer< E > &serializer, const T(&values)[N])
	Writes a fixed-size array to a Serializer. More...

template<serialization::Endian E, class T , size_t N>
size_t	extract (Serializer< E > &serializer, T(&values)[N])
	Reads a fixed-size array from a Serializer. More...

template<serialization::Endian E, class T , size_t N>
size_t	insert (Serializer< E > &serializer, const std::array< T, N > &values)
	Writes a std::array to a Serializer. More...

template<serialization::Endian E, class T , size_t N>
size_t	extract (Serializer< E > &serializer, const std::array< T, N > &values)
	Reads a std::array from a Serializer. More...

template<serialization::Endian E, typename T0 , typename T1 , typename... Ts>
size_t	insert (Serializer< E > &serializer, const T0 &value0, const T1 &value1, Ts... values)
	Writes multiple values to a Serializer. More...

template<serialization::Endian E, typename T0 , typename T1 , typename... Ts>
size_t	extract (Serializer< E > &serializer, T0 &value0, T1 &value1, Ts &... values)
	Reads multiple values from a Serializer. More...

template<serialization::Endian E, class T >
bool	insert (const T &value, uint8_t *buffer, size_t buffer_length, size_t offset=0, bool exact_size=false)
	Serializes a value to a raw byte buffer. More...

template<serialization::Endian E, class T >
bool	extract (T &value, const uint8_t *buffer, size_t buffer_length, size_t offset=0, bool exact_size=false)
	Deserializes a value from a raw byte buffer. More...

template<serialization::Endian E, class T >
bool	insert (T value, microstrain::ArrayView< uint8_t > buffer, size_t offset=0, bool exact_size=false)
	Serializes a value to a raw byte buffer (ArrayView version). More...

template<serialization::Endian E, class T >
bool	extract (T &value, microstrain::ConstU8ArrayView buffer, size_t offset=0, bool exact_size=false)
	Deserializes a value from a raw byte buffer (ArrayView version). More...

Variables
static constexpr size_t	DYNAMIC_EXTENT = SIZE_MAX

Typedef Documentation

◆ ConstArrayView

template<class T >

using microstrain::ConstArrayView = typedef ArrayView<const T>

◆ U8ArrayView

using microstrain::U8ArrayView = typedef ArrayView<uint8_t>

◆ ConstU8ArrayView

using microstrain::ConstU8ArrayView = typedef ConstArrayView<uint8_t>

◆ CharArrayView

using microstrain::CharArrayView = typedef ArrayView<char>

◆ ConstCharArrayView

using microstrain::ConstCharArrayView = typedef ConstArrayView<char>

◆ EmbeddedTimestamp

using microstrain::EmbeddedTimestamp = typedef C::microstrain_embedded_timestamp

◆ EmbeddedTimeout

using microstrain::EmbeddedTimeout = typedef C::microstrain_embedded_timeout

Function Documentation

◆ bitmaskFirstN()

template<typename T >

constexpr T microstrain::bitmaskFirstN ( unsigned int nbits )

constexpr

Template Parameters

T	An unsigned integral type.

Parameters

nbits The number of 1 bits starting at location 0. Must not exceed the number of bits in T (e.g. nbits <= 32 for T=uint32_t).

Returns: the bitmask

◆ bitmaskN()

template<typename T >

constexpr T microstrain::bitmaskN	(	unsigned int	bitI,
		unsigned int	nbits
	)

constexpr

If bitI == bitJ, then the result will have exactly one bit set.

Template Parameters

T	An unsigned integral type.

Parameters

bitI	The 0-based index of the first 1 bit. Must be LESS than the number of bits in T (and not equal).
bitJ	The 0-based index of the the last 1 bit. Must be greater than or equal to bitI and cannot exceed the number of bits in T.

Returns: the bitmask

◆ bitmaskItoJ()

template<typename T >

constexpr T microstrain::bitmaskItoJ	(	unsigned int	bitI,
		unsigned int	bitJ
	)

constexpr

Template Parameters

T	An unsigned integral type.

Parameters

bitI	The 0-based index of the first 1 bit. Must not exceed the number of bits in T.
bitJ	The 0-based index of the first 0 bit after the last 1 bit. Must be greater than or equal to bitI and cannot exceed the number of bits in T.

Returns: the bitmask

◆ bitmaskIthruJ()

template<typename T >

constexpr T microstrain::bitmaskIthruJ	(	unsigned int	bitI,
		unsigned int	bitJ
	)

constexpr

If bitI == bitJ, then the result will have exactly one bit set.

Template Parameters

T	An unsigned integral type.

Parameters

bitI	The 0-based index of the first 1 bit. Must not exceed the number of bits in T.
bitJ	The 0-based index of the the last 1 bit. Must be greater than or equal to bitI and cannot exceed the number of bits in T.

Returns: the bitmask

◆ testBit()

template<typename RegType >

constexpr bool microstrain::testBit	(	RegType	reg,
		unsigned int	bit
	)

constexpr

Template Parameters

RegType An integral type. Let the compiler deduce this in most cases.

Parameters

reg	Value containing the bit to check.
bit	The 0-based index of the bit to check in val. Must be less than the number of bits in RegType.

Returns: True if the bit is set, false otherwise.

◆ setBit()

template<typename RegType >

constexpr void microstrain::setBit	(	RegType &	reg,
		unsigned int	bit,
		bool	value = `true`
	)

constexpr

Template Parameters

RegType An integral type. Let the compiler deduce this.

Parameters

reg	Value to be modified.
bit	The 0-based index of the bit to modify. Must be less than the number of bits in RegType.
value	Sets the bit to this value. Default true.

◆ getBitsN()

template<typename RegType >

constexpr RegType microstrain::getBitsN	(	RegType	reg,
		unsigned int	bitI,
		unsigned int	nbits
	)

constexpr

Template Parameters

RegType An unsigned integral type. Let the compiler deduce this.

Parameters

reg	Register value.
bitI	The 0-based index of the first bit to extract. Must be less than the number of bits in RegType.
nbits	How many consecutive bits to extract.

Returns: The value stored in bits [bitI..bitI+N) as the same type as reg.

◆ getBitsItoJ()

template<typename RegType >

constexpr RegType microstrain::getBitsItoJ	(	RegType	reg,
		unsigned int	bitI,
		unsigned int	bitJ
	)

constexpr

Template Parameters

RegType An unsigned integral type. Let the compiler deduce this.

Parameters

reg	Register value.
bitI	The 0-based index of the first bit to extract. Must be less than the number of bits in RegType.
bitJ	The 0-based index of the bit after last bit to extract. Must be greater than or equal to bitI and cannot exceed the number of bits in RegType.

Returns: The value stored in bits [bitI..bitJ) as the same type as reg.

◆ getBitsIthruJ()

template<typename RegType >

constexpr RegType microstrain::getBitsIthruJ	(	RegType	reg,
		unsigned int	bitI,
		unsigned int	bitJ
	)

constexpr

Template Parameters

RegType An unsigned integral type. Let the compiler deduce this.

Parameters

reg	Register value.
bitI	The 0-based index of the first bit to extract. Must be less than the number of bits in RegType.
bitJ	The 0-based index of the last bit to extract. Must be greater than or equal to bitI and less than the number of bits in RegType.

Returns: The value stored in bits [bitI..bitJ] as the same type as reg.

◆ setBitsN() [1/2]

template<typename RegType >

constexpr void microstrain::setBitsN	(	RegType &	reg,
		unsigned int	bitI,
		unsigned int	nbits
	)

constexpr

Template Parameters

RegType An unsigned integral type. Let the compiler deduce this.

Parameters

reg	Value to be modified.
bitI	The 0-based index of the first affected bit.
nbits	Number of consecutive bits to set to '1'.

◆ setBitsItoJ() [1/2]

template<typename RegType >

constexpr void microstrain::setBitsItoJ	(	RegType &	reg,
		unsigned int	bitI,
		unsigned int	bitJ
	)

constexpr

Template Parameters

RegType An unsigned integral type. Let the compiler deduce this.

Parameters

reg	Value to be modified.
bitI	The 0-based index of the first affected bit.
bitJ	The 0-based index of the bit after the last affected bit.

◆ setBitsIthruJ()

template<typename RegType >

constexpr void microstrain::setBitsIthruJ	(	RegType &	reg,
		unsigned int	bitI,
		unsigned int	bitJ
	)

constexpr

Template Parameters

RegType An unsigned integral type. Let the compiler deduce this.

Parameters

reg	Value to be modified.
bitI	The 0-based index of the first affected bit.
bitJ	The 0-based index of the last affected bit.

◆ clearBitsN()

template<typename RegType >

constexpr void microstrain::clearBitsN	(	RegType &	reg,
		unsigned int	bitI,
		unsigned int	nbits
	)

constexpr

Template Parameters

RegType An unsigned integral type. Let the compiler deduce this.

Parameters

reg	Value to be modified.
bitI	The 0-based index of the first affected bit.
nbits	Number of consecutive bits to set to '0'.

◆ clearBitsItoJ()

template<typename RegType >

constexpr void microstrain::clearBitsItoJ	(	RegType &	reg,
		unsigned int	bitI,
		unsigned int	bitJ
	)

constexpr

Template Parameters

RegType An unsigned integral type. Let the compiler deduce this.

Parameters

reg	Value to be modified.
bitI	The 0-based index of the first affected bit.
bitJ	The 0-based index of the bit after the last affected bit.

◆ clearBitsIthruJ()

template<typename RegType >

constexpr void microstrain::clearBitsIthruJ	(	RegType &	reg,
		unsigned int	bitI,
		unsigned int	bitJ
	)

constexpr

Template Parameters

RegType An unsigned integral type. Let the compiler deduce this.

Parameters

reg	Value to be modified.
bitI	The 0-based index of the first affected bit.
bitJ	The 0-based index of the last affected bit.

◆ setBitsN() [2/2]

template<typename RegType , typename ValType >

constexpr void microstrain::setBitsN	(	RegType &	reg,
		unsigned int	bitI,
		unsigned int	nbits,
		ValType	value
	)

constexpr

Template Parameters

RegType	An unsigned integral type. Let the compiler deduce this.
ValType	An integral type used for the input value. Let the compiler deduce this.

Parameters

reg	Value to be modified.
bitI	The 0-based index of the first bit of value in reg.
nbits	Number of consecutive bits used to represent the value in reg.
value	Value to insert into reg at bit I.

◆ setBitsItoJ() [2/2]

template<typename RegType , typename ValType >

constexpr void microstrain::setBitsItoJ	(	RegType &	reg,
		unsigned int	bitI,
		unsigned int	bitJ,
		ValType	value
	)

constexpr

Template Parameters

RegType	An unsigned integral type. Let the compiler deduce this.
ValType	An integral type used for the input value. Let the compiler deduce this.

Parameters

reg	Value to be modified.
bitI	The 0-based index of the first bit of value in reg.
bitJ	The 0-based index of the bit after the last affected bit.
value	Value to insert into reg at bit I.

◆ modifyBitsIthruJ()

template<typename RegType , typename ValType >

constexpr void microstrain::modifyBitsIthruJ	(	RegType &	reg,
		unsigned int	bitI,
		unsigned int	bitJ,
		ValType	value
	)

constexpr

Template Parameters

RegType	An unsigned integral type. Let the compiler deduce this.
ValType	An integral type used for the input value. Let the compiler deduce this.

Parameters

reg	Value to be modified.
bitI	The 0-based index of the first bit of value in reg.
bitJ	The 0-based index of the last bit of value in reg.
value	Value to insert into reg at bit I.

◆ add_sat()

template<class T >

constexpr T microstrain::add_sat	(	T	x,
		T	y
	)

constexprnoexcept

see https://en.cppreference.com/w/cpp/numeric/add_sat

◆ sub_sat()

template<class T >

constexpr T microstrain::sub_sat	(	T	x,
		T	y
	)

constexprnoexcept

see https://en.cppreference.com/w/cpp/numeric/sub_sat

◆ saturate_cast()

template<class T , class U >

constexpr T microstrain::saturate_cast ( U x )

constexprnoexcept

See https://en.cppreference.com/w/cpp/numeric/saturate_cast

Template Parameters

T	Result type.
U	Source type. Let the compiler deduce this.

Parameters

x	Value to cast.

Returns: The value of x, clamped to the valid range of T.

◆ assign_sat()

template<class T , class U >

constexpr void microstrain::assign_sat	(	T &	destination,
		U	value
	)

constexpr

Template Parameters

T	Destination type. Let the compiler deduce this.
U	Source type. Let the compiler deduce this.

Parameters

[out]	destination	Variable in which to store the value.
[in]	value	Value to store in destination.

◆ accum_sat()

template<class T , class U >

constexpr T& microstrain::accum_sat	(	T &	counter,
		U	amount
	)

constexpr

Template Parameters

T	Type of the accumulator. Let the compiler deduce this.
U	Type of the value being added. Let the compiler deduce this.

Parameters

[out]	counter	Accumulator variable to modify.
[in]	value	Value to add to counter.

Returns: A reference the the accumulator.

◆ reduce_sat()

template<class T , class U >

constexpr T& microstrain::reduce_sat	(	T &	counter,
		U	amount
	)

constexpr

Template Parameters

T	Type of the accumulator. Let the compiler deduce this.
U	Type of the value being subtracted. Let the compiler deduce this.

Parameters

[out]	counter	Accumulator variable to modify.
[in]	value	Value to subtract from counter.

Returns: A reference the the accumulator.

◆ operator==() [1/2]

constexpr bool microstrain::operator==	(	Id	l,
		Index	r
	)

inlineconstexpr

◆ operator==() [2/2]

constexpr bool microstrain::operator==	(	Index	l,
		Id	r
	)

inlineconstexpr

◆ indexOrNull()

template<class Container >

auto* microstrain::indexOrNull	(	Container &	container,
		Index	index
	)

◆ indexOrDefault()

template<class Container , typename Value >

auto microstrain::indexOrDefault	(	Container &	container,
		Index	index,
		Value	default_
	)

◆ insert()

template<serialization::Endian E, class T >

std::enable_if<std::is_enum<T>::value, size_t>::type microstrain::insert	(	Serializer< E > &	buffer,
		T	value
	)

Template Parameters

E	Endianness of buffer. Automatically deduced from the serializer parameter.
T	Type of the enum. Automatically deduced from the underlying type of the enum.

Parameters

buffer	Serializer object pointing to the destination buffer.
value	The enum value to write to the buffer.

Returns: The size of T, for consistency.

◆ extract()

template<serialization::Endian E, class T >

std::enable_if<std::is_enum<T>::value, size_t>::type microstrain::extract	(	Serializer< E > &	buffer,
		T &	value
	)

Template Parameters

E	Endianness of buffer. Automatically deduced from the serializer parameter.
T	Type of the enum. Automatically deduced from the underlying type of the enum.

Parameters

	buffer	Serializer object pointing to the source buffer.
[out]	value	The value will be stored in this variable.

Returns: The size of T, for consistency.

Variable Documentation

◆ DYNAMIC_EXTENT

constexpr size_t microstrain::DYNAMIC_EXTENT = SIZE_MAX

staticconstexpr

Namespaces

Classes

Typedefs

Functions

Variables

Typedef Documentation

◆ ConstArrayView

◆ U8ArrayView

◆ ConstU8ArrayView

◆ CharArrayView

◆ ConstCharArrayView

◆ EmbeddedTimestamp

◆ EmbeddedTimeout

Function Documentation

◆ bitmaskFirstN()

◆ bitmaskN()

◆ bitmaskItoJ()

◆ bitmaskIthruJ()

◆ testBit()

◆ setBit()

◆ getBitsN()

◆ getBitsItoJ()

◆ getBitsIthruJ()

◆ setBitsN() [1/2]

◆ setBitsItoJ() [1/2]

◆ setBitsIthruJ()

◆ clearBitsN()

◆ clearBitsItoJ()

◆ clearBitsIthruJ()

◆ setBitsN() [2/2]

◆ setBitsItoJ() [2/2]

◆ modifyBitsIthruJ()

◆ add_sat()

◆ sub_sat()

◆ saturate_cast()

◆ assign_sat()

◆ accum_sat()

◆ reduce_sat()

◆ operator==() [1/2]

◆ operator==() [2/2]

◆ indexOrNull()

◆ indexOrDefault()

◆ insert()

◆ extract()

Variable Documentation

◆ DYNAMIC_EXTENT