Functions to work with different byte orders. More...

Detailed Description

Functions to work with different byte orders.

Author: René Kijewski rene..nosp@m.kije.nosp@m.wski@.nosp@m.fu-b.nosp@m.erlin.nosp@m..de

Definition in file byteorder.h.

#include <string.h>
#include <stdint.h>
#include "unaligned.h"

Include dependency graph for byteorder.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
union	le_uint16_t
	A 16 bit integer in little endian. More...

union	le_uint32_t
	A 32 bit integer in little endian. More...

union	le_uint64_t
	A 64 bit integer in little endian. More...

union	be_uint16_t
	A 16 bit integer in big endian aka network byte order. More...

union	be_uint32_t
	A 32 bit integer in big endian aka network byte order. More...

union	be_uint64_t
	A 64 bit integer in big endian aka network byte order. More...

#define	_byteorder_swap_le(V, T) (V)
	Swaps the byteorder according to the endianness (host -> le) More...

#define	_byteorder_swap(V, T) (byteorder_swap ## T((V)))
	Swaps the byteorder according to the endianness (host -> BE) More...

typedef be_uint16_t	network_uint16_t
	A 16 bit integer in network byte order. More...

typedef be_uint32_t	network_uint32_t
	A 32 bit integer in network byte order. More...

typedef be_uint64_t	network_uint64_t
	A 64 bit integer in network byte order. More...

static uint16_t	byteorder_ltohs (le_uint16_t v)
	Convert from little endian to host byte order, 16 bit. More...

static uint32_t	byteorder_ltohl (le_uint32_t v)
	Convert from little endian to host byte order, 32 bit. More...

static uint64_t	byteorder_ltohll (le_uint64_t v)
	Convert from little endian to host byte order, 64 bit. More...

static be_uint16_t	byteorder_ltobs (le_uint16_t v)
	Convert from little endian to big endian, 16 bit. More...

static be_uint32_t	byteorder_ltobl (le_uint32_t v)
	Convert from little endian to big endian, 32 bit. More...

static be_uint64_t	byteorder_ltobll (le_uint64_t v)
	Convert from little endian to big endian, 64 bit. More...

static le_uint16_t	byteorder_btols (be_uint16_t v)
	Convert from big endian to little endian, 16 bit. More...

static le_uint32_t	byteorder_btoll (be_uint32_t v)
	Convert from big endian to little endian, 32 bit. More...

static le_uint64_t	byteorder_btolll (be_uint64_t v)
	Convert from big endian to little endian, 64 bit. More...

static le_uint16_t	byteorder_htols (uint16_t v)
	Convert from host byte order to little endian, 16 bit. More...

static le_uint32_t	byteorder_htoll (uint32_t v)
	Convert from host byte order to little endian, 32 bit. More...

static le_uint64_t	byteorder_htolll (uint64_t v)
	Convert from host byte order to little endian, 64 bit. More...

static network_uint16_t	byteorder_htons (uint16_t v)
	Convert from host byte order to network byte order, 16 bit. More...

static network_uint32_t	byteorder_htonl (uint32_t v)
	Convert from host byte order to network byte order, 32 bit. More...

static network_uint64_t	byteorder_htonll (uint64_t v)
	Convert from host byte order to network byte order, 64 bit. More...

static uint16_t	byteorder_ntohs (network_uint16_t v)
	Convert from network byte order to host byte order, 16 bit. More...

static uint32_t	byteorder_ntohl (network_uint32_t v)
	Convert from network byte order to host byte order, 32 bit. More...

static uint64_t	byteorder_ntohll (network_uint64_t v)
	Convert from network byte order to host byte order, 64 bit. More...

static uint16_t	byteorder_swaps (uint16_t v)
	Swap byte order, 16 bit. More...

static uint32_t	byteorder_swapl (uint32_t v)
	Swap byte order, 32 bit. More...

static uint64_t	byteorder_swapll (uint64_t v)
	Swap byte order, 64 bit. More...

static uint16_t	byteorder_bebuftohs (const uint8_t *buf)
	Read a big endian encoded unsigned integer from a buffer into host byte order encoded variable, 16-bit. More...

