クラスStrictMath

java.lang.Object
java.lang.StrictMath
public final class StrictMath extends Object
StrictMathクラスは、指数関数、対数関数、平方根、および三角関数といった基本的な数値処理を実行するためのメソッドを含んでいます。

Javaプログラムの移植性を保つために、このパッケージにある一部の数値関数の定義は、既存のアルゴリズムと同一の計算結果を出すことが求められています。 こうしたアルゴリズムは、有名なネットワーク・ライブラリであるnetlibから「Freely Distributable Math Library」(fdlibm)パッケージとして入手可能です。 これらのアルゴリズムは、Cプログラミング言語で記述され、Javaに変換され、Java算術のルールに従ってすべての浮動小数点操作および整数操作で実行されることを理解されます。 変形では、次の変換が使用されます:

  • Cでの64ビットdoubleの上限および下限値の抽出および設定は、ビット単位変換「doubleからlong」および「longからdouble」を実行するJavaプラットフォーム・メソッドを使用して表されます。
  • Cの符号なしint値は、Javaの符号付き int値にマップされ、同じテキスト操作の結果が異なる符号なしセマンティクスをレプリケートするための操作の更新が行われます。 たとえば、符号なしC値の>>シフトは、符号付きJava値の>>>シフトに置き換えられます。 符号なしC値 (<, <=, >, >=)のサイズ付き比較は、compareUnsignedに対する意味的に同等のコールに置き換えられます。

Javaの数学ライブラリはfdlibmのバージョン5.3を基に定義されています。 fdlibmで複数の定義が与えられている関数(たとえばacos)については、IEEE 754コア関数のバージョンを使用してください(ファイル名がeで始まるファイルの中にある)。 fdlibmセマンティックスを必要とするメソッドは、sin、cos、tan、asin、acos、atan、exp、log、log10、cbrt、atan2、pow、sinh、cosh、tanh、hypot、expm1、およびlog1pです。

このプラットフォームでは、intおよびlongプリミティブ型を使って2の補数の符号付き整数演算を実行します。 開発者は、算術演算が一貫して正しい結果を生成するようにプリミティブ型を選択する必要があります。これは、場合によっては、それらの演算が計算の値の範囲をオーバーフローしないことを意味しています。 ベスト・プラクティスは、プリミティブ型と、オーバーフローを回避するアルゴリズムを選択することです。 サイズがintまたはlongで、オーバーフロー・エラーを検出する必要がある場合、名前がExactで終わるメソッドは結果のオーバーフロー時にArithmeticExceptionをスローします。

IEEE 754推奨される操作

