Floating Point

Functions
posh_u32_t	POSH_LittleFloatBits (float f)
posh_u32_t	POSH_BigFloatBits (float f)
void	POSH_DoubleBits (double d, posh_byte_t dst[8])
double	POSH_DoubleFromBits (const posh_byte_t src[8])
float	POSH_FloatFromLittleBits (posh_u32_t bits)
float	POSH_FloatFromBigBits (posh_u32_t bits)
float *	POSH_WriteFloatToLittle (void *dst, float f)
float *	POSH_WriteFloatToBig (void *dst, float f)
float	POSH_ReadFloatFromLittle (const void *src)
float	POSH_ReadFloatFromBig (const void *src)
double *	POSH_WriteDoubleToLittle (void *dst, double d)
double *	POSH_WriteDoubleToBig (void *dst, double d)
double	POSH_ReadDoubleFromLittle (const void *src)
double	POSH_ReadDoubleFromBig (const void *src)

Detailed Description

Unavailable if @ref POSH_NO_FLOAT "POSH_NO_FLOAT" is defined.  By
default floating point support is enabled, but if you find that
this causes problems or is inconvenient and you're not using
the support, you can define <code><b>POSH_NO_FLOAT</code></b> to disable
POSH's use of any floating point types or operations.

Here are some code examples:

*
*  //read a little-endian float from disk
*  float LoadFloat( FILE *fp )
*  {
*  float      f;
*  posh_u32_t u32;
*
*  fread( &u32, sizeof( u32 ), 1, fp );
*
*  f = POSH_FloatFromLittleBits( u32 );
*
*  return f;
*  }
*
*  //write a little-endian float to disk
*  void WriteFloat( FILE *fp, float f )
*  {
*  posh_u32_t u32;
*
*  u32 = POSH_LittleFloatBits( f );
*
*  fwrite( &u32, sizeof( u32 ), 1, fp );
*  }
*
*  

Function Documentation

posh_u32_t POSH_BigFloatBits

(

float

f)

Extracts raw big-endian bits from a 32-bit floating point value

Parameters

f[in]

floating point value

Returns

a big-endian bit representation of f

Definition at line 671 of file posh.cpp.

References POSH_SwapU32().

Referenced by NetBuffer::addFloat(), and s_testFloatingPoint().

{
    union
    {
        float f32;
        posh_u32_t u32;
    }
    u;

    u.f32 = f;

#if defined POSH_LITTLE_ENDIAN
    return POSH_SwapU32( u.u32 );

#else
    return u.u32;
#endif
}

void POSH_DoubleBits	(	double	d,
		posh_byte_t	dst[8]
	)

Extracts raw, little-endian bit representation from a 64-bit double.

Parameters

d[in]	64-bit double precision value
dst[out]	8-byte storage buffer

Returns

the raw bits used to represent the value 'd', in the form dst[0]=LSB

Definition at line 698 of file posh.cpp.

Referenced by NetBuffer::addDouble(), and s_testFloatingPoint().

{
    union
    {
        double d64;
        posh_byte_t bytes[8];
    }
    u;

    u.d64  = d;

#if defined POSH_LITTLE_ENDIAN
    dst[0] = u.bytes[0];
    dst[1] = u.bytes[1];
    dst[2] = u.bytes[2];
    dst[3] = u.bytes[3];
    dst[4] = u.bytes[4];
    dst[5] = u.bytes[5];
    dst[6] = u.bytes[6];
    dst[7] = u.bytes[7];
#else
    dst[0] = u.bytes[7];
    dst[1] = u.bytes[6];
    dst[2] = u.bytes[5];
    dst[3] = u.bytes[4];
    dst[4] = u.bytes[3];
    dst[5] = u.bytes[2];
    dst[6] = u.bytes[1];
    dst[7] = u.bytes[0];
#endif
}

double POSH_DoubleFromBits

(

const posh_byte_t

src[8])

