Represents a value that can be any of the supported SQL data types. More...

#include <SqlVariant.hpp>

Public Types
using	InnerType = std::variant< SqlNullType, SqlGuid, bool, int8_t, short, unsigned short, int, unsigned int, long long, unsigned long long, float, double, std::string, std::string_view, std::u16string, std::u16string_view, SqlText, SqlDate, SqlTime, SqlDateTime >
	The inner type of the variant.

Public Member Functions
	SqlVariant ()=default
	Default construct a new SqlVariant.

	SqlVariant (SqlVariant const &)=default
	Copy construct a new SqlVariant from another.

	SqlVariant (SqlVariant &&) noexcept=default
	Move construct a new SqlVariant from another.

SqlVariant &	operator= (SqlVariant const &)=default
	Copy assign a new SqlVariant from another.

SqlVariant &	operator= (SqlVariant &&) noexcept=default
	Move assign a new SqlVariant from another.

	~SqlVariant ()=default
	Destructor for SqlVariant.

LIGHTWEIGHT_FORCE_INLINE	SqlVariant (InnerType const &other)
	Copy constructor of a SqlVariant from one of the supported types.

LIGHTWEIGHT_FORCE_INLINE	SqlVariant (InnerType &&other) noexcept
	Move constructor of a SqlVariant from one of the supported types.

template<std::size_t N, typename T = char, SqlFixedStringMode Mode>
constexpr LIGHTWEIGHT_FORCE_INLINE	SqlVariant (SqlFixedString< N, T, Mode > const &other)
	Construct a new SqlVariant from a SqlFixedString.

template<std::size_t TextSize>
constexpr LIGHTWEIGHT_FORCE_INLINE	SqlVariant (char const (&text)[TextSize])
	Copy constructor of a SqlVariant from a char array.

template<std::size_t TextSize>
constexpr LIGHTWEIGHT_FORCE_INLINE	SqlVariant (char16_t const (&text)[TextSize])
	Copy constructor of a SqlVariant from a char16_t array.

template<typename T >
LIGHTWEIGHT_FORCE_INLINE	SqlVariant (std::optional< T > const &other)
	Copy constructor of a SqlVariant from an optional of one of the supported types.

LIGHTWEIGHT_FORCE_INLINE SqlVariant &	operator= (InnerType const &other)
	Assignment operator of a SqlVariant from one of the supported types.

LIGHTWEIGHT_FORCE_INLINE SqlVariant &	operator= (InnerType &&other) noexcept
	Assignment operator of a SqlVariant from one of the supported types.

template<detail::HasSqlViewHelper StringViewLike>
LIGHTWEIGHT_FORCE_INLINE	SqlVariant (StringViewLike const *newValue)
	Construct from an string-like object that implements an SqlViewHelper<>.

template<detail::HasSqlViewHelper StringViewLike>
LIGHTWEIGHT_FORCE_INLINE SqlVariant &	operator= (StringViewLike const *newValue) noexcept
	Assign from an string-like object that implements an SqlViewHelper<>.

LIGHTWEIGHT_FORCE_INLINE bool	IsNull () const noexcept
	Check if the value is NULL.

template<typename T >
LIGHTWEIGHT_FORCE_INLINE bool	Is () const noexcept
	Check if the value is of the specified type.

template<typename T >
LIGHTWEIGHT_FORCE_INLINE decltype(auto)	Get () noexcept
	Retrieve the value as the specified type.

template<typename T >
LIGHTWEIGHT_FORCE_INLINE T	ValueOr (T &&defaultValue) const noexcept
	Retrieve the value as the specified type, or return the default value if the value is NULL.

LIGHTWEIGHT_FORCE_INLINE std::optional< bool >	TryGetBool () const noexcept
	Retrieve the bool from the variant or std::nullopt.

LIGHTWEIGHT_FORCE_INLINE std::optional< int8_t >	TryGetInt8 () const noexcept
	Retrieve the int8_t from the variant or std::nullopt.

LIGHTWEIGHT_FORCE_INLINE std::optional< short >	TryGetShort () const noexcept
	Retrieve the unsigned short from the variant or std::nullopt.

LIGHTWEIGHT_FORCE_INLINE std::optional< unsigned short >	TryGetUShort () const noexcept
	Retrieve the unsigned short from the variant or std::nullopt.

