archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-27 14:54:52 +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/Double.java
View file

@ -739,6 +739,10 @@ public final class Double 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 value of the argument is NaN;
* {@code false} otherwise.
@ -751,6 +755,10 @@ public final class Double 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 value of the argument is positive
* infinity or negative infinity; {@code false} otherwise.
@ -765,6 +773,10 @@ public final class Double 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 d the {@code double} value to be tested
* @return {@code true} if the argument is a finite
* floating-point value, {@code false} otherwise.
@ -908,6 +920,10 @@ public final class Double extends Number
* Returns the value of this {@code Double} as a {@code float}
* after a narrowing primitive conversion.
*
* @apiNote
* This method corresponds to the convertFormat operation defined
* in IEEE 754.
*
* @return the {@code double} value represented by this object
* converted to type {@code float}
* @jls 5.1.3 Narrowing Primitive Conversion
@ -1217,6 +1233,9 @@ public final class Double extends Number
/**
* Adds two {@code double} 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}
@ -1232,6 +1251,10 @@ public final class Double extends Number
* Returns the greater of two {@code double} values
* as if by calling {@link Math#max(double, double) 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}
@ -1246,6 +1269,10 @@ public final class Double extends Number
* Returns the smaller of two {@code double} values
* as if by calling {@link Math#min(double, double) 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}.