src/java.base/share/classes/java/lang/Math.java
changeset 57923 3da1848cc39b
parent 57863 cf45b7945e4b
child 58421 6fc57e391539
equal deleted inserted replaced
57919:339af8e17cb3 57923:3da1848cc39b
   950     }
   950     }
   951 
   951 
   952     /**
   952     /**
   953      * Returns the argument incremented by one, throwing an exception if the
   953      * Returns the argument incremented by one, throwing an exception if the
   954      * result overflows an {@code int}.
   954      * result overflows an {@code int}.
       
   955      * The overflow only occurs for {@linkplain Integer#MAX_VALUE the maximum value}.
   955      *
   956      *
   956      * @param a the value to increment
   957      * @param a the value to increment
   957      * @return the result
   958      * @return the result
   958      * @throws ArithmeticException if the result overflows an int
   959      * @throws ArithmeticException if the result overflows an int
   959      * @since 1.8
   960      * @since 1.8
   968     }
   969     }
   969 
   970 
   970     /**
   971     /**
   971      * Returns the argument incremented by one, throwing an exception if the
   972      * Returns the argument incremented by one, throwing an exception if the
   972      * result overflows a {@code long}.
   973      * result overflows a {@code long}.
       
   974      * The overflow only occurs for {@linkplain Long#MAX_VALUE the maximum value}.
   973      *
   975      *
   974      * @param a the value to increment
   976      * @param a the value to increment
   975      * @return the result
   977      * @return the result
   976      * @throws ArithmeticException if the result overflows a long
   978      * @throws ArithmeticException if the result overflows a long
   977      * @since 1.8
   979      * @since 1.8
   986     }
   988     }
   987 
   989 
   988     /**
   990     /**
   989      * Returns the argument decremented by one, throwing an exception if the
   991      * Returns the argument decremented by one, throwing an exception if the
   990      * result overflows an {@code int}.
   992      * result overflows an {@code int}.
       
   993      * The overflow only occurs for {@linkplain Integer#MIN_VALUE the minimum value}.
   991      *
   994      *
   992      * @param a the value to decrement
   995      * @param a the value to decrement
   993      * @return the result
   996      * @return the result
   994      * @throws ArithmeticException if the result overflows an int
   997      * @throws ArithmeticException if the result overflows an int
   995      * @since 1.8
   998      * @since 1.8
  1004     }
  1007     }
  1005 
  1008 
  1006     /**
  1009     /**
  1007      * Returns the argument decremented by one, throwing an exception if the
  1010      * Returns the argument decremented by one, throwing an exception if the
  1008      * result overflows a {@code long}.
  1011      * result overflows a {@code long}.
       
  1012      * The overflow only occurs for {@linkplain Long#MIN_VALUE the minimum value}.
  1009      *
  1013      *
  1010      * @param a the value to decrement
  1014      * @param a the value to decrement
  1011      * @return the result
  1015      * @return the result
  1012      * @throws ArithmeticException if the result overflows a long
  1016      * @throws ArithmeticException if the result overflows a long
  1013      * @since 1.8
  1017      * @since 1.8
  1022     }
  1026     }
  1023 
  1027 
  1024     /**
  1028     /**
  1025      * Returns the negation of the argument, throwing an exception if the
  1029      * Returns the negation of the argument, throwing an exception if the
  1026      * result overflows an {@code int}.
  1030      * result overflows an {@code int}.
       
  1031      * The overflow only occurs for {@linkplain Integer#MIN_VALUE the minimum value}.
  1027      *
  1032      *
  1028      * @param a the value to negate
  1033      * @param a the value to negate
  1029      * @return the result
  1034      * @return the result
  1030      * @throws ArithmeticException if the result overflows an int
  1035      * @throws ArithmeticException if the result overflows an int
  1031      * @since 1.8
  1036      * @since 1.8
  1040     }
  1045     }
  1041 
  1046 
  1042     /**
  1047     /**
  1043      * Returns the negation of the argument, throwing an exception if the
  1048      * Returns the negation of the argument, throwing an exception if the
  1044      * result overflows a {@code long}.
  1049      * result overflows a {@code long}.
       
  1050      * The overflow only occurs for {@linkplain Long#MIN_VALUE the minimum value}.
  1045      *
  1051      *
  1046      * @param a the value to negate
  1052      * @param a the value to negate
  1047      * @return the result
  1053      * @return the result
  1048      * @throws ArithmeticException if the result overflows a long
  1054      * @throws ArithmeticException if the result overflows a long
  1049      * @since 1.8
  1055      * @since 1.8