Java – StringBuilderの基本的な使い方をわかりやすく解説

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

JavaのStringBuilderは、文字列を効率的に操作するためのクラスです。

Stringは不変(immutable)であるため、文字列操作のたびに新しいオブジェクトが生成されますが、StringBuilderは可変(mutable)で、同じオブジェクト内で操作が行われるため、パフォーマンスが向上します。

主なメソッドには、文字列を追加するappend、特定の位置に挿入するinsert、文字列を削除するdelete、文字列を反転するreverseなどがあります。

操作後にtoStringを使うことで、String型に変換できます。

特にループ内で文字列を頻繁に操作する場合に有用です。

目次から探す

StringBuilderとは

JavaにおけるStringBuilderは、文字列を効率的に操作するためのクラスです。

通常、JavaのStringは不変(immutable)であり、一度作成すると変更できません。

そのため、文字列を頻繁に変更する場合、毎回新しいStringオブジェクトを作成する必要があり、パフォーマンスに影響を与えることがあります。

StringBuilderはこの問題を解決するために設計されています。

特徴

可変性: StringBuilderは、文字列を変更することができるため、同じオブジェクトを使い続けることができます。
効率性: 文字列の追加や削除が高速に行えるため、大量の文字列操作に向いています。
スレッド非安全: StringBuilderはスレッドセーフではないため、複数のスレッドから同時にアクセスされる場合は注意が必要です。

StringBuilderを使うことで、文字列の連結や挿入、削除などが簡単に行えます。

例えば、以下のように使います。

StringBuilder sb = new StringBuilder("こんにちは");
sb.append("、世界！"); // 文字列の追加
System.out.println(sb.toString()); //  こんにちは、世界！

このように、StringBuilderを使うことで、効率的に文字列を操作することができます。

次のセクションでは、StringBuilderの基本操作について詳しく見ていきましょう。

StringBuilderの基本操作

StringBuilderを使うことで、文字列の操作が簡単に行えます。

ここでは、StringBuilderの基本的な操作方法について詳しく説明します。

主な操作には、文字列の追加、挿入、削除、置換、長さの取得などがあります。

以下にそれぞれの操作を紹介します。

文字列の追加

append()メソッドを使うことで、文字列を末尾に追加できます。

StringBuilder sb = new StringBuilder("こんにちは");
sb.append("、世界！");
System.out.println(sb.toString()); //  こんにちは、世界！

文字列の挿入

insert()メソッドを使うと、指定した位置に文字列を挿入できます。

StringBuilder sb = new StringBuilder("こんにちは世界！");
sb.insert(5, "、"); // 5文字目に挿入
System.out.println(sb.toString()); //  こんにちは、世界！

文字列の削除

delete()メソッドを使うことで、指定した範囲の文字列を削除できます。

StringBuilder sb = new StringBuilder("こんにちは、世界！");
sb.delete(5, 6); // 5文字目から6文字目を削除
System.out.println(sb.toString()); //  こんにちは世界！

文字列の置換

replace()メソッドを使うと、指定した範囲の文字列を別の文字列に置き換えられます。

StringBuilder sb = new StringBuilder("こんにちは、世界！");
sb.replace(5, 6, "、"); // 5文字目を「、」に置換
System.out.println(sb.toString()); //  こんにちは、世界！

長さの取得

length()メソッドを使うことで、現在の文字列の長さを取得できます。

StringBuilder sb = new StringBuilder("こんにちは、世界！");
int length = sb.length();
System.out.println("文字列の長さ: " + length); //  文字列の長さ: 10

文字列のクリア

setLength(0)メソッドを使うと、StringBuilderの内容をクリアできます。

StringBuilder sb = new StringBuilder("こんにちは、世界！");
sb.setLength(0); // 内容をクリア
System.out.println(sb.toString()); //  (空文字列)

これらの基本操作を使うことで、StringBuilderを活用した文字列操作がスムーズに行えます。

次のセクションでは、StringBuilderの応用例について見ていきましょう。

StringBuilderの応用例

StringBuilderは、文字列の操作を効率的に行うための強力なツールです。

ここでは、実際のプログラムでの応用例をいくつか紹介します。

これらの例を通じて、StringBuilderの便利さを実感していただけると思います。

複数の文字列を連結する

大量の文字列を連結する場合、StringBuilderを使うとパフォーマンスが向上します。

例えば、ユーザーからの入力をまとめて表示する場合などに便利です。

StringBuilder sb = new StringBuilder();
String[] names = {"田中", "鈴木", "佐藤"};
for (String name : names) {
    sb.append(name).append("さん、");
}
sb.setLength(sb.length() - 1); // 最後の「、」を削除
System.out.println(sb.toString()); //  田中さん、鈴木さん、佐藤さん

HTMLの生成

HTMLを動的に生成する際にもStringBuilderが役立ちます。

例えば、リストを作成する場合などです。

StringBuilder sb = new StringBuilder();
sb.append("<ul>\n");
String[] items = {"りんご", "ばなな", "みかん"};
for (String item : items) {
    sb.append("  <li>").append(item).append("</li>\n");
}
sb.append("</ul>");
System.out.println(sb.toString());

文字列のフォーマット

StringBuilderを使って、複雑な文字列のフォーマットを行うこともできます。

例えば、カスタムメッセージを作成する場合です。

StringBuilder sb = new StringBuilder();
String name = "山田";
int age = 30;
sb.append("こんにちは、").append(name).append("さん。")
  .append("あなたは").append(age).append("歳です。");
System.out.println(sb.toString()); //  こんにちは、山田さん。あなたは30歳です。

文字列の逆順

