stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8294730: Add @throws and @implNote clauses to BigInteger::isProblablePrime and BigInteger::nextProblablePrime

Browse Source 
Reviewed-by: darcy, bpb
This commit is contained in:
Raffaello Giulietti 2022-10-18 09:56:03 +00:00
parent 4434cbb719
commit 0b7d811c98
1 changed files with 9 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
src/java.base/share/classes/java/math/BigInteger.java
View File

@ -868,6 +868,10 @@ public class BigInteger extends Number implements Comparable<BigInteger> {
* @return the first integer greater than this {@code BigInteger} that
* is probably prime.
* @throws ArithmeticException {@code this < 0} or {@code this} is too large.
* @implNote Due to the nature of the underlying algorithm,
* and depending on the size of {@code this},
* this method could consume a large amount of memory, up to
* exhaustion of available heap space, or could run for a long time.
* @since 1.5
*/
public BigInteger nextProbablePrime() {
@ -3880,6 +3884,11 @@ public class BigInteger extends Number implements Comparable<BigInteger> {
* this method is proportional to the value of this parameter.
* @return {@code true} if this BigInteger is probably prime,
* {@code false} if it's definitely composite.
* @throws ArithmeticException {@code this} is too large.
* @implNote Due to the nature of the underlying primality test algorithm,
* and depending on the size of {@code this} and {@code certainty},
* this method could consume a large amount of memory, up to
* exhaustion of available heap space, or could run for a long time.
*/
public boolean isProbablePrime(int certainty) {
if (certainty <= 0)