nmUnpackF32

Unpack a 32-bit float from the message buffer. More...

Unpack a 32-bit float from the message buffer.

Synopsis:

#include "rnr/netmsgs.h"

extern int nmUnpackF32(byte_t buf[], size_t bufSize, float *pVal, NMEndian_T eEndian);

Description:
The IEEE 754 32-bit format is used with both the big and little endian byte orders.

Note

On some machines, while integers were represented in little-endian form, floating point numbers were represented in big-endian form. Because there are many floating point formats, and a lack of a standard network representation, no standard for transferring floating point values has been made - Wikipedia.

Todo:

Detect non-IEEE 754 formats and convert to IEEE 754 prior to packing.

Parameters

[in]	buf	Input message buffer.
	bufSize	Size of input buffer.
[out]	pVal	Pointer to value to unpack (set).
	eEndian	Unpacking order. See NMEndian_T.

Returns

On success, returns the number of bytes unpacked. On error, the appropriate negated netmsgs error code ( < 0) is returned.