Creates a double-precision, 64-bit floating point value from a set if raw, little-endian bits

Parameters

src[in]

little-endian byte representation of 64-bit double precision floating point value

Returns

double precision floating point representation of the raw bits

Remarks

No error checking is performed, so there are no guarantees that the result is a valid number, nor is there any check to ensure that src is non-NULL. BE CAREFUL USING THIS.

Definition at line 742 of file posh.cpp.

Referenced by NetBuffer::getDouble(), and s_testFloatingPoint().

{
    union
    {
        double d64;
        posh_byte_t bytes[8];
    }
    u;

#if defined POSH_LITTLE_ENDIAN
    u.bytes[0] = src[0];
    u.bytes[1] = src[1];
    u.bytes[2] = src[2];
    u.bytes[3] = src[3];
    u.bytes[4] = src[4];
    u.bytes[5] = src[5];
    u.bytes[6] = src[6];
    u.bytes[7] = src[7];
#else
    u.bytes[0] = src[7];
    u.bytes[1] = src[6];
    u.bytes[2] = src[5];
    u.bytes[3] = src[4];
    u.bytes[4] = src[3];
    u.bytes[5] = src[2];
    u.bytes[6] = src[1];
    u.bytes[7] = src[0];
#endif

    return u.d64;
}

float POSH_FloatFromBigBits

(

posh_u32_t

bits)

Creates a floating point number from big-endian bits

Parameters

bits[in]

raw floating point bits in big-endian form

Returns

a floating point number based on the given bit representation

Remarks

No error checking is performed, so there are no guarantees that the result is a valid number. BE CAREFUL USING THIS.

Definition at line 809 of file posh.cpp.

References bits, and POSH_SwapU32().

Referenced by NetBuffer::getFloat(), and s_testFloatingPoint().

{
    union
    {
        float f32;
        posh_u32_t u32;
    }
    u;

    u.u32 = bits;
#if defined POSH_LITTLE_ENDIAN
    u.u32 = POSH_SwapU32( u.u32 );
#endif

    return u.f32;
}

float POSH_FloatFromLittleBits

(

posh_u32_t

bits)

Creates a floating point number from little endian bits

Parameters

bits[in]

raw floating point bits in little-endian form

Returns

a floating point number based on the given bit representation

Remarks

No error checking is performed, so there are no guarantees that the result is a valid number. BE CAREFUL USING THIS.

Definition at line 783 of file posh.cpp.

References bits, and POSH_SwapU32().

Referenced by s_testFloatingPoint().

{
    union
    {
        float f32;
        posh_u32_t u32;
    }
    u;

    u.u32 = bits;
#if defined POSH_BIG_ENDIAN
    u.u32 = POSH_SwapU32( u.u32 );
#endif

    return u.f32;
}

posh_u32_t POSH_LittleFloatBits

(

float

f)

Extracts raw little-endian bits from a 32-bit floating point value

Parameters

f[in]

floating point value

Returns

a little-endian bit representation of f

Definition at line 645 of file posh.cpp.

References POSH_SwapU32().

Referenced by s_testFloatingPoint().

{
    union
    {
        float f32;
        posh_u32_t u32;
    }
    u;

    u.f32 = f;

#if defined POSH_LITTLE_ENDIAN
    return u.u32;

#else
    return POSH_SwapU32( u.u32 );
#endif
}

double POSH_ReadDoubleFromBig

(

const void *

src)

double POSH_ReadDoubleFromLittle

(

const void *

src)

float POSH_ReadFloatFromBig

(

const void *

src)

float POSH_ReadFloatFromLittle

(

const void *

src)

double* POSH_WriteDoubleToBig	(	void *	dst,
		double	d
	)

double* POSH_WriteDoubleToLittle	(	void *	dst,
		double	d
	)

float* POSH_WriteFloatToBig	(	void *	dst,
		float	f
	)

float* POSH_WriteFloatToLittle	(	void *	dst,
		float	f
	)