Java – Doubleラッパークラス使い方

2025-04-15更新日: 2025-04-15

JavaのDoubleラッパークラスは、基本データ型doubleをオブジェクトとして扱うためのクラスです。

Doubleクラスを使うことで、double値をコレクションに格納したり、メソッドの引数として渡したりできます。

Doubleクラスには、parseDouble(String s)メソッドを使って文字列をdoubleに変換したり、toString()メソッドでdouble値を文字列に変換する機能があります。

また、DoubleクラスはNaNやPOSITIVE_INFINITYなどの定数も提供し、特殊な数値を扱う際に便利です。

equals()メソッドを使ってDoubleオブジェクト同士の比較も可能です。

目次から探す

Javaを使った求人

読み込み中…

Doubleラッパークラスとは

Doubleクラスの概要

JavaのDoubleクラスは、基本データ型であるdoubleをオブジェクトとして扱うためのラッパークラスです。

このクラスは、数値をオブジェクトとして操作する際に便利で、特にコレクションフレームワークで使用されることが多いです。

Doubleクラスは、java.langパッケージに含まれており、数値の変換や比較、解析などのメソッドを提供しています。

基本データ型doubleとの違い

doubleはJavaの基本データ型で、浮動小数点数を表現します。

一方、Doubleクラスはこのdoubleをオブジェクトとして扱うためのラッパーです。

以下に、doubleとDoubleの主な違いを示します。

特徴	double	Double
型	プリミティブ型	オブジェクト型
初期値	0.0	null
使用用途	高速な数値計算	コレクションでの使用、メソッドの引数や戻り値

doubleはメモリ効率が良く、数値計算に適していますが、Doubleはオブジェクトとして扱えるため、コレクションに格納する際に便利です。

オートボクシングとアンボクシング

Javaでは、doubleとDoubleの間で自動的に変換が行われる機能があります。

これをオートボクシングとアンボクシングと呼びます。

オートボクシング: 基本データ型doubleをDoubleオブジェクトに自動的に変換すること。
アンボクシング: Doubleオブジェクトを基本データ型doubleに自動的に変換すること。

以下に、オートボクシングとアンボクシングの例を示します。

// App.java
public class App {
    public static void main(String[] args) {
        // オートボクシング
        Double doubleObject = 10.5; // doubleからDoubleへの自動変換
        // アンボクシング
        double primitiveDouble = doubleObject; // Doubleからdoubleへの自動変換
        System.out.println("Doubleオブジェクト: " + doubleObject);
        System.out.println("プリミティブdouble: " + primitiveDouble);
    }
}

Doubleオブジェクト: 10.5
プリミティブdouble: 10.5

この例では、double型の値がDoubleオブジェクトに自動的に変換され、またDoubleオブジェクトがdouble型に自動的に変換されています。

オートボクシングとアンボクシングにより、コードがより簡潔になり、開発者の負担が軽減されます。

Doubleクラスの基本的な使い方

Doubleオブジェクトの生成

Doubleクラスのオブジェクトを生成する方法は主に2つあります。

1つはコンストラクタを使用する方法、もう1つはオートボクシングを利用する方法です。

// App.java
public class App {
    public static void main(String[] args) {
        // コンストラクタを使用して生成
        Double doubleObject1 = new Double(10.5);
        // オートボクシングを使用して生成
        Double doubleObject2 = 20.5; // doubleからDoubleへの自動変換
        System.out.println("Doubleオブジェクト1: " + doubleObject1);
        System.out.println("Doubleオブジェクト2: " + doubleObject2);
    }
}

Doubleオブジェクト1: 10.5
Doubleオブジェクト2: 20.5

コンストラクタを使用する方法は明示的ですが、オートボクシングを利用することでコードを簡潔に記述できます。

文字列からの変換

Doubleクラスは、文字列をDoubleオブジェクトに変換するためのメソッドを提供しています。

Double.valueOf(String s)メソッドを使用することで、文字列をDoubleオブジェクトに変換できます。

