閉じる

JavaでintをStringに変換する方法:String.valueOfとtoStringの使い分け

Javaプログラミングにおいて、数値型であるintを文字列型であるStringに変換する処理は、ログ出力や画面表示、データの連結など、日常的に頻繁に発生する操作です。

Javaにはこの変換を行うための方法がいくつか用意されており、それぞれのメソッドには特徴や適切な利用シーンが存在します。

開発者がプログラムの意図を明確にし、効率的なコードを記述するためには、これらの使い分けを正しく理解しておくことが重要です。

本記事では、主要な変換方法であるString.valueOfInteger.toStringを中心に、それぞれの動作原理やパフォーマンス、さらに最新のJava環境における最適な選択肢について詳しく詳しく紹介します。

String.valueOfメソッドによる変換

Javaで数値を文字列に変換する際に、最も一般的かつ推奨される方法の一つが String.valueOf メソッドです。

このメソッドは静的(static)メソッドとして定義されており、引数として渡されたさまざまなデータ型を文字列に変換する役割を担います。

String.valueOf の基本的な使い方

String.valueOfを使用する場合、変換したいint型の変数を引数に渡すだけで完了します。

Java
// int型の変数を定義
int number = 100;

// String.valueOfを使用して文字列に変換
String result = String.valueOf(number);

// 結果を表示
System.out.println("変換結果: " + result);
実行結果
変換結果: 100

String.valueOf の内部動作

実は、String.valueOf(int i)メソッドの内部では、後述する Integer.toString メソッドを呼び出しています

そのため、実行速度や結果においてInteger.toStringと大きな差はありません。

それにもかかわらずこのメソッドが推奨される理由は、「どのようなデータ型でも同じメソッド名で変換できる」という汎用性にあります。

例えば、将来的に変数の型がintからdoublelongに変更されたとしても、メソッド名を書き換える必要がないため、コードの保守性が向上します。

Integer.toStringメソッドによる変換

Integer.toStringメソッドも、int型を文字列に変換するために非常によく使われる手段です。

これはjava.lang.Integerクラスに定義されている静的メソッドであり、整数値を直接文字列に変換する機能を提供します。

Integer.toString の基本的な使い方

使い方はString.valueOfとほぼ同じですが、クラス名が異なります。

Java
int age = 25;

// Integer.toStringを使用して変換
String ageStr = Integer.toString(age);

System.out.println("年齢: " + ageStr);
実行結果
年齢: 25

Integer.toString を選ぶべきケース

Integer.toStringを明示的に使用するメリットは、「数値型を変換していること」をコード上で明確に示せる点にあります。

また、このメソッドには第2引数として基数(進数)を指定できるオーバーロードが存在します。

例えば、10進数の数値を2進数や16進数の文字列として取得したい場合には、Integer.toStringを使用する必要があります。

Java
int value = 255;

// 16進数の文字列に変換
String hexString = Integer.toString(value, 16);

System.out.println("16進数表記: " + hexString);
実行結果
16進数表記: ff

このように、単純な変換以上の制御が必要な場合にはInteger.toStringが適しています。

空文字との連結による簡易的な変換

Javaの初心者からベテランまで、多くの開発者が利用する最も手軽な方法が、空文字("")と数値を+演算子で連結する方法です。

連結演算子の仕組み

Javaでは、文字列と他のデータ型を+演算子で連結すると、自動的に数値が文字列に変換される仕組みがあります。

Java
int count = 10;

// 空文字と連結して変換
String countStr = count + "";

System.out.println("カウント: " + countStr);
実行結果
カウント: 10

この方法は非常に記述が短く、直感的であるため、デバッグ時のログ出力などで頻繁に利用されます。

パフォーマンス上の懸念

しかし、大規模なループ内などでの過度な使用には注意が必要です。

内部的にはStringBuilder(またはJavaのバージョンによってはStringConcatFactory)が使用され、オブジェクトの生成コストが発生するためです。

厳密なパフォーマンスが求められる場面や、大量の変換を行う場合は String.valueOf を使用する方が望ましいと言えます。

各変換方法の比較表

それぞれの変換方法の特徴を以下の表にまとめました。

方法記述の簡潔さ汎用性特徴・備考
String.valueOf(i)最も一般的で安全。型を選ばない。
Integer.toString(i)整数に特化。進数指定が可能。
i + “”手軽だが、大量処理には不向き。

最新のJavaにおける文字列変換(String Templates)

2026年現在のモダンなJava開発環境においては、文字列の中に変数を埋め込む新しい手法も普及しています。

特に「String Templates(文字列テンプレート)」は、従来の文字列連結よりも安全かつ可読性の高い方法を提供します。

String Templates の利用例

変数を直接リテラルの中に記述できるため、型変換を意識せずに文字列を構築できます。

Java
int score = 95;

// STRプロセッサを使用したテンプレート(Java 21以降のプレビュー/標準機能)
String message = STR."あなたのスコアは \{score} 点です。";

System.out.println(message);
実行結果
あなたのスコアは 95 点です。

この方法では、内部で効率的な処理が行われるだけでなく、変換メソッドを明示的に呼び出す手間が省けるという大きな利点があります。

複雑な文字列を組み立てる場合には、個別にString.valueOfを呼ぶのではなく、このテンプレート機能を積極的に活用しましょう。

変換時に注意すべき「Null」の扱い

基本データ型であるintを扱う場合は問題になりませんが、ラッパークラスであるIntegerを扱う際には注意が必要です。

オブジェクトがnullの場合にどのように動作するかが、メソッドによって異なるからです。

Integer オブジェクトを変換する場合

以下の例では、nullの可能性があるInteger型を扱っています。

Java
Integer nullableInt = null;

// String.valueOf は "null" という文字列を返す
String safeResult = String.valueOf(nullableInt);
System.out.println("Result 1: " + safeResult);

// Integer.toString は NullPointerException を発生させる
try {
    String errorResult = nullableInt.toString();
} catch (NullPointerException e) {
    System.out.println("Result 2: エラーが発生しました");
}
実行結果
Result 1: null
Result 2: エラーが発生しました

実行時エラーを防ぎ、より堅牢なプログラムを作成するためには、String.valueOf を使用するのが安全です。

もしnullの場合に空文字にしたい、あるいはデフォルト値を返したいといった要件がある場合は、Objects.toString(obj, "")などの利用も検討してください。

まとめ

JavaでintStringに変換する方法は多岐にわたりますが、基本的には「String.valueOf」を使用するのがベストプラクティスと言えます。

進数指定が必要な場合はInteger.toString、一時的なデバッグや簡単な連結なら+ ""、そして複雑な文字列構築ならString Templatesと使い分けるのが理想的です。

各メソッドの特性や内部動作を理解することで、予期せぬエラー(NullPointerException)を回避し、パフォーマンスと可読性のバランスが取れた高品質なコードを書くことができるようになります。

プロジェクトのコーディング規約やJavaのバージョンに合わせて、最適な方法を選択してください。

URLをコピーしました!