CLDC 1.1.1

java.lang
Class Math

java.lang.Object
  extended byjava.lang.Math

public final class Math
extends Object

The class Math contains methods for performing basic numeric operations.

Since:
JDK1.0, CLDC 1.0

Field Summary
static double E
          The double value that is closer than any other to e, the base of the natural logarithms.
static double PI
          The double value that is closer than any other to pi, the ratio of the circumference of a circle to its diameter.
 
Method Summary
static double abs(double a)
          Returns the absolute value of a double value.
static float abs(float a)
          Returns the absolute value of a float value.
static int abs(int a)
          Returns the absolute value of an int value.
static long abs(long a)
          Returns the absolute value of a long value.
static double acos(double a)
          Returns the arc cosine of an angle, in the range of 0.0 through pi.
static double asin(double a)
          Returns the arc sine of an angle, in the range of -pi/2 through pi/2.
static double atan(double a)
          Returns the arc tangent of an angle, in the range of -pi/2 through pi/2.
static double atan2(double a, double b)
          Converts rectangular coordinates (ba) to polar (r, theta).
static double ceil(double a)
          Returns the smallest (closest to negative infinity) double value that is not less than the argument and is equal to a mathematical integer.
static double cos(double a)
          Returns the trigonometric cosine of an angle.
static double floor(double a)
          Returns the largest (closest to positive infinity) double value that is not greater than the argument and is equal to a mathematical integer.
static double max(double a, double b)
          Returns the greater of two double values.
static float max(float a, float b)
          Returns the greater of two float values.
static int max(int a, int b)
          Returns the greater of two int values.
static long max(long a, long b)
          Returns the greater of two long values.
static double min(double a, double b)
          Returns the smaller of two double values.
static float min(float a, float b)
          Returns the smaller of two float values.
static int min(int a, int b)
          Returns the smaller of two int values.
static long min(long a, long b)
          Returns the smaller of two long values.
static double sin(double a)
          Returns the trigonometric sine of an angle.
static double sqrt(double a)
          Returns the correctly rounded positive square root of a double value.
static double tan(double a)
          Returns the trigonometric tangent of an angle.
static double toDegrees(double angrad)
          Converts an angle measured in radians to the equivalent angle measured in degrees.
static double toRadians(double angdeg)
          Converts an angle measured in degrees to the equivalent angle measured in radians.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

E

public static final double E
The double value that is closer than any other to e, the base of the natural logarithms.

Since:
CLDC 1.1
See Also:
Constant Field Values

PI

public static final double PI
The double value that is closer than any other to pi, the ratio of the circumference of a circle to its diameter.

Since:
CLDC 1.1
See Also:
Constant Field Values
Method Detail

sin

public static double sin(double a)
Returns the trigonometric sine of an angle. Special cases:

Parameters:
a - an angle, in radians.
Returns:
the sine of the argument.
Since:
CLDC 1.1

cos

public static double cos(double a)
Returns the trigonometric cosine of an angle. Special case:

Parameters:
a - an angle, in radians.
Returns:
the cosine of the argument.
Since:
CLDC 1.1

tan

public static double tan(double a)
Returns the trigonometric tangent of an angle. Special cases:

Parameters:
a - an angle, in radians.
Returns:
the tangent of the argument.
Since:
CLDC 1.1

asin

public static double asin(double a)
Returns the arc sine of an angle, in the range of -pi/2 through pi/2. Special cases:

A result must be within 1 ulp of the correctly rounded result. Results must be semi-monotonic.

Parameters:
a - the double value whose arc sine is to be returned.
Returns:
the arc sine of the argument.

acos

public static double acos(double a)
Returns the arc cosine of an angle, in the range of 0.0 through pi. Special case:

A result must be within 1 ulp of the correctly rounded result. Results must be semi-monotonic.

Parameters:
a - the double value whose arc cosine is to be returned.
Returns:
the arc cosine of the argument.

atan

public static double atan(double a)
Returns the arc tangent of an angle, in the range of -pi/2 through pi/2. Special cases:

A result must be within 1 ulp of the correctly rounded result. Results must be semi-monotonic.

Parameters:
a - the double value whose arc tangent is to be returned.
Returns:
the arc tangent of the argument.

toRadians

public static double toRadians(double angdeg)
Converts an angle measured in degrees to the equivalent angle measured in radians.

Parameters:
angdeg - an angle, in degrees
Returns:
the measurement of the angle angdeg in radians.
Since:
CLDC 1.1

toDegrees

public static double toDegrees(double angrad)
Converts an angle measured in radians to the equivalent angle measured in degrees.

Parameters:
angrad - an angle, in radians
Returns:
the measurement of the angle angrad in degrees.
Since:
CLDC 1.1

sqrt

public static double sqrt(double a)
Returns the correctly rounded positive square root of a double value. Special cases:

Parameters:
a - a double value.
Returns:
the positive square root of a. If the argument is NaN or less than zero, the result is NaN.
Since:
CLDC 1.1

ceil