static uint32_t	byteorder_bebuftohl (const uint8_t *buf)
	Read a big endian encoded unsigned integer from a buffer into host byte order encoded variable, 32-bit. More...

static uint64_t	byteorder_bebuftohll (const uint8_t *buf)
	Read a big endian encoded unsigned integer from a buffer into host byte order encoded variable, 64-bit. More...

static void	byteorder_htobebufs (uint8_t *buf, uint16_t val)
	Write a host byte order encoded unsigned integer as big endian encoded value into a buffer, 16-bit. More...

static void	byteorder_htobebufl (uint8_t *buf, uint32_t val)
	Write a host byte order encoded unsigned integer as big endian encoded value into a buffer, 32-bit. More...

static void	byteorder_htobebufll (uint8_t *buf, uint64_t val)
	Write a host byte order encoded unsigned integer as big endian encoded value into a buffer, 64-bit. More...

static uint16_t	htons (uint16_t v)
	Convert from host byte order to network byte order, 16 bit. More...

static uint32_t	htonl (uint32_t v)
	Convert from host byte order to network byte order, 32 bit. More...

static uint64_t	htonll (uint64_t v)
	Convert from host byte order to network byte order, 64 bit. More...

static uint16_t	ntohs (uint16_t v)
	Convert from network byte order to host byte order, 16 bit. More...

static uint32_t	ntohl (uint32_t v)
	Convert from network byte order to host byte order, 32 bit. More...

static uint64_t	ntohll (uint64_t v)
	Convert from network byte order to host byte order, 64 bit. More...

static uint16_t	byteorder_lebuftohs (const uint8_t *buf)

static uint32_t	byteorder_lebuftohl (const uint8_t *buf)

static uint64_t	byteorder_lebuftohll (const uint8_t *buf)

static void	byteorder_htolebufs (uint8_t *buf, uint16_t val)

static void	byteorder_htolebufl (uint8_t *buf, uint32_t val)

static void	byteorder_htolebufll (uint8_t *buf, uint64_t val)

Macro Definition Documentation

◆ _byteorder_swap

#define _byteorder_swap	(	V,
		T
	)	(byteorder_swap ## T((V)))

Swaps the byteorder according to the endianness (host -> BE)

Definition at line 506 of file byteorder.h.

◆ _byteorder_swap_le

#define _byteorder_swap_le	(	V,
		T
	)	(V)

Swaps the byteorder according to the endianness (host -> le)

Definition at line 417 of file byteorder.h.

Typedef Documentation

◆ network_uint16_t

typedef be_uint16_t network_uint16_t

A 16 bit integer in network byte order.

Definition at line 107 of file byteorder.h.

◆ network_uint32_t

typedef be_uint32_t network_uint32_t

A 32 bit integer in network byte order.

Definition at line 112 of file byteorder.h.

◆ network_uint64_t

typedef be_uint64_t network_uint64_t

A 64 bit integer in network byte order.

Definition at line 117 of file byteorder.h.

Function Documentation

◆ byteorder_bebuftohl()

static uint32_t byteorder_bebuftohl ( const uint8_t * buf )

inlinestatic

Read a big endian encoded unsigned integer from a buffer into host byte order encoded variable, 32-bit.

Note: This function is agnostic to the alignment of the target value in the given buffer

Parameters

[in] buf position in a buffer holding the target value

Returns: 32-bit unsigned integer in host byte order

Definition at line 596 of file byteorder.h.

◆ byteorder_bebuftohll()

static uint64_t byteorder_bebuftohll ( const uint8_t * buf )

inlinestatic

Read a big endian encoded unsigned integer from a buffer into host byte order encoded variable, 64-bit.

Note: This function is agnostic to the alignment of the target value in the given buffer

Parameters

[in] buf position in a buffer holding the target value

Returns: 64-bit unsigned integer in host byte order

Definition at line 610 of file byteorder.h.

◆ byteorder_bebuftohs()

static uint16_t byteorder_bebuftohs ( const uint8_t * buf )

inlinestatic

