FpUtils

Returns the first floating-point argument with the sign of the second floating-point argument. For this method, a NaN sign argument is always treated as if it were positive.

Returns the first floating-point argument with the sign of the second floating-point argument. For this method, a NaN sign argument is always treated as if it were positive.

Returns unbiased exponent of a float.

Returns unbiased exponent of a double.

Returns unbiased exponent of a float; for subnormal values, the number is treated as if it were normalized. That is for all finite, non-zero, positive numbers x, scalb(x, -ilogb(x)) is always in the range [1, 2).

Special cases:

• If the argument is NaN, then the result is 2³⁰.
• If the argument is infinite, then the result is 2²⁸.
• If the argument is zero, then the result is -(2²⁸).

Returns unbiased exponent of a double; for subnormal values, the number is treated as if it were normalized. That is for all finite, non-zero, positive numbers x, scalb(x, -ilogb(x)) is always in the range [1, 2).

Special cases:

• If the argument is NaN, then the result is 2³⁰.
• If the argument is infinite, then the result is 2²⁸.
• If the argument is zero, then the result is -(2²⁸).

Returns true if the argument is a finite floating-point value; returns false otherwise (for NaN and infinity arguments).

Returns true if the argument is a finite floating-point value; returns false otherwise (for NaN and infinity arguments).

Returns true if the specified number is infinitely large in magnitude, false otherwise.

Note that this method is equivalent to the Float.isInfinite method; the functionality is included in this class for convenience.

Returns true if the specified number is infinitely large in magnitude, false otherwise.

Note that this method is equivalent to the Double.isInfinite method; the functionality is included in this class for convenience.

Returns true if the specified number is a Not-a-Number (NaN) value, false otherwise.

Note that this method is equivalent to the Double.isNaN method; the functionality is included in this class for convenience.

Returns true if the specified number is a Not-a-Number (NaN) value, false otherwise.

Note that this method is equivalent to the Float.isNaN method; the functionality is included in this class for convenience.

Returns true if the unordered relation holds between the two arguments. When two floating-point values are unordered, one value is neither less than, equal to, nor greater than the other. For the unordered relation to be true, at least one argument must be a NaN.

Returns true if the unordered relation holds between the two arguments. When two floating-point values are unordered, one value is neither less than, equal to, nor greater than the other. For the unordered relation to be true, at least one argument must be a NaN.

Returns the floating-point number adjacent to the first argument in the direction of the second argument. If both arguments compare as equal, the second argument is returned.

Special cases:

• If either argument is a NaN, then NaN is returned.
• If both arguments are signed zeros, a float zero with the same sign as direction is returned (as implied by the requirement of returning the second argument if the arguments compare as equal).
• If start is ±Float.MIN_VALUE and direction has a value such that the result should have a smaller magnitude, then a zero with the same sign as start is returned.
• If start is infinite and direction has a value such that the result should have a smaller magnitude, Float.MAX_VALUE with the same sign as start is returned.
• If start is equal to ± Float.MAX_VALUE and direction has a value such that the result should have a larger magnitude, an infinity with same sign as start is returned.

Returns the floating-point number adjacent to the first argument in the direction of the second argument. If both arguments compare as equal the second argument is returned.

Special cases:

• If either argument is a NaN, then NaN is returned.
• If both arguments are signed zeros, direction is returned unchanged (as implied by the requirement of returning the second argument if the arguments compare as equal).
• If start is ±Double.MIN_VALUE and direction has a value such that the result should have a smaller magnitude, then a zero with the same sign as start is returned.
• If start is infinite and direction has a value such that the result should have a smaller magnitude, Double.MAX_VALUE with the same sign as start is returned.
• If start is equal to ± Double.MAX_VALUE and direction has a value such that the result should have a larger magnitude, an infinity with same sign as start is returned.

Returns the floating-point value adjacent to d in the direction of negative infinity. This method is semantically equivalent to nextAfter(d, Double.NEGATIVE_INFINITY); however, a nextDown implementation may run faster than its equivalent nextAfter call.

Special Cases:

• If the argument is NaN, the result is NaN.
• If the argument is negative infinity, the result is negative infinity.
• If the argument is zero, the result is -Double.MIN_VALUE

Returns the floating-point value adjacent to f in the direction of negative infinity. This method is semantically equivalent to nextAfter(f, Float.NEGATIVE_INFINITY); however, a nextDown implementation may run faster than its equivalent nextAfter call.

Special Cases:

