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


まず直す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を収録しています。
割る前に片方を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 - 整数の商
0 - 0をdoubleへ
0.0
割る前にキャスト
- 1をdoubleへ
1.0 - 小数を含む割り算
1.0 / 4 - 小数の商
0.25
この挙動はJava言語仕様の除算演算子の規則で確認できます。例えば5 / 2は2、-5 / 2は-2です。この取込件数の例では負の件数を受け付けません。負数を含む別の業務で常に下方向へ丸めたい場合は、単に整数の割り算に置き換えてよいかを仕様から判断します。
全0件は「未集計」、全件失敗は「0.0%」に分ける
成功率の計算は、取り込みを試した行のうち、何行を取り込めたかを表示する場面に絞ります。分母に数えるのは取込を試した行です。見出し行を数えるか、途中の空行をどう扱うかはCSVを読み込む側で決めます。この例に渡す値は、分母と分子の集計規則が揃った後の件数です。
例では成功件数0以上、全件数0以上、成功件数は全件数以下を前提にします。負数や成功件数が分母を超える値は、上流の件数を確認できるよう例外にします。0 / 0は、先に件数の条件を通過し、全件数が0の分岐で「未集計」を返します。1 / 0は集計として矛盾しているので例外です。0件を先にまとめて判定すると、矛盾した1件まで未集計として表示してしまいます。
| 成功件数 / 全件数 | 表示または動作 | 確認する内容 |
|---|---|---|
| 1 / 4 | 25.0% | 小数の商を割合表示に使う |
| 2 / 3 | 66.7% | 表示を小数第1位に揃える |
| 0 / 4 | 0.0% | 試した4件のすべてが失敗 |
| 4 / 4 | 100.0% | 試した4件のすべてが成功 |
| 0 / 0 | 未集計 | 取り込みを試した行が0件 |
| 1 / 0 | IllegalArgumentException | 成功件数が全件数を超えている |
整数で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版
変数・条件分岐から、クラスの基本まで学ぶ一冊。
豊富な図とサンプルで、変数、条件分岐、クラス、例外処理まで順番に学べます。Javaの最初の教科書を探している人向けです。
- Javaを基礎から体系的に学びたい
- Java 25 LTS対応の入門書を選びたい
当サイトはAmazonアソシエイト・プログラムの参加者です。価格・在庫・配送条件はAmazonでご確認ください。
この記事とあわせて読みたい
まとめ
int / intの商は整数です。小数を表示したいときは、割る前に片方をdoubleへ変えます。全4件中1件なら25.0%、全4件中0件なら0.0%、全0件なら未集計です。修正の確認では、0%、100%、その間の割合、分母0をそれぞれ実行してください。



