archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-27 23:04:50 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8273346: Expand library mappings to IEEE 754 operations

Browse source 
Reviewed-by: bpb
This commit is contained in:
Joe Darcy 2022-06-07 16:13:42 +00:00
parent 96641c0c42
commit 5d4ea9b954
4 changed files with 156 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

27
src/java.base/share/classes/java/lang/Float.java
View file

@ -559,6 +559,10 @@ public final class Float extends Number
* Returns {@code true} if the specified number is a
* Not-a-Number (NaN) value, {@code false} otherwise.
*
* @apiNote
* This method corresponds to the isNaN operation defined in IEEE
* 754.
*
* @param v the value to be tested.
* @return {@code true} if the argument is NaN;
* {@code false} otherwise.
@ -571,6 +575,10 @@ public final class Float extends Number
* Returns {@code true} if the specified number is infinitely
* large in magnitude, {@code false} otherwise.
*
* @apiNote
* This method corresponds to the isInfinite operation defined in
* IEEE 754.
*
* @param v the value to be tested.
* @return {@code true} if the argument is positive infinity or
* negative infinity; {@code false} otherwise.
@ -586,6 +594,10 @@ public final class Float extends Number
* value; returns {@code false} otherwise (for NaN and infinity
* arguments).
*
* @apiNote
* This method corresponds to the isFinite operation defined in
* IEEE 754.
*
* @param f the {@code float} value to be tested
* @return {@code true} if the argument is a finite
* floating-point value, {@code false} otherwise.
@ -754,6 +766,10 @@ public final class Float extends Number
* Returns the value of this {@code Float} as a {@code double}
* after a widening primitive conversion.
*
* @apiNote
* This method corresponds to the convertFormat operation defined
* in IEEE 754.
*
* @return the {@code float} value represented by this
* object converted to type {@code double}
* @jls 5.1.2 Widening Primitive Conversion
@ -1039,6 +1055,9 @@ public final class Float extends Number
/**
* Adds two {@code float} values together as per the + operator.
*
* @apiNote This method corresponds to the addition operation
* defined in IEEE 754.
*
* @param a the first operand
* @param b the second operand
* @return the sum of {@code a} and {@code b}
@ -1054,6 +1073,10 @@ public final class Float extends Number
* Returns the greater of two {@code float} values
* as if by calling {@link Math#max(float, float) Math.max}.
*
* @apiNote
* This method corresponds to the maximum operation defined in
* IEEE 754.
*
* @param a the first operand
* @param b the second operand
* @return the greater of {@code a} and {@code b}
@ -1068,6 +1091,10 @@ public final class Float extends Number
* Returns the smaller of two {@code float} values
* as if by calling {@link Math#min(float, float) Math.min}.
*
* @apiNote
* This method corresponds to the minimum operation defined in
* IEEE 754.
*
* @param a the first operand
* @param b the second operand
* @return the smaller of {@code a} and {@code b}