Javaのint同士の割り算で割合が0になる原因と、先にdoubleへ変える修正を扱う記事のアイキャッチ

実装・エラー解決

Javaで割合が0になる原因|int同士の割り算とdoubleのキャスト位置

CSVを4件取り込み、そのうち1件が成功。画面には成功率25.0%と出したいのに、Javaでは0.0%になりました。成功件数と全件数がどちらもintなら、double rate = succeeded / total;と書いても、割り算の時点で整数の0になります。

新人SE
新人SE
受け取る変数はdoubleなのに、1を4で割ると0.0になるのはなぜですか?

ポンコツSE
ポンコツSE
割り算をするときの型は、左右に置いた値で決まります。片方を先にdoubleへ変えると、1.0 ÷ 4で0.25を計算できます。

まず直す1行は double rate = (double) succeeded / total; です。 あわせて、成功0件・全4件なら0.0%、全0件なら未集計と表示を分けます。同じ0に見えると、取込対象が来ていない状況と、来た対象がすべて失敗した状況を運用担当が見分けられません。

記事と同じコードを実行する

ZIPを展開し、JDK 17で java src/main/java/ImportSuccessRate.java を実行します。JUnitの10件はMaven 3.9系で mvn test を実行します。本体・テスト・pom.xml・READMEを収録しています。

サンプルZIPをダウンロード GitHubでコード全文と実行手順を見る

割る前に片方をdoubleにすると、1÷4で0.25が残る

succeeded = 1、total = 4を使って、結果を変数へ入れるまでの順番を比べます。double rate = succeeded / total;では、最初にint / intを計算します。整数の割り算では商の小数部分が0に向かって切り捨てられるので、この例の商は0です。その後、代入するときに整数の0がdoubleの0.0へ変換されます。変数の宣言をdoubleにしても、すでに捨てた0.25は戻りません。

(double) (succeeded / total)も、括弧の中で整数の割り算を終えてから0を変換します。(double) succeeded / totalはキャストが分子だけにかかるため、先に1が1.0になり、割り算はdoubleとして行われます。分母だけ先に変えても同じです。ソース上で判断するときは、左辺の型より先に/の両側を見ます。

キャストする位置で、1÷4の答えが変わる

割った後にキャスト

  1. 割り算1 / 4
  2. 整数の商0
  3. 0をdoubleへ0.0

割る前にキャスト

  1. 1をdoubleへ1.0
  2. 小数を含む割り算1.0 / 4
  3. 小数の商0.25

この挙動はJava言語仕様の除算演算子の規則で確認できます。例えば5 / 2は2、-5 / 2は-2です。この取込件数の例では負の件数を受け付けません。負数を含む別の業務で常に下方向へ丸めたい場合は、単に整数の割り算に置き換えてよいかを仕様から判断します。

関連記事Javaのintの掛け算はlongに代入してもあふれる|原因と直し方 割り算の前と同様に、掛け算でも計算時の型を先に確認します。intの積をlongへ代入してもあふれる例を実行できます。 記事を読む

全0件は「未集計」、全件失敗は「0.0%」に分ける

成功率の計算は、取り込みを試した行のうち、何行を取り込めたかを表示する場面に絞ります。分母に数えるのは取込を試した行です。見出し行を数えるか、途中の空行をどう扱うかはCSVを読み込む側で決めます。この例に渡す値は、分母と分子の集計規則が揃った後の件数です。

例では成功件数0以上、全件数0以上、成功件数は全件数以下を前提にします。負数や成功件数が分母を超える値は、上流の件数を確認できるよう例外にします。0 / 0は、先に件数の条件を通過し、全件数が0の分岐で「未集計」を返します。1 / 0は集計として矛盾しているので例外です。0件を先にまとめて判定すると、矛盾した1件まで未集計として表示してしまいます。

成功件数 / 全件数表示または動作確認する内容
1 / 425.0%小数の商を割合表示に使う
2 / 366.7%表示を小数第1位に揃える
0 / 40.0%試した4件のすべてが失敗
4 / 4100.0%試した4件のすべてが成功
0 / 0未集計取り込みを試した行が0件
1 / 0IllegalArgumentException成功件数が全件数を超えている

整数で0を分母にするとArithmeticExceptionになります。分子をdoubleへ変えた場合は、0.0 / 0でNaN、正の値を0で割るとInfinityです。0件を何と表示するかを先に決め、割り算の前に処理します。後から画面だけでNaNを消すと、未集計の理由が他の画面や集計処理へ伝わりません。