Read a big endian encoded unsigned integer from a buffer into host byte order encoded variable, 16-bit.

Note: This function is agnostic to the alignment of the target value in the given buffer

Parameters

[in] buf position in a buffer holding the target value

Returns: 16-bit unsigned integer in host byte order

Definition at line 585 of file byteorder.h.

◆ byteorder_btoll()

static le_uint32_t byteorder_btoll ( be_uint32_t v )

inlinestatic

Convert from big endian to little endian, 32 bit.

Parameters

[in] v The integer in big endian.

Returns: v converted to little endian.

Definition at line 467 of file byteorder.h.

◆ byteorder_btolll()

static le_uint64_t byteorder_btolll ( be_uint64_t v )

inlinestatic

Convert from big endian to little endian, 64 bit.

Parameters

[in] v The integer in big endian.

Returns: v converted to little endian.

Definition at line 474 of file byteorder.h.

◆ byteorder_btols()

static le_uint16_t byteorder_btols ( be_uint16_t v )

inlinestatic

Convert from big endian to little endian, 16 bit.

Parameters

[in] v The integer in big endian.

Returns: v converted to little endian.

Definition at line 460 of file byteorder.h.

◆ byteorder_htobebufl()

static void byteorder_htobebufl	(	uint8_t *	buf,
		uint32_t	val
	)

inlinestatic

Write a host byte order encoded unsigned integer as big endian encoded value into a buffer, 32-bit.

Note: This function is alignment agnostic and works with any given memory location of the buffer

Parameters

[out]	buf	target buffer, must be able to accept 4 bytes
[in]	val	value written to the buffer, in host byte order

Definition at line 640 of file byteorder.h.

◆ byteorder_htobebufll()

static void byteorder_htobebufll	(	uint8_t *	buf,
		uint64_t	val
	)

inlinestatic

Write a host byte order encoded unsigned integer as big endian encoded value into a buffer, 64-bit.

Note: This function is alignment agnostic and works with any given memory location of the buffer

Parameters

[out]	buf	target buffer, must be able to accept 8 bytes
[in]	val	value written to the buffer, in host byte order

Definition at line 654 of file byteorder.h.

◆ byteorder_htobebufs()

static void byteorder_htobebufs	(	uint8_t *	buf,
		uint16_t	val
	)

inlinestatic

Write a host byte order encoded unsigned integer as big endian encoded value into a buffer, 16-bit.

Note: This function is alignment agnostic and works with any given memory location of the buffer

Parameters

[out]	buf	target buffer, must be able to accept 2 bytes
[in]	val	value written to the buffer, in host byte order

Definition at line 628 of file byteorder.h.

◆ byteorder_htolebufl()

static void byteorder_htolebufl	(	uint8_t *	buf,
		uint32_t	val
	)

inlinestatic

Definition at line 727 of file byteorder.h.

◆ byteorder_htolebufll()

static void byteorder_htolebufll	(	uint8_t *	buf,
		uint64_t	val
	)

inlinestatic

Definition at line 741 of file byteorder.h.

◆ byteorder_htolebufs()

static void byteorder_htolebufs	(	uint8_t *	buf,
		uint16_t	val
	)

inlinestatic

Definition at line 715 of file byteorder.h.

◆ byteorder_htoll()

static le_uint32_t byteorder_htoll ( uint32_t v )

inlinestatic

Convert from host byte order to little endian, 32 bit.

Parameters

[in] v The integer in host byte order.

Returns: v converted to little endian.

Definition at line 488 of file byteorder.h.

◆ byteorder_htolll()

static le_uint64_t byteorder_htolll ( uint64_t v )

inlinestatic

Convert from host byte order to little endian, 64 bit.

Parameters

[in] v The integer in host byte order.

Returns: v converted to little endian.

Definition at line 495 of file byteorder.h.

◆ byteorder_htols()

static le_uint16_t byteorder_htols ( uint16_t v )

inlinestatic

Convert from host byte order to little endian, 16 bit.

Parameters

[in] v The integer in host byte order.

Returns: v converted to little endian.

Definition at line 481 of file byteorder.h.

