time-to-botec

Benchmark sampling in different programming languages
Log | Files | Refs | README

repl.txt (1269B)


      1 
      2 {{alias}}( x, low )
      3     Sets the less significant 32 bits of a double-precision floating-point
      4     number.
      5 
      6     Setting the lower order bits of `NaN` or positive or negative infinity will
      7     return `NaN`, as `NaN` is defined as a double whose exponent bit sequence is
      8     all ones and whose fraction can be any bit sequence except all zeros.
      9     Positive and negative infinity are defined as doubles with an exponent bit
     10     sequence equal to all ones and a fraction equal to all zeros. Hence,
     11     changing the less significant bits of positive and negative infinity
     12     converts each value to `NaN`.
     13 
     14     Parameters
     15     ----------
     16     x: number
     17         Input value.
     18 
     19     low: integer
     20         Unsigned 32-bit integer to replace the lower order word of `x`.
     21 
     22     Returns
     23     -------
     24     out: number
     25         Double having the same higher order word as `x`.
     26 
     27     Examples
     28     --------
     29     > var low = 5 >>> 0;
     30     > var x = 3.14e201;
     31     > var y = {{alias}}( x, low )
     32     3.139998651394392e+201
     33 
     34     // Special cases:
     35     > var low = 12345678;
     36     > var y = {{alias}}( {{alias:@stdlib/constants/float64/pinf}}, low )
     37     NaN
     38     > y = {{alias}}( {{alias:@stdlib/constants/float64/ninf}}, low )
     39     NaN
     40     > y = {{alias}}( NaN, low )
     41     NaN
     42 
     43     See Also
     44     --------
     45