ieee-float

ieee-float

IEEE 754 32-bit and 64-bit floating point JavaScript binary conversion

Read and write 32-bit and 64-bit floating-point numbers to either Arrays or nodejs Buffers.

var fp = require('ieee-float');
var output = [];

fp.writeFloatLE(output, 1.5);
// => output = [0, 0, 192, 63]

var val = fp.readFloatBE(output.reverse());
// => 1.5

Api

writeFloatLE( buf, val, [offset] )

Store a little-endian 32-bit float into the buffer or array buf starting at offset (default 0). No bounds checking is done, will write past the end of the buffer.

writeFloatBE( buf, val, [offset] )

Store a big-endian 32-bit float into the buffer or array buf starting at offset. No bounds checking is done, will write past the end of the buffer.

readFloatLE( buf, [offset] )

Extract a little-endian 32-bit float from the buffer or array buf starting at offset. No bounds checking is done, will read past the end of the array and return 0.

readFloatBE( buf, [offset] )

Extract a big-endian 32-bit float from the buffer or array buf starting at offset. No bounds checking is done, will read past the end of the buffer and return 0.

writeDoubleLE( buf, val, [offset] )

Store a little-endian 64-bit double into buf starting at offset (default offset 0).

writeDoubleBE( buf, val, [offset] )

Store a big-endian 64-bit double into buf starting at offset (default offset 0).

readDoubleLE( buf, [offset] )

Extract a little-endian 64-bit double from the bytes in buf starting at offset.

readDoubleBE( buf, [offset] )

Extract a big-endian 64-bit double from the bytes in buf starting at offset.

Benchmark

qtimeit=0.21.0 node=8.9.1 v8=6.1.534.47 platform=linux kernel=4.9.0-0.bpo.4-amd64 up_threshold=false
arch=ia32 mhz=4513 cpuCount=8 cpu="Intel(R) Core(TM) i7-6700K CPU @ 4.00GHz"
timeGoal=0.2 opsPerTest=1 forkTests=false
name                            speed           rate
nodejs read float          19,410,324 ops/sec    485 >>
ieee-float read float      86,210,648 ops/sec   2155 >>>>>>>>>>>
nodejs write float         22,589,349 ops/sec    565 >>>
ieee-float write float    296,086,555 ops/sec   7402 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
nodejs read double         17,608,010 ops/sec    440 >>
ieee-float read double     62,516,398 ops/sec   1563 >>>>>>>>
nodejs write double        22,425,025 ops/sec    561 >>>
ieee-float write double   258,465,677 ops/sec   6462 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

Todo

• perhaps should return NaN (or throw) if reading from outside the array bounds

Related Work

• qbson
• messagepackjs
• buffalo