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