All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.lang.Math 

java.lang.Object
   |
   +----java.lang.Math
public final class Math
extends Object
The class Math contains methods for performing basic numeric operations such as the elementary exponential, logarithm, square root, and trigonometric functions.

To help ensure portability of Java programs, the definitions of many of the numeric functions in this package require that they produce the same results as certain published algorithms. These algorithms are available from the well-known network library netlib as the package "Freely Distributable Math Library" (fdlibm). These algorithms, which are written in the C programming language, are then to be understood as executed with all floating-point operations following the rules of Java floating-point arithmetic.

The network library may be found on the World Wide Web at

then perform a keyword search for "fdlibm".

The Java math library is defined with respect to the version of fdlibm dated January 4, 1995. Where fdlibm provides more than one definition for a function (such as acos), use the "IEEE 754 core function" version (residing in a file whose name begins with the letter e).

Variable Index

o E
The double value that is closer than any other to e, the base of the natural logarithms.
o PI
The double value that is closer than any other to pi, the ratio of the circumference of a circle to its diameter.

Method Index

o abs(double)
Returns the absolute value of a double value.
o abs(float)
Returns the absolute value of a float value.
o abs(int)
Returns the absolute value of an int value.
o abs(long)
Returns the absolute value of a long value.
o acos(double)
Returns the arc cosine of an angle, in the range of 0.0 through pi.
o asin(double)
Returns the arc sine of an angle, in the range of -pi/2 through pi/2.
o atan(double)
Returns the arc tangent of an angle, in the range of -pi/2 through pi/2.
o atan2(double, double)
Converts rectangular coordinates (b, a) to polar (r, theta).
o ceil(double)
Returns the smallest (closest to negative infinity) double value that is not less than the argument and is equal to a mathematical integer.
o cos(double)
Returns the trigonometric cosine of an angle.
o exp(double)
Returns the exponential number e (i.e., 2.718...) raised to the power of a double value.
o floor(double)
Returns the largest (closest to positive infinity) double value that is not greater than the argument and is equal to a mathematical integer.
o IEEEremainder(double, double)
Computes the remainder operation on two arguments as prescribed by the IEEE 754 standard.
o log(double)
Returns the natural logarithm (base e) of a double value.
o max(double, double)
Returns the greater of two double values.
o max(float, float)
Returns the greater of two float values.
o max(int, int)
Returns the greater of two int values.
o max(long, long)
Returns the greater of two long values.
o min(double, double)
Returns the smaller of two double values.
o min(float, float)
Returns the smaller of two float values.
o min(int, int)
Returns the smaller of two int values.
o min(long, long)
Returns the smaller of two long values.
o pow(double, double)
Returns of value of the first argument raised to the power of the second argument.
o random()
Returns a random number between 0.0 and 1.0.
o rint(double)
returns the closest integer to the argument.
o round(double)
Returns the closest long to the argument.
o round(float)
Returns the closest int to the argument.
o sin(double)
Returns the trigonometric sine of an angle.
o sqrt(double)
Returns the square root of a double value.
o tan(double)
Returns the trigonometric tangent of an angle.

Variables

o E 
Properties Public Constant 
   E=double
The double value that is closer than any other to e, the base of the natural logarithms.

o PI 
Properties Public Constant 
   PI=double
The double value that is closer than any other to pi, the ratio of the circumference of a circle to its diameter.

Methods

o sin 
    method sin(a=double) returns double public  static
Returns the trigonometric sine of an angle.

Parameters:
a - an angle, in radians.
Returns:
the sine of the argument.
o cos 
    method cos(a=double) returns double public  static
Returns the trigonometric cosine of an angle.

Parameters:
a - an angle, in radians.
Returns:
the cosine of the argument.
o tan 
    method tan(a=double) returns double public  static
Returns the trigonometric tangent of an angle.

Parameters:
a - an angle, in radians.
Returns:
the tangent of the argument.
o asin 
    method asin(a=double) returns double public  static