同じ1件/4件で0.0と0.25を出して、違いを確かめる

以下をImportSuccessRate.javaへ保存すれば、JDK 17でjava ImportSuccessRate.javaを実行できます。ZIPを使う場合は、展開したフォルダーの直下からjava src/main/java/ImportSuccessRate.javaを実行します。最初の3行が割り算とキャストの比較、残りの4行が業務画面に相当する表示です。

ImportSuccessRate.java(全文)

import java.util.Locale;

public class ImportSuccessRate {

    public static String format(int succeeded, int total) {
        if (succeeded < 0 || total < 0 || succeeded > total) {
            throw new IllegalArgumentException("成功件数は0以上、全件数以下です");
        }
        if (total == 0) {
            return "未集計";
        }

        double ratio = (double) succeeded / total;
        return String.format(Locale.ROOT, "%.1f%%", ratio * 100.0);
    }

    public static void main(String[] args) {
        int succeeded = 1;
        int total = 4;

        double assignedToDouble = succeeded / total;
        double castAfterDivision = (double) (succeeded / total);
        double castBeforeDivision = (double) succeeded / total;

        System.out.println("doubleへ代入: " + assignedToDouble);
        System.out.println("割った後にキャスト: " + castAfterDivision);
        System.out.println("割る前にキャスト: " + castBeforeDivision);
        System.out.println("1件成功 / 4件: " + format(succeeded, total));
        System.out.println("2件成功 / 3件: " + format(2, 3));
        System.out.println("0件成功 / 4件: " + format(0, 4));
        System.out.println("0件成功 / 0件: " + format(0, 0));
    }
}

Java 17での実行結果

doubleへ代入: 0.0
割った後にキャスト: 0.0
割る前にキャスト: 0.25
1件成功 / 4件: 25.0%
2件成功 / 3件: 66.7%
0件成功 / 4件: 0.0%
0件成功 / 0件: 未集計

formatは、商を0.25のような比率として計算し、最後に100.0倍して表示します。%.1fは小数第1位までを表示し、%%は%そのものを出します。Locale.ROOTを渡しているので、実行環境の既定の言語設定が変わっても、この例の小数点はピリオドになります。

succeeded / total * 100.0と書いても、整数同士の割り算が先に終わるので1件/4件は0.0になります。succeeded * 100 / totalは1件/4件では25になりますが、整数の割り算なので2件/3件の小数部分が消え、件数が大きいと先の掛け算がintの範囲を超えます。試しに分子10億、分母20億を渡し、このサンプルのままなら50.0%と出ることをテストで確認します。

画面の表示だけに使う割合では、この例のようにdoubleで求め、表示の桁を最後に整えられます。表示を66.7%にした文字列を別の計算へ戻して使うと、3分の2を正確に保ったことにはなりません。例えば「成功率が3分の2以上か」を厳密に決めるなら、正の分母を確認した上で3L * succeeded >= 2L * totalのように件数同士で比較できます。この例の件数はintなので、先にlongへ広げた積はその範囲に収まります。

1件/4件と全0件を、別々のテストで固定する

成功と失敗が混ざる入力を入れないと、整数の割り算を見逃します。全件成功は4 / 4でも1、成功0件は0 / 4でも0になるためです。1件/4件に加えて、表示の丸めを確認する2件/3件、整数で100倍すると大きい10億件/20億件も確かめます。

ZIPを展開し、pom.xmlがあるフォルダーでmvn testを実行します。本文だけから再現するときは、上の本体をsrc/main/java/ImportSuccessRate.java、下のテストをsrc/test/java/ImportSuccessRateTest.javaに置きます。pom.xmlを同じプロジェクトの直下に保存してください。

ImportSuccessRateTest.java(全文)
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.CsvSource;

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertThrows;

class ImportSuccessRateTest {

    @ParameterizedTest
    @CsvSource({
            "1, 4, 25.0%",
            "2, 3, 66.7%",
            "0, 4, 0.0%",
            "4, 4, 100.0%",
            "0, 0, 未集計",
            "1000000000, 2000000000, 50.0%"
    })
    void formatsValidCounts(int succeeded, int total, String expected) {
        assertEquals(expected, ImportSuccessRate.format(succeeded, total));
    }