// App.java
public class App {
    public static void main(String[] args) {
        String str = "30.5";
        Double doubleObject = Double.valueOf(str);
        System.out.println("文字列から変換したDoubleオブジェクト: " + doubleObject);
    }
}

文字列から変換したDoubleオブジェクト: 30.5

この例では、文字列"30.5"がDoubleオブジェクトに変換されています。

valueOfメソッドは、文字列が数値として正しい形式であることを確認し、変換を行います。

Doubleから文字列への変換

Doubleオブジェクトを文字列に変換するには、toString()メソッドを使用します。

このメソッドは、Doubleオブジェクトの数値を文字列形式で返します。

// App.java
public class App {
    public static void main(String[] args) {
        Double doubleObject = 40.5;
        String str = doubleObject.toString();
        System.out.println("Doubleオブジェクトから変換した文字列: " + str);
    }
}

Doubleオブジェクトから変換した文字列: 40.5

この例では、Doubleオブジェクトの値が文字列に変換されています。

toString()メソッドを使用することで、Doubleオブジェクトを簡単に文字列に変換できます。

Doubleクラスのメソッド

parseDoubleメソッドの使い方

parseDoubleメソッドは、文字列を基本データ型のdoubleに変換するために使用されます。

このメソッドは、Doubleクラスの静的メソッドであり、文字列が数値として正しい形式であることを確認して変換を行います。

// App.java
public class App {
    public static void main(String[] args) {
        String str = "50.5";
        double primitiveDouble = Double.parseDouble(str);
        System.out.println("文字列から変換したプリミティブdouble: " + primitiveDouble);
    }
}

文字列から変換したプリミティブdouble: 50.5

この例では、文字列"50.5"がdouble型に変換されています。

parseDoubleメソッドは、数値形式の文字列をdoubleに変換する際に便利です。

toStringメソッドの使い方

toStringメソッドは、Doubleオブジェクトの数値を文字列形式で返します。

このメソッドは、Doubleクラスのインスタンスメソッドであり、オブジェクトの内容を文字列として表現する際に使用されます。

// App.java
public class App {
    public static void main(String[] args) {
        Double doubleObject = 60.5;
        String str = doubleObject.toString();
        System.out.println("Doubleオブジェクトから変換した文字列: " + str);
    }
}

Doubleオブジェクトから変換した文字列: 60.5

この例では、Doubleオブジェクトの値が文字列に変換されています。

toStringメソッドを使用することで、Doubleオブジェクトを簡単に文字列に変換できます。

equalsメソッドによる比較

equalsメソッドは、Doubleオブジェクト同士を比較するために使用されます。

このメソッドは、オブジェクトの値が等しいかどうかを判定します。

// App.java
public class App {
    public static void main(String[] args) {
        Double doubleObject1 = 70.5;
        Double doubleObject2 = 70.5;
        Double doubleObject3 = 80.5;
        System.out.println("doubleObject1とdoubleObject2は等しいか: " + doubleObject1.equals(doubleObject2));
        System.out.println("doubleObject1とdoubleObject3は等しいか: " + doubleObject1.equals(doubleObject3));
    }
}

doubleObject1とdoubleObject2は等しいか: true
doubleObject1とdoubleObject3は等しいか: false

この例では、doubleObject1とdoubleObject2は同じ値を持っているため、equalsメソッドはtrueを返します。

一方、doubleObject1とdoubleObject3は異なる値を持っているため、falseを返します。

isNaNとisInfiniteメソッド

isNaNメソッドは、DoubleオブジェクトがNaN(Not-a-Number)であるかどうかを判定します。

また、isInfiniteメソッドは、Doubleオブジェクトが無限大であるかどうかを判定します。

// App.java
public class App {
    public static void main(String[] args) {
        Double nanValue = Double.NaN;
        Double infiniteValue = Double.POSITIVE_INFINITY;
        Double finiteValue = 90.5;
        System.out.println("nanValueはNaNか: " + nanValue.isNaN());
        System.out.println("infiniteValueは無限大か: " + infiniteValue.isInfinite());
        System.out.println("finiteValueは無限大か: " + finiteValue.isInfinite());
    }
}