LIGHTWEIGHT_FORCE_INLINE std::optional< int >	TryGetInt () const noexcept
	Retrieve the int from the variant or std::nullopt.

LIGHTWEIGHT_FORCE_INLINE std::optional< unsigned int >	TryGetUInt () const noexcept
	Retrieve the unsigned int from the variant or std::nullopt.

LIGHTWEIGHT_FORCE_INLINE std::optional< long long >	TryGetLongLong () const noexcept
	Retrieve the long long from the variant or std::nullopt.

LIGHTWEIGHT_FORCE_INLINE std::optional< unsigned long long >	TryGetULongLong () const noexcept
	Retrieve the unsigned long long from the variant or std::nullopt.

std::optional< std::string_view >	TryGetStringView () const noexcept
	function to get string_view from SqlVariant or std::nullopt

std::optional< std::u16string_view >	TryGetUtf16StringView () const noexcept

LIGHTWEIGHT_FORCE_INLINE std::optional< SqlDate >	TryGetDate () const
	function to get SqlDate from SqlVariant or std::nullopt

bool	operator== (SqlVariant const &other) const noexcept

bool	operator!= (SqlVariant const &other) const noexcept

LIGHTWEIGHT_FORCE_INLINE std::optional< SqlTime >	TryGetTime () const
	function to get SqlTime from SqlVariant or std::nullopt

LIGHTWEIGHT_FORCE_INLINE std::optional< SqlDateTime >	TryGetDateTime () const
	function to get SqlDateTime from SqlVariant or std::nullopt

LIGHTWEIGHT_FORCE_INLINE std::optional< SqlGuid >	TryGetGuid () const
	Retrieve the GUID from the variant or std::nullopt if the value is NULL.

LIGHTWEIGHT_API std::string	ToString () const
	Create string representation of the variant. Can be used for debug purposes.

Public Attributes
InnerType	value

Detailed Description

Represents a value that can be any of the supported SQL data types.

Use this class with care. Always prefer native types when possible, in order to avoid any unnecessary overhead.

Definition at line 42 of file SqlVariant.hpp.

Member Typedef Documentation

◆ InnerType

using SqlVariant::InnerType = std::variant<SqlNullType, SqlGuid, bool, int8_t, short, unsigned short, int, unsigned int, long long, unsigned long long, float, double, std::string, std::string_view, std::u16string, std::u16string_view, SqlText, SqlDate, SqlTime, SqlDateTime>

The inner type of the variant.

This type is a variant of all the supported SQL data types.

Definition at line 47 of file SqlVariant.hpp.

Constructor & Destructor Documentation

◆ SqlVariant() [1/7]

LIGHTWEIGHT_FORCE_INLINE SqlVariant::SqlVariant ( InnerType const & other )

inline

Copy constructor of a SqlVariant from one of the supported types.

Definition at line 84 of file SqlVariant.hpp.

◆ SqlVariant() [2/7]

LIGHTWEIGHT_FORCE_INLINE SqlVariant::SqlVariant ( InnerType && other )

inlinenoexcept

Move constructor of a SqlVariant from one of the supported types.

Definition at line 90 of file SqlVariant.hpp.

◆ SqlVariant() [3/7]

template<std::size_t N, typename T = char, SqlFixedStringMode Mode>

constexpr LIGHTWEIGHT_FORCE_INLINE SqlVariant::SqlVariant ( SqlFixedString< N, T, Mode > const & other )

inlineconstexpr

Construct a new SqlVariant from a SqlFixedString.

Definition at line 97 of file SqlVariant.hpp.

◆ SqlVariant() [4/7]

template<std::size_t TextSize>

constexpr LIGHTWEIGHT_FORCE_INLINE SqlVariant::SqlVariant ( char const (&) text[TextSize] )

inlineconstexpr

Copy constructor of a SqlVariant from a char array.

Definition at line 104 of file SqlVariant.hpp.

◆ SqlVariant() [5/7]

template<std::size_t TextSize>

constexpr LIGHTWEIGHT_FORCE_INLINE SqlVariant::SqlVariant ( char16_t const (&) text[TextSize] )

inlineconstexpr

Copy constructor of a SqlVariant from a char16_t array.

Definition at line 111 of file SqlVariant.hpp.