Mathクラスでは、選択したMathメソッドおよびStrictMathメソッド「IEEE 754の推奨操作に関連」の実装基準の共有品質について説明します。
導入されたバージョン:
1.3
外部仕様

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static final double
    E
    自然対数の底eにもっとも近いdouble値です。
    static final double
    PI
    pi (π) (円の直径に対する円周の比率)にもっとも近いdouble値。
    static final double
    TAU
    tau (τ) (円の半径に対する演習の比率)にもっとも近いdouble値。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    static double
    abs(double a)
    double値の絶対値を返します。
    static float
    abs(float a)
    float値の絶対値を返します。
    static int
    abs(int a)
    int値の絶対値を返します。
    static long
    abs(long a)
    long値の絶対値を返します。
    static int
    absExact(int a)
    int値がintとして正確に表現可能な場合は、その数学的絶対値を返します。結果が正のint範囲をオーバーフローした場合は、ArithmeticExceptionをスローします。
    static long
    absExact(long a)
    long値がlongとして正確に表現可能な場合は、その数学的絶対値を返します。結果が正のlong範囲をオーバーフローした場合は、ArithmeticExceptionをスローします。
    static double
    acos(double a)
    指定された値の逆余弦(アーク・コサイン)を返します。返される角度の範囲は、0.0からpiです。
    static int
    addExact(int x, int y)
    引数の合計を返します。結果がintをオーバーフローする場合は例外をスローします。
    static long
    addExact(long x, long y)
    引数の合計を返します。その結果がlongをオーバーフローする場合は例外をスローします。
    static double
    asin(double a)
    値の円弧正弦を返します。返される角度は、pi/2からpi/2の範囲内です。
    static double
    atan(double a)
    値の円弧の正接を返します。返される角度は、- pi/2からpi/2の範囲内です。
    static double
    atan2(double y, double x)
    直交座標(x, y)から極座標(r, theta)への変換から得られる角度thetaを返します。
    static double
    cbrt(double a)
    double値の立方根を返します。
    static double
    ceil(double a)
    引数の値以上で、計算上の整数と等しい、最小の(負の無限大にもっとも近い) double値を返します。
    static int
    ceilDiv(int x, int y)
    代数商以上の最小の(負の無限大に近い) int値を返します。
    static long
    ceilDiv(long x, int y)
    代数商の最小の(負の無限大に近い) long値を返します。
    static long
    ceilDiv(long x, long y)
    代数商の最小の(負の無限大に近い) long値を返します。
    static int
    ceilDivExact(int x, int y)
    代数商以上の最小の(負の無限大に近い) int値を返します。
    static long
    ceilDivExact(long x, long y)
    代数商の最小の(負の無限大に近い) long値を返します。
    static int
    ceilMod(int x, int y)
    int引数のceiling modulusを返します。
    static int
    ceilMod(long x, int y)
    longおよびint引数のceiling modulusを返します。
    static long
    ceilMod(long x, long y)
    long引数のceiling modulusを返します。
    static double
    clamp(double value, double min, double max)
    最小と最大に収まるように値をクランプします。
    static float
    clamp(float value, float min, float max)
    最小と最大に収まるように値をクランプします。
    static int
    clamp(long value, int min, int max)
    最小と最大に収まるように値をクランプします。
    static long
    clamp(long value, long min, long max)
    最小と最大に収まるように値をクランプします。
    static double
    copySign(double magnitude, double sign)
    2番目の浮動小数点引数の符号を付けた、最初の浮動小数点引数を返します。
    static float
    copySign(float magnitude, float sign)
    2番目の浮動小数点引数の符号を付けた、最初の浮動小数点引数を返します。
    static double
    cos(double a)
    指定された角度の余弦(コサイン)を返します。
    static double
    cosh(double x)
    double値の双曲線余弦を返します。
    static int
    decrementExact(int a)
    引数を1だけ減分したものを返します。結果がintをオーバーフローする場合は例外をスローします。
    static long
    decrementExact(long a)
    引数を1だけ減分したものを返します。結果がlongをオーバーフローする場合は例外をスローします。
    static int
    divideExact(int x, int y)
    結果がintをオーバーフローした場合に例外をスローして、引数の商を返します。
    static long
    divideExact(long x, long y)
    結果がlongをオーバーフローした場合に例外をスローして、引数の商を返します。
    static double
    exp(double a)
    オイラー数eをdouble値で累乗した値を返します。
    static double
    expm1(double x)
    ex-1を返します。
    static double
    floor(double a)
    引数の値以下で、計算上の整数と等しい、最大の(正の無限大にもっとも近い) double値を返します。
    static int
    floorDiv(int x, int y)
    商代数以下の最大(正の無限大にもっとも近い) int値を返します。
    static long
    floorDiv(long x, int y)
    商代数以下の最大(正の無限大にもっとも近い) long値を返します。
    static long
    floorDiv(long x, long y)
    商代数以下の最大(正の無限大にもっとも近い) long値を返します。
    static int
    floorDivExact(int x, int y)
    商代数以下の最大(正の無限大にもっとも近い) int値を返します。
    static long
    floorDivExact(long x, long y)
    商代数以下の最大(正の無限大にもっとも近い) long値を返します。
    static int
    floorMod(int x, int y)
    int引数のフロア・モジュラスを返します。
    static int
    floorMod(long x, int y)
    longおよびint引数のフロア・モジュラスを返します。
    static long
    floorMod(long x, long y)
    long引数のフロア・モジュラスを返します。
    static double
    fma(double a, double b, double c)
    3つの引数の融合積加算を返します。つまり、3番目の引数で合計された最初の2つの引数の正確な積を返し、1回を最も近いdoubleに丸めます。
    static float
    fma(float a, float b, float c)
    3つの引数の融合積加算を返します。つまり、3番目の引数で合計された最初の2つの引数の正確な積を返し、1回を最も近いfloatに丸めます。
    static int
    getExponent(double d)
    doubleの表現で使用されている、バイアスなしの指数を返します。
    static int
    getExponent(float f)
    floatの表現で使用されている、バイアスなしの指数を返します。
    static double
    hypot(double x, double y)
    sqrt(x2 +y2)を返します(途中でオーバーフローやアンダーフローは発生しない)。
    static double
    IEEEremainder(double f1, double f2)
    IEEE 754標準に従って、2個の引数について剰余を計算します。
    static int
    incrementExact(int a)
    引数を1だけ増分して返します。結果がintをオーバーフローした場合は例外をスローします。
    static long
    incrementExact(long a)
    引数を1だけ増分して返します。結果がlongをオーバーフローした場合は例外をスローします。
    static double
    log(double a)
    指定されたdouble値の自然対数(底はe)を返します。
    static double
    log10(double a)
    double値の10を底とする対数を返します。
    static double
    log1p(double x)
    引数と1の合計の自然対数を返します。
    static double
    max(double a, double b)
    2つのdouble値のうち大きいほうを返します。
    static float
    max(float a, float b)
    2つのfloat値のうち大きいほうを返します。
    static int
    max(int a, int b)
    2つのint値のうち大きいほうを返します。
    static long
    max(long a, long b)
    2つのlong値のうち大きいほうを返します。
    static double
    min(double a, double b)
    2つのdouble値のうち小さいほうを返します。
    static float
    min(float a, float b)
    2つのfloat値のうち小さいほうを返します。
    static int
    min(int a, int b)
    2つのint値のうち小さいほうを返します。
    static long
    min(long a, long b)
    2つのlong値のうち小さいほうを返します。
    static int
    multiplyExact(int x, int y)
    引数の積を返します。結果がintをオーバーフローした場合は例外をスローします。
    static long
    multiplyExact(long x, int y)
    引数の積を返します。結果がlongをオーバーフローした場合は例外をスローします。
    static long
    multiplyExact(long x, long y)
    引数の積を返します。結果がlongをオーバーフローした場合は例外をスローします。
    static long
    multiplyFull(int x, int y)
    引数の正確な数学的積を返します。
    static long
    multiplyHigh(long x, long y)
    2つの64ビット・ファクタの128ビット製品の最上位64ビットをlongとして返します。
    static int
    negateExact(int a)
    引数の否定を返します。結果がintをオーバーフローした場合は例外をスローします。
    static long
    negateExact(long a)
    引数の否定を返します。結果がlongをオーバーフローした場合は例外をスローします。
    static double
    nextAfter(double start, double direction)
    2番目の引数の方向で、最初の引数に隣接する浮動小数点値を返します。
    static float
    nextAfter(float start, double direction)
    2番目の引数の方向で、最初の引数に隣接する浮動小数点値を返します。
    static double
    nextDown(double d)
    負の無限大方向でdに隣接する浮動小数点値を返します。
    static float
    nextDown(float f)
    負の無限大方向でfに隣接する浮動小数点値を返します。
    static double
    nextUp(double d)
    正の無限大方向でdに隣接する浮動小数点値を返します。
    static float
    nextUp(float f)
    正の無限大方向でfに隣接する浮動小数点値を返します。
    static double
    pow(double a, double b)
    1番目の引数を、2番目の引数で累乗した値を返します。
    static double
    random()
    0.0以上で1.0より小さい、正の符号の付いたdouble値を返します。
    static double
    rint(double a)
    引数の値にもっとも近く、計算上の整数に等しいdouble値を返します。
    static long
    round(double a)
    引数にもっとも近いlongを返します。同数の場合は正の無限大方向に丸めます。
    static int
    round(float a)
    引数にもっとも近いintを返します。同数の場合は正の無限大方向に丸めます。
    static double
    scalb(double d, int scaleFactor)
    正しく丸められた浮動小数点の倍数によって実行されるかのように、d × 2scaleFactorを返します。
    static float
    scalb(float f, int scaleFactor)
    正しく丸められた浮動小数点の倍数によって実行されるかのように、f × 2scaleFactorを返します。
    static double
    signum(double d)
    引数の符号要素を返します。引数がゼロの場合はゼロ、引数がゼロより大きい場合は1.0、引数がゼロより小さい場合は -1.0です。
    static float
    signum(float f)
    引数の符号要素を返します。引数がゼロの場合はゼロ、引数がゼロより大きい場合は1、引数がゼロより小さい場合は -1です。
    static double
    sin(double a)
    指定された角度の正弦(サイン)を返します。
    static double
    sinh(double x)
    double値の双曲線正弦を返します。
    static double
    sqrt(double a)
    double値の正しく丸めた正の平方根を返します。
    static int
    subtractExact(int x, int y)
    引数の差分を返します。結果がintをオーバーフローした場合は例外をスローします。
    static long
    subtractExact(long x, long y)
    引数の差分を返します。結果がlongをオーバーフローした場合は例外をスローします。
    static double
    tan(double a)
    指定された角度の正接(タンジェント)を返します。
    static double
    tanh(double x)
    double値の双曲線正接を返します。
    static double
    toDegrees(double angrad)
    ラジアンで計測した角度を、相当する度に変換します。
    static int
    toIntExact(long value)
    long引数の値を返します。その値がintをオーバーフローする場合は例外をスローします。
    static double
    toRadians(double angdeg)
    度で計測した角度を、相当するラジアンに変換します。
    static double
    ulp(double d)
    引数のulpのサイズを返します。
    static float
    ulp(float f)
    引数のulpのサイズを返します。
    static long
    unsignedMultiplyHigh(long x, long y)
    符号なし64ビット・ファクタの符号なし128ビット積の最も重要な64ビットをlongとして返します。

    クラスjava.lang.Objectで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • フィールド詳細

    • E

      public static final double E
      自然対数の底eにもっとも近いdouble値です。
      関連項目:

    • PI

      public static final double PI
      pi (π) (円の直径に対する円周の比率)にもっとも近いdouble値。
      関連項目:

    • TAU

      public static final double TAU
      tau (τ) (円の半径に対する演習の比率)にもっとも近いdouble値。
      APIのノート:
      piの値はtauの半分です。つまり、tauはpiの2倍です。
      導入されたバージョン:
      19
      関連項目:

  • メソッドの詳細

    • sin

      public static double sin(double a)
      指定された角度の正弦(サイン)を返します。 特例として:
      • 引数がNaNまたは無限大の場合、結果はNaNになります。
      • 引数がゼロの場合、結果はゼロに引数と同じ符号を付けた値になります。
      パラメータ:
      a - ラジアンで表した角度。
      戻り値:
      引数の正弦(サイン)。

    • cos

      public static double cos(double a)
      指定された角度の余弦(コサイン)を返します。 特例として:
      • 引数がNaNまたは無限大の場合、結果はNaNになります。
      • 引数がゼロの場合、結果は1.0になります。
      パラメータ:
      a - ラジアンで表した角度。
      戻り値:
      引数の余弦(コサイン)。

    • tan

      public static double tan(double a)
      指定された角度の正接(タンジェント)を返します。 特例として:
      • 引数がNaNまたは無限大の場合、結果はNaNになります。
      • 引数がゼロの場合、結果はゼロに引数と同じ符号を付けた値になります。
      パラメータ:
      a - ラジアンで表した角度。
      戻り値:
      引数の正接(タンジェント)。

    • asin

      public static double asin(double a)
      値の円弧正弦を返します。返される角度は、pi/2からpi/2の範囲内です。 特例として:
      • 引数がNaNまたはその絶対値が1を超える場合、結果はNaNになります。
      • 引数がゼロの場合、結果はゼロに引数と同じ符号を付けた値になります。
      パラメータ:
      a - この値の逆正弦(アーク・サイン)が返される。
      戻り値:
      引数の逆正弦(アーク・サイン)。

    • acos

      public static double acos(double a)
      指定された値の逆余弦(アーク・コサイン)を返します。返される角度の範囲は、0.0からpiです。 特例として:
      • 引数がNaNまたはその絶対値が1を超える場合、結果はNaNになります。
      • 引数が1.0の場合、結果はゼロになります。
      パラメータ:
      a - この値の逆余弦(アーク・コサイン)が返される。
      戻り値:
      引数の逆余弦(アーク・コサイン)。

    • atan

      public static double atan(double a)
      値の円弧の正接を返します。返される角度は、- pi/2からpi/2の範囲内です。 特例として:
      • 引数がNaNの場合、NaNが返されます。
      • 引数がゼロの場合、結果はゼロに引数と同じ符号を付けた値になります。
      • 引数がinfiniteの場合、結果は入力と同じ符号でpi/2に最も近い値になります。
      パラメータ:
      a - この値の逆正接(アーク・タンジェント)が返される。
      戻り値:
      引数の逆正接(アーク・タンジェント)。

    • toRadians

      public static double toRadians(double angdeg)
      度で計測した角度を、相当するラジアンに変換します。 通常、度からラジアンへの変換は正確ではありません。
      パラメータ:
      angdeg - 度で計測した角度
      戻り値:
      ラジアンで表した、角度angdegの計測値。

    • toDegrees

      public static double toDegrees(double angrad)
      ラジアンで計測した角度を、相当する度に変換します。 通常、ラジアンから度への変換は正確ではありません。ユーザーは、cos(toRadians(90.0))が正確に0.0に対応することを期待できません。
      パラメータ:
      angrad - ラジアンで表した角度
      戻り値:
      度で表した、角度angradの計測値。

    • exp

      public static double exp(double a)
      オイラー数eをdouble値で累乗した値を返します。 特例として:
      • 引数がNaNの場合は、NaNを返します。
      • 引数が正の無限大の場合は、正の無限大が返されます。
      • 引数が負の無限大の場合は、正のゼロが返されます。
      • 引数がゼロの場合、結果は1.0になります。
      パラメータ:
      a - eの累乗で使用する指数。
      戻り値:
      値ea。ここで、eは自然対数の底。

    • log

      public static double log(double a)
      指定されたdouble値の自然対数(底はe)を返します。 特例として:
      • 引数がNaNまたはゼロより小さい場合、NaNが返されます。
      • 引数が正の無限大の場合は、正の無限大が返されます。
      • 引数が正のゼロまたは負のゼロの場合は、負の無限大が返されます。
      • 引数が1.0の場合、結果はゼロになります。
      パラメータ:
      a - 値
      戻り値:
      値ln a (aの自然対数)。

    • log10

      public static double log10(double a)
      double値の10を底とする対数を返します。 特例として:
      • 引数がNaNまたはゼロより小さい場合、NaNが返されます。
      • 引数が正の無限大の場合は、正の無限大が返されます。
      • 引数が正のゼロまたは負のゼロの場合は、負の無限大が返されます。
      • 引数が10n (nは整数)に等しい場合、結果はnになります。 特に、引数が1.0 (100)の場合、結果はゼロになります。
      パラメータ:
      a - 値
      戻り値:
      aの10を底とする対数。
      導入されたバージョン:
      1.5

    • sqrt

      public static double sqrt(double a)
      double値の正しく丸めた正の平方根を返します。 特例として:
      • 引数がNaNまたはゼロより小さい場合、NaNが返されます。
      • 引数が正の無限大の場合は、正の無限大が返されます。
      • 引数が正のゼロまたは負のゼロの場合は、引数と同じ値が返されます。
      それ以外の場合は、引数値の真の数学の平方根にもっとも近いdouble値が返されます。
      パラメータ:
      a - 値。
      戻り値:
      aの正の平方根。

    • cbrt

      public static double cbrt(double a)
      double値の立方根を返します。 正の有限値xの場合、cbrt(-x)== -cbrt(x)。つまり、負の値の立方根は、値の絶対値の立方根を負にしたものです。 特例として:
      • 引数がNaNの場合、NaNが返されます。
      • 引数が無限大の場合、結果は引数と同じ符号を付けた無限大になります。
      • 引数がゼロの場合、結果はゼロに引数と同じ符号を付けた値になります。
      パラメータ:
      a - 値。
      戻り値:
      aの立方根。
      導入されたバージョン:
      1.5

    • IEEEremainder

      public static double IEEEremainder(double f1, double f2)
      IEEE 754標準に従って、2個の引数について剰余を計算します。 剰余の値は、計算上はf1 - f2 × nに等しくなります。ここで、nは商f1/f2の正確な値にもっとも近い整数です。f1/f2に同じ程度に近似する整数が2つ存在する場合、nには偶数が選択されます。 剰余が0の場合、その符号は第1引数の符号と同じになります。 特例として:
      • どちらかの引数がNaN、1番目の引数が無限大、2番目の引数が正のゼロまたは負のゼロの場合は、NaNが返されます。
      • 1番目の引数が有限で2番目の引数が無限大の場合は、1番目の引数と同じ値が返されます。
      パラメータ:
      f1 - 被除数。
      f2 - 除数。
      戻り値:
      f1をf2で除算したときの剰余。

    • ceil

      public static double ceil(double a)
      引数の値以上で、計算上の整数と等しい、最小の(負の無限大にもっとも近い) double値を返します。 特例として:
      • 引数がすでに計算上の整数と等しい場合は、引数と同じ値が返されます。
      • 引数がNaN、無限大、正のゼロ、または負のゼロの場合は、引数と同じ値が返されます。
      • 引数がゼロより小さく、-1.0より大きい場合は、負のゼロが返されます。
      StrictMath.ceil(x)の値は-StrictMath.floor(-x)とまったく同じです。
      パラメータ:
      a - 値。
      戻り値:
      引数の値以上で、計算上の整数と等しい、最小の(負の無限大にもっとも近い)浮動小数点値。

    • floor

      public static double floor(double a)
      引数の値以下で、計算上の整数と等しい、最大の(正の無限大にもっとも近い) double値を返します。 特例として:
      • 引数がすでに計算上の整数と等しい場合は、引数と同じ値が返されます。
      • 引数がNaN、無限大、正のゼロ、または負のゼロの場合は、引数と同じ値が返されます。
      パラメータ:
      a - 値。
      戻り値:
      引数の値以上で、計算上の整数と等しい、最大の(正の無限大にもっとも近い)浮動小数点値。

    • rint

      public static double rint(double a)
      引数の値にもっとも近く、計算上の整数に等しいdouble値を返します。 2つのdouble値の整数が引数の値と同程度に近似している場合、結果は偶数の整数値になります。 特例として:
      • 引数がすでに計算上の整数と等しい場合は、引数と同じ値が返されます。
      • 引数がNaN、無限大、正のゼロ、または負のゼロの場合は、引数と同じ値が返されます。
      パラメータ:
      a - 値。
      戻り値:
      aにもっとも近く、計算上の整数に等しい浮動小数点値。

    • atan2

      public static double atan2(double y, double x)
      直交座標(x, y)から極座標(r, theta)への変換から得られる角度thetaを返します。 このメソッドでは、- piからpiの範囲のy/xの円弧の接線を計算して、フェーズthetaを計算します。 特例として:
      • どちらかの引数がNaNの場合、結果はNaNになります。
      • 1番目の引数が正のゼロで2番目の引数が正、または1番目の引数が正の有限で2番目の引数が正の無限大の場合、結果は正のゼロになります。
      • 1番目の引数が負のゼロで2番目の引数が正、または1番目の引数が負の有限で2番目の引数が正の無限大の場合、結果は負のゼロになります。
      • 1番目の引数が正のゼロで2番目の引数が負、または1番目の引数が正の有限で2番目の引数が負の無限大の場合、結果はpiにもっとも近似のdouble値になります。
      • 1番目の引数が負のゼロで2番目の引数が負、または1番目の引数が負の有限で2番目の引数が負の無限大の場合、結果は -piにもっとも近似のdouble値になります。
      • 1番目の引数が正で2番目の引数が正または負のゼロ、または1番目の引数が正の無限大で2番目の引数が有限の場合、結果はpi2にもっとも近似のdouble値になります。
      • 1番目の引数が負で2番目の引数が正または負のゼロ、または1番目の引数が負の無限大で2番目の引数が有限の場合、結果は -pi/2にもっとも近似のdouble値になります。
      • どちらの引数も正の無限大の場合、結果はpi/4にもっとも近似のdouble値になります。
      • 1番目の引数が正の無限大で2番目の引数が負の無限大の場合、結果は3*pi/4にもっとも近似のdouble値になります。
      • 1番目の引数が負の無限大で2番目の引数が正の無限大の場合、結果は -pi/4にもっとも近似のdouble値になります。
      • どちらの引数も負の無限大の場合、結果は -3*pi/4にもっとも近似のdouble値になります。
      APIのノート:
      yが正符号で、有限なゼロ以外のxの場合、atan2の正確な数値は次のようになります:
      • x > 0の場合、atan(abs(y/x))
      • x < 0、πの場合 - atan(abs(y/x))
      パラメータ:
      y - 縦座標
      x - 横座標
      戻り値:
      直交座標(デカルト座標)上の点(x, y)に対応する極座標上の点(r, theta)の、theta (シータ)成分。

    • pow

      public static double pow(double a, double b)
      1番目の引数を、2番目の引数で累乗した値を返します。 特例として:
      • 2番目の引数が正のゼロまたは負のゼロの場合は、結果は1.0になります。
      • 2番目の引数が1.0の場合は、結果は1番目の引数と同じ値になります。
      • 2番目の引数がNaNの場合は、結果はNaNになります。
      • 1番目の引数がNaNで2番目の引数がゼロでない場合、結果はNaNになります。
      • 条件
        • 最初の引数の絶対値が1より大きく、2番目の引数が正の無限大の場合、または
        • 最初の引数の絶対値が1より小さく、2番目の引数が負の無限大の場合
        結果は正の無限大になります。
      • 条件
        • 最初の引数の絶対値が1より大きく、2番目の引数が負の無限大の場合、または
        • 最初の引数の絶対値が1より小さく、2番目の引数が正の無限大の場合
        結果は正のゼロになります。
      • 1番目の引数の絶対値が1で2番目の引数が無限大の場合は、結果はNaNになります。
      • 条件
        • 最初の引数が正のゼロ、かつ2番目の引数がゼロより大きい場合、または
        • 最初の引数が正の無限大で、かつ2番目の引数がゼロより小さい場合
        結果は正のゼロになります。
      • 条件
        • 最初の引数が正のゼロで、かつ2番目の引数がゼロより小さい場合、または
        • 最初の引数が正の無限大で、かつ2番目の引数がゼロより大きい場合
        結果は正の無限大になります。
      • 条件
        • 最初の引数が負のゼロ、かつ2番目の引数がゼロより大きいが有限の奇数の整数ではない場合、または
        • 最初の引数が負の無限大であり、かつ2番目の引数がゼロより小さいが有限の奇数の整数ではない場合
        結果は正のゼロになります。
      • 条件
        • 最初の引数が負のゼロであり、かつ2番目の引数が正の有限の奇数の整数の場合、または
        • 最初の引数が負の無限大であり、かつ2番目の引数が負の有限の奇数の整数の場合
        結果は負のゼロになります。
      • 条件
        • 最初の引数が負のゼロであり、かつ2番目の引数がゼロより小さいが有限の奇数の整数ではない場合、または
        • 最初の引数が負の無限大であり、かつ2番目の引数がゼロより大きいが有限の奇数の整数ではない場合
        結果は正の無限大になります。
      • 条件
        • 最初の引数が負のゼロであり、かつ2番目の引数が負の有限の奇数の整数の場合、または
        • 最初の引数が負の無限大であり、かつ2番目の引数が正の有限の奇数の整数の場合
        結果は負の無限大になります。
      • 最初の引数が有限でゼロより小さい場合
        • 2番目の引数が有限の偶数の整数の場合、結果は最初の引数の絶対値を2番目の引数で累乗した値に等しくなります
        • 2番目の引数が有限の奇数の整数の場合、結果は最初の引数の絶対値を2番目の引数で累乗した値の負の値に等しくなります
        • 2番目の引数が有限であり、かつ整数ではない場合、結果はNaNになります。
      • どちらの引数も整数の場合、結果が実際double値として正確に表される場合は1番目の引数を2番目の引数で累乗した計算値とまったく同じ結果になります。

      (上記の説明においては、ceilメソッドによる固定小数点、または同じことですが、floorメソッドによる固定小数点の場合に限り、浮動小数点値は整数として考えます。 そのメソッドを適用した結果と同じ場合に限り、値は引数が1つのメソッドの固定小数点となります。)

      APIのノート:
      このメソッドの特殊なケース定義は、±1.0のIEEE 754推奨される pow操作の特殊なケース定義と無限の累乗を発生させる特殊なケース定義とは異なります。 このメソッドでは、このようなケースは不確定として扱われ、NaNが返されます。 IEEE 754仕様では、無限の累乗が大きい整数 (大規模な浮動小数点数は数値整数で、特に整数です)として扱われるため、1.0が返されます。
      パラメータ:
      a - 基数。
      b - 指数。
      戻り値:
      値ab

    • round

      public static int round(float a)
      引数にもっとも近いintを返します。同数の場合は正の無限大方向に丸めます。

      特例として:

      • 引数がNaNの場合は、結果は0になります。
      • 引数が負の無限大である場合、またはInteger.MIN_VALUE以下の任意の値である場合、結果はInteger.MIN_VALUEの値に等しくなります。
      • 引数が正の無限大である場合、またはInteger.MAX_VALUE以上の任意の値である場合、結果はInteger.MAX_VALUEの値に等しくなります。

      パラメータ:
      a - 整数に丸める浮動小数点値。
      戻り値:
      引数をもっとも近いint値に丸めた値。
      関連項目:

    • round

      public static long round(double a)
      引数にもっとも近いlongを返します。同数の場合は正の無限大方向に丸めます。

      特例として:

      • 引数がNaNの場合は、結果は0になります。
      • 引数が負の無限大である場合、またはLong.MIN_VALUE以下の任意の値である場合、結果はLong.MIN_VALUEの値に等しくなります。
      • 引数が正の無限大である場合、またはLong.MAX_VALUE以上の任意の値である場合、結果はLong.MAX_VALUEの値に等しくなります。

      パラメータ:
      a - longに丸める浮動小数点値。
      戻り値:
      引数をもっとも近いlong値に丸めた値。
      関連項目:

    • random

      public static double random()
      0.0以上で1.0より小さい、正の符号の付いたdouble値を返します。 戻り値は、この範囲からの一様分布によって擬似乱数的に選択されます。

      最初にこのメソッドが呼び出されたときに、メソッドは単一の新しい擬似乱数ジェネレータを作成します。これは、次の式とまったく同じです。

      new java.util.Random()
      この新しい擬似乱数ジェネレータは、以後このメソッドへのすべての呼出しに使われます。ほかの場所では使われません。

      このメソッドは、複数のスレッドが正しく使えるよう適切に同期されます。 しかし、多数のスレッドで擬似乱数を高頻度で発生する必要がある場合は、スレッド独自の擬似乱数ジェネレータを用意して各スレッドのコンテンションを減らしてもかまいません。

      戻り値:
      0.0以上1.0未満の擬似乱数double。
      関連項目:

    • addExact

      public static int addExact(int x, int y)
      引数の合計を返します。結果がintをオーバーフローする場合は例外をスローします。
      パラメータ:
      x - 最初の値
      y - 2番目の値
      戻り値:
      結果
      スロー:
      ArithmeticException - 結果がintをオーバーフローする場合
      導入されたバージョン:
      1.8
      関連項目:

    • addExact

      public static long addExact(long x, long y)
      引数の合計を返します。その結果がlongをオーバーフローする場合は例外をスローします。
      パラメータ:
      x - 最初の値
      y - 2番目の値
      戻り値:
      結果
      スロー:
      ArithmeticException - 結果がlongをオーバーフローする場合
      導入されたバージョン:
      1.8
      関連項目:

    • subtractExact

      public static int subtractExact(int x, int y)
      引数の差分を返します。結果がintをオーバーフローした場合は例外をスローします。
      パラメータ:
      x - 最初の値
      y - 最初の値から減算する2番目の値
      戻り値:
      結果
      スロー:
      ArithmeticException - 結果がintをオーバーフローする場合
      導入されたバージョン:
      1.8
      関連項目:

    • subtractExact

      public static long subtractExact(long x, long y)
      引数の差分を返します。結果がlongをオーバーフローした場合は例外をスローします。
      パラメータ:
      x - 最初の値
      y - 最初の値から減算する2番目の値
      戻り値:
      結果
      スロー:
      ArithmeticException - 結果がlongをオーバーフローする場合
      導入されたバージョン:
      1.8
      関連項目:

    • multiplyExact

      public static int multiplyExact(int x, int y)
      引数の積を返します。結果がintをオーバーフローした場合は例外をスローします。
      パラメータ:
      x - 最初の値
      y - 2番目の値
      戻り値:
      結果
      スロー:
      ArithmeticException - 結果がintをオーバーフローする場合
      導入されたバージョン:
      1.8
      関連項目:

    • multiplyExact

      public static long multiplyExact(long x, int y)
      引数の積を返します。結果がlongをオーバーフローした場合は例外をスローします。
      パラメータ:
      x - 最初の値
      y - 2番目の値
      戻り値:
      結果
      スロー:
      ArithmeticException - 結果がlongをオーバーフローする場合
      導入されたバージョン:
      9
      関連項目:

    • multiplyExact

      public static long multiplyExact(long x, long y)
      引数の積を返します。結果がlongをオーバーフローした場合は例外をスローします。
      パラメータ:
      x - 最初の値
      y - 2番目の値
      戻り値:
      結果
      スロー:
      ArithmeticException - 結果がlongをオーバーフローする場合
      導入されたバージョン:
      1.8
      関連項目:

    • divideExact

      public static int divideExact(int x, int y)
      結果がintをオーバーフローした場合に例外をスローして、引数の商を返します。 このようなオーバーフローは、xがInteger.MIN_VALUEで、yが-1の場合にこのメソッドで発生します。 一方、Integer.MIN_VALUE / -1が直接評価された場合、結果はInteger.MIN_VALUEとなり、例外はスローされません。

      yがゼロの場合、ArithmeticExceptionは(JLS 15.17.2)がスローされます。

      組込みの剰余演算子"%"は、このメソッドと組込みの除算演算子"/"の両方に対応する適切な演算子です。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      商x / y
      スロー:
      ArithmeticException - yが0の場合、または商がintをオーバーフローする場合
      Java言語仕様を参照してください:
      「15.17.2 部署演算子 /」
      導入されたバージョン:
      18
      関連項目:

    • divideExact

      public static long divideExact(long x, long y)
      結果がlongをオーバーフローした場合に例外をスローして、引数の商を返します。 このようなオーバーフローは、xがLong.MIN_VALUEで、yが-1の場合にこのメソッドで発生します。 一方、Long.MIN_VALUE / -1が直接評価された場合、結果はLong.MIN_VALUEとなり、例外はスローされません。

      yがゼロの場合、ArithmeticExceptionは(JLS 15.17.2)がスローされます。

      組込みの剰余演算子"%"は、このメソッドと組込みの除算演算子"/"の両方に対応する適切な演算子です。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      商x / y
      スロー:
      ArithmeticException - yがゼロの場合、または商が長すぎる場合
      Java言語仕様を参照してください:
      「15.17.2 部署演算子 /」
      導入されたバージョン:
      18
      関連項目:

    • floorDivExact

      public static int floorDivExact(int x, int y)
      商代数以下の最大(正の無限大にもっとも近い) int値を返します。 このメソッドはfloorDiv(int,int)と同じです。ただし、除算がInteger.MIN _VALUEで、除算が-1の場合、整数オーバーフローを無視してInteger.MIN_VALUEを返すのではなく、ArithmeticExceptionをスローします。

      floor modulusメソッドfloorMod(int,int)は、このメソッドとfloorDiv(int,int)メソッドの両方に対応する適切なメソッドです。

      例および整数除算の/演算子との比較については、Math.floorDivを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      商代数以下の最大(正の無限大にもっとも近い) int値。
      スロー:
      ArithmeticException - 除数yがゼロの場合、または分割xがInteger.MIN_VALUEで、除数yが-1の場合。
      導入されたバージョン:
      18
      関連項目:

    • floorDivExact

      public static long floorDivExact(long x, long y)
      商代数以下の最大(正の無限大にもっとも近い) long値を返します。 このメソッドはfloorDiv(long,long)と同じです。ただし、除算がLong.MIN _VALUEで、除算が-1の場合、整数オーバーフローを無視してLong.MIN_VALUEを返すのではなく、ArithmeticExceptionをスローします。

      floor modulusメソッドfloorMod(long,long)は、このメソッドとfloorDiv(long,long)メソッドの両方に対応する適切なメソッドです。

      例については、Math.floorDivを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      商代数以下の最大(正の無限大にもっとも近い) long値。
      スロー:
      ArithmeticException - 除数yがゼロの場合、または分割xがLong.MIN_VALUEで、除数yが-1の場合。
      導入されたバージョン:
      18
      関連項目:

    • ceilDivExact

      public static int ceilDivExact(int x, int y)
      代数商以上の最小の(負の無限大に近い) int値を返します。 このメソッドはceilDiv(int,int)と同じです。ただし、除算がInteger.MIN _VALUEで、除算が-1の場合、整数オーバーフローを無視してInteger.MIN_VALUEを返すのではなく、ArithmeticExceptionをスローします。

      このメソッドとceilDiv(int,int)メソッドの両方に、ceil modulusメソッドceilMod(int,int)が適しています。

      例および整数除算/演算子との比較は、Math.ceilDivを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      代数商以上の最小の(負の無限大に近い) int値。
      スロー:
      ArithmeticException - 除数yがゼロの場合、または分割xがInteger.MIN_VALUEで、除数yが-1の場合。
      導入されたバージョン:
      18
      関連項目:

    • ceilDivExact

      public static long ceilDivExact(long x, long y)
      代数商の最小の(負の無限大に近い) long値を返します。 このメソッドはceilDiv(long,long)と同じです。ただし、除算がLong.MIN _VALUEで、除算が-1の場合、整数オーバーフローを無視してLong.MIN_VALUEを返すのではなく、ArithmeticExceptionをスローします。

      このメソッドとceilDiv(long,long)メソッドの両方に、ceil modulusメソッドceilMod(long,long)が適しています。

      例については、Math.ceilDivを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      代数商以上の最小の(負の無限大に近い) long値。
      スロー:
      ArithmeticException - 除数yがゼロの場合、または分割xがLong.MIN_VALUEで、除数yが-1の場合。
      導入されたバージョン:
      18
      関連項目:

    • incrementExact

      public static int incrementExact(int a)
      引数を1だけ増分して返します。結果がintをオーバーフローした場合は例外をスローします。 オーバーフローは「最大値」に対してのみ発生します。
      パラメータ:
      a - 増分する値
      戻り値:
      結果
      スロー:
      ArithmeticException - 結果がintをオーバーフローする場合
      導入されたバージョン:
      14
      関連項目:

    • incrementExact

      public static long incrementExact(long a)
      引数を1だけ増分して返します。結果がlongをオーバーフローした場合は例外をスローします。 オーバーフローは「最大値」に対してのみ発生します。
      パラメータ:
      a - 増分する値
      戻り値:
      結果
      スロー:
      ArithmeticException - 結果がlongをオーバーフローする場合
      導入されたバージョン:
      14
      関連項目:

    • decrementExact

      public static int decrementExact(int a)
      引数を1だけ減分したものを返します。結果がintをオーバーフローする場合は例外をスローします。 オーバーフローは「最小値」に対してのみ発生します。
      パラメータ:
      a - 減分する値
      戻り値:
      結果
      スロー:
      ArithmeticException - 結果がintをオーバーフローする場合
      導入されたバージョン:
      14
      関連項目:

    • decrementExact

      public static long decrementExact(long a)
      引数を1だけ減分したものを返します。結果がlongをオーバーフローする場合は例外をスローします。 オーバーフローは「最小値」に対してのみ発生します。
      パラメータ:
      a - 減分する値
      戻り値:
      結果
      スロー:
      ArithmeticException - 結果がlongをオーバーフローする場合
      導入されたバージョン:
      14
      関連項目:

    • negateExact

      public static int negateExact(int a)
      引数の否定を返します。結果がintをオーバーフローした場合は例外をスローします。 オーバーフローは「最小値」に対してのみ発生します。
      パラメータ:
      a - 否定する値
      戻り値:
      結果
      スロー:
      ArithmeticException - 結果がintをオーバーフローする場合
      導入されたバージョン:
      14
      関連項目:

    • negateExact

      public static long negateExact(long a)
      引数の否定を返します。結果がlongをオーバーフローした場合は例外をスローします。 オーバーフローは「最小値」に対してのみ発生します。
      パラメータ:
      a - 否定する値
      戻り値:
      結果
      スロー:
      ArithmeticException - 結果がlongをオーバーフローする場合
      導入されたバージョン:
      14
      関連項目:

    • toIntExact

      public static int toIntExact(long value)
      long引数の値を返します。その値がintをオーバーフローする場合は例外をスローします。
      パラメータ:
      value - long値
      戻り値:
      intとしての引数
      スロー:
      ArithmeticException - argumentがintをオーバーフローする場合
      導入されたバージョン:
      1.8
      関連項目:

    • multiplyFull

      public static long multiplyFull(int x, int y)
      引数の正確な数学的積を返します。
      パラメータ:
      x - 最初の値
      y - 2番目の値
      戻り値:
      結果
      導入されたバージョン:
      9
      関連項目:

    • multiplyHigh

      public static long multiplyHigh(long x, long y)
      2つの64ビット・ファクタの128ビット製品の最上位64ビットをlongとして返します。
      パラメータ:
      x - 最初の値
      y - 2番目の値
      戻り値:
      結果
      導入されたバージョン:
      9
      関連項目:

    • unsignedMultiplyHigh

      public static long unsignedMultiplyHigh(long x, long y)
      符号なし64ビット・ファクタの符号なし128ビット積の最も重要な64ビットをlongとして返します。
      パラメータ:
      x - 最初の値
      y - 2番目の値
      戻り値:
      結果
      導入されたバージョン:
      18
      関連項目:

    • floorDiv

      public static int floorDiv(int x, int y)
      商代数以下の最大(正の無限大にもっとも近い) int値を返します。 特殊なケースが1つあります: 配当がInteger.MIN _VALUEで、除数が-1の場合、整数のオーバーフローが発生し、結果はInteger.MIN_VALUEになります。

      例および整数除算の/演算子との比較については、Math.floorDivを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      商代数以下の最大(正の無限大にもっとも近い) int値。
      スロー:
      ArithmeticException - 除数yがゼロである場合
      導入されたバージョン:
      1.8
      関連項目:

    • floorDiv

      public static long floorDiv(long x, int y)
      商代数以下の最大(正の無限大にもっとも近い) long値を返します。 特殊なケースが1つあります: 配当がLong.MIN _VALUEで、除数が-1の場合、整数のオーバーフローが発生し、結果はLong.MIN_VALUEになります。

      例および整数除算の/演算子との比較については、Math.floorDivを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      商代数以下の最大(正の無限大にもっとも近い) long値。
      スロー:
      ArithmeticException - 除数yがゼロである場合
      導入されたバージョン:
      9
      関連項目:

    • floorDiv

      public static long floorDiv(long x, long y)
      商代数以下の最大(正の無限大にもっとも近い) long値を返します。 特殊なケースが1つあります: 配当がLong.MIN _VALUEで、除数が-1の場合、整数のオーバーフローが発生し、結果はLong.MIN_VALUEになります。

      例および整数除算の/演算子との比較については、Math.floorDivを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      商代数以下の最大(正の無限大にもっとも近い) long値。
      スロー:
      ArithmeticException - 除数yがゼロである場合
      導入されたバージョン:
      1.8
      関連項目:

    • floorMod

      public static int floorMod(int x, int y)
      int引数のフロア・モジュラスを返します。

      floor modulusはr = x - (floorDiv(x, y) * y)で、除数yと同じ符号を持つか、ゼロで、-abs(y) < r < +abs(y)の範囲にあります。

      floorDivとfloorModの関係は次のようになります。

      • floorDiv(x, y) * y + floorMod(x, y) == x

      例および%演算子との比較については、Math.floorModを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      フロア・モジュラスx - (floorDiv(x, y) * y)
      スロー:
      ArithmeticException - 除数yがゼロである場合
      導入されたバージョン:
      1.8
      関連項目:

    • floorMod

      public static int floorMod(long x, int y)
      longおよびint引数のフロア・モジュラスを返します。

      floor modulusはr = x - (floorDiv(x, y) * y)で、除数yと同じ符号を持つか、ゼロで、-abs(y) < r < +abs(y)の範囲にあります。

      floorDivとfloorModの関係は次のようになります。

      • floorDiv(x, y) * y + floorMod(x, y) == x

      例および%演算子との比較については、Math.floorModを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      フロア・モジュラスx - (floorDiv(x, y) * y)
      スロー:
      ArithmeticException - 除数yがゼロである場合
      導入されたバージョン:
      9
      関連項目:

    • floorMod

      public static long floorMod(long x, long y)
      long引数のフロア・モジュラスを返します。

      floor modulusはr = x - (floorDiv(x, y) * y)で、除数yと同じ符号を持つか、ゼロで、-abs(y) < r < +abs(y)の範囲にあります。

      floorDivとfloorModの関係は次のようになります。

      • floorDiv(x, y) * y + floorMod(x, y) == x

      例および%演算子との比較については、Math.floorModを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      フロア・モジュラスx - (floorDiv(x, y) * y)
      スロー:
      ArithmeticException - 除数yがゼロである場合
      導入されたバージョン:
      1.8
      関連項目:

    • ceilDiv

      public static int ceilDiv(int x, int y)
      代数商以上の最小の(負の無限大に近い) int値を返します。 特殊なケースが1つあります: 配当がInteger.MIN _VALUEで、除数が-1の場合、整数のオーバーフローが発生し、結果はInteger.MIN_VALUEになります。

      例および整数除算/演算子との比較は、Math.ceilDivを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      代数商以上の最小の(負の無限大に近い) int値。
      スロー:
      ArithmeticException - 除数yがゼロである場合
      導入されたバージョン:
      18
      関連項目:

    • ceilDiv

      public static long ceilDiv(long x, int y)
      代数商の最小の(負の無限大に近い) long値を返します。 特殊なケースが1つあります: 配当がLong.MIN _VALUEで、除数が-1の場合、整数のオーバーフローが発生し、結果はLong.MIN_VALUEになります。

      例および整数除算/演算子との比較は、Math.ceilDivを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      代数商以上の最小の(負の無限大に近い) long値。
      スロー:
      ArithmeticException - 除数yがゼロである場合
      導入されたバージョン:
      18
      関連項目:

    • ceilDiv

      public static long ceilDiv(long x, long y)
      代数商の最小の(負の無限大に近い) long値を返します。 特殊なケースが1つあります: 配当がLong.MIN _VALUEで、除数が-1の場合、整数のオーバーフローが発生し、結果はLong.MIN_VALUEになります。

      例および整数除算/演算子との比較は、Math.ceilDivを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      代数商以上の最小の(負の無限大に近い) long値。
      スロー:
      ArithmeticException - 除数yがゼロである場合
      導入されたバージョン:
      18
      関連項目:

    • ceilMod

      public static int ceilMod(int x, int y)
      int引数のceiling modulusを返します。

      ceiling modulusはr = x - (ceilDiv(x, y) * y)で、除数yとして逆の符号を持つか、または0であり、-abs(y) < r < +abs(y)の範囲にあります。

      ceilDivとceilModの関係は次のようになります:

      • ceilDiv(x, y) * y + ceilMod(x, y) == x

      例および%演算子との比較は、Math.ceilModを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      ceiling modulus x - (ceilDiv(x, y) * y)
      スロー:
      ArithmeticException - 除数yがゼロである場合
      導入されたバージョン:
      18
      関連項目:

    • ceilMod

      public static int ceilMod(long x, int y)
      longおよびint引数のceiling modulusを返します。

      ceiling modulusはr = x - (ceilDiv(x, y) * y)で、除数yとして逆の符号を持つか、または0であり、-abs(y) < r < +abs(y)の範囲にあります。

      ceilDivとceilModの関係は次のようになります:

      • ceilDiv(x, y) * y + ceilMod(x, y) == x

      例および%演算子との比較は、Math.ceilModを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      ceiling modulus x - (ceilDiv(x, y) * y)
      スロー:
      ArithmeticException - 除数yがゼロである場合
      導入されたバージョン:
      18
      関連項目:

    • ceilMod

      public static long ceilMod(long x, long y)
      long引数のceiling modulusを返します。

      ceiling modulusはr = x - (ceilDiv(x, y) * y)で、除数yとして逆の符号を持つか、または0であり、-abs(y) < r < +abs(y)の範囲にあります。

      ceilDivとceilModの関係は次のようになります:

      • ceilDiv(x, y) * y + ceilMod(x, y) == x

      例および%演算子との比較は、Math.ceilModを参照してください。

      パラメータ:
      x - 被除数
      y - 除数
      戻り値:
      ceiling modulus x - (ceilDiv(x, y) * y)
      スロー:
      ArithmeticException - 除数yがゼロである場合
      導入されたバージョン:
      18
      関連項目:

    • abs

      public static int abs(int a)
      int値の絶対値を返します。 引数が負でない場合は引数そのものを返します。 負のときは、その正負を逆にした値を返します。

      引数がInteger.MIN_VALUEの値(intの最小値)と等しい場合は、結果も同じ値(負の値)になります。 対照的に、absExact(int)メソッドはこの値に対してArithmeticExceptionをスローします。

      パラメータ:
      a - 絶対値を決定する引数。
      戻り値:
      引数の絶対値。
      関連項目:

    • absExact

      public static int absExact(int a)
      int値がintとして正確に表現可能な場合は、その数学的絶対値を返します。結果が正のint範囲をオーバーフローした場合は、ArithmeticExceptionをスローします。

      2つの補数整数の範囲は、負の値の(JLS 4.2.1)が追加された非対称であるため、Integer.MIN_VALUEの数学的絶対値は正のint範囲をオーバーフローするため、その引数に対して例外がスローされます。

      パラメータ:
      a - 絶対値を決定する引数
      戻り値:
      オーバーフローが発生しないかぎり、引数の絶対値
      スロー:
      ArithmeticException - 引数がInteger.MIN_VALUEの場合
      導入されたバージョン:
      15
      関連項目:

    • abs

      public static long abs(long a)
      long値の絶対値を返します。 引数が負でない場合は引数そのものを返します。 負のときは、その正負を逆にした値を返します。

      引数がLong.MIN_VALUEの値(longの最小値)と等しい場合は、結果も同じ値(負の値)になります。 対照的に、absExact(long)メソッドはこの値に対してArithmeticExceptionをスローします。

      パラメータ:
      a - 絶対値を決定する引数。
      戻り値:
      引数の絶対値。
      関連項目:

    • absExact

      public static long absExact(long a)
      long値がlongとして正確に表現可能な場合は、その数学的絶対値を返します。結果が正のlong範囲をオーバーフローした場合は、ArithmeticExceptionをスローします。

      2つの補数整数の範囲は、負の値の(JLS 4.2.1)が追加された非対称であるため、Long.MIN_VALUEの数学的絶対値は正のlong範囲をオーバーフローするため、その引数に対して例外がスローされます。

      パラメータ:
      a - 絶対値を決定する引数
      戻り値:
      オーバーフローが発生しないかぎり、引数の絶対値
      スロー:
      ArithmeticException - 引数がLong.MIN_VALUEの場合
      導入されたバージョン:
      15
      関連項目:

    • abs

      public static float abs(float a)
      float値の絶対値を返します。 引数が負でない場合は引数そのものを返します。 負のときは、その正負を逆にした値を返します。 特例として:
      • 引数が正のゼロまたは負のゼロの場合は、正のゼロを返します。
      • 引数が無限大の場合は、正の無限大値を返します。
      • 引数がNaNの場合は、NaNを返します。
      APIのノート:
      前述のように、このメソッドの有効な実装の1つが、引数と同じ指数および仮数を持つfloatを計算する次の式によって指定されますが、正の値を示す保証付きゼロ記号ビットが使用されます:
      Float.intBitsToFloat(0x7fffffff & Float.floatToRawIntBits(a))
      パラメータ:
      a - 絶対値を決定する引数
      戻り値:
      引数の絶対値。

    • abs

      public static double abs(double a)
      double値の絶対値を返します。 引数が負でない場合は引数そのものを返します。 負のときは、その正負を逆にした値を返します。 特例として:
      • 引数が正のゼロまたは負のゼロの場合は、正のゼロを返します。
      • 引数が無限大の場合は、正の無限大値を返します。
      • 引数がNaNの場合は、NaNを返します。
      APIのノート:
      前述のように、このメソッドの有効な実装の1つが、引数と同じ指数および仮数を持つdoubleを計算する次の式によって指定されますが、正の値を示す保証付きゼロ記号ビットが使用されます:
      Double.longBitsToDouble((Double.doubleToRawLongBits(a)<<1)>>>1)
      パラメータ:
      a - 絶対値を決定する引数
      戻り値:
      引数の絶対値。

    • max

      public static int max(int a, int b)
      2つのint値のうち大きいほうを返します。 つまり、結果はInteger.MAX_VALUEの値に近いほうの引数となります。 引数の値が同じ場合は同じ値を返します。
      パラメータ:
      a - 引数。
      b - 別の引数。
      戻り値:
      aとbのどちらか大きい方。

    • max

      public static long max(long a, long b)
      2つのlong値のうち大きいほうを返します。 つまり、結果はLong.MAX_VALUEの値に近いほうの引数となります。 引数の値が同じ場合は同じ値を返します。
      パラメータ:
      a - 引数。
      b - 別の引数。
      戻り値:
      aとbのどちらか大きい方。

    • max

      public static float max(float a, float b)
      2つのfloat値のうち大きいほうを返します。 つまり、結果は正の無限大に近いほうの引数となります。 引数の値が同じ場合は同じ値を返します。 どちらかの値がNaNの場合はNaNを返します。 数値比較演算子とは異なり、このメソッドは負のゼロが厳密には正のゼロよりも小さいと見なします。 一方の引数が正のゼロでもう一方が負のゼロの場合は、正のゼロを返します。
      パラメータ:
      a - 引数。
      b - 別の引数。
      戻り値:
      aとbのどちらか大きい方。

    • max

      public static double max(double a, double b)
      2つのdouble値のうち大きいほうを返します。 つまり、結果は正の無限大に近いほうの引数となります。 引数の値が同じ場合は同じ値を返します。 どちらかの値がNaNの場合はNaNを返します。 数値比較演算子とは異なり、このメソッドは負のゼロが厳密には正のゼロよりも小さいと見なします。 一方の引数が正のゼロでもう一方が負のゼロの場合は、正のゼロを返します。
      パラメータ:
      a - 引数。
      b - 別の引数。
      戻り値:
      aとbのどちらか大きい方。

    • min

      public static int min(int a, int b)
      2つのint値のうち小さいほうを返します。 つまり、結果はInteger.MIN_VALUEの値に近いほうの引数となります。 引数の値が同じ場合は同じ値を返します。
      パラメータ:
      a - 引数。
      b - 別の引数。
      戻り値:
      aとbのどちらか小さい方。

    • min

      public static long min(long a, long b)
      2つのlong値のうち小さいほうを返します。 つまり、結果はLong.MIN_VALUEの値に近いほうの引数となります。 引数の値が同じ場合は同じ値を返します。
      パラメータ:
      a - 引数。
      b - 別の引数。
      戻り値:
      aとbのどちらか小さい方。

    • min

      public static float min(float a, float b)
      2つのfloat値のうち小さいほうを返します。 つまり、結果は負の無限大に近いほうの値となります。 引数の値が同じ場合は同じ値を返します。 どちらかの値がNaNの場合はNaNを返します。 数値比較演算子とは異なり、このメソッドは負のゼロが厳密には正のゼロよりも小さいと見なします。 一方の引数が正のゼロでもう一方が負のゼロの場合は、負のゼロを返します。
      パラメータ:
      a - 引数。
      b - 別の引数。
      戻り値:
      aとb.のどちらか小さい方

    • min

      public static double min(double a, double b)
      2つのdouble値のうち小さいほうを返します。 つまり、結果は負の無限大に近いほうの値となります。 引数の値が同じ場合は同じ値を返します。 どちらかの値がNaNの場合はNaNを返します。 数値比較演算子とは異なり、このメソッドは負のゼロが厳密には正のゼロよりも小さいと見なします。 一方の引数が正のゼロでもう一方が負のゼロの場合は、負のゼロを返します。
      パラメータ:
      a - 引数。
      b - 別の引数。
      戻り値:
      aとbのどちらか小さい方。

    • clamp

      public static int clamp(long value, int min, int max)
      最小と最大に収まるように値をクランプします。値がminより小さい場合、minが返されます。 値がmaxより大きい場合は、maxが返されます。 それ以外の場合は、元の値が返されます。

      long型の元の値はint型に収まらない場合がありますが、境界はint型であるため、結果は常にint型に収まります。 これにより、メソッドを使用して、飽和状態でlong値をintに安全にキャストできます。

      パラメータ:
      value - クランプする値
      min - 最小許容値
      max - 最大許容値
      戻り値:
      min..max間隔に収まるクランプ値
      スロー:
      IllegalArgumentException - min > maxの場合
      導入されたバージョン:
      21

    • clamp

      public static long clamp(long value, long min, long max)
      最小と最大に収まるように値をクランプします。値がminより小さい場合、minが返されます。 値がmaxより大きい場合は、maxが返されます。 それ以外の場合は、元の値が返されます。
      パラメータ:
      value - クランプする値
      min - 最小許容値
      max - 最大許容値
      戻り値:
      min..max間隔に収まるクランプ値
      スロー:
      IllegalArgumentException - min > maxの場合
      導入されたバージョン:
      21

    • clamp

      public static double clamp(double value, double min, double max)
      最小と最大に収まるように値をクランプします。値がminより小さい場合、minが返されます。 値がmaxより大きい場合は、maxが返されます。 それ以外の場合は、元の値が返されます。 値がNaNの場合、結果もNaNになります。

      数値比較演算子とは異なり、このメソッドは負のゼロが厳密には正のゼロよりも小さいと見なします。 たとえば、clamp(-0.0, 0.0, 1.0)は0.0を返します。

      パラメータ:
      value - クランプする値
      min - 最小許容値
      max - 最大許容値
      戻り値:
      min..max間隔に収まるクランプ値
      スロー:
      IllegalArgumentException - minおよびmax引数のいずれかがNaN、min > max、またはminが+0.0、maxが -0.0の場合。
      導入されたバージョン:
      21

    • clamp

      public static float clamp(float value, float min, float max)
      最小と最大に収まるように値をクランプします。値がminより小さい場合、minが返されます。 値がmaxより大きい場合は、maxが返されます。 それ以外の場合は、元の値が返されます。 値がNaNの場合、結果もNaNになります。

      数値比較演算子とは異なり、このメソッドは負のゼロが厳密には正のゼロよりも小さいと見なします。 たとえば、clamp(-0.0f, 0.0f, 1.0f)は0.0fを返します。

      パラメータ:
      value - クランプする値
      min - 最小許容値
      max - 最大許容値
      戻り値:
      min..max間隔に収まるクランプ値
      スロー:
      IllegalArgumentException - minおよびmax引数のいずれかがNaN、min > max、またはminが+0.0f、maxが -0.0fの場合。
      導入されたバージョン:
      21

    • fma

      public static double fma(double a, double b, double c)
      3つの引数の融合積加算を返します。つまり、3番目の引数で合計された最初の2つの引数の正確な積を返し、1回を最も近いdoubleに丸めます。 丸めは「最も近い偶数丸めモードへの丸め」を使用して行われます。 対照的に、a * b + cが通常の浮動小数点式として評価される場合、2つの端数処理エラー(乗算操作の1つ目、加算操作の2つ目)が関係します。

      特例として:

      • 引数がNaNの場合、結果はNaNになります。
      • 最初の2つの引数のいずれかが無限で、もう一方がゼロの場合、結果はNaNになります。
      • 最初の2つの引数の正確な積が無限(つまり、少なくとも1つの引数が無限であり、もう1つはゼロでもNaNでもありません)で、3番目の引数が反対の符号の無限大である場合、結果はNaNになります。

      fusedMac(a, 1.0, c)は(a + c)と同じ結果を返します。 ただし、fusedMac(-0.0, +0.0, +0.0)は+0.0、(-0.0 * +0.0)は-0.0、fusedMac(a, b, -0.0)は(a * b)と同等であるため、fusedMac(a, b, +0.0)は必ずしも(a * b)と同じ結果を返すわけではありません。

      APIのノート:
      このメソッドは、IEEE 754-2008で定義されているfusedMultiplyAddオペレーションに対応します。
      パラメータ:
      a - 値
      b - 値
      c - 値
      戻り値:
      (a × b + c)は、範囲と精度が無制限であるかのように計算され、1回は最も近いdouble値に丸められます
      導入されたバージョン:
      9

    • fma

      public static float fma(float a, float b, float c)
      3つの引数の融合積加算を返します。つまり、3番目の引数で合計された最初の2つの引数の正確な積を返し、1回を最も近いfloatに丸めます。 丸めは「最も近い偶数丸めモードへの丸め」を使用して行われます。 対照的に、a * b + cが通常の浮動小数点式として評価される場合、2つの端数処理エラー(乗算操作の1つ目、加算操作の2つ目)が関係します。

      特例として:

      • 引数がNaNの場合、結果はNaNになります。
      • 最初の2つの引数のいずれかが無限で、もう一方がゼロの場合、結果はNaNになります。
      • 最初の2つの引数の正確な積が無限(つまり、少なくとも1つの引数が無限であり、もう1つはゼロでもNaNでもありません)で、3番目の引数が反対の符号の無限大である場合、結果はNaNになります。

      fma(a, 1.0f, c)は(a + c)と同じ結果を返します。 ただし、fma(-0.0f, +0.0f, +0.0f)は+0.0f、(-0.0f * +0.0f)は-0.0f、fma(a, b, -0.0f)は(a * b)と同等であるため、fma(a, b, +0.0f)は必ずしも(a * b)と同じ結果を返すわけではありません。

      APIのノート:
      このメソッドは、IEEE 754-2008で定義されているfusedMultiplyAddオペレーションに対応します。
      パラメータ:
      a - 値
      b - 値
      c - 値
      戻り値:
      (a × b + c)は、範囲と精度が無制限であるかのように計算され、1回は最も近いfloat値に丸められます
      導入されたバージョン:
      9

    • ulp

      public static double ulp(double d)
      引数のulpのサイズを返します。 double値の最後の位置にあるulpの単位は、この浮動小数点値と次に大きい大きさの double値の間の正の距離です。 xがNaNでない場合は、ulp(-x)== ulp(x)となります。

      特例として:

      • 引数がNaNの場合、NaNが返されます。
      • 引数が正または負の無限大の場合は、結果は正の無限大になります。
      • 引数が正または負のゼロの場合は、結果はDouble.MIN_VALUEになります。
      • 引数が±Double.MAX_VALUEの場合、結果は2971に等しくなります。

      パラメータ:
      d - ulpが返される浮動小数点値
      戻り値:
      引数のulpのサイズ
      導入されたバージョン:
      1.5

    • ulp

      public static float ulp(float f)
      引数のulpのサイズを返します。 float値の最後の位置にあるulpの単位は、この浮動小数点値と次に大きい大きさの float値の間の正の距離です。 xがNaNでない場合は、ulp(-x)== ulp(x)となります。

      特例として:

      • 引数がNaNの場合、NaNが返されます。
      • 引数が正または負の無限大の場合は、結果は正の無限大になります。
      • 引数が正または負のゼロの場合は、結果はFloat.MIN_VALUEになります。
      • 引数が±Float.MAX_VALUEの場合、結果は2104に等しくなります。

      パラメータ:
      f - ulpが返される浮動小数点値
      戻り値:
      引数のulpのサイズ
      導入されたバージョン:
      1.5

    • signum

      public static double signum(double d)
      引数の符号要素を返します。引数がゼロの場合はゼロ、引数がゼロより大きい場合は1.0、引数がゼロより小さい場合は -1.0です。

      特例として:

      • 引数がNaNの場合、NaNが返されます。
      • 引数が正のゼロまたは負のゼロの場合は、引数と同じ値が返されます。

      パラメータ:
      d - 符号が返される浮動小数点値
      戻り値:
      引数の符号要素
      導入されたバージョン:
      1.5

    • signum

      public static float signum(float f)
      引数の符号要素を返します。引数がゼロの場合はゼロ、引数がゼロより大きい場合は1、引数がゼロより小さい場合は -1です。

      特例として:

      • 引数がNaNの場合、NaNが返されます。
      • 引数が正のゼロまたは負のゼロの場合は、引数と同じ値が返されます。

      パラメータ:
      f - 符号が返される浮動小数点値
      戻り値:
      引数の符号要素
      導入されたバージョン:
      1.5

    • sinh

      public static double sinh(double x)
      double値の双曲線正弦を返します。 xの双曲線正弦は、(ex − e−x)/2 (ここでeは「オイラーの番号」)として定義されます。

      特例として:

      • 引数がNaNの場合、NaNが返されます。
      • 引数が無限大の場合、結果は引数と同じ符号を付けた無限大になります。
      • 引数がゼロの場合、結果はゼロに引数と同じ符号を付けた値になります。

      パラメータ:
      x - 双曲線正弦が返される数字。
      戻り値:
      xの双曲線正弦。
      導入されたバージョン:
      1.5

    • cosh

      public static double cosh(double x)
      double値の双曲線余弦を返します。 xのハイパーボリック・サインは、(ex + e−x)/2 (eは「オイラーの番号」)として定義されます。

      特例として:

      • 引数がNaNの場合、NaNが返されます。
      • 引数が無限大の場合は、正の無限大値が返されます。
      • 引数がゼロの場合、結果は1.0になります。

      パラメータ:
      x - 双曲線余弦が返される数字。
      戻り値:
      xの双曲線余弦。
      導入されたバージョン:
      1.5

    • tanh

      public static double tanh(double x)
      double値の双曲線正接を返します。 xの双曲線正接は、(ex − e−x )/(ex + e−x)、つまりsinh(x) / cosh(x))として定義されます。 正確なtanhの絶対値は常に1未満です。

      特例として:

      • 引数がNaNの場合、NaNが返されます。
      • 引数がゼロの場合、結果はゼロに引数と同じ符号を付けた値になります。
      • 引数が正の無限大の場合、結果は+1.0になります。
      • 引数が負の無限大の場合、結果は-1.0になります。

      パラメータ:
      x - 双曲線正接が返される数字。
      戻り値:
      xの双曲線正接。
      導入されたバージョン:
      1.5

    • hypot

      public static double hypot(double x, double y)
      sqrt(x2 +y2)を返します(途中でオーバーフローやアンダーフローは発生しない)。

      特例として:

      • どちらかの引数が無限大の場合は、結果は正の無限大値になります。
      • どちらかの引数がNaNであり、かつどちらの引数も無限大でない場合、結果はNaNになります。
      • 両方の引数がゼロの場合、結果は正のゼロになります。

      パラメータ:
      x - 値
      y - 値
      戻り値:
      sqrt(x2 +y2)(途中でオーバーフローやアンダーフローは発生しない)
      導入されたバージョン:
      1.5

    • expm1

      public static double expm1(double x)
      ex-1を返します。 xの値が0に近い場合、expm1(x) + 1の正確な合計はexp(x)に比べ、exの真の結果にかなり近くなります。

      特例として:

      • 引数がNaNの場合は、NaNを返します。
      • 引数が正の無限大の場合は、正の無限大が返されます。
      • 引数が負の無限大の場合、結果は -1.0になります。
      • 引数がゼロの場合、結果はゼロに引数と同じ符号を付けた値になります。

      パラメータ:
      x - ex -1の計算でeを大きくする指数。
      戻り値:
      値ex - 1。
      導入されたバージョン:
      1.5

    • log1p

      public static double log1p(double x)
      引数と1の合計の自然対数を返します。 xの値が小さい場合、log1p(x)の結果は、log(1.0+x)の浮動小数点評価よりもln(1+x)の真の結果にかなり近くなります。

      特例として:

      • 引数がNaNまたは -1より小さい場合、結果はNaNになります。
      • 引数が正の無限大の場合は、正の無限大が返されます。
      • 引数が負の値の場合、結果は負の無限大になります。
      • 引数がゼロの場合、結果はゼロに引数と同じ符号を付けた値になります。

      パラメータ:
      x - 値
      戻り値:
      値ln(x + 1)(x + 1の自然対数)
      導入されたバージョン:
      1.5

    • copySign

      public static double copySign(double magnitude, double sign)
      2番目の浮動小数点引数の符号を付けた、最初の浮動小数点引数を返します。 このメソッドの場合、NaN sign引数は常に正であるかのように扱われます。
      パラメータ:
      magnitude - 結果の絶対値を提供するパラメータ
      sign - 結果の符号を提供するパラメータ
      戻り値:
      magnitudeの絶対値とsignの符号を持つ値。
      導入されたバージョン:
      1.6

    • copySign

      public static float copySign(float magnitude, float sign)
      2番目の浮動小数点引数の符号を付けた、最初の浮動小数点引数を返します。 このメソッドの場合、NaN sign引数は常に正であるかのように扱われます。
      パラメータ:
      magnitude - 結果の絶対値を提供するパラメータ
      sign - 結果の符号を提供するパラメータ
      戻り値:
      magnitudeの絶対値とsignの符号を持つ値。
      導入されたバージョン:
      1.6

    • getExponent

      public static int getExponent(float f)
      floatの表現で使用されている、バイアスなしの指数を返します。 特例として:
      • 引数がNaNまたは無限大の場合、結果はFloat.MAX_EXPONENT+1になります。
      • 引数がゼロまたは非正規の場合、結果はFloat.MIN_EXPONENT -1になります。
      パラメータ:
      f - float値
      戻り値:
      引数の不偏指数
      導入されたバージョン:
      1.6

    • getExponent

      public static int getExponent(double d)
      doubleの表現で使用されている、バイアスなしの指数を返します。 特例として:
      パラメータ:
      d - double値
      戻り値:
      引数の不偏指数
      導入されたバージョン:
      1.6

    • nextAfter

      public static double nextAfter(double start, double direction)
      2番目の引数の方向で、最初の引数に隣接する浮動小数点値を返します。 両方の引数が等しいと見なされる場合は、2番目の引数が返されます。

      特例として:

      • どちらかの引数がNaNの場合、NaNが返されます。
      • 両方の引数が符号付きゼロの場合、両方の引数が等しいと見なされる場合は2番目の引数が返されるという要件のとおり、directionが変更されずに返されます。
      • startが±Double.MIN_VALUEであり、directionの値が、結果の絶対値をより小さくすべきであることを示していた場合、startと同じ符号を持つゼロが返されます。
      • startが無限大であり、directionの値が、結果の絶対値をより小さくすべきであることを示していた場合、startと同じ符号を持つDouble.MAX_VALUEが返されます。
      • startが±Double.MAX_VALUEに等しく、directionの値が、結果の絶対値をより大きくすべきであることを示していた場合、startと同じ符号を持つ無限大が返されます。

      パラメータ:
      start - 開始浮動小数点値
      direction - startの近傍、startのどちらを返すべきかを示す値
      戻り値:
      directionの方向でstartの近傍にある浮動小数点数。
      導入されたバージョン:
      1.6

    • nextAfter

      public static float nextAfter(float start, double direction)
      2番目の引数の方向で、最初の引数に隣接する浮動小数点値を返します。 両方の引数が等しいと見なされる場合は、2番目の引数に等しい値が返されます。

      特例として:

      • どちらかの引数がNaNの場合、NaNが返されます。
      • 両方の符号付きゼロと見なされる場合は、directionに等しい値が返されます。
      • startが±Float.MIN_VALUEであり、directionの値が、結果の絶対値をより小さくすべきであることを示していた場合、startと同じ符号を持つゼロが返されます。
      • startが無限大であり、directionの値が、結果の絶対値をより小さくすべきであることを示していた場合、startと同じ符号を持つFloat.MAX_VALUEが返されます。
      • startが±Float.MAX_VALUEに等しく、directionの値が、結果の絶対値をより大きくすべきであることを示していた場合、startと同じ符号を持つ無限大が返されます。

      パラメータ:
      start - 開始浮動小数点値
      direction - startの近傍、startのどちらを返すべきかを示す値
      戻り値:
      directionの方向でstartの近傍にある浮動小数点数。
      導入されたバージョン:
      1.6

    • nextUp

      public static double nextUp(double d)
      正の無限大方向でdに隣接する浮動小数点値を返します。 このメソッドは意味的にはnextAfter(d, Double.POSITIVE_INFINITY)と等価ですが、nextUpの実装は対応するnextAfter呼び出しよりも、高速で動作する可能性があります。

      特例として:

      • 引数がNaNの場合は、NaNを返します。
      • 引数が正の無限大の場合は、正の無限大が返されます。
      • 引数がゼロの場合、結果はDouble.MIN_VALUEになります

      パラメータ:
      d - 開始浮動小数点値
      戻り値:
      正の無限大に近いほうの、隣接する浮動小数点値。
      導入されたバージョン:
      1.6

    • nextUp

      public static float nextUp(float f)
      正の無限大方向でfに隣接する浮動小数点値を返します。 このメソッドは意味的にはnextAfter(f, Float.POSITIVE_INFINITY)と等価ですが、nextUpの実装は対応するnextAfter呼び出しよりも、高速で動作する可能性があります。

      特例として:

      • 引数がNaNの場合は、NaNを返します。
      • 引数が正の無限大の場合は、正の無限大が返されます。
      • 引数がゼロの場合、結果はFloat.MIN_VALUEになります

      パラメータ:
      f - 開始浮動小数点値
      戻り値:
      正の無限大に近いほうの、隣接する浮動小数点値。
      導入されたバージョン:
      1.6

    • nextDown

      public static double nextDown(double d)
      負の無限大方向でdに隣接する浮動小数点値を返します。 このメソッドは意味的にはnextAfter(d, Double.NEGATIVE_INFINITY)と同等ですが、nextDownの実装はそれに対応するnextAfter呼出しよりも、高速で動作する可能性があります。

      特例として:

      • 引数がNaNの場合は、NaNを返します。
      • 引数が負の無限大の場合、結果は負の無限大になります。
      • 引数がゼロの場合、結果は-Double.MIN_VALUEになります

      パラメータ:
      d - 開始浮動小数点値
      戻り値:
      負の無限大に近いほうの、隣接する浮動小数点値。
      導入されたバージョン:
      1.8

    • nextDown

      public static float nextDown(float f)
      負の無限大方向でfに隣接する浮動小数点値を返します。 このメソッドは意味的にはnextAfter(f, Float.NEGATIVE_INFINITY)と同等ですが、nextDownの実装はそれに対応するnextAfter呼出しよりも、高速で動作する可能性があります。

      特例として:

      • 引数がNaNの場合は、NaNを返します。
      • 引数が負の無限大の場合、結果は負の無限大になります。
      • 引数がゼロの場合、結果は-Float.MIN_VALUEになります

      パラメータ:
      f - 開始浮動小数点値
      戻り値:
      負の無限大に近いほうの、隣接する浮動小数点値。
      導入されたバージョン:
      1.8

    • scalb

      public static double scalb(double d, int scaleFactor)
      正しく丸められた浮動小数点の倍数によって実行されるかのように、d × 2scaleFactorを返します。 結果の指数がDouble.MIN_EXPONENTとDouble.MAX_EXPONENTの間である場合、答えは正確に計算されます。 結果の指数が Double.MAX_EXPONENTより大きくなる場合、無限大が返されます。 結果が非正規の場合は精度が失われる可能性があります。つまり、scalb(x, n)が非正規の場合、scalb(scalb(x, n), -n)がxと等しくならない可能性があります。 結果がNaN以外の場合、その結果はdと同じ符号を持ちます。

      特例として:

      • 最初の引数がNaNの場合は、NaNが返されます。
      • 最初の引数が無限大の場合は、同じ符号の無限大値が返されます。
      • 最初の引数がゼロの場合は、同じ符号のゼロが返されます。

      パラメータ:
      d - 2の累乗によってスケーリングされる数。
      scaleFactor - dをスケーリングするときに使用される2の累乗
      戻り値:
      d × 2scaleFactor
      導入されたバージョン:
      1.6

    • scalb

      public static float scalb(float f, int scaleFactor)
      正しく丸められた浮動小数点の倍数によって実行されるかのように、f × 2scaleFactorを返します。 結果の指数がFloat.MIN_EXPONENTとFloat.MAX_EXPONENTの間である場合、答えは正確に計算されます。 結果の指数が Float.MAX_EXPONENTより大きくなる場合、無限大が返されます。 結果が非正規の場合は精度が失われる可能性があります。つまり、scalb(x, n)が非正規の場合、scalb(scalb(x, n), -n)がxと等しくならない可能性があります。 結果がNaN以外の場合、その結果はfと同じ符号を持ちます。

      特例として:

      • 最初の引数がNaNの場合は、NaNが返されます。
      • 最初の引数が無限大の場合は、同じ符号の無限大値が返されます。
      • 最初の引数がゼロの場合は、同じ符号のゼロが返されます。

      パラメータ:
      f - 2の累乗によってスケーリングされる数。
      scaleFactor - fをスケーリングするときに使用される2の累乗
      戻り値:
      f × 2scaleFactor
      導入されたバージョン:
      1.6