phobos ~master (2024-10-03T07:50:27Z)

nativeToLittleEndian

std bitmanip

Converts the given value from the native endianness to little endian and returns it as a ubyte[n] where n is the size of the given type.

Returning a ubyte[n] helps prevent accidentally using a swapped value as a regular one (and in the case of floating point values, it's necessary, because the FPU will mess up any swapped floating point values. So, you can't actually have swapped floating point values as floating point values).

@safe pure nothrow @nogc
auto
nativeToLittleEndian
(
T
)
(
const T val
)
if (
canSwapEndianness!T
)

Examples

int i = 12345;
ubyte[4] swappedI = nativeToLittleEndian(i);
assert(i == littleEndianToNative!int(swappedI));

double d = 123.45;
ubyte[8] swappedD = nativeToLittleEndian(d);
assert(d == littleEndianToNative!double(swappedD));

Meta

Source

See Implementation

std bitmanip aliasesfunctionsstructstemplates

Page generated by adrdox