nanValueはNaNか: true
infiniteValueは無限大か: true
finiteValueは無限大か: false

この例では、nanValueはNaNであるためisNaNメソッドはtrueを返し、infiniteValueは無限大であるためisInfiniteメソッドはtrueを返します。

finiteValueは有限の数値であるため、isInfiniteメソッドはfalseを返します。

Doubleクラスの定数

NaNの扱い

NaN(Not-a-Number)は、数値演算が定義されない結果を表すために使用される特殊な定数です。

Doubleクラスでは、Double.NaNとして定義されています。

NaNは、通常の数値とは異なり、比較演算において特別な扱いが必要です。

// App.java
public class App {
    public static void main(String[] args) {
        Double nanValue = Double.NaN;
        System.out.println("nanValueはNaNか: " + nanValue.isNaN());
        System.out.println("nanValue == Double.NaN: " + (nanValue == Double.NaN));
    }
}

nanValueはNaNか: true
nanValue == Double.NaN: false

この例では、nanValueがNaNであることをisNaNメソッドで確認できますが、==演算子での比較はfalseを返します。

NaNは他のNaNと等しくないため、==演算子ではなくisNaNメソッドを使用して判定する必要があります。

POSITIVE_INFINITYとNEGATIVE_INFINITY

Doubleクラスには、正の無限大と負の無限大を表す定数が用意されています。

これらは、それぞれDouble.POSITIVE_INFINITYとDouble.NEGATIVE_INFINITYとして定義されています。

これらの定数は、数値が非常に大きい場合や、ゼロで割った場合などに使用されます。

// App.java
public class App {
    public static void main(String[] args) {
        Double positiveInfinity = Double.POSITIVE_INFINITY;
        Double negativeInfinity = Double.NEGATIVE_INFINITY;
        System.out.println("positiveInfinityは無限大か: " + positiveInfinity.isInfinite());
        System.out.println("negativeInfinityは無限大か: " + negativeInfinity.isInfinite());
    }
}

positiveInfinityは無限大か: true
negativeInfinityは無限大か: true

この例では、positiveInfinityとnegativeInfinityが無限大であることをisInfiniteメソッドで確認できます。

これらの定数は、無限大を扱う際に便利です。

MAX_VALUEとMIN_VALUE

Doubleクラスには、表現可能な最大値と最小値を表す定数が用意されています。

Double.MAX_VALUEは、double型で表現できる最大の正の数を示し、Double.MIN_VALUEは、正の非ゼロの最小の数を示します。

// App.java
public class App {
    public static void main(String[] args) {
        System.out.println("Doubleの最大値: " + Double.MAX_VALUE);
        System.out.println("Doubleの最小値: " + Double.MIN_VALUE);
    }
}

Doubleの最大値: 1.7976931348623157E308
Doubleの最小値: 4.9E-324

この例では、Double.MAX_VALUEとDouble.MIN_VALUEを使用して、double型で表現可能な最大値と最小値を表示しています。

これらの定数は、数値の範囲を確認する際に役立ちます。

Doubleクラスの応用例

コレクションでの使用

Doubleクラスは、Javaのコレクションフレームワークで使用する際に非常に便利です。

doubleのようなプリミティブ型はコレクションに直接格納できないため、Doubleオブジェクトとして扱う必要があります。

以下は、ArrayListにDoubleオブジェクトを格納する例です。

// App.java
import java.util.ArrayList;
public class App {
    public static void main(String[] args) {
        ArrayList<Double> doubleList = new ArrayList<>();
        doubleList.add(10.5);
        doubleList.add(20.5);
        doubleList.add(30.5);
        for (Double value : doubleList) {
            System.out.println("リストの値: " + value);
        }
    }
}

リストの値: 10.5
リストの値: 20.5
リストの値: 30.5

この例では、ArrayListにDoubleオブジェクトを格納し、リスト内の各要素を出力しています。

Doubleクラスを使用することで、コレクションに数値を簡単に格納できます。

数値計算での使用

Doubleクラスは、数値計算を行う際にも使用されます。

特に、計算結果をオブジェクトとして扱いたい場合に便利です。

