#include <nullable.hpp>

Collaboration diagram for sparrow::nullable< T, B >:

Public Types
using	stored_value_type = T
using	self_type = nullable<T, B>
using	value_traits = nullable_traits<T>
using	value_type = typename value_traits::value_type
using	reference = typename value_traits::reference
using	const_reference = typename value_traits::const_reference
using	rvalue_reference = typename value_traits::rvalue_reference
using	const_rvalue_reference = typename value_traits::const_rvalue_reference
using	flag_traits = nullable_traits<B>
using	flag_type = typename flag_traits::value_type
using	flag_reference = typename flag_traits::reference
using	flag_const_reference = typename flag_traits::const_reference
using	flag_rvalue_reference = typename flag_traits::rvalue_reference
using	flag_const_rvalue_reference = typename flag_traits::const_rvalue_reference

Public Member Functions
template<std::default_initializable U = T, std::default_initializable BB = B>
constexpr	nullable () noexcept
	Default constructor creating a null nullable.
template<std::default_initializable U = T, std::default_initializable BB = B>
constexpr	nullable (nullval_t) noexcept
	Constructor from nullval_t creating a null nullable.
template<class U> requires (not std::same_as<self_type, std::decay_t<U>> and std::constructible_from<T, U &&>)
	explicit (not std::convertible_to< U &&, T >) const expr nullable(U &&value) noexcept(noexcept(T(std::declval< U >())))
	Constructor from a value creating a non-null nullable.
constexpr	nullable (const self_type &rhs)=default
	Default copy constructor.