Returns the arc sine of an angle, in the range of -pi/2 through pi/2.

Parameters:
a - an angle, in radians.
Returns:
the arc sine of the argument.
o acos 
    method acos(a=double) returns double public  static
Returns the arc cosine of an angle, in the range of 0.0 through pi.

Parameters:
a - an angle, in radians.
Returns:
the arc cosine of the argument.
o atan 
    method atan(a=double) returns double public  static
Returns the arc tangent of an angle, in the range of -pi/2 through pi/2.

Parameters:
a - an angle, in radians.
Returns:
the arc tangent of the argument.
o exp 
    method exp(a=double) returns double public  static
Returns the exponential number e (i.e., 2.718...) raised to the power of a double value.

Parameters:
a - a double value.
Returns:
the value ea, where e is the base of the natural logarithms.
o log 
    method log(a=double) returns double public  static
Returns the natural logarithm (base e) of a double value.

Parameters:
a - a number greater than 0.0.
Returns:
the value ln a, the natural logarithm of a.
o sqrt 
    method sqrt(a=double) returns double public  static
Returns the square root of a double value.

Parameters:
a - a double value.
Returns:
the square root of a. If the argument is NaN or less than zero, the result is NaN.
o IEEEremainder 
    method IEEEremainder(f1=double, -
                         f2=double) returns double public  static
Computes the remainder operation on two arguments as prescribed by the IEEE 754 standard. The remainder value is mathematically equal to f1 - f2 × n, where n is the mathematical integer closest to the exact mathematical value of the quotient f1/f2, and if two mathematical integers are equally close to f1/f2, then n is the integer that is even. If the remainder is zero, its sign is the same as the sign of the first argument.

Parameters:
f1 - the dividend.
f2 - the divisor.
Returns:
the remainder when f1 is divided by f2.
o ceil 
    method ceil(a=double) returns double public  static
Returns the smallest (closest to negative infinity) double value that is not less than the argument and is equal to a mathematical integer.

Parameters:
a - a double value.
Returns:
the smallest (closest to negative infinity) double value that is not less than the argument and is equal to a mathematical integer.
o floor 
    method floor(a=double) returns double public  static
Returns the largest (closest to positive infinity) double value that is not greater than the argument and is equal to a mathematical integer.

Parameters:
a - a double value.
a - an assigned value.
Returns:
the largest (closest to positive infinity) double value that is not greater than the argument and is equal to a mathematical integer.
o rint 
    method rint(a=double) returns double public  static
returns the closest integer to the argument.

Parameters:
a - a double value.
Returns:
the closest double value to a that is equal to a mathematical integer. If two double values that are mathematical integers are equally close to the value of the argument, the result is the integer value that is even.
o atan2 
    method atan2(a=double, -
                 b=double) returns double public  static
Converts rectangular coordinates (b, a) to polar (r, theta). This method computes the phase theta by computing an arc tangent of b/a in the range of -pi to pi.

Parameters:
a - a double value.
b - a double value.
Returns:
the theta component of the point (r, theta) in polar coordinates that corresponds to the point (b, a) in Cartesian coordinates.
o pow 
    method pow(a=double, -
               b=double) returns double public  static
Returns of value of the first argument raised to the power of the second argument.

If (a == 0.0), then b must be greater than 0.0; otherwise an exception is thrown. An exception also will occur if (a <= 0.0) and b is not equal to a whole number.

Parameters:
a - a double value.
b - a double value.
Returns:
the value ab.
Throws: ArithmeticException
if (a == 0.0) and (b <= 0.0), or if (a <= 0.0) and b is not equal to a whole number.
o round 
    method round(a=float) returns int public  static
Returns the closest int to the argument.

If the argument is negative infinity or any value less than or equal to the value of Integer.MIN_VALUE, the result is equal to the value of Integer.MIN_VALUE.