以下は、Doubleオブジェクトを使用して基本的な数値計算を行う例です。

// App.java
public class App {
    public static void main(String[] args) {
        Double num1 = 15.5;
        Double num2 = 4.5;
        Double sum = num1 + num2;
        Double difference = num1 - num2;
        Double product = num1 * num2;
        Double quotient = num1 / num2;
        System.out.println("合計: " + sum);
        System.out.println("差: " + difference);
        System.out.println("積: " + product);
        System.out.println("商: " + quotient);
    }
}

合計: 20.0
差: 11.0
積: 69.75
商: 3.4444444444444446

この例では、Doubleオブジェクトを使用して加算、減算、乗算、除算を行っています。

Doubleクラスを使用することで、計算結果をオブジェクトとして扱うことができます。

データベースとの連携

Doubleクラスは、データベースとの連携においても重要な役割を果たします。

データベースから取得した数値データをDoubleオブジェクトとして扱うことで、Javaプログラム内での操作が容易になります。

以下は、JDBCを使用してデータベースからDouble型のデータを取得する例です。

// App.java
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.Statement;
public class App {
    public static void main(String[] args) {
        String url = "jdbc:mysql://localhost:3306/mydatabase";
        String user = "username";
        String password = "password";
        try (Connection conn = DriverManager.getConnection(url, user, password);
             Statement stmt = conn.createStatement();
             ResultSet rs = stmt.executeQuery("SELECT price FROM products")) {
            while (rs.next()) {
                Double price = rs.getDouble("price");
                System.out.println("商品価格: " + price);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

商品価格: 100.5
商品価格: 200.75
商品価格: 150.0

この例では、データベースからpriceカラムの値を取得し、Doubleオブジェクトとして扱っています。

Doubleクラスを使用することで、データベースからの数値データを効率的に操作できます。

Doubleクラスの注意点

精度の問題

Doubleクラスを使用する際には、浮動小数点数の精度に注意が必要です。

double型は有限のビット数で数値を表現するため、非常に大きな数や非常に小さな数を扱うときに精度の問題が発生することがあります。

特に、計算結果が予想と異なる場合があるため、金融計算などの精度が重要な場面ではBigDecimalクラスの使用を検討することが推奨されます。

// App.java
public class App {
    public static void main(String[] args) {
        double a = 0.1;
        double b = 0.2;
        double sum = a + b;
        System.out.println("0.1 + 0.2の結果: " + sum);
    }
}

0.1 + 0.2の結果: 0.30000000000000004

この例では、0.1と0.2を加算した結果が0.3ではなく、0.30000000000000004となっています。

これは浮動小数点数の精度の問題によるものです。

比較時の注意点

Doubleオブジェクトを比較する際には、==演算子を使用するのではなく、equalsメソッドを使用することが推奨されます。

==演算子はオブジェクトの参照を比較するため、値が等しくても異なるオブジェクトであればfalseを返します。

// App.java
public class App {
    public static void main(String[] args) {
        Double doubleObject1 = 0.3;
        Double doubleObject2 = 0.3;
        System.out.println("==による比較: " + (doubleObject1 == doubleObject2));
        System.out.println("equalsによる比較: " + doubleObject1.equals(doubleObject2));
    }
}

==による比較: false
equalsによる比較: true

この例では、==演算子による比較はfalseを返しますが、equalsメソッドによる比較はtrueを返します。

equalsメソッドを使用することで、値の比較が正確に行えます。

NullPointerExceptionの回避

Doubleオブジェクトを使用する際には、null値に注意が必要です。

null値を持つDoubleオブジェクトに対してメソッドを呼び出すと、NullPointerExceptionが発生する可能性があります。

これを回避するためには、nullチェックを行うか、Optionalクラスを使用することが推奨されます。

// App.java
public class App {
    public static void main(String[] args) {
        Double doubleObject = null;
        if (doubleObject != null) {
            System.out.println("Doubleオブジェクトの値: " + doubleObject);
        } else {
            System.out.println("Doubleオブジェクトはnullです");
        }
    }
}