# ieee-float

> pure javascript IEEE 754 32-bit and 64-bit floating point binary conversion

Latest version **0.6.0** (published 2018-01-27) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install ieee-float
pnpm add ieee-float
yarn add ieee-float
bun add ieee-float
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.6.0 |
| Published | 2018-01-27 |
| First published | 2017-12-24 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >= 0.10 |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | Andras |
| Maintainers | andrasq |
| Keywords | ieee, 754, floating point, conversion, read, write |

## Links

- npm: https://www.npmjs.com/package/ieee-float
- Repository: https://github.com/andrasq/node-ieee-float.git#readme
- Homepage: https://github.com/andrasq/node-ieee-float/tree/readme#readme
- Issues: https://github.com/andrasq/node-ieee-float/issues
- npm.io page: https://npm.io/package/ieee-float

## Alternatives

- [csv-to-markdown-table](https://npm.io/package/csv-to-markdown-table.md) — 47.0K weekly downloads
- [@sapphire/ratelimits](https://npm.io/package/@sapphire/ratelimits.md) — 4.4K weekly downloads
- [js-csvparser](https://npm.io/package/js-csvparser.md) — 2.0K weekly downloads
- [@adadapted/js-sdk](https://npm.io/package/@adadapted/js-sdk.md) — 251 weekly downloads
- [@grapecity/spread-sheets-sparklines](https://npm.io/package/@grapecity/spread-sheets-sparklines.md) — 103 weekly downloads

## Recent versions

- 0.6.0 (latest) — 2018-01-27
- 0.3.5 (backfill) — 2019-03-29
- 0.5.1 — 2018-01-16
- 0.4.0 — 2017-12-27
- 0.3.2 — 2017-12-24

## README

ieee-float
==========
[![Build Status](https://api.travis-ci.org/andrasq/node-ieee-float.svg?branch=master)](https://travis-ci.org/andrasq/node-ieee-float?branch=master)
[![Coverage Status](https://codecov.io/github/andrasq/node-ieee-float/coverage.svg?branch=master)](https://codecov.io/github/andrasq/node-ieee-float?branch=master)


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](https://github.com/andrasq/node-qbson#readme)
- [messagepackjs](https://npmjs.com/package/messagepackjs)
- [buffalo](https://npmjs.com/package/buffalo)

---
_Source: https://npm.io/package/ieee-float · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._