◆ SqlVariant() [6/7]

template<typename T >

LIGHTWEIGHT_FORCE_INLINE SqlVariant::SqlVariant ( std::optional< T > const & other )

inline

Copy constructor of a SqlVariant from an optional of one of the supported types.

Definition at line 118 of file SqlVariant.hpp.

◆ SqlVariant() [7/7]

template<detail::HasSqlViewHelper StringViewLike>

LIGHTWEIGHT_FORCE_INLINE SqlVariant::SqlVariant ( StringViewLike const * newValue )

inlineexplicit

Construct from an string-like object that implements an SqlViewHelper<>.

Definition at line 139 of file SqlVariant.hpp.

Member Function Documentation

◆ operator=() [1/3]

LIGHTWEIGHT_FORCE_INLINE SqlVariant & SqlVariant::operator= ( InnerType const & other )

inline

Assignment operator of a SqlVariant from one of the supported types.

Definition at line 124 of file SqlVariant.hpp.

◆ operator=() [2/3]

LIGHTWEIGHT_FORCE_INLINE SqlVariant & SqlVariant::operator= ( InnerType && other )

inlinenoexcept

Assignment operator of a SqlVariant from one of the supported types.

Definition at line 131 of file SqlVariant.hpp.

◆ operator=() [3/3]

template<detail::HasSqlViewHelper StringViewLike>

LIGHTWEIGHT_FORCE_INLINE SqlVariant & SqlVariant::operator= ( StringViewLike const * newValue )

inlinenoexcept

Assign from an string-like object that implements an SqlViewHelper<>.

Definition at line 146 of file SqlVariant.hpp.

◆ IsNull()

LIGHTWEIGHT_FORCE_INLINE bool SqlVariant::IsNull ( ) const

inlinenoexcept

Check if the value is NULL.

Definition at line 153 of file SqlVariant.hpp.

Referenced by Get(), TryGetDate(), TryGetDateTime(), TryGetGuid(), TryGetStringView(), TryGetTime(), and ValueOr().

◆ Is()

template<typename T >

LIGHTWEIGHT_FORCE_INLINE bool SqlVariant::Is ( ) const

inlinenoexcept

Check if the value is of the specified type.

Definition at line 160 of file SqlVariant.hpp.

◆ Get()

template<typename T >

LIGHTWEIGHT_FORCE_INLINE decltype(auto) SqlVariant::Get ( )

inlinenoexcept

Retrieve the value as the specified type.

Definition at line 167 of file SqlVariant.hpp.

References IsNull().

◆ ValueOr()

template<typename T >

LIGHTWEIGHT_FORCE_INLINE T SqlVariant::ValueOr ( T && defaultValue ) const

inlinenoexcept

Retrieve the value as the specified type, or return the default value if the value is NULL.

Definition at line 182 of file SqlVariant.hpp.

References IsNull().

◆ TryGetBool()

LIGHTWEIGHT_FORCE_INLINE std::optional< bool > SqlVariant::TryGetBool ( ) const

inlinenoexcept

Retrieve the bool from the variant or std::nullopt.

Definition at line 195 of file SqlVariant.hpp.

◆ TryGetInt8()

LIGHTWEIGHT_FORCE_INLINE std::optional< int8_t > SqlVariant::TryGetInt8 ( ) const

inlinenoexcept

Retrieve the int8_t from the variant or std::nullopt.

Definition at line 197 of file SqlVariant.hpp.

◆ TryGetShort()

LIGHTWEIGHT_FORCE_INLINE std::optional< short > SqlVariant::TryGetShort ( ) const

inlinenoexcept

Retrieve the unsigned short from the variant or std::nullopt.

Definition at line 199 of file SqlVariant.hpp.

◆ TryGetUShort()

LIGHTWEIGHT_FORCE_INLINE std::optional< unsigned short > SqlVariant::TryGetUShort ( ) const

inlinenoexcept

Retrieve the unsigned short from the variant or std::nullopt.

Definition at line 201 of file SqlVariant.hpp.

◆ TryGetInt()

LIGHTWEIGHT_FORCE_INLINE std::optional< int > SqlVariant::TryGetInt ( ) const

inlinenoexcept

Retrieve the int from the variant or std::nullopt.

Definition at line 203 of file SqlVariant.hpp.