◆ byteorder_htonl()

static network_uint32_t byteorder_htonl ( uint32_t v )

inlinestatic

Convert from host byte order to network byte order, 32 bit.

Parameters

[in] v The integer in host byte order.

Returns: v converted to network byte order.

Definition at line 520 of file byteorder.h.

◆ byteorder_htonll()

static network_uint64_t byteorder_htonll ( uint64_t v )

inlinestatic

Convert from host byte order to network byte order, 64 bit.

Parameters

[in] v The integer in host byte order.

Returns: v converted to network byte order.

Definition at line 527 of file byteorder.h.

◆ byteorder_htons()

static network_uint16_t byteorder_htons ( uint16_t v )

inlinestatic

Convert from host byte order to network byte order, 16 bit.

Parameters

[in] v The integer in host byte order.

Returns: v converted to network byte order.

Definition at line 513 of file byteorder.h.

◆ byteorder_lebuftohl()

static uint32_t byteorder_lebuftohl ( const uint8_t * buf )

inlinestatic

Definition at line 683 of file byteorder.h.

◆ byteorder_lebuftohll()

static uint64_t byteorder_lebuftohll ( const uint8_t * buf )

inlinestatic

Definition at line 697 of file byteorder.h.

◆ byteorder_lebuftohs()

static uint16_t byteorder_lebuftohs ( const uint8_t * buf )

inlinestatic

Definition at line 672 of file byteorder.h.

◆ byteorder_ltobl()

static be_uint32_t byteorder_ltobl ( le_uint32_t v )

inlinestatic

Convert from little endian to big endian, 32 bit.

Parameters

[in] v The integer in little endian.

Returns: v converted to big endian.

Definition at line 446 of file byteorder.h.

◆ byteorder_ltobll()

static be_uint64_t byteorder_ltobll ( le_uint64_t v )

inlinestatic

Convert from little endian to big endian, 64 bit.

Parameters

[in] v The integer in little endian.

Returns: v converted to big endian.

Definition at line 453 of file byteorder.h.

◆ byteorder_ltobs()

static be_uint16_t byteorder_ltobs ( le_uint16_t v )

inlinestatic

Convert from little endian to big endian, 16 bit.

Parameters

[in] v The integer in little endian.

Returns: v converted to big endian.

Definition at line 439 of file byteorder.h.

◆ byteorder_ltohl()

static uint32_t byteorder_ltohl ( le_uint32_t v )

inlinestatic

Convert from little endian to host byte order, 32 bit.

Parameters

[in] v The integer in little endian.

Returns: v converted to host byte order.

Definition at line 429 of file byteorder.h.

◆ byteorder_ltohll()

static uint64_t byteorder_ltohll ( le_uint64_t v )

inlinestatic

Convert from little endian to host byte order, 64 bit.

Parameters

[in] v The integer in little endian.

Returns: v converted to host byte order.

Definition at line 434 of file byteorder.h.

◆ byteorder_ltohs()

static uint16_t byteorder_ltohs ( le_uint16_t v )

inlinestatic

Convert from little endian to host byte order, 16 bit.

Parameters

[in] v The integer in little endian.

Returns: v converted to host byte order.

Definition at line 424 of file byteorder.h.

◆ byteorder_ntohl()

static uint32_t byteorder_ntohl ( network_uint32_t v )

inlinestatic

Convert from network byte order to host byte order, 32 bit.

Parameters

[in] v The integer in network byte order.

Returns: v converted to host byte order.

Definition at line 539 of file byteorder.h.

◆ byteorder_ntohll()

static uint64_t byteorder_ntohll ( network_uint64_t v )

inlinestatic

Convert from network byte order to host byte order, 64 bit.

Parameters

[in] v The integer in network byte order.

Returns: v converted to host byte order.

Definition at line 544 of file byteorder.h.

◆ byteorder_ntohs()

static uint16_t byteorder_ntohs ( network_uint16_t v )

inlinestatic

Convert from network byte order to host byte order, 16 bit.

Parameters

[in] v The integer in network byte order.

Returns: v converted to host byte order.

Definition at line 534 of file byteorder.h.