文字列を逆にする処理も簡単に行えます。

reverse()メソッドを使うことで、手軽に逆順の文字列を得ることができます。

StringBuilder sb = new StringBuilder("こんにちは");
sb.reverse();
System.out.println(sb.toString()); //  はちにんこ

大量データの処理

大量のデータを扱う場合、StringBuilderを使うことでメモリの使用効率が良くなります。

例えば、ログファイルの内容をまとめて表示する場合などです。

StringBuilder sb = new StringBuilder();
for (int i = 1; i <= 1000; i++) {
    sb.append("ログエントリ ").append(i).append("\n");
}
System.out.println(sb.toString()); // 1000行のログを出力

これらの応用例を通じて、StringBuilderの使い方やその利点を理解していただけたでしょうか。

次のセクションでは、StringBuilderを使用する際の注意点についてお話しします。

StringBuilderを使用する際の注意点

StringBuilderは非常に便利なクラスですが、使用する際にはいくつかの注意点があります。

これらを理解しておくことで、より効果的にStringBuilderを活用できるようになります。

スレッドセーフではない

StringBuilderはスレッドセーフではありません。

つまり、複数のスレッドから同時にアクセスされると、予期しない動作を引き起こす可能性があります。

スレッド間で共有する場合は、StringBufferを使用することを検討してください。

StringBufferはスレッドセーフですが、パフォーマンスが若干劣ります。

初期容量の設定

StringBuilderは内部的に配列を使用して文字列を管理しています。

初期容量を指定しない場合、文字列が増えるたびに配列のサイズが変更されることがあります。

これにより、パフォーマンスが低下することがあります。

大量の文字列を扱う場合は、初期容量を設定することをおすすめします。

StringBuilder sb = new StringBuilder(100); // 初期容量を100に設定

不要なメモリ使用

StringBuilderの内容をクリアする際、setLength(0)を使用することで、メモリを解放せずに再利用できますが、長時間使用しない場合は、StringBuilderを破棄することも考慮してください。

特に大きなデータを扱う場合、メモリリークの原因になることがあります。

文字列の不変性を理解する

StringBuilderは可変ですが、Stringは不変です。

StringBuilderを使って文字列を操作した後、toString()メソッドを呼び出すことでStringに変換されます。

この際、元のStringBuilderの内容は変更されません。

Stringの不変性を理解しておくことが重要です。

例外処理

StringBuilderのメソッドを使用する際には、例外が発生する可能性があります。

特に、インデックスを指定するメソッド(insert(), delete(), replace()など)では、範囲外のインデックスを指定するとStringIndexOutOfBoundsExceptionが発生します。

これらのメソッドを使用する際は、インデックスの範囲を確認することが大切です。

StringBuilder sb = new StringBuilder("こんにちは");
try {
    sb.delete(10, 12); // 範囲外のインデックス
} catch (StringIndexOutOfBoundsException e) {
    System.out.println("インデックスが範囲外です。");
}

これらの注意点を理解し、適切にStringBuilderを使用することで、より効率的で安全なプログラミングが可能になります。

次のセクションでは、StringBuilderを使うべき場面と使わないべき場面についてお話しします。

StringBuilderを使うべき場面と使わないべき場面

StringBuilderは非常に便利なクラスですが、すべての状況で最適というわけではありません。

ここでは、StringBuilderを使うべき場面と、逆に使わないべき場面について詳しく説明します。

StringBuilderを使うべき場面

頻繁な文字列の変更が必要な場合

文字列を頻繁に追加、削除、挿入する必要がある場合、StringBuilderを使用することでパフォーマンスが向上します。

例えば、ループ内で文字列を構築する場合などです。

大量のデータを扱う場合

大量の文字列データを扱う際、StringBuilderはメモリの効率的な使用を可能にします。

特に、長い文字列を連結する場合に効果的です。

動的な文字列生成が必要な場合

ユーザー入力や外部データに基づいて動的に文字列を生成する場合、StringBuilderは非常に便利です。

例えば、HTMLやXMLの生成などが該当します。

パフォーマンスが重要な場合

文字列操作のパフォーマンスが重要なアプリケーションでは、StringBuilderを使用することで、Stringの不変性によるオーバーヘッドを回避できます。

StringBuilderを使わないべき場面

スレッドセーフが必要な場合

複数のスレッドから同時にアクセスされる可能性がある場合、StringBuilderはスレッドセーフではないため、StringBufferを使用することを検討してください。

単純な文字列操作の場合

文字列の連結や操作が少ない場合、StringBuilderを使う必要はありません。

単純なStringの連結であれば、+演算子を使った方がコードがシンプルになります。

不変の文字列が必要な場合

文字列が不変であることが求められる場合、Stringを使用する方が適切です。

特に、文字列の内容が変更されないことが保証されている場合には、Stringを選択しましょう。

小さな文字列の操作

小さな文字列を扱う場合、StringBuilderを使用することで逆にオーバーヘッドが発生することがあります。

小さな文字列の連結や操作には、通常のStringを使用する方が効率的です。

これらのポイントを考慮しながら、StringBuilderを適切に活用することで、効率的でパフォーマンスの良いプログラムを作成することができます。

次のセクションでは、これまでの内容を振り返り、StringBuilderの重要性を再確認します。

まとめ

この記事では、JavaのStringBuilderについて、その基本的な使い方や応用例、注意点、使うべき場面と使わないべき場面を詳しく紹介しました。

StringBuilderは、文字列を効率的に操作するための強力なツールであり、特に頻繁に文字列を変更する必要がある場合に非常に役立ちます。

これを機に、StringBuilderを活用して、より効率的なプログラミングを実践してみてください。