    @ParameterizedTest
    @CsvSource({"-1, 4", "0, -1", "5, 4", "1, 0"})
    void rejectsInvalidCounts(int succeeded, int total) {
        assertThrows(IllegalArgumentException.class,
                () -> ImportSuccessRate.format(succeeded, total));
    }
}
pom.xml(全文)
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>info.syachiku</groupId>
  <artifactId>integer-division-sample</artifactId>
  <version>1.0.0</version>
  <properties>
    <maven.compiler.release>17</maven.compiler.release>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>
  <dependencies>
    <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter</artifactId>
      <version>5.12.2</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-resources-plugin</artifactId>
        <version>3.3.1</version>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.14.1</version>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
        <version>3.5.3</version>
      </plugin>
    </plugins>
  </build>
</project>

通常版は、表示の6件と範囲外を拒否する4件の合計10件が成功しました。本体のformatにあるdouble ratio = (double) succeeded / total;だけをdouble ratio = (double) (succeeded / total);に変えて実行すると、25.0%、66.7%、50.0%の3件が0.0%になって失敗します。結果を確認したら、その1行を元に戻します。

通常版とキャストを後に戻した版のJUnitログ抜粋

通常版
[INFO] Tests run: 10, Failures: 0, Errors: 0, Skipped: 0

割った後のキャストへ変更
expected: <25.0%> but was: <0.0%>
expected: <66.7%> but was: <0.0%>
expected: <50.0%> but was: <0.0%>
[ERROR] Tests run: 10, Failures: 3, Errors: 0, Skipped: 0

レビューでは「割る前の型」と「全0件の扱い」を確認する

画面で0.0%を見たら、まず成功件数と全件数を同じ処理時点で比べます。全4件中1件成功なのに0.0%なら割り算の式を追い、4件中0件成功なら個々の取込エラーを確認します。全0件なら、ファイルが来ていないのか、ファイルは来たが取込対象の行がなかったのかを、ファイル受付や入力側の記録で見ます。割合だけを記録すると、この切り分けに必要な情報が残りません。

レビューコメント例 「doubleへ代入する時点で、1件/4件はもう整数の0になっています。分子を割る前にキャストしてください。全4件中0件と全0件が画面で区別できるよう、0.0%と未集計もテストで確認しましょう。」

  • /を評価するときに片方の型がdoubleになっている。
  • 成功件数と全件数を同じ対象から数え、分母が0の表示と範囲外の扱いを区別する。
  • 0%と100%に加え、1件/4件と2件/3件で小数が残ることを確認する。
  • 表示用の丸めを、金額計算や厳密なしきい値判定へ持ち込まない。

型や演算子の練習から戻りたい場合は、『スッキリわかるJava入門 第5版』を案内します。変数と式の型を読めるようにしてから、画面表示や集計のコードへ進むと、括弧やキャストの位置を説明しやすくなります。

書籍「スッキリわかるJava入門 第5版」の表紙
商品画像:Amazon.co.jp
PR Java初学者向け

スッキリわかるJava入門 第5版

中山 清喬 (著), 国本 大悟 (著), 株式会社フレアリンク (監修)

変数・条件分岐から、クラスの基本まで学ぶ一冊。

豊富な図とサンプルで、変数、条件分岐、クラス、例外処理まで順番に学べます。Javaの最初の教科書を探している人向けです。

  • Javaを基礎から体系的に学びたい
  • Java 25 LTS対応の入門書を選びたい

当サイトはAmazonアソシエイト・プログラムの参加者です。価格・在庫・配送条件はAmazonでご確認ください。

関連記事BigDecimal.divideでArithmeticExceptionになる原因|割り切れない計算の丸め方 金額や厳密な小数の計算では、割り切れないときの桁数と丸め方を指定する例を確認できます。 記事を読む 関連記事Java初心者におすすめの最初の1冊|Spring Bootに進むまでの学び方 変数、条件分岐、型を読むところから学びたいときに、Javaの最初の1冊と練習方法を選べます。 記事を読む

まとめ

int / intの商は整数です。小数を表示したいときは、割る前に片方をdoubleへ変えます。全4件中1件なら25.0%、全4件中0件なら0.0%、全0件なら未集計です。修正の確認では、0%、100%、その間の割合、分母0をそれぞれ実行してください。

-実装・エラー解決
-,