◆ byteorder_swapl()

static uint32_t byteorder_swapl ( uint32_t v )

inlinestatic

Swap byte order, 32 bit.

Parameters

[in] v The integer to swap.

Returns: The swapped integer.

Definition at line 403 of file byteorder.h.

◆ byteorder_swapll()

static uint64_t byteorder_swapll ( uint64_t v )

inlinestatic

Swap byte order, 64 bit.

Parameters

[in] v The integer to swap.

Returns: The swapped integer.

Definition at line 408 of file byteorder.h.

◆ byteorder_swaps()

static uint16_t byteorder_swaps ( uint16_t v )

inlinestatic

Swap byte order, 16 bit.

Parameters

[in] v The integer to swap.

Returns: The swapped integer.

Definition at line 398 of file byteorder.h.

◆ htonl()

static uint32_t htonl ( uint32_t v )

inlinestatic

Convert from host byte order to network byte order, 32 bit.

See also: byteorder_htonl()

Parameters

[in] v The integer to convert.

Returns: Converted integer.

Definition at line 554 of file byteorder.h.

◆ htonll()

static uint64_t htonll ( uint64_t v )

inlinestatic

Convert from host byte order to network byte order, 64 bit.

See also: byteorder_htonll()

Parameters

[in] v The integer to convert.

Returns: Converted integer.

Definition at line 559 of file byteorder.h.

◆ htons()

static uint16_t htons ( uint16_t v )

inlinestatic

Convert from host byte order to network byte order, 16 bit.

See also: byteorder_htons()

Parameters

[in] v The integer to convert.

Returns: Converted integer.

Definition at line 549 of file byteorder.h.

◆ ntohl()

static uint32_t ntohl ( uint32_t v )

inlinestatic

Convert from network byte order to host byte order, 32 bit.

See also: byteorder_ntohl()

Parameters

[in] v The integer to convert.

Returns: Converted integer.

Definition at line 571 of file byteorder.h.

◆ ntohll()

static uint64_t ntohll ( uint64_t v )

inlinestatic

Convert from network byte order to host byte order, 64 bit.

See also: byteorder_ntohll()

Parameters

[in] v The integer to convert.

Returns: Converted integer.

Definition at line 578 of file byteorder.h.

◆ ntohs()

static uint16_t ntohs ( uint16_t v )

inlinestatic

Convert from network byte order to host byte order, 16 bit.

See also: byteorder_ntohs()

Parameters

[in] v The integer to convert.

Returns: Converted integer.

Definition at line 564 of file byteorder.h.

Detailed Description

Data Structures

Macro Definition Documentation

◆ _byteorder_swap

◆ _byteorder_swap_le

Typedef Documentation

◆ network_uint16_t

◆ network_uint32_t

◆ network_uint64_t

Function Documentation

◆ byteorder_bebuftohl()

◆ byteorder_bebuftohll()

◆ byteorder_bebuftohs()

◆ byteorder_btoll()

◆ byteorder_btolll()

◆ byteorder_btols()

◆ byteorder_htobebufl()

◆ byteorder_htobebufll()

◆ byteorder_htobebufs()

◆ byteorder_htolebufl()

◆ byteorder_htolebufll()

◆ byteorder_htolebufs()

◆ byteorder_htoll()

◆ byteorder_htolll()

◆ byteorder_htols()

◆ byteorder_htonl()

◆ byteorder_htonll()

◆ byteorder_htons()

◆ byteorder_lebuftohl()

◆ byteorder_lebuftohll()

◆ byteorder_lebuftohs()

◆ byteorder_ltobl()

◆ byteorder_ltobll()

◆ byteorder_ltobs()

◆ byteorder_ltohl()

◆ byteorder_ltohll()

◆ byteorder_ltohs()

◆ byteorder_ntohl()

◆ byteorder_ntohll()

◆ byteorder_ntohs()

◆ byteorder_swapl()

◆ byteorder_swapll()

◆ byteorder_swaps()

◆ htonl()

◆ htonll()

◆ htons()

◆ ntohl()

◆ ntohll()

◆ ntohs()