public static double ceil(double a)
Returns the smallest (closest to negative infinity) double value that is not less than the argument and is equal to a mathematical integer. Special cases: Note that the value of Math.ceil(x) is exactly the value of -Math.floor(-x).

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.
Since:
CLDC 1.1

floor

public static double floor(double a)
Returns the largest (closest to positive infinity) double value that is not greater than the argument and is equal to a mathematical integer. Special cases:

Parameters:
a - a double value.
Returns:
the largest (closest to positive infinity) double value that is not greater than the argument and is equal to a mathematical integer.
Since:
CLDC 1.1

atan2

public static double atan2(double a,
                           double b)
Converts rectangular coordinates (ba) to polar (r, theta). This method computes the phase theta by computing an arc tangent of a/b in the range of -pi to pi. Special cases:

A result must be within 2 ulps of the correctly rounded result. Results must be semi-monotonic.

Parameters:
a - a double value.
b - a double value.
Returns:
the theta component of the point (rtheta) in polar coordinates that corresponds to the point (ba) in Cartesian coordinates.

abs

public static int abs(int a)
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:
Integer.MIN_VALUE

abs

public static long abs(long a)
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:
Long.MIN_VALUE

abs

public static float abs(float a)
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. Special cases: In other words, the result is equal to the value of the expression:

Float.intBitsToFloat(0x7fffffff & Float.floatToIntBits(a))

Parameters:
a - a float value.
Returns:
the absolute value of the argument.
Since:
CLDC 1.1

abs

public static double abs(double a)
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. Special cases: In other words, the result is equal to the value of the expression:

Double.longBitsToDouble((Double.doubleToLongBits(a)<<1)>>>1)

Parameters:
a - a double value.
Returns:
the absolute value of the argument.
Since:
CLDC 1.1

max

public static int max(int a,
                      int b)
Returns the greater of two int values. That is, the result is the argument closer to the value of Integer.MAX_VALUE. If the arguments have the same value, the result is that same value.

Parameters:
a - an int value.
b - an int value.
Returns:
the larger of a and b.
See Also:
Long.MAX_VALUE

max

public static long max(long a,
                       long b)
Returns the greater of two long values. That is, the result is the argument closer to the value of Long.MAX_VALUE. If the arguments have the same value, the result is that same value.

Parameters:
a - a long value.
b - a long value.
Returns:
the larger of a and b.
See Also:
Long.MAX_VALUE

max

public static float max(float a,
                        float b)
Returns the greater of two float values. That is, the result is the argument closer to positive infinity. If the arguments have the same value, the result is that same value. If either value is NaN, then the result is NaN. Unlike the the numerical comparison operators, this method considers negative zero to be strictly smaller than positive zero. If one argument is positive zero and the other negative zero, the result is positive zero.

Parameters:
a - a float value.
b - a float value.
Returns:
the larger of a and b.

max

public static double max(double a,
                         double b)
Returns the greater of two double values. That is, the result is the argument closer to positive infinity. If the arguments have the same value, the result is that same value. If either value is NaN, then the result is NaN. Unlike the the numerical comparison operators, this method considers negative zero to be strictly smaller than positive zero. If one argument is positive zero and the other negative zero, the result is positive zero.

Parameters:
a - a double value.
b - a double value.
Returns:
the larger of a and b.

min

public static int min(int a,
                      int b)
Returns the smaller of two int values. That is, the result the argument closer to the value of Integer.MIN_VALUE. If the arguments have the same value, the result is that same value.

Parameters:
a - an int value.
b - an int value.
Returns:
the smaller of a and b.
See Also:
Long.MIN_VALUE

min

public static long min(long a,
                       long b)
Returns the smaller of two long values. That is, the result is the argument closer to the value of Long.MIN_VALUE. If the arguments have the same value, the result is that same value.

Parameters:
a - a long value.
b - a long value.
Returns:
the smaller of a and b.
See Also:
Long.MIN_VALUE

min

public static float min(float a,
                        float b)
Returns the smaller of two float values. That is, the result is the value closer to negative infinity. If the arguments have the same value, the result is that same value. If either value is NaN, then the result is NaN. Unlike the the numerical comparison operators, this method considers negative zero to be strictly smaller than positive zero. If one argument is positive zero and the other is negative zero, the result is negative zero.

Parameters:
a - a float value.
b - a float value.
Returns:
the smaller of a and b.
Since:
CLDC 1.1

min

public static double min(double a,
                         double b)
Returns the smaller of two double values. That is, the result is the value closer to negative infinity. If the arguments have the same value, the result is that same value. If either value is NaN, then the result is NaN. Unlike the the numerical comparison operators, this method considers negative zero to be strictly smaller than positive zero. If one argument is positive zero and the other is negative zero, the result is negative zero.

Parameters:
a - a double value.
b - a double value.
Returns:
the smaller of a and b.
Since:
CLDC 1.1

CLDC 1.1.1

Copyright 2000-2007 Sun Microsystems, Inc. All Rights Reserved. Use of this specification is subject to license terms.