If the argument is positive infinity or any value greater than or equal to the value of Integer.MAX_VALUE, the result is equal to the value of Integer.MAX_VALUE.

Parameters:
a - a float value.
Returns:
the value of the argument rounded to the nearest int value.
See Also:
MAX_VALUE, MIN_VALUE
o round 
    method round(a=double) returns long public  static
Returns the closest long to the argument.

If the argument is negative infinity or any value less than or equal to the value of Long.MIN_VALUE, the result is equal to the value of Long.MIN_VALUE.

If the argument is positive infinity or any value greater than or equal to the value of Long.MAX_VALUE, the result is equal to the value of Long.MAX_VALUE.

Parameters:
a - a double value.
Returns:
the value of the argument rounded to the nearest long value.
See Also:
MAX_VALUE, MIN_VALUE
o random 
    method random() returns double public  static  protect
Returns a random number between 0.0 and 1.0. Random number generators are often referred to as pseudorandom number generators because the numbers produced tend to repeat themselves after a period of time.

Returns:
a pseudorandom double between 0.0 and 1.0.
See Also:
nextDouble
o abs 
    method abs(a=int) returns int public  static
Returns the absolute value of an int value. If the argument is not negative, the argument is returned. If the argument is negative, the negation of the argument is returned.

Note that if the argument is equal to the value of Integer.MIN_VALUE, the most negative representable int value, the result is that same value, which is negative.

Parameters:
a - an int value.
Returns:
the absolute value of the argument.
See Also:
MIN_VALUE
o abs 
    method abs(a=long) returns long public  static
Returns the absolute value of a long value. If the argument is not negative, the argument is returned. If the argument is negative, the negation of the argument is returned.

Note that if the argument is equal to the value of Long.MIN_VALUE, the most negative representable long value, the result is that same value, which is negative.

Parameters:
a - a long value.
Returns:
the absolute value of the argument.
See Also:
MIN_VALUE
o abs 
    method abs(a=float) returns float public  static
Returns the absolute value of a float value. If the argument is not negative, the argument is returned. If the argument is negative, the negation of the argument is returned.

Parameters:
a - a float value.
Returns:
the absolute value of the argument.
o abs 
    method abs(a=double) returns double public  static
Returns the absolute value of a double value. If the argument is not negative, the argument is returned. If the argument is negative, the negation of the argument is returned.

Parameters:
a - a double value.
Returns:
the absolute value of the argument.
o max 
    method max(a=int, -
               b=int) returns int public  static
Returns the greater of two int values.

Parameters:
a - an int value.
b - an int value.
Returns:
the larger of a and b.
o max 
    method max(a=long, -
               b=long) returns long public  static
Returns the greater of two long values.

Parameters:
a - a long value.
b - a long value.
Returns:
the larger of a and b.
o max 
    method max(a=float, -
               b=float) returns float public  static
Returns the greater of two float values.

Parameters:
a - a float value.
b - a float value.
Returns:
the larger of a and b.
o max 
    method max(a=double, -
               b=double) returns double public  static
Returns the greater of two double values.

Parameters:
a - a double value.
b - a double value.
Returns:
the larger of a and b.
o min 
    method min(a=int, -
               b=int) returns int public  static
Returns the smaller of two int values.

Parameters:
a - an int value.
b - an int value.
Returns:
the smaller of a and b.
o min 
    method min(a=long, -
               b=long) returns long public  static
Returns the smaller of two long values.

Parameters:
a - a long value.
b - a long value.
Returns:
the smaller of a and b.
o min 
    method min(a=float, -
               b=float) returns float public  static
Returns the smaller of two float values.

Parameters:
a - a float value.
b - a float value.
Returns:
the smaller of a and b.
o min 
    method min(a=double, -
               b=double) returns double public  static
Returns the smaller of two double values.

Parameters:
a - a double value.
b - a double value.
Returns:
the smaller of a and b. 
All Packages  Class Hierarchy  This Package  Previous  Next  Index