template<class TO, mpl::boolean_like BO> requires (impl::both_constructible_from_cref<T, TO, B, BO> and not impl::initializable_from_refs<T, nullable<TO, BO>>)
	explicit (not impl::both_convertible_from_cref< T, TO, B, BO >) SPARROW_CONSTEXPR nullable(const nullable< TO
	Converting copy constructor from different nullable types.
BO	m_null_flag (rhs.null_flag())
constexpr	nullable (self_type &&rhs) noexcept=default
	Default move constructor.
template<class TO, mpl::boolean_like BO> requires (impl::both_constructible_from_cond_ref<T, TO, B, BO> and not impl::initializable_from_refs<T, nullable<TO, BO>>)
	explicit (not impl::both_convertible_from_cond_ref< T, TO, B, BO >) SPARROW_CONSTEXPR nullable(nullable< TO
	Converting move constructor from different nullable types.
BO	m_null_flag (std::move(rhs).null_flag())
constexpr	nullable (value_type &&value, flag_type &&null_flag)
	Constructor from value and flag.
constexpr	nullable (std::add_lvalue_reference_t< T > value, std::add_lvalue_reference_t< B > null_flag)
	Constructor from lvalue references (for reference semantics).
constexpr	nullable (value_type &&value, std::add_lvalue_reference_t< B > null_flag)
	Constructor from moved value and flag reference.
constexpr	nullable (std::add_lvalue_reference_t< T > value, flag_type &&null_flag)
	Constructor from value reference and moved flag.
template<class U, class V> requires (std::same_as<std::remove_cvref_t<U>, T> && std::same_as<std::remove_cvref_t<V>, B> && std::is_const_v <std::remove_reference_t<U>> && not std::is_const_v<std::remove_reference_t<V>> && not std::is_reference_v<T> && not std::is_reference_v<B> && std::is_lvalue_reference_v<U &&> && std::is_lvalue_reference_v<V &&>)
constexpr	nullable (U &value, V &null_flag)
	Constructor from const value and non-const flag reference (for non-reference types only).
template<class U, class V> requires (std::same_as<std::remove_cvref_t<U>, T> && std::same_as<std::remove_cvref_t<V>, B> && not std::is_reference_v<T> && not std::is_reference_v<B> && (std::is_const_v<std::remove_reference_t<U>> \|\| std::is_const_v<std::remove_reference_t<V>>) )
constexpr	nullable (U &&value, V &&null_flag)
	Constructor from two forwarding references (for value types with const qualifiers).
constexpr self_type &	operator= (nullval_t) noexcept
	Assignment from nullval_t, setting nullable to null state.
template<class TO> requires (not std::same_as<self_type, TO> and std::assignable_from<std::add_lvalue_reference_t<T>, TO>)
constexpr self_type &	operator= (TO &&rhs) noexcept(std::is_nothrow_assignable_v< std::add_lvalue_reference_t< T >, TO > &&std::is_nothrow_assignable_v< std::add_lvalue_reference_t< B >, bool >)
	Assignment from a value, setting nullable to non-null state.
constexpr self_type &	operator= (const self_type &rhs) noexcept(std::is_nothrow_assignable_v< std::add_lvalue_reference_t< T >, const_reference > &&std::is_nothrow_assignable_v< std::add_lvalue_reference_t< B >, flag_const_reference >)
	Default copy assignment operator.
template<class TO, mpl::boolean_like BO> requires ( impl::both_assignable_from_cref<T, TO, B, BO> and not impl::initializable_from_refs<T, nullable<TO, BO>> and not impl::assignable_from_refs<T, nullable<TO, BO>> )
constexpr self_type &	operator= (const nullable< TO, BO > &rhs) noexcept(std::is_nothrow_assignable_v< std::add_lvalue_reference_t< T >, typename nullable< TO, BO >::const_reference > &&std::is_nothrow_assignable_v< std::add_lvalue_reference_t< B >, typename nullable< TO, BO >::flag_const_reference >)
	Converting assignment operator from different nullable types.
constexpr self_type &	operator= (self_type &&rhs) noexcept(std::is_nothrow_assignable_v< std::add_lvalue_reference_t< T >, rvalue_reference > &&std::is_nothrow_assignable_v< std::add_lvalue_reference_t< B >, flag_rvalue_reference >)
	Default move assignment operator.
template<class TO, mpl::boolean_like BO> requires ( impl::both_assignable_from_cond_ref<T, TO, B, BO> and not impl::initializable_from_refs<T, nullable<TO, BO>> and not impl::assignable_from_refs<T, nullable<TO, BO>> )
constexpr self_type &	operator= (nullable< TO, BO > &&rhs) noexcept(std::is_nothrow_assignable_v< std::add_lvalue_reference_t< T >, typename nullable< TO, BO >::rvalue_reference > &&std::is_nothrow_assignable_v< std::add_lvalue_reference_t< B >, typename nullable< TO, BO >::flag_rvalue_reference >)
	Converting move assignment operator from different nullable types.
constexpr	operator bool () const noexcept
	Conversion to bool indicating non-null state.
constexpr bool	has_value () const noexcept
	Checks whether the nullable contains a valid value.
constexpr flag_reference	null_flag () &noexcept
	Gets mutable reference to the validity flag.
constexpr flag_const_reference	null_flag () const &noexcept
	Gets const reference to the validity flag.
constexpr flag_rvalue_reference	null_flag () &&noexcept
	Gets rvalue reference to the validity flag.
constexpr flag_const_rvalue_reference	null_flag () const &&noexcept
	Gets const rvalue reference to the validity flag.
constexpr reference	get () &noexcept
	Gets mutable reference to the stored value.
constexpr const_reference	get () const &noexcept
	Gets const reference to the stored value.
constexpr rvalue_reference	get () &&noexcept
	Gets rvalue reference to the stored value.
constexpr const_rvalue_reference	get () const &&noexcept
	Gets const rvalue reference to the stored value.
constexpr reference	value () &
	Gets mutable reference to the value with null checking.
constexpr const_reference	value () const &
	Gets const reference to the value with null checking.
constexpr rvalue_reference	value () &&
	Gets rvalue reference to the value with null checking.
constexpr const_rvalue_reference	value () const &&
	Gets const rvalue reference to the value with null checking.
template<class U>
constexpr value_type	value_or (U &&default_value) const &
	Gets the value or a default if null (const version).
template<class U>
constexpr value_type	value_or (U &&default_value) &&
	Gets the value or a default if null (rvalue version).
void	swap (self_type &other) noexcept
	Swaps this nullable with another.
void	reset () noexcept
	Resets the nullable to null state.
template<class U>
constexpr auto	value_or (U &&default_value) const &-> value_type
template<class U>
constexpr auto	value_or (U &&default_value) &&-> value_type

Public Attributes
BO &	rhs: m_value(rhs.get())
BO &&	rhs: m_value(std::move(rhs).get())

Friends
template<class TO, mpl::boolean_like BO>
class	nullable

Detailed Description

template<class T, mpl::boolean_like B = bool>
class sparrow::nullable< T, B >

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 395 of file nullable.hpp.

Member Typedef Documentation

◆ const_reference

template<class T, mpl::boolean_like B = bool>

using sparrow::nullable< T, B >::const_reference = typename value_traits::const_reference

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 404 of file nullable.hpp.

◆ const_rvalue_reference

template<class T, mpl::boolean_like B = bool>

using sparrow::nullable< T, B >::const_rvalue_reference = typename value_traits::const_rvalue_reference

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 406 of file nullable.hpp.

◆ flag_const_reference

template<class T, mpl::boolean_like B = bool>

using sparrow::nullable< T, B >::flag_const_reference = typename flag_traits::const_reference

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 410 of file nullable.hpp.

◆ flag_const_rvalue_reference

template<class T, mpl::boolean_like B = bool>

using sparrow::nullable< T, B >::flag_const_rvalue_reference = typename flag_traits::const_rvalue_reference

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 412 of file nullable.hpp.

◆ flag_reference

template<class T, mpl::boolean_like B = bool>

using sparrow::nullable< T, B >::flag_reference = typename flag_traits::reference

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 409 of file nullable.hpp.

◆ flag_rvalue_reference

template<class T, mpl::boolean_like B = bool>

using sparrow::nullable< T, B >::flag_rvalue_reference = typename flag_traits::rvalue_reference

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 411 of file nullable.hpp.

◆ flag_traits

template<class T, mpl::boolean_like B = bool>

using sparrow::nullable< T, B >::flag_traits = nullable_traits

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 407 of file nullable.hpp.

◆ flag_type

template<class T, mpl::boolean_like B = bool>

using sparrow::nullable< T, B >::flag_type = typename flag_traits::value_type

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 408 of file nullable.hpp.

◆ reference

template<class T, mpl::boolean_like B = bool>

using sparrow::nullable< T, B >::reference = typename value_traits::reference

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 403 of file nullable.hpp.

◆ rvalue_reference

template<class T, mpl::boolean_like B = bool>

using sparrow::nullable< T, B >::rvalue_reference = typename value_traits::rvalue_reference

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 405 of file nullable.hpp.

◆ self_type

template<class T, mpl::boolean_like B = bool>

using sparrow::nullable< T, B >::self_type = nullable<T, B>

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 400 of file nullable.hpp.

◆ stored_value_type

template<class T, mpl::boolean_like B = bool>

using sparrow::nullable< T, B >::stored_value_type = T

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 399 of file nullable.hpp.

◆ value_traits

template<class T, mpl::boolean_like B = bool>

using sparrow::nullable< T, B >::value_traits = nullable_traits<T>

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 401 of file nullable.hpp.

◆ value_type

template<class T, mpl::boolean_like B = bool>

using sparrow::nullable< T, B >::value_type = typename value_traits::value_type

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 402 of file nullable.hpp.

Constructor & Destructor Documentation

◆ nullable() [1/10]

template<class T, mpl::boolean_like B = bool>

template<std::default_initializable U = T, std::default_initializable BB = B>

sparrow::nullable< T, B >::nullable ( )

inlineconstexprnoexcept

Default constructor creating a null nullable.

Template Parameters

U	Value type (deduced, must be default constructible)
BB	Flag type (deduced, must be default constructible)

Precondition: T and B must be default constructible

Postcondition: has_value() returns false; get() returns default-constructed value; null_flag() returns false

Definition at line 426 of file nullable.hpp.

◆ nullable() [2/10]

template<class T, mpl::boolean_like B = bool>

template<std::default_initializable U = T, std::default_initializable BB = B>

sparrow::nullable< T, B >::nullable ( nullval_t )

inlineconstexprnoexcept

Constructor from nullval_t creating a null nullable.

Template Parameters

U	Value type (deduced, must be default constructible)
BB	Flag type (deduced, must be default constructible)

Precondition: T and B must be default constructible

Postcondition: has_value() returns false; get() returns default-constructed value; null_flag() returns false

Definition at line 444 of file nullable.hpp.

◆ nullable() [3/10]

template<class T, mpl::boolean_like B = bool>

sparrow::nullable< T, B >::nullable ( const self_type & rhs )

constexprdefault

Default copy constructor.

Parameters

rhs	Source nullable to copy from

Precondition: rhs must be in a valid state

Postcondition: This nullable is an exact copy of rhs; has_value() equals rhs.has_value(); If non-null, get() equals rhs.get()

◆ nullable() [4/10]

template<class T, mpl::boolean_like B = bool>

sparrow::nullable< T, B >::nullable ( self_type && rhs )

constexprdefaultnoexcept

Default move constructor.

Parameters

rhs	Source nullable to move from

Precondition: rhs must be in a valid state

Postcondition: This nullable is an exact copy of rhs; has_value() equals rhs.has_value(); If non-null, get() equals rhs.get()

◆ nullable() [5/10]

template<class T, mpl::boolean_like B = bool>

sparrow::nullable< T, B >::nullable	(	value_type &&	value,
		flag_type &&	null_flag )

inlineconstexpr

Constructor from value and flag.

Parameters

value	Value to move and store
null_flag	Flag to move and store

Postcondition: get() returns the moved value; null_flag() returns the moved flag; Original value and flag are moved from

Definition at line 622 of file nullable.hpp.

◆ nullable() [6/10]

template<class T, mpl::boolean_like B = bool>

sparrow::nullable< T, B >::nullable	(	std::add_lvalue_reference_t< T >	value,
		std::add_lvalue_reference_t< B >	null_flag )

inlineconstexpr

Constructor from lvalue references (for reference semantics).

Parameters

value	Reference to value to store
null_flag	Reference to flag to store

Postcondition: get() refers to the provided value reference; null_flag() refers to the provided flag reference; Changes to the nullable affect the referenced objects

Definition at line 638 of file nullable.hpp.

◆ nullable() [7/10]

template<class T, mpl::boolean_like B = bool>

sparrow::nullable< T, B >::nullable	(	value_type &&	value,
		std::add_lvalue_reference_t< B >	null_flag )

inlineconstexpr

Constructor from moved value and flag reference.

Parameters

value	Value to move and store
null_flag	Reference to flag to store

Postcondition: get() returns the moved value; null_flag() refers to the provided flag reference

Definition at line 653 of file nullable.hpp.

◆ nullable() [8/10]

template<class T, mpl::boolean_like B = bool>

sparrow::nullable< T, B >::nullable	(	std::add_lvalue_reference_t< T >	value,
		flag_type &&	null_flag )

inlineconstexpr

Constructor from value reference and moved flag.

Parameters

value	Reference to value to store
null_flag	Flag to move and store

Postcondition: get() refers to the provided value reference; null_flag() returns the moved flag

Definition at line 668 of file nullable.hpp.

◆ nullable() [9/10]

template<class T, mpl::boolean_like B = bool>

template<class U, class V>
requires (std::same_as<std::remove_cvref_t, T> && std::same_as<std::remove_cvref_t<V>, B> && std::is_const_v
<std::remove_reference_t> && not std::is_const_v<std::remove_reference_t<V>> && not std::is_reference_v<T> && not
std::is_reference_v && std::is_lvalue_reference_v && std::is_lvalue_reference_v<V &&>)

sparrow::nullable< T, B >::nullable	(	U &	value,
		V &	null_flag )

inlineconstexpr

Constructor from const value and non-const flag reference (for non-reference types only).

Parameters

value	Const reference to value to store
null_flag	Reference to flag to store

Postcondition: get() refers to the provided value reference; null_flag() refers to the provided flag reference

Definition at line 689 of file nullable.hpp.

◆ nullable() [10/10]

template<class T, mpl::boolean_like B = bool>

template<class U, class V>
requires (std::same_as<std::remove_cvref_t, T> && std::same_as<std::remove_cvref_t<V>, B> && not std::is_reference_v<T> && not
std::is_reference_v && (std::is_const_v<std::remove_reference_t> || std::is_const_v<std::remove_reference_t<V>>) )

sparrow::nullable< T, B >::nullable	(	U &&	value,
		V &&	null_flag )

inlineconstexpr

Constructor from two forwarding references (for value types with const qualifiers).

This handles the special case where values are passed with const qualifiers that don't match T and B exactly. Occurs with arrays like bool8_array where inner_const_reference is bool but dereferencing returns const-qualified values.

Parameters

value	Value to forward and store
null_flag	Flag to forward and store

Postcondition: get() returns the stored value; null_flag() returns the stored flag

Definition at line 713 of file nullable.hpp.

Member Function Documentation

◆ explicit() [1/3]

template<class T, mpl::boolean_like B = bool>

template<class TO, mpl::boolean_like BO>
requires (impl::both_constructible_from_cond_ref<T, TO, B, BO> and not impl::initializable_from_refs<T, nullable<TO, BO>>)

sparrow::nullable< T, B >::explicit ( not impl::both_convertible_from_cond_ref< T, TO, B, BO > )

Converting move constructor from different nullable types.

Template Parameters

TO	Source value type
BO	Source flag type

Parameters

rhs	Source nullable to move from

Precondition: T must be constructible from TO; B must be constructible from BO; TO must not be initializable from this nullable type (prevents ambiguity)

Postcondition: This nullable contains converted moves of rhs value and flag; has_value() equals rhs.has_value(); If non-null, get() is constructed from std::move(rhs).get()

◆ explicit() [2/3]

template<class T, mpl::boolean_like B = bool>

template<class TO, mpl::boolean_like BO>
requires (impl::both_constructible_from_cref<T, TO, B, BO> and not impl::initializable_from_refs<T, nullable<TO, BO>>)

sparrow::nullable< T, B >::explicit ( not impl::both_convertible_from_cref< T, TO, B, BO > ) const

Converting copy constructor from different nullable types.

Template Parameters

TO	Source value type
BO	Source flag type

Parameters

rhs	Source nullable to copy from

Precondition: T must be constructible from TO; B must be constructible from BO; TO must not be initializable from this nullable type (prevents ambiguity)

Postcondition: This nullable contains converted copies of rhs value and flag; has_value() equals rhs.has_value(); If non-null, get() is constructed from rhs.get()

◆ explicit() [3/3]

template<class T, mpl::boolean_like B = bool>

template<class U>
requires (not std::same_as<self_type, std::decay_t> and std::constructible_from<T, U &&>)

sparrow::nullable< T, B >::explicit ( not std::convertible_to ) const &&

inlinenoexcept

Constructor from a value creating a non-null nullable.

Template Parameters

U	Type of the input value (must be constructible to T)

Parameters

value Value to store

Precondition: U must be constructible to T; U must not be the same type as nullable (to avoid recursion)

Postcondition: has_value() returns true; get() returns the constructed value; null_flag() returns true

Definition at line 464 of file nullable.hpp.

◆ get() [1/4]

template<class T, mpl::boolean_like B>

auto sparrow::nullable< T, B >::get ( ) &&

nodiscardconstexprnoexcept

Gets rvalue reference to the stored value.

Returns: Rvalue reference to the value

Postcondition: If value is a reference type, returns the reference; If value is a value type, returns moved value

Definition at line 1436 of file nullable.hpp.

◆ get() [2/4]

template<class T, mpl::boolean_like B>

auto sparrow::nullable< T, B >::get ( ) &

nodiscardconstexprnoexcept

Gets mutable reference to the stored value.

Returns: Mutable reference to the value

Postcondition: Returned reference provides access to the stored value; Value is accessible regardless of null state; Modifications through reference affect stored value

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 1424 of file nullable.hpp.

Here is the caller graph for this function:

◆ get() [3/4]

template<class T, mpl::boolean_like B>

auto sparrow::nullable< T, B >::get ( ) const &&

nodiscardconstexprnoexcept

Gets const rvalue reference to the stored value.

Returns: Const rvalue reference to the value

Postcondition: If value is a reference type, returns the reference; If value is a value type, returns moved const value

Definition at line 1449 of file nullable.hpp.

◆ get() [4/4]

template<class T, mpl::boolean_like B>

auto sparrow::nullable< T, B >::get ( ) const &

nodiscardconstexprnoexcept

Gets const reference to the stored value.

Returns: Const reference to the value

Postcondition: Returned reference provides read-only access to stored value; Value is accessible regardless of null state

Definition at line 1430 of file nullable.hpp.

◆ has_value()

template<class T, mpl::boolean_like B>

bool sparrow::nullable< T, B >::has_value ( ) const

nodiscardconstexprnoexcept

Checks whether the nullable contains a valid value.

Returns: true if nullable contains a valid value, false if null

Postcondition: Return value equals static_cast<bool>(*this); Return value equals static_cast<bool>(null_flag())

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 1380 of file nullable.hpp.

Here is the caller graph for this function:

◆ m_null_flag() [1/2]

template<class T, mpl::boolean_like B = bool>

BO sparrow::nullable< T, B >::m_null_flag ( rhs. null_flag() )

inline

Definition at line 505 of file nullable.hpp.

◆ m_null_flag() [2/2]

template<class T, mpl::boolean_like B = bool>

BO sparrow::nullable< T, B >::m_null_flag ( std::move(rhs).null_flag() )

inline

Definition at line 574 of file nullable.hpp.

◆ null_flag() [1/4]

template<class T, mpl::boolean_like B>

auto sparrow::nullable< T, B >::null_flag ( ) &&

nodiscardconstexprnoexcept

Gets rvalue reference to the validity flag.

Returns: Rvalue reference to the flag

Postcondition: If flag is a reference type, returns the reference; If flag is a value type, returns moved flag

Definition at line 1398 of file nullable.hpp.

◆ null_flag() [2/4]

template<class T, mpl::boolean_like B>

auto sparrow::nullable< T, B >::null_flag ( ) &

nodiscardconstexprnoexcept

Gets mutable reference to the validity flag.

Returns: Mutable reference to the flag

Postcondition: Returned reference can be used to modify the null state; Changes to the flag affect has_value() result

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 1386 of file nullable.hpp.

Here is the caller graph for this function:

◆ null_flag() [3/4]

template<class T, mpl::boolean_like B>

auto sparrow::nullable< T, B >::null_flag ( ) const &&

nodiscardconstexprnoexcept

Gets const rvalue reference to the validity flag.

Returns: Const rvalue reference to the flag

Postcondition: If flag is a reference type, returns the reference; If flag is a value type, returns moved const flag

Definition at line 1411 of file nullable.hpp.

◆ null_flag() [4/4]

template<class T, mpl::boolean_like B>

auto sparrow::nullable< T, B >::null_flag ( ) const &

nodiscardconstexprnoexcept

Gets const reference to the validity flag.

Returns: Const reference to the flag

Postcondition: Returned reference reflects current null state

Definition at line 1392 of file nullable.hpp.

◆ operator bool()

template<class T, mpl::boolean_like B>

sparrow::nullable< T, B >::operator bool ( ) const

explicitconstexprnoexcept

Conversion to bool indicating non-null state.

Returns: true if nullable contains a valid value, false if null

Postcondition: Return value equals has_value(); Return value equals static_cast<bool>(null_flag())

Definition at line 1374 of file nullable.hpp.

Here is the call graph for this function:

◆ operator=() [1/6]

template<class T, mpl::boolean_like B = bool>

template<class TO, mpl::boolean_like BO>
requires ( impl::both_assignable_from_cref<T, TO, B, BO> and not impl::initializable_from_refs<T, nullable<TO, BO>> and not
impl::assignable_from_refs<T, nullable<TO, BO>> )

self_type & sparrow::nullable< T, B >::operator= ( const nullable< TO, BO > & rhs )

inlineconstexprnoexcept

Converting assignment operator from different nullable types.

Template Parameters

TO	Source value type
BO	Source flag type

Parameters

rhs	Source nullable to copy from

Returns: Reference to this nullable

Precondition: T must be constructible from TO; B must be constructible from BO; TO must not be initializable from this nullable type (prevents ambiguity)

Postcondition: This nullable contains converted copies of rhs value and flag; has_value() equals rhs.has_value(); If non-null, get() is constructed from rhs.get()

Definition at line 802 of file nullable.hpp.

◆ operator=() [2/6]

template<class T, mpl::boolean_like B = bool>

self_type & sparrow::nullable< T, B >::operator= ( const self_type & rhs )

inlineconstexprnoexcept

Default copy assignment operator.

Parameters

rhs	Source nullable to copy from

Returns: Reference to this nullable

Precondition: rhs must be in a valid state

Postcondition: This nullable is an exact copy of rhs; has_value() equals rhs.has_value(); get() is assigned from rhs.get()

Definition at line 771 of file nullable.hpp.

◆ operator=() [3/6]

template<class T, mpl::boolean_like B = bool>

template<class TO, mpl::boolean_like BO>
requires ( impl::both_assignable_from_cond_ref<T, TO, B, BO> and not impl::initializable_from_refs<T, nullable<TO, BO>> and not
impl::assignable_from_refs<T, nullable<TO, BO>> )

self_type & sparrow::nullable< T, B >::operator= ( nullable< TO, BO > && rhs )

inlineconstexprnoexcept

Converting move assignment operator from different nullable types.

Template Parameters

TO	Source value type
BO	Source flag type

Parameters

rhs	Source nullable to move from

Returns: Reference to this nullable

Precondition: T must be constructible from TO; B must be constructible from BO; TO must not be initializable from this nullable type (prevents ambiguity)

Postcondition: This nullable contains converted moves of rhs value and flag; has_value() equals rhs.has_value(); If non-null, get() is constructed from std::move(rhs).get()

Definition at line 854 of file nullable.hpp.

◆ operator=() [4/6]

template<class T, mpl::boolean_like B = bool>

self_type & sparrow::nullable< T, B >::operator= ( nullval_t )

inlineconstexprnoexcept

Assignment from nullval_t, setting nullable to null state.

Parameters

nullval_t nullval sentinel value

Returns: Reference to this nullable

Postcondition: has_value() returns false; null_flag() returns false; get() remains accessible but semantically invalid

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 729 of file nullable.hpp.

◆ operator=() [5/6]

template<class T, mpl::boolean_like B = bool>

self_type & sparrow::nullable< T, B >::operator= ( self_type && rhs )

inlineconstexprnoexcept

Default move assignment operator.

Parameters

rhs	Source nullable to move from

Returns: Reference to this nullable

Precondition: rhs must be in a valid state

Postcondition: This nullable is an exact copy of rhs; has_value() equals rhs.has_value(); get() is assigned from std::move(rhs).get()

Definition at line 823 of file nullable.hpp.

◆ operator=() [6/6]

template<class T, mpl::boolean_like B = bool>

template<class TO>
requires (not std::same_as<self_type, TO> and std::assignable_from<std::add_lvalue_reference_t<T>, TO>)

self_type & sparrow::nullable< T, B >::operator= ( TO && rhs )

inlineconstexprnoexcept

Assignment from a value, setting nullable to non-null state.

Template Parameters

TO	Type of the assigned value

Parameters

rhs	Value to assign

Returns: Reference to this nullable

Precondition: TO must not be the same as nullable type; TO must be assignable to T

Postcondition: has_value() returns true; get() contains the assigned value; null_flag() returns true

Definition at line 750 of file nullable.hpp.

◆ reset()

template<class T, mpl::boolean_like B>

void sparrow::nullable< T, B >::reset ( )

noexcept

Resets the nullable to null state.

Postcondition: has_value() returns false; null_flag() returns false; get() remains accessible but semantically invalid

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 1512 of file nullable.hpp.

◆ swap()

template<class T, mpl::boolean_like B>

void sparrow::nullable< T, B >::swap ( self_type & other )

noexcept

Swaps this nullable with another.

Parameters

other Nullable to swap with

Postcondition: This nullable contains other's previous value and flag; other contains this nullable's previous value and flag

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 1504 of file nullable.hpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ value() [1/4]

template<class T, mpl::boolean_like B>

auto sparrow::nullable< T, B >::value ( ) &

nodiscardconstexpr

Gets mutable reference to the value with null checking.

Returns: Mutable reference to the value

Precondition: has_value() must be true

Postcondition: Returns reference to the stored value

Exceptions

bad_nullable_access if has_value() is false

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 1462 of file nullable.hpp.

Here is the call graph for this function:

◆ value() [2/4]

template<class T, mpl::boolean_like B>

auto sparrow::nullable< T, B >::value ( ) &&

nodiscardconstexpr

Gets rvalue reference to the value with null checking.

Returns: Rvalue reference to the value

Precondition: has_value() must be true

Postcondition: Returns rvalue reference to the stored value; If value type, original value is moved from

Exceptions

bad_nullable_access if has_value() is false

Definition at line 1476 of file nullable.hpp.

◆ value() [3/4]

template<class T, mpl::boolean_like B>

auto sparrow::nullable< T, B >::value ( ) const &

nodiscardconstexpr

Gets const reference to the value with null checking.

Returns: Const reference to the value

Precondition: has_value() must be true

Postcondition: Returns const reference to the stored value

Exceptions

bad_nullable_access if has_value() is false

Definition at line 1469 of file nullable.hpp.

Here is the call graph for this function:

◆ value() [4/4]

template<class T, mpl::boolean_like B>

auto sparrow::nullable< T, B >::value ( ) const &&

nodiscardconstexpr

Gets const rvalue reference to the value with null checking.

Returns: Const rvalue reference to the value

Precondition: has_value() must be true

Postcondition: Returns const rvalue reference to the stored value

Exceptions

bad_nullable_access if has_value() is false

Definition at line 1483 of file nullable.hpp.

◆ value_or() [1/4]

template<class T, mpl::boolean_like B = bool>

template<class U>

value_type sparrow::nullable< T, B >::value_or ( U && default_value ) &&

nodiscardconstexpr

Gets the value or a default if null (rvalue version).

Template Parameters

U	Type of the default value

Parameters

default_value Value to return if nullable is null

Returns: Moved stored value if non-null, otherwise default_value

Precondition: U must be convertible to value_type

Postcondition: If has_value() is true, returns moved stored value; If has_value() is false, returns converted default_value

◆ value_or() [2/4]

template<class T, mpl::boolean_like B = bool>

template<class U>

auto sparrow::nullable< T, B >::value_or ( U && default_value ) && -> value_type

constexpr

Definition at line 1498 of file nullable.hpp.

◆ value_or() [3/4]

template<class T, mpl::boolean_like B = bool>

template<class U>

value_type sparrow::nullable< T, B >::value_or ( U && default_value ) const &

nodiscardconstexpr

Gets the value or a default if null (const version).

Template Parameters

U	Type of the default value

Parameters

default_value Value to return if nullable is null

Returns: Stored value if non-null, otherwise default_value

Precondition: U must be convertible to value_type

Postcondition: If has_value() is true, returns copy of stored value; If has_value() is false, returns converted default_value

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

◆ value_or() [4/4]

template<class T, mpl::boolean_like B = bool>

template<class U>

auto sparrow::nullable< T, B >::value_or ( U && default_value ) const & -> value_type

constexpr

Definition at line 1491 of file nullable.hpp.

◆ nullable

template<class T, mpl::boolean_like B = bool>

template<class TO, mpl::boolean_like BO>

friend class nullable

friend

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 1073 of file nullable.hpp.

Member Data Documentation

◆ rhs [1/2]

template<class T, mpl::boolean_like B = bool>

BO&& sparrow::nullable< T, B >::rhs

Definition at line 571 of file nullable.hpp.

◆ rhs [2/2]

template<class T, mpl::boolean_like B = bool>

BO& sparrow::nullable< T, B >::rhs

Examples: /home/runner/work/sparrow/sparrow/include/sparrow/utils/nullable.hpp.

Definition at line 502 of file nullable.hpp.

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

sparrow/utils/nullable.hpp

Public Types

Public Member Functions

Public Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ const_reference

◆ const_rvalue_reference

◆ flag_const_reference

◆ flag_const_rvalue_reference

◆ flag_reference

◆ flag_rvalue_reference

◆ flag_traits

◆ flag_type

◆ reference

◆ rvalue_reference

◆ self_type

◆ stored_value_type

◆ value_traits

◆ value_type

Constructor & Destructor Documentation

◆ nullable() [1/10]

◆ nullable() [2/10]

◆ nullable() [3/10]

◆ nullable() [4/10]

◆ nullable() [5/10]

◆ nullable() [6/10]

◆ nullable() [7/10]

◆ nullable() [8/10]

◆ nullable() [9/10]

◆ nullable() [10/10]

Member Function Documentation

◆ explicit() [1/3]

◆ explicit() [2/3]

◆ explicit() [3/3]

◆ get() [1/4]

◆ get() [2/4]

◆ get() [3/4]

◆ get() [4/4]

◆ has_value()

◆ m_null_flag() [1/2]

◆ m_null_flag() [2/2]

◆ null_flag() [1/4]

◆ null_flag() [2/4]

◆ null_flag() [3/4]

◆ null_flag() [4/4]

◆ operator bool()

◆ operator=() [1/6]

◆ operator=() [2/6]

◆ operator=() [3/6]

◆ operator=() [4/6]

◆ operator=() [5/6]

◆ operator=() [6/6]

◆ reset()

◆ swap()

◆ value() [1/4]

◆ value() [2/4]

◆ value() [3/4]

◆ value() [4/4]

◆ value_or() [1/4]

◆ value_or() [2/4]

◆ value_or() [3/4]

◆ value_or() [4/4]

Friends And Related Symbol Documentation

◆ nullable

Member Data Documentation

◆ rhs [1/2]

◆ rhs [2/2]