• If the argument is NaN, the result is NaN.
• If the argument is negative infinity, the result is negative infinity.
• If the argument is zero, the result is -Float.MIN_VALUE

Returns the floating-point value adjacent to f in the direction of positive infinity. This method is semantically equivalent to nextAfter(f, Double.POSITIVE_INFINITY); however, a nextUp implementation may run faster than its equivalent nextAfter call.

Special Cases:

• If the argument is NaN, the result is NaN.
• If the argument is positive infinity, the result is positive infinity.
• If the argument is zero, the result is Float.MIN_VALUE

Returns the floating-point value adjacent to d in the direction of positive infinity. This method is semantically equivalent to nextAfter(d, Double.POSITIVE_INFINITY); however, a nextUp implementation may run faster than its equivalent nextAfter call.

Special Cases:

• If the argument is NaN, the result is NaN.
• If the argument is positive infinity, the result is positive infinity.
• If the argument is zero, the result is Double.MIN_VALUE

Returns the first floating-point argument with the sign of the second floating-point argument. Note that unlike the copySign method, this method does not require NaN sign arguments to be treated as positive values; implementations are permitted to treat some NaN arguments as positive and other NaN arguments as negative to allow greater performance.

Returns the first floating-point argument with the sign of the second floating-point argument. Note that unlike the copySign method, this method does not require NaN sign arguments to be treated as positive values; implementations are permitted to treat some NaN arguments as positive and other NaN arguments as negative to allow greater performance.

Return d × 2^scale_factor rounded as if performed by a single correctly rounded floating-point multiply to a member of the double value set. See §4.2.3 of the Java Language Specification for a discussion of floating-point value sets. If the exponent of the result is between the double's minimum exponent and maximum exponent, the answer is calculated exactly. If the exponent of the result would be larger than doubles's maximum exponent, an infinity is returned. Note that if the result is subnormal, precision may be lost; that is, when scalb(x, n) is subnormal, scalb(scalb(x, n), -n) may not equal x. When the result is non-NaN, the result has the same sign as d.

Special cases:

• If the first argument is NaN, NaN is returned.
• If the first argument is infinite, then an infinity of the same sign is returned.
• If the first argument is zero, then a zero of the same sign is returned.

Return f × 2^scale_factor rounded as if performed by a single correctly rounded floating-point multiply to a member of the float value set. See §4.2.3 of the Java Language Specification for a discussion of floating-point value set. If the exponent of the result is between the float's minimum exponent and maximum exponent, the answer is calculated exactly. If the exponent of the result would be larger than float's maximum exponent, an infinity is returned. Note that if the result is subnormal, precision may be lost; that is, when scalb(x, n) is subnormal, scalb(scalb(x, n), -n) may not equal x. When the result is non-NaN, the result has the same sign as f.

Special cases:

• If the first argument is NaN, NaN is returned.
• If the first argument is infinite, then an infinity of the same sign is returned.
• If the first argument is zero, then a zero of the same sign is returned.

Returns the signum function of the argument; zero if the argument is zero, 1.0 if the argument is greater than zero, -1.0 if the argument is less than zero.

Special Cases:

• If the argument is NaN, then the result is NaN.
• If the argument is positive zero or negative zero, then the result is the same as the argument.

Returns the signum function of the argument; zero if the argument is zero, 1.0f if the argument is greater than zero, -1.0f if the argument is less than zero.

Special Cases:

• If the argument is NaN, then the result is NaN.
• If the argument is positive zero or negative zero, then the result is the same as the argument.

Returns the size of an ulp of the argument. An ulp of a float value is the positive distance between this floating-point value and the float value next larger in magnitude. Note that for non-NaN x, ulp(-x) == ulp(x).

Special Cases:

• If the argument is NaN, then the result is NaN.
• If the argument is positive or negative infinity, then the result is positive infinity.
• If the argument is positive or negative zero, then the result is Float.MIN_VALUE.
• If the argument is ±Float.MAX_VALUE, then the result is equal to 2¹⁰⁴.

Returns the size of an ulp of the argument. An ulp of a double value is the positive distance between this floating-point value and the double value next larger in magnitude. Note that for non-NaN x, ulp(-x) == ulp(x).

Special Cases:

• If the argument is NaN, then the result is NaN.
• If the argument is positive or negative infinity, then the result is positive infinity.
• If the argument is positive or negative zero, then the result is Double.MIN_VALUE.
• If the argument is ±Double.MAX_VALUE, then the result is equal to 2⁹⁷¹.