◆ TryGetUInt()

LIGHTWEIGHT_FORCE_INLINE std::optional< unsigned int > SqlVariant::TryGetUInt ( ) const

inlinenoexcept

Retrieve the unsigned int from the variant or std::nullopt.

Definition at line 205 of file SqlVariant.hpp.

◆ TryGetLongLong()

LIGHTWEIGHT_FORCE_INLINE std::optional< long long > SqlVariant::TryGetLongLong ( ) const

inlinenoexcept

Retrieve the long long from the variant or std::nullopt.

Definition at line 207 of file SqlVariant.hpp.

◆ TryGetULongLong()

LIGHTWEIGHT_FORCE_INLINE std::optional< unsigned long long > SqlVariant::TryGetULongLong ( ) const

inlinenoexcept

Retrieve the unsigned long long from the variant or std::nullopt.

Definition at line 209 of file SqlVariant.hpp.

◆ TryGetStringView()

std::optional< std::string_view > SqlVariant::TryGetStringView ( ) const

inlinenoexcept

function to get string_view from SqlVariant or std::nullopt

Definition at line 230 of file SqlVariant.hpp.

References IsNull().

◆ TryGetUtf16StringView()

std::optional< std::u16string_view > SqlVariant::TryGetUtf16StringView ( ) const

inlinenoexcept

Definition at line 245 of file SqlVariant.hpp.

◆ TryGetDate()

LIGHTWEIGHT_FORCE_INLINE std::optional< SqlDate > SqlVariant::TryGetDate ( ) const

inline

function to get SqlDate from SqlVariant or std::nullopt

Definition at line 260 of file SqlVariant.hpp.

References IsNull().

◆ operator==()

bool SqlVariant::operator== ( SqlVariant const & other ) const

inlinenoexcept

Definition at line 278 of file SqlVariant.hpp.

◆ operator!=()

bool SqlVariant::operator!= ( SqlVariant const & other ) const

inlinenoexcept

Definition at line 283 of file SqlVariant.hpp.

◆ TryGetTime()

LIGHTWEIGHT_FORCE_INLINE std::optional< SqlTime > SqlVariant::TryGetTime ( ) const

inline

function to get SqlTime from SqlVariant or std::nullopt

Definition at line 289 of file SqlVariant.hpp.

References IsNull().

◆ TryGetDateTime()

LIGHTWEIGHT_FORCE_INLINE std::optional< SqlDateTime > SqlVariant::TryGetDateTime ( ) const

inline

function to get SqlDateTime from SqlVariant or std::nullopt

Definition at line 309 of file SqlVariant.hpp.

References IsNull().

◆ TryGetGuid()

LIGHTWEIGHT_FORCE_INLINE std::optional< SqlGuid > SqlVariant::TryGetGuid ( ) const

inline

Retrieve the GUID from the variant or std::nullopt if the value is NULL.

Definition at line 321 of file SqlVariant.hpp.

References IsNull().

Member Data Documentation

◆ value

InnerType SqlVariant::value

Definition at line 68 of file SqlVariant.hpp.

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

Lightweight/DataBinder/SqlVariant.hpp

Public Types

Public Member Functions

Public Attributes

Detailed Description

Member Typedef Documentation

◆ InnerType

Constructor & Destructor Documentation

◆ SqlVariant() [1/7]

◆ SqlVariant() [2/7]

◆ SqlVariant() [3/7]

◆ SqlVariant() [4/7]

◆ SqlVariant() [5/7]

◆ SqlVariant() [6/7]

◆ SqlVariant() [7/7]

Member Function Documentation

◆ operator=() [1/3]

◆ operator=() [2/3]

◆ operator=() [3/3]

◆ IsNull()

◆ Is()

◆ Get()

◆ ValueOr()

◆ TryGetBool()

◆ TryGetInt8()

◆ TryGetShort()

◆ TryGetUShort()

◆ TryGetInt()

◆ TryGetUInt()

◆ TryGetLongLong()

◆ TryGetULongLong()

◆ TryGetStringView()

◆ TryGetUtf16StringView()

◆ TryGetDate()

◆ operator==()

◆ operator!=()

◆ TryGetTime()

◆ TryGetDateTime()

◆ TryGetGuid()

Member Data Documentation

◆ value