CppUtilities::LE Namespace Reference

Encapsulates binary conversion functions using the little endian byte order. More...

Functions
CPP_UTILITIES_WARNING_PUSH CPP_UTILITIES_EXPORT constexpr std::int16_t	toInt16 (const char *value)
	Returns a 16-bit signed integer converted from two bytes at a specified position in a char array.
CPP_UTILITIES_EXPORT constexpr std::uint16_t	toUInt16 (const char *value)
	Returns a 16-bit unsigned integer converted from two bytes at a specified position in a char array.
CPP_UTILITIES_EXPORT constexpr std::int32_t	toInt32 (const char *value)
	Returns a 32-bit signed integer converted from four bytes at a specified position in a char array.
CPP_UTILITIES_EXPORT constexpr std::uint32_t	toUInt24 (const char *value)
	Returns a 32-bit unsigned integer converted from three bytes at a specified position in a char array.
CPP_UTILITIES_EXPORT constexpr std::uint32_t	toUInt32 (const char *value)
	Returns a 32-bit unsigned integer converted from four bytes at a specified position in a char array.
CPP_UTILITIES_EXPORT constexpr std::int64_t	toInt64 (const char *value)
	Returns a 64-bit signed integer converted from eight bytes at a specified position in a char array.
CPP_UTILITIES_EXPORT constexpr std::uint64_t	toUInt64 (const char *value)
	Returns a 64-bit unsigned integer converted from eight bytes at a specified position in a char array.
CPP_UTILITIES_EXPORT float	toFloat32 (const char *value)
	Returns a 32-bit floating point number converted from four bytes at a specified position in a char array.
CPP_UTILITIES_EXPORT double	toFloat64 (const char *value)
	Returns a 64-bit floating point number converted from eight bytes at a specified position in a char array.
template<class T, Traits::EnableIf< std::is_integral< T > > * = nullptr>
CPP_UTILITIES_EXPORT T	toInt (const char *value)
	Returns the specified (unsigned) integer converted from the specified char array.
CPP_UTILITIES_EXPORT void	getBytes24 (std::uint32_t value, char *outputbuffer)
	Stores the specified 24-bit unsigned integer value at a specified position in a char array.
template<class T, Traits::EnableIf< std::is_integral< T > > * = nullptr>
CPP_UTILITIES_EXPORT void	getBytes (T value, char *outputbuffer)
	Stores the specified (unsigned) integer value in a char array.
CPP_UTILITIES_EXPORT void	getBytes (float value, char *outputbuffer)
	Stores the specified 32-bit floating point value at a specified position in a char array.
CPP_UTILITIES_EXPORT void	getBytes (double value, char *outputbuffer)
	Stores the specified 64-bit floating point value at a specified position in a char array.

Detailed Description

Encapsulates binary conversion functions using the little endian byte order.

See also

Endianness - Wikipedia

Function Documentation

getBytes() [1/3]

CPP_UTILITIES_EXPORT void CppUtilities::LE::getBytes ( double value, char * outputbuffer )

inline

Stores the specified 64-bit floating point value at a specified position in a char array.

Definition at line 206 of file binaryconversion.h.

getBytes() [2/3]

CPP_UTILITIES_EXPORT void CppUtilities::LE::getBytes ( float value, char * outputbuffer )

inline

Stores the specified 32-bit floating point value at a specified position in a char array.

Definition at line 196 of file binaryconversion.h.

getBytes() [3/3]

template<class T, Traits::EnableIf< std::is_integral< T > > * = nullptr>

CPP_UTILITIES_EXPORT void CppUtilities::LE::getBytes ( T value, char * outputbuffer )

inline

Stores the specified (unsigned) integer value in a char array.

Remarks

• The value outputbuffer must point to a sequence of characters that is at least as long as the specified integer type.
• This function is potentially faster than the width-specific toInt…() because the width-specific functions use custom code that may not be optimized by the compiler. (Only GCC optimized it but not Clang and MSVC.)

Definition at line 185 of file binaryconversion.h.

getBytes24()

CPP_UTILITIES_EXPORT void CppUtilities::LE::getBytes24 ( std::uint32_t value, char * outputbuffer )

inline

Stores the specified 24-bit unsigned integer value at a specified position in a char array.

Remarks

Ignores the most significant byte.

Definition at line 165 of file binaryconversion.h.

toFloat32()

CPP_UTILITIES_EXPORT float CppUtilities::LE::toFloat32 ( const char * value )

inline

Returns a 32-bit floating point number converted from four bytes at a specified position in a char array.

Definition at line 126 of file binaryconversion.h.

toFloat64()

CPP_UTILITIES_EXPORT double CppUtilities::LE::toFloat64 ( const char * value )

inline

Returns a 64-bit floating point number converted from eight bytes at a specified position in a char array.

Definition at line 136 of file binaryconversion.h.

toInt()

template<class T, Traits::EnableIf< std::is_integral< T > > * = nullptr>

CPP_UTILITIES_EXPORT T CppUtilities::LE::toInt ( const char * value )

inline

Returns the specified (unsigned) integer converted from the specified char array.

Remarks

• The value must point to a sequence of characters that is at least as long as the specified integer type.
• This function is potentially faster than the width-specific toInt…() because the width-specific functions use custom code that may not be optimized by the compiler. (Only GCC optimized it but not Clang and MSVC.) Note that the width-specific functions cannot be changed as they are constexpr and thus cannot use memcpy().

Definition at line 151 of file binaryconversion.h.

toInt16()

CPP_UTILITIES_WARNING_PUSH CPP_UTILITIES_EXPORT constexpr std::int16_t CppUtilities::LE::toInt16 ( const char * value )

constexpr

Returns a 16-bit signed integer converted from two bytes at a specified position in a char array.

Definition at line 22 of file binaryconversion.h.

toInt32()

CPP_UTILITIES_EXPORT constexpr std::int32_t CppUtilities::LE::toInt32 ( const char * value )

constexpr

Returns a 32-bit signed integer converted from four bytes at a specified position in a char array.

Definition at line 46 of file binaryconversion.h.

toInt64()

CPP_UTILITIES_EXPORT constexpr std::int64_t CppUtilities::LE::toInt64 ( const char * value )

constexpr

Returns a 64-bit signed integer converted from eight bytes at a specified position in a char array.

Definition at line 90 of file binaryconversion.h.

toUInt16()

CPP_UTILITIES_EXPORT constexpr std::uint16_t CppUtilities::LE::toUInt16 ( const char * value )

constexpr

Returns a 16-bit unsigned integer converted from two bytes at a specified position in a char array.

Definition at line 34 of file binaryconversion.h.

toUInt24()

CPP_UTILITIES_EXPORT constexpr std::uint32_t CppUtilities::LE::toUInt24 ( const char * value )

constexpr

Returns a 32-bit unsigned integer converted from three bytes at a specified position in a char array.

Definition at line 62 of file binaryconversion.h.

toUInt32()

CPP_UTILITIES_EXPORT constexpr std::uint32_t CppUtilities::LE::toUInt32 ( const char * value )

constexpr

Returns a 32-bit unsigned integer converted from four bytes at a specified position in a char array.

Definition at line 76 of file binaryconversion.h.

toUInt64()

CPP_UTILITIES_EXPORT constexpr std::uint64_t CppUtilities::LE::toUInt64 ( const char * value )

constexpr

Returns a 64-bit unsigned integer converted from eight bytes at a specified position in a char array.

Definition at line 108 of file binaryconversion.h.