idanoo/GoScrobble
1
0
Fork 0
mirror of https://github.com/idanoo/GoScrobble.git synced 2024-11-24 09:25:15 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
main
GoScrobble/web/node_modules/@webassemblyjs/floating-point-hex-parser
History
Daniel Mason 7e38fdbd7d 0.2.0 - Mid migration
2022-04-25 14:48:54 +12:00
..
esm 0.2.0 - Mid migration 2022-04-25 14:48:54 +12:00
lib 0.2.0 - Mid migration 2022-04-25 14:48:54 +12:00
LICENSE 0.2.0 - Mid migration 2022-04-25 14:48:54 +12:00
package.json 0.2.0 - Mid migration 2022-04-25 14:48:54 +12:00
README.md 0.2.0 - Mid migration 2022-04-25 14:48:54 +12:00

README.md

Parser function for floating point hexadecimals

license GitHub last commit npm

A JavaScript function to parse floating point hexadecimals as defined by the WebAssembly specification.

Usage

import parseHexFloat from '@webassemblyjs/floating-point-hex-parser'

parseHexFloat('0x1p-1')               // 0.5
parseHexFloat('0x1.921fb54442d18p+2') // 6.283185307179586

Tests

This module is tested in two ways. The first one is through a small set of test cases that can be found in test/regular.test.js. The second one is non-deterministic (sometimes called fuzzing):

  1. Generate a random IEEE754 double precision value x.
  2. Compute its representation y in floating point hexadecimal format using the C standard library function printf since C supports this format.
  3. Give both values to JS testcase and see if parseHexFloat(y) === x.

By default one npm test run tests 100 random samples. If you want to do more, you can set the environment variable FUZZ_AMOUNT to whatever number of runs you'd like. Because it uses one child process for each sample, it is really slow though. For more details about the randomized tests see the source.

Links