jaulib v1.1.2-28-g30efb27-dirty
Jau Support Library (C++, Java, ..)
|
Byte utility functions and types for endian- and bit conversions, inclusive alignment handling and general get & put functionality. More...
Namespaces | |
namespace | jau::impl |
Classes | |
struct | jau::has_endian_big< Dummy_type > |
A big-endian type trait for convenience . More... | |
struct | jau::has_endian_little< Dummy_type > |
A little-endian type trait for convenience . More... | |
class | jau::POctets |
Persistent endian aware octet data, i.e. More... | |
class | jau::TOctets |
Transient endian aware octet data, i.e. More... | |
class | jau::TOctetSlice |
Transient endian aware octet data slice, i.e. More... | |
class | jau::TROOctets |
Transient read only and endian aware octet data, i.e. More... | |
Enumerations | |
enum class | jau::endian : uint32_t { jau::endian::little = 0x41424344U , jau::endian::big = 0x44434241U , jau::endian::pdp = 0x43444142U , jau::endian::honeywell = 0x42414443U , jau::endian::undefined = 0x00000000U , jau::endian::native = impl::get_host_order() } |
Endian identifier, indicating endianess of all scalar types. More... | |
enum class | jau::lb_endian : uint32_t { jau::lb_endian::little = static_cast<uint32_t>( endian::little ) , jau::lb_endian::big = static_cast<uint32_t>( endian::big ) , jau::lb_endian::native = static_cast<uint32_t>( endian::native ) } |
Simplified reduced endian type only covering little- and big-endian. More... | |
Functions | |
constexpr uint128dp_t | jau::be_to_cpu (uint128dp_t const &n) noexcept |
constexpr uint16_t | jau::be_to_cpu (uint16_t const n) noexcept |
constexpr uint192dp_t | jau::be_to_cpu (uint192dp_t const &n) noexcept |
constexpr uint256dp_t | jau::be_to_cpu (uint256dp_t const &n) noexcept |
constexpr uint32_t | jau::be_to_cpu (uint32_t const n) noexcept |
constexpr uint64_t | jau::be_to_cpu (uint64_t const &n) noexcept |
constexpr uint128dp_t | jau::bswap (uint128dp_t const &source) noexcept |
constexpr uint16_t | jau::bswap (uint16_t const source) noexcept |
constexpr uint192dp_t | jau::bswap (uint192dp_t const &source) noexcept |
constexpr uint256dp_t | jau::bswap (uint256dp_t const &source) noexcept |
constexpr uint32_t | jau::bswap (uint32_t const source) noexcept |
constexpr uint64_t | jau::bswap (uint64_t const &source) noexcept |
constexpr void | jau::bswap (uint8_t *sink, uint8_t const *source, nsize_t len) |
const uint8_t * | jau::cast_char_ptr_to_uint8 (const char *s) noexcept |
const char * | jau::cast_uint8_ptr_to_char (const uint8_t *b) noexcept |
char * | jau::cast_uint8_ptr_to_char (uint8_t *b) noexcept |
constexpr uint128dp_t | jau::cpu_to_be (uint128dp_t const &h) noexcept |
constexpr uint16_t | jau::cpu_to_be (uint16_t const h) noexcept |
constexpr uint192dp_t | jau::cpu_to_be (uint192dp_t const &h) noexcept |
constexpr uint256dp_t | jau::cpu_to_be (uint256dp_t const &h) noexcept |
constexpr uint32_t | jau::cpu_to_be (uint32_t const h) noexcept |
constexpr uint64_t | jau::cpu_to_be (uint64_t const &h) noexcept |
constexpr uint128dp_t | jau::cpu_to_le (uint128dp_t const &h) noexcept |
constexpr uint16_t | jau::cpu_to_le (uint16_t const h) noexcept |
constexpr uint192dp_t | jau::cpu_to_le (uint192dp_t const &h) noexcept |
constexpr uint256dp_t | jau::cpu_to_le (uint256dp_t const &h) noexcept |
constexpr uint32_t | jau::cpu_to_le (uint32_t const h) noexcept |
constexpr uint64_t | jau::cpu_to_le (uint64_t const &h) noexcept |
std::string | jau::dfa_utf8_decode (const uint8_t *buffer, const size_t buffer_size) |
Returns all valid consecutive UTF-8 characters within buffer in the range up to buffer_size or until EOS. More... | |
uint32_t | jau::dfa_utf8_decode (uint32_t &state, uint32_t &codep, const uint32_t byte_value) |
constexpr int8_t | jau::get_int8 (uint8_t const *buffer) noexcept |
template<typename T > | |
constexpr T | jau::get_packed_value (const packed_t< T > *source, const lb_endian byte_order) noexcept |
Return packed_t::store after converting it to from either lb_endian::little or lb_endian::big depending on given byte_order to lb_endian::native. More... | |
constexpr uint128dp_t | jau::get_uint128 (uint8_t const *buffer) noexcept |
See get_uint16() for reference. More... | |
constexpr uint128dp_t | jau::get_uint128 (uint8_t const *buffer, const lb_endian byte_order) noexcept |
See get_uint16() for reference. More... | |
constexpr uint16_t | jau::get_uint16 (uint8_t const *buffer) noexcept |
Returns a uint16_t value from the given byte address using packed_t to resolve a potential memory alignment issue free of costs. More... | |
constexpr uint16_t | jau::get_uint16 (uint8_t const *buffer, const lb_endian byte_order) noexcept |
Returns a uint16_t value from the given byte address using packed_t to resolve a potential memory alignment issue free of costs. More... | |
constexpr uint192dp_t | jau::get_uint192 (uint8_t const *buffer) noexcept |
See get_uint16() for reference. More... | |
constexpr uint192dp_t | jau::get_uint192 (uint8_t const *buffer, const lb_endian byte_order) noexcept |
See get_uint16() for reference. More... | |
constexpr uint256dp_t | jau::get_uint256 (uint8_t const *buffer) noexcept |
See get_uint16() for reference. More... | |
constexpr uint256dp_t | jau::get_uint256 (uint8_t const *buffer, const lb_endian byte_order) noexcept |
See get_uint16() for reference. More... | |
constexpr uint32_t | jau::get_uint32 (uint8_t const *buffer) noexcept |
See get_uint16() for reference. More... | |
constexpr uint32_t | jau::get_uint32 (uint8_t const *buffer, const lb_endian byte_order) noexcept |
See get_uint16() for reference. More... | |
constexpr uint64_t | jau::get_uint64 (uint8_t const *buffer) noexcept |
See get_uint16() for reference. More... | |
constexpr uint64_t | jau::get_uint64 (uint8_t const *buffer, const lb_endian byte_order) noexcept |
See get_uint16() for reference. More... | |
constexpr uint8_t | jau::get_uint8 (uint8_t const *buffer) noexcept |
template<typename T > | |
constexpr std::enable_if_t< std::is_standard_layout_v< T >, T > | jau::get_value (uint8_t const *buffer) noexcept |
Returns a T value from the given byte address using packed_t to resolve a potential memory alignment issue free of costs. More... | |
template<typename T > | |
constexpr std::enable_if_t< std::is_standard_layout_v< T >, T > | jau::get_value (uint8_t const *buffer, const lb_endian byte_order) noexcept |
Returns a T value from the given byte address using packed_t to resolve a potential memory alignment issue free of costs. More... | |
constexpr bool | jau::is_big_endian () noexcept |
Evaluates true if platform is running in big endian mode, i.e. More... | |
constexpr bool | jau::is_defined_endian (const endian &v) noexcept |
Evaluates true if the given endian is defined, i.e. More... | |
constexpr bool | jau::is_little_endian () noexcept |
Evaluates true if platform is running in little endian mode, i.e. More... | |
constexpr bool | jau::is_little_endian (const endian byte_order) noexcept |
Returns true if given byte_order equals endian::little, otherwise false. More... | |
constexpr bool | jau::is_little_endian (const lb_endian byte_order) noexcept |
Returns true if given byte_order equals lb_endian::little, otherwise false. More... | |
constexpr bool | jau::is_little_or_big_endian () noexcept |
Evaluates true if platform is running in little or big endian mode, i.e. More... | |
constexpr uint128dp_t | jau::le_to_cpu (uint128dp_t const &l) noexcept |
constexpr uint16_t | jau::le_to_cpu (uint16_t const l) noexcept |
constexpr uint192dp_t | jau::le_to_cpu (uint192dp_t const &l) noexcept |
constexpr uint256dp_t | jau::le_to_cpu (uint256dp_t const &l) noexcept |
constexpr uint32_t | jau::le_to_cpu (uint32_t const l) noexcept |
constexpr uint64_t | jau::le_to_cpu (uint64_t const &l) noexcept |
constexpr void | jau::put_uint128 (uint8_t *buffer, const uint128dp_t &v) noexcept |
See put_uint16() for reference. More... | |
constexpr void | jau::put_uint128 (uint8_t *buffer, const uint128dp_t &v, const lb_endian byte_order) noexcept |
See put_uint16() for reference. More... | |
constexpr void | jau::put_uint16 (uint8_t *buffer, const uint16_t v) noexcept |
Put the given uint16_t value into the given byte address using packed_t to resolve a potential memory alignment issue free of costs. More... | |
constexpr void | jau::put_uint16 (uint8_t *buffer, const uint16_t v, const lb_endian byte_order) noexcept |
Put the given uint16_t value into the given byte address using packed_t to resolve a potential memory alignment issue free of costs. More... | |
constexpr void | jau::put_uint192 (uint8_t *buffer, const uint192dp_t &v) noexcept |
See put_uint16() for reference. More... | |
constexpr void | jau::put_uint192 (uint8_t *buffer, const uint192dp_t &v, const lb_endian byte_order) noexcept |
See put_uint16() for reference. More... | |
constexpr void | jau::put_uint256 (uint8_t *buffer, const uint256dp_t &v) noexcept |
See put_uint16() for reference. More... | |
constexpr void | jau::put_uint256 (uint8_t *buffer, const uint256dp_t &v, const lb_endian byte_order) noexcept |
See put_uint16() for reference. More... | |
constexpr void | jau::put_uint32 (uint8_t *buffer, const uint32_t v) noexcept |
See put_uint16() for reference. More... | |
constexpr void | jau::put_uint32 (uint8_t *buffer, const uint32_t v, const lb_endian byte_order) noexcept |
See put_uint16() for reference. More... | |
constexpr void | jau::put_uint64 (uint8_t *buffer, const uint64_t &v) noexcept |
See put_uint16() for reference. More... | |
constexpr void | jau::put_uint64 (uint8_t *buffer, const uint64_t &v, const lb_endian byte_order) noexcept |
See put_uint16() for reference. More... | |
constexpr void | jau::put_uint8 (uint8_t *buffer, const uint8_t v) noexcept |
template<typename T > | |
constexpr std::enable_if_t< std::is_standard_layout_v< T >, void > | jau::put_value (uint8_t *buffer, const T &v) noexcept |
Put the given T value into the given byte address using packed_t to resolve a potential memory alignment issue free of costs. More... | |
template<typename T > | |
constexpr std::enable_if_t< std::is_standard_layout_v< T >, void > | jau::put_value (uint8_t *buffer, const T &v, const lb_endian byte_order) noexcept |
Put the given T value into the given byte address using packed_t to resolve a potential memory alignment issue free of costs. More... | |
constexpr endian | jau::to_endian (const lb_endian v) noexcept |
constexpr lb_endian | jau::to_lb_endian (const endian v) noexcept |
std::string | jau::to_string (const endian &v) noexcept |
Return std::string representation of the given endian. More... | |
std::string | jau::to_string (const lb_endian &v) noexcept |
Return std::string representation of the given lb_endian. More... | |
Variables | |
template<typename Dummy_type > | |
constexpr bool | jau::has_endian_big_v = has_endian_big<Dummy_type>::value |
Value access of big-endian type trait for convenience . More... | |
template<typename Dummy_type > | |
constexpr bool | jau::has_endian_little_v = has_endian_little<Dummy_type>::value |
Value access of little-endian type trait for convenience . More... | |
Byte utility functions and types for endian- and bit conversions, inclusive alignment handling and general get & put functionality.
This category is also supporting Integer types and arithmetic.
All endian API entries are of constexpr
and hence evaluated at compile time.
Therefore, if-branches and expressions are also of constexpr
and optimized 'away' at compile time.
This includes the cpu_to_<endian>(..)
and <endian>_to_cpu(..)
etc utility functions.
See endian enum class regarding endian constexpr
compile time determination.
Aligned memory transfer from and to potentially unaligned memory is performed via put_uint16(), get_uint16() with all its explicit stdint types, as well as the generic template functions put_value() and get_value(). The implementation uses packed_t to resolve a potential memory alignment issue free of costs, see packed_t_alignment_cast.
|
strong |
Endian identifier, indicating endianess of all scalar types.
Inspired by C++20 std::endian
Corner case platforms currently not supported, i.e. unified endianess and mixed endianess.
All endian API entries are of constexpr
and hence evaluated at compile time.
Therefore, if-branches and expressions are also of constexpr
and optimized 'away' at compile time.
This includes the cpu_to_<endian>(..)
and <endian>_to_cpu(..)
etc utility functions.
On i386 platforms the host byte order is Least Significant Byte first (LSB) or Little-Endian, whereas the network byte order, as used on the Internet, is Most Significant Byte first (MSB) or Big-Endian. See #include <arpa/inet.h>
Bluetooth is LSB or Little-Endian!
See lb_endian
Definition at line 202 of file byte_util.hpp.
|
strong |
Simplified reduced endian type only covering little- and big-endian.
See endian for details.
Enumerator | |
---|---|
little | Identifier for little endian, equivalent to endian::little. |
big | Identifier for big endian, equivalent to endian::big. |
native | Identifier for native platform type, one of the above. |
Definition at line 226 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 88 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 97 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 108 of file byte_util.hpp.
|
constexpr |
Definition at line 123 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 130 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 136 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 142 of file byte_util.hpp.
|
inlinenoexcept |
Definition at line 148 of file byte_util.hpp.
|
inlinenoexcept |
Definition at line 151 of file byte_util.hpp.
|
inlinenoexcept |
|
noexcept |
Return std::string representation of the given endian.
v | the endian value |
Definition at line 437 of file basic_types.cpp.
|
noexcept |
Return std::string representation of the given lb_endian.
v | the lb_endian value |
Definition at line 448 of file basic_types.cpp.
Definition at line 252 of file byte_util.hpp.
Definition at line 261 of file byte_util.hpp.
|
constexprnoexcept |
Evaluates true
if the given endian is defined, i.e.
little
, big
, pdp
or honeywell
.
Definition at line 275 of file byte_util.hpp.
|
constexprnoexcept |
Returns true
if given byte_order
equals endian::little, otherwise false.
Definition at line 293 of file byte_util.hpp.
|
constexprnoexcept |
Returns true
if given byte_order
equals lb_endian::little, otherwise false.
Definition at line 300 of file byte_util.hpp.
|
constexprnoexcept |
Evaluates true
if platform is running in little endian mode, i.e.
jau::endian::little == jau::endian::native
.
Definition at line 308 of file byte_util.hpp.
|
constexprnoexcept |
Evaluates true
if platform is running in big endian mode, i.e.
jau::endian::big == jau::endian::native
.
Definition at line 316 of file byte_util.hpp.
|
constexprnoexcept |
Evaluates true
if platform is running in little or big endian mode, i.e.
jau::endian::little == jau::endian::native || jau::endian::big == jau::endian::native
.
Definition at line 324 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 374 of file byte_util.hpp.
|
constexprnoexcept |
|
constexprnoexcept |
Definition at line 393 of file byte_util.hpp.
|
constexprnoexcept |
|
constexprnoexcept |
Definition at line 412 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 421 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 430 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 439 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 449 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 458 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 467 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 476 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 486 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 495 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 504 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 513 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 523 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 532 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 541 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 550 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 560 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 569 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 578 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 587 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 604 of file byte_util.hpp.
|
constexprnoexcept |
Definition at line 608 of file byte_util.hpp.
|
constexprnoexcept |
|
constexprnoexcept |
Return packed_t::store after converting it to from either lb_endian::little or lb_endian::big depending on given byte_order
to lb_endian::native.
T |
source | |
byte_order |
Definition at line 625 of file byte_util.hpp.
|
constexprnoexcept |
Put the given uint16_t value into the given byte address using packed_t to resolve a potential memory alignment issue free of costs.
Definition at line 635 of file byte_util.hpp.
|
constexprnoexcept |
Put the given uint16_t value into the given byte address using packed_t to resolve a potential memory alignment issue free of costs.
The value is converted from lb_endian::native to either lb_endian::little or lb_endian::big depending on given byte_order
before it is stored in memory.
Definition at line 648 of file byte_util.hpp.
|
constexprnoexcept |
Returns a uint16_t value from the given byte address using packed_t to resolve a potential memory alignment issue free of costs.
Definition at line 658 of file byte_util.hpp.
|
constexprnoexcept |
Returns a uint16_t value from the given byte address using packed_t to resolve a potential memory alignment issue free of costs.
The value is converted from either lb_endian::little or lb_endian::big depending on given byte_order
to lb_endian::native before it is returned to the caller.
Definition at line 671 of file byte_util.hpp.
|
constexprnoexcept |
See put_uint16() for reference.
Definition at line 680 of file byte_util.hpp.
|
constexprnoexcept |
See put_uint16() for reference.
Definition at line 688 of file byte_util.hpp.
|
constexprnoexcept |
See get_uint16() for reference.
Definition at line 696 of file byte_util.hpp.
|
constexprnoexcept |
See get_uint16() for reference.
Definition at line 704 of file byte_util.hpp.
|
constexprnoexcept |
See put_uint16() for reference.
Definition at line 713 of file byte_util.hpp.
|
constexprnoexcept |
See put_uint16() for reference.
Definition at line 721 of file byte_util.hpp.
|
constexprnoexcept |
See get_uint16() for reference.
Definition at line 729 of file byte_util.hpp.
|
constexprnoexcept |
See get_uint16() for reference.
Definition at line 737 of file byte_util.hpp.
|
constexprnoexcept |
See put_uint16() for reference.
Definition at line 746 of file byte_util.hpp.
|
constexprnoexcept |
See put_uint16() for reference.
Definition at line 754 of file byte_util.hpp.
|
constexprnoexcept |
See get_uint16() for reference.
Definition at line 762 of file byte_util.hpp.
|
constexprnoexcept |
See get_uint16() for reference.
Definition at line 770 of file byte_util.hpp.
|
constexprnoexcept |
See put_uint16() for reference.
Definition at line 779 of file byte_util.hpp.
|
constexprnoexcept |
See put_uint16() for reference.
Definition at line 787 of file byte_util.hpp.
|
constexprnoexcept |
See get_uint16() for reference.
Definition at line 795 of file byte_util.hpp.
|
constexprnoexcept |
See get_uint16() for reference.
Definition at line 803 of file byte_util.hpp.
|
constexprnoexcept |
See put_uint16() for reference.
Definition at line 812 of file byte_util.hpp.
|
constexprnoexcept |
See put_uint16() for reference.
Definition at line 820 of file byte_util.hpp.
|
constexprnoexcept |
See get_uint16() for reference.
Definition at line 828 of file byte_util.hpp.
|
constexprnoexcept |
See get_uint16() for reference.
Definition at line 836 of file byte_util.hpp.
|
constexprnoexcept |
Put the given T value into the given byte address using packed_t to resolve a potential memory alignment issue free of costs.
T |
buffer | |
v |
Definition at line 861 of file byte_util.hpp.
|
constexprnoexcept |
Put the given T value into the given byte address using packed_t to resolve a potential memory alignment issue free of costs.
The value is converted from lb_endian::native to either lb_endian::little or lb_endian::big depending on given byte_order
before it is stored in memory.
T |
buffer | |
v | |
byte_order |
Definition at line 885 of file byte_util.hpp.
|
constexprnoexcept |
Returns a T value from the given byte address using packed_t to resolve a potential memory alignment issue free of costs.
T |
buffer |
Definition at line 904 of file byte_util.hpp.
|
constexprnoexcept |
Returns a T value from the given byte address using packed_t to resolve a potential memory alignment issue free of costs.
The value is converted from either lb_endian::little or lb_endian::big depending on given byte_order
to lb_endian::native before it is returned to the caller.
T |
buffer | |
byte_order |
Definition at line 927 of file byte_util.hpp.
uint32_t jau::dfa_utf8_decode | ( | uint32_t & | state, |
uint32_t & | codep, | ||
const uint32_t | byte_value | ||
) |
state | |
codep | |
byte_value |
Definition at line 90 of file dfa_utf8_decode.cpp.
std::string jau::dfa_utf8_decode | ( | const uint8_t * | buffer, |
const size_t | buffer_size | ||
) |
Returns all valid consecutive UTF-8 characters within buffer in the range up to buffer_size or until EOS.
In case a non UTF-8 character has been detected, the content will be cut off and the decoding loop ends.
Method utilizes a finite state machine detecting variable length UTF-8 codes. See Bjoern Hoehrmann's site http://bjoern.hoehrmann.de/utf-8/decoder/dfa/ for details.
Definition at line 31 of file dfa_utf8_decode.cpp.
|
constexpr |
Value access of little-endian type trait for convenience .
Since all endian definitions are of constexpr
, code can simply use expressions of these for compile-time evaluation and optimization. A template SFINAE
is not required.
Dummy_type | just to make template SFINAE happy |
Definition at line 346 of file byte_util.hpp.
|
constexpr |
Value access of big-endian type trait for convenience .
Since all endian definitions are of constexpr
, code can simply use expressions of these for compile-time evaluation and optimization. A template SFINAE
is not required.
Dummy_type | just to make template SFINAE happy |
Definition at line 366 of file byte_util.hpp.