java.lang
クラス Math

java.lang.Object
  java.lang.Math

public final class Math
extends Object

基本的な演算機能を提供します。

導入されたバージョン:

CLDC 1.0

E

public static final double E

自然対数の底 e に最も近い double 値です。

導入されたバージョン:

CLDC 1.1

関連項目:

定数フィールド値

PI

public static final double PI

円周率 pi に最も近い double 値です。

導入されたバージョン:

CLDC 1.1

関連項目:

定数フィールド値

abs

public static int abs(int value)

渡された値の絶対値を返します。 引数が負数ではない場合、戻り値には受け取った値がそのまま返されます。 引数が負数の場合は符号を逆にした値を返します。

ただし、Integer.MIN_VALUE と等しい値の場合はそのままの値を返します。 これは２の補数による数値表現の限界のために符号を反転させることができないためです。

パラメータ:

value - 絶対値を求めたい値を渡します。

戻り値:

渡した値の絶対値を返します。

abs

public static long abs(long value)

渡された値の絶対値を返します。 引数が負数ではない場合、戻り値には受け取った値がそのまま返されます。 引数が負数の場合は符号を逆にした値を返します。

ただし、Long.MIN_VALUE と等しい値の場合はそのままの値を返します。 これは２の補数による数値表現の限界のために符号を反転させることができないためです。

パラメータ:

value - 絶対値を求めたい値を渡します。

戻り値:

渡した値の絶対値を返します。

max

public static int max(int value1,
                      int value2)

渡された２つの値の大きい方を戻り値として返します。 両方の値が等しい場合は渡された値をそのまま返します。

パラメータ:

value1 - 比較対象にする値の片方を渡します。

value2 - 比較対象にする値のもう片方を渡します。

戻り値:

どちらか大きい方の値を返します。

max

public static long max(long value1,
                       long value2)

渡された２つの値の大きい方を戻り値として返します。 両方の値が等しい場合は渡された値をそのまま返します。

パラメータ:

value1 - 比較対象にする値の片方を渡します。

value2 - 比較対象にする値のもう片方を渡します。

戻り値:

どちらか大きい方の値を返します。

min

public static int min(int value1,
                      int value2)

渡された２つの値の小さい方を戻り値として返します。 両方の値が等しい場合は渡された値をそのまま返します。

パラメータ:

value1 - 比較対象にする値の片方を渡します。

value2 - 比較対象にする値のもう片方を渡します。

戻り値:

どちらか小さい方の値を返します。

min

public static long min(long value1,
                       long value2)

渡された２つの値の小さい方を戻り値として返します。 両方の値が等しい場合は渡された値をそのまま返します。

パラメータ:

value1 - 比較対象にする値の片方を渡します。

value2 - 比較対象にする値のもう片方を渡します。

戻り値:

どちらか小さい方の値を返します。

sin

public static double sin(double a)

三角法による角度の正弦（サイン）を返します。 特別なケースとして以下のものがあります：

• a が非数（NaN）ならば非数（NaN）を返します。
• a がゼロならば、符号を含めてその値をそのまま返します。

パラメータ:

a - ラジアン単位の角度を渡します。

戻り値:

指定したラジアン単位の角度に対応する正弦（サイン）を返します。

導入されたバージョン:

CLDC 1.1

cos

public static double cos(double a)

三角法による角度の余弦（コサイン）を返します。 特別なケースとして以下のものがあります：

• a が非数（NaN）ならば非数（NaN）を返します。

パラメータ:

a - ラジアン単位の角度を渡します。

戻り値:

指定したラジアン単位の角度に対応する余弦（コサイン）を返します。

導入されたバージョン:

CLDC 1.1

tan

public static double tan(double a)

三角法による角度の正接（タンジェント）を返します。 特別なケースとして以下のものがあります：

• a が非数（NaN）ならば非数（NaN）を返します。
• a がゼロならば、符号を含めてその値をそのまま返します。

パラメータ:

a - ラジアン単位の角度を渡します。

戻り値:

指定したラジアン単位の角度に対応する正接（タンジェント）を返します。

導入されたバージョン:

CLDC 1.1

toRadians

public static double toRadians(double angdeg)

度単位の角度を同等なラジアン単位の角度に変換します。

パラメータ:

angdeg - 度で表現された角度を渡します。

戻り値:

ラジアン単位に変換された angdeg の角度を返します。

導入されたバージョン:

CLDC 1.1

toDegrees

public static double toDegrees(double angrad)

ラジアン単位の角度を同等な度単位の角度に変換します。

パラメータ:

angrad - ラジアン単位で表現された角度を渡します。

戻り値:

度に変換された angrad の角度を返します。

導入されたバージョン:

CLDC 1.1

sqrt

public static double sqrt(double a)

double 値を正しく丸めた正の平方根を返します。 特別なケースとして以下のものがあります：

• a が非数（NaN）ならば非数（NaN）を返します。
• a が正の無限大ならば正の無限大を返します。
• a がゼロならば、符号を含めてその値をそのまま返します。

パラメータ:

a - 変換する値を渡します。

戻り値:

a に対応する正の平方根を返します。 a が非数（NaN）かゼロ未満ならば、結果は非数（NaN）です。

導入されたバージョン:

CLDC 1.1

ceil

public static double ceil(double a)

a の値以上で、数学上の整数と等しく、最も小さい（負の無限大に最も近い）double 値を返します。 特別なケースとして以下のものがあります：

• a が既に数学上の整数と等しいなら a をそのまま返します。
• a が非数（NaN）、無限大、またはゼロ（正と負両方）であれば、a をそのまま返します。
• a がゼロより小さく -1.0 以上であるならば負のゼロを返します。

Math.ceil(x) は -Math.floor(-x) と等価であることに注目してください。

パラメータ:

a - 対象とする double を渡します。

戻り値:

a 以上で数学上の整数と等しく、最も小さい（負の無限大に最も近い）値を返します。

導入されたバージョン:

CLDC 1.1

floor

public static double floor(double a)

a の値以下で、数学上の整数と等しく、最も大きい（正の無限大に最も近い）double 値を返します。 特別なケースとして以下のものがあります：

• a が既に数学上の整数と等しいなら a をそのまま返します。
• a が非数（NaN）、無限大、またはゼロ（正と負両方）であれば、a をそのまま返します。

パラメータ:

a - 対象とする double を渡します。

戻り値:

a の値以下で、数学上の整数と等しく、最も大きい（正の無限大に最も近い）値を返します。

導入されたバージョン:

CLDC 1.1

abs

public static float abs(float a)

float 値の絶対値を返します。 a が負でなければ、そのままの値を返します。 a が負ならば、符号を反転させた値を返します。 特別なケースとして以下のものがあります：

• a が正のゼロか負のゼロであれば、正のゼロを返します。
• a が無限大であれば正の無限大を返します。
• a が非数（NaN）であれば非数（NaN）を返します。

言い換えると、以下の式による表現の結果と等しくなります：

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

パラメータ:

a - 絶対値を求める float 値を渡します。

戻り値:

a の絶対値を返します。

導入されたバージョン:

CLDC 1.1

abs

public static double abs(double a)

double 値の絶対値を返します。 a が負でなければ、そのままの値を返します。 a が負ならば、符号を反転させた値を返します。 特別なケースとして以下のものがあります：

• a が正のゼロか負のゼロであれば、正のゼロを返します。
• a が無限大であれば正の無限大を返します。
• a が非数（NaN）であれば非数（NaN）を返します。

言い換えると、以下の式による表現の結果と等しくなります：

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

パラメータ:

a - 絶対値を求める double 値を渡します。

戻り値:

a の絶対値を返します。

導入されたバージョン:

CLDC 1.1

max

public static float max(float a,
                        float b)

２つの float 値のうち、より大きい方の値を返します。 すなわち、正の無限大により近いほうの値です。 a と b が同じ値ならば、その値を返します。 値が非数（NaN）であるなら非数（NaN）を返します。 このメソッドは数値比較演算子と異なり、厳密には負のゼロが正のゼロよりも小さいとみなします。 つまり、片方のパラメータが正のゼロであり、もう片方のパラメータが負のゼロであるなら、正のゼロを返します。

パラメータ:

a - 比較する対象の float 値を渡します。

b - 比較する対象の float 値を渡します。

戻り値:

a と b のうち、大きな方の値を返します。

導入されたバージョン:

CLDC 1.1

max

public static double max(double a,
                         double b)

２つの double 値のうち、より大きい方の値を返します。 すなわち、正の無限大により近いほうの値です。 a と b が同じ値ならば、その値を返します。 値が非数（NaN）であるなら非数（NaN）を返します。 このメソッドは数値比較演算子と異なり、厳密には負のゼロが正のゼロよりも小さいとみなします。 つまり、片方のパラメータが正のゼロであり、もう片方のパラメータが負のゼロであるなら、正のゼロを返します。

パラメータ:

a - 比較する対象の double 値を渡します。

b - 比較する対象の double 値を渡します。

戻り値:

a と b のうち、大きな方の値を返します。

導入されたバージョン:

CLDC 1.1

min

public static float min(float a,
                        float b)

２つの float 値のうち、より小さい方の値を返します。 すなわち、負の無限大により近いほうの値です。 a と b が同じ値ならば、その値を返します。 値が非数（NaN）であるなら非数（NaN）を返します。 このメソッドは数値比較演算子と異なり、厳密には負のゼロが正のゼロよりも小さいとみなします。 つまり、片方のパラメータが正のゼロであり、もう片方のパラメータが負のゼロであるなら、負のゼロを返します。

パラメータ:

a - 比較する対象の float 値を渡します。

b - 比較する対象の float 値を渡します。

戻り値:

a と b のうち、小さな方の値を返します。

導入されたバージョン:

CLDC 1.1

min

public static double min(double a,
                         double b)

２つの double 値のうち、より小さい方の値を返します。 すなわち、負の無限大により近いほうの値です。 a と b が同じ値ならば、その値を返します。 値が非数（NaN）であるなら非数（NaN）を返します。 このメソッドは数値比較演算子と異なり、厳密には負のゼロが正のゼロよりも小さいとみなします。 つまり、片方のパラメータが正のゼロであり、もう片方のパラメータが負のゼロであるなら、負のゼロを返します。

パラメータ:

a - 比較する対象の double 値を渡します。

b - 比較する対象の double 値を渡します。

戻り値:

a と b のうち、小さな方の値を返します。

導入されたバージョン:

CLDC 1.1