if (input == "yes") と書いたのに、なぜか条件に入らない。
文字列の中身を比べるときは equals を使います。== は「同じインスタンスか」を見る演算子で、中身が同じでも false になるからです。
文字列操作は毎日のように書くのに、equals と ==、replace と replaceAll、trim と strip のように、似た名前の落とし穴があちこちに埋まっています。
どれもコンパイルは通るので、動かして初めて「あれ?」となるのが厄介なところです。
ここでは比較・切り出し・結合・分割・置換・0埋め・数値変換の7つを、実際に動かした出力つきでまとめました。
この記事でわかること
- 文字列の比較は
equals。==が通ったり通らなかったりする理由 substring・split・replaceAllの「引数の読み違い」で起きるバグ- 全角スペースを消すなら
trimではなくstrip - 0埋め・桁区切り・文字列と数値の変換の書き方
コードはすべて OpenJDK 23.0.1 で実行して出力を確かめています。使っているメソッドは、List.of(Java 9〜)・strip(Java 11〜)・formatted(Java 15〜)を除けば Java 8 でも動きます。
PARTS LIST /目次
Javaの文字列操作とは?Stringの基本を先に押さえる
Javaの文字列操作とは、String クラスのメソッドを使って文字列を比べたり、切り出したり、つないだりする処理のことです。
String はJavaに最初から入っているクラスで、import も要りません。メソッドの数は多いものの、日常的に使うのは限られています。
メソッドを見ていく前に、1つだけ知っておくと後の話がすべて楽になる性質があります。Stringは「中身を変更できない」という性質です。
Stringは「変更できない」文字列のクラス
String のインスタンスは、一度作ると中身を書き換えられません。toUpperCase() や replace() は元の文字列を変えず、新しい文字列を作って返します。
String t = "abc";
t.toUpperCase(); // 戻り値を捨てている
System.out.println(t); // abc
t = t.toUpperCase(); // 戻り値を代入し直す
System.out.println(t); // ABC
1行目の呼び出しは、変換した結果を誰も受け取っていません。コンパイルエラーにもならないので、「メソッドを呼んだのに変わらない」と悩む原因になります。
replace・trim・toUpperCase などは、どれも元の文字列を書き換えません。戻り値を変数に入れ直すか、そのまま次の処理に渡すのが基本です。文字を何度も足していく処理だけは、書き換えられる StringBuilder を使います。
よく使うStringメソッド一覧表
よく使うメソッドを、やりたいこと別に並べました。迷ったらこの表から探して、詳しい使い方は各見出しで確認してください。
空文字か空白だけかを判定する isEmpty・isBlank は、別記事のisBlankとisEmptyの違いで比較表つきでまとめています。
文字列の比較はequalsを使う(==との違い)
文字列の中身が同じか比べるときは、必ず equals を使います。== は「同じインスタンスかどうか」を比べる演算子で、中身が同じでも false になることがあります。
厄介なのは、== でも true になる場面があることです。テストで通ってしまい、本番の入力で初めて壊れる。文字列比較のバグは、だいたいこの順番でやってきます。
==がtrueにもfalseにもなる理由
次のコードは、3つとも中身は同じ "java" です。
String a = "java";
String b = "java";
String c = new String("java");
System.out.println(a == b); // true
System.out.println(a == c); // false
System.out.println(a.equals(c)); // true
a と b のようにソースコードに直接書いた文字列(リテラル)は、Javaが同じインスタンスを使い回します。だから == でも true になります。
一方、new String() やキーボード入力・ファイル・DBから来た文字列は、別のインスタンスです。== は false を返します。実際のアプリで比べる文字列のほとんどは後者なので、== は使わないと決めてしまうのが一番安全です。
インスタンスと参照の関係は、Javaのインスタンスとは?で図にしています。
nullが入りうるならObjects.equalsか定数を左に
equals にも弱点があります。左側の変数が null だと、呼んだ瞬間に NullPointerException で落ちます。
String input = null;
// input.equals("yes") → NullPointerException
System.out.println("yes".equals(input)); // false
System.out.println(Objects.equals(input, "yes")); // false(java.util.Objects)
決まった文字列と比べるなら、定数を左に置けば null でも false が返るだけです。両方とも変数なら Objects.equals を使います。
NullPointerExceptionには、私も何度も悩まされてきました。文字列の比較は「とりあえず変数.equals()」と書きがちで、nullが来る経路を見落とすと落ちます。定数を左に書く書き方は地味ですが、この経路をまるごと塞げます。
null の扱い全般はJava Nullableとは?にまとめています。
大小比較・大文字小文字を無視する比較
並べ替えのために「どちらが先か」を知りたいときは compareTo を使います。戻り値は0なら同じ、負なら左が先、正なら左が後です。
"apple".compareTo("banana")→ -1(apple が先)"Java".equalsIgnoreCase("JAVA")→ true(大文字小文字を無視)"Java".compareToIgnoreCase("java")→ 0
戻り値は最初に違った文字どうしの差になるので、-1 や 1 とは限りません("10".compareTo("9") は -8)。正負で判定し、値そのものには頼らないでください。
compareTo は文字コード順なので、「10」と「9」を比べると「10」が先になります。数字として比べたいなら、先に数値へ変換してください。
比較の方法は、次の順に判定すると迷いません。
flowchart TD
A["文字列を比べたい"] --> B{"順番を知りたい?"}
B -->|"はい"| C["compareTo<br>(数字なら数値に変換してから)"]
B -->|"いいえ"| D{"大文字小文字を無視?"}
D -->|"はい"| E["equalsIgnoreCase"]
D -->|"いいえ"| F{"両方nullになりうる?"}
F -->|"はい"| G["Objects.equals(a, b)"]
F -->|"いいえ"| H["定数.equals(変数)<br>(定数を左に書く)"]
文字列の切り出し・検索(substring・indexOf・contains)
文字列の一部を取り出すのが substring、場所を探すのが indexOf、含むかどうかだけ知りたいのが contains です。
切り出しは「何文字目から何文字目まで」を数字で指定するので、数え方を1つ間違えるだけで1文字ずれます。ここが文字列操作で一番、目で追ってデバッグする時間が長い部分かもしれません。
substringの引数は「開始」と「終了の手前」
substring(開始, 終了) の終了位置は、その文字を含みません。位置は0から数えます。
String s = "2026-11-07";
System.out.println(s.substring(0, 4)); // 2026(0〜3文字目)
System.out.println(s.substring(5)); // 11-07(5文字目から最後まで)
System.out.println(s.substring(s.lastIndexOf("-") + 1)); // 07
「終了 − 開始 = 取り出す文字数」と覚えると、数え間違いが減ります。範囲が文字列の長さを超えると StringIndexOutOfBoundsException が出るので、長さが決まっていない入力では先に length() を確かめます。
日付の文字列を切り出しているなら、LocalDate.parse で日付として扱うほうが安全です。
indexOf・containsで含むかどうかを判定する
indexOf は見つかった位置を、見つからなければ -1 を返します。contains は true か false だけを返します。
System.out.println("Hello Java".contains("Java")); // true
System.out.println("Hello Java".indexOf("Java")); // 6
System.out.println("Hello Java".indexOf("Python")); // -1
含むかどうかだけなら contains、位置を使って切り出すなら indexOf と使い分けます。「数字だけで構成されているか」のようなパターンでの判定は、Java正規表現入門の matches を使います。
文字列の結合と分割(+・StringBuilder・join・split)
文字列をつなぐ方法は3つ、分ける方法は実質 split の1つです。つなぐ側は選び方、分ける側は引数の癖が要点です。
結合は書き方を間違えても結果は同じで、差が出るのは速さと読みやすさです。分割のほうは、引数を1文字読み違えるだけで結果の配列がまるごと変わります。
結合は3つの書き方を場面で選ぶ
数個の文字列を1回つなぐだけなら + で十分です。ループで何度も足していくなら StringBuilder、リストを区切り文字でつなぐなら String.join を使います。
// リストを区切り文字でつなぐ
System.out.println(String.join(",", List.of("A", "B", "C"))); // A,B,C
// ループで足していく
StringBuilder sb = new StringBuilder();
for (int i = 1; i <= 3; i++) {
sb.append(i).append(" ");
}
System.out.println(sb.toString().strip()); // 1 2 3
ループの中で += を使うと、Stringは変更できないので、回るたびに新しい文字列が作られます。数件なら気にならなくても、数万件のCSVを組み立てるような処理では差が出ます。
複数行の固定の文字列をつなぐなら、Java 15以降はテキストブロックのほうが読みやすくなります。
splitの落とし穴:末尾の空文字と「.」
split には、知らないとハマる癖が2つあります。
System.out.println(Arrays.toString("a,b,,c,,".split(","))); // [a, b, , c]
System.out.println(Arrays.toString("a,b,,c,,".split(",", -1))); // [a, b, , c, , ]
System.out.println(Arrays.toString("192.168.0.1".split("."))); // []
System.out.println(Arrays.toString("192.168.0.1".split("\\."))); // [192, 168, 0, 1]
1つ目は、末尾の空文字が黙って消えることです。CSVの最後の列が空だと、列数が足りなくなります。第2引数に -1 を渡すと、末尾の空文字も残ります。
2つ目は、引数が正規表現として扱われることです。「.」は正規表現で「任意の1文字」なので、全部の文字が区切りになり、結果は空の配列です。
「.」「|」「+」「*」などで区切るときは、「\.」のようにエスケープします。CSVを分けるときは、列数が変わらないように split(",", -1) を使うと安全です。
文字列の置換・トリム・0埋め
置き換えの replace と replaceAll、空白を消す trim と strip。どちらも名前が似ているのに動きが違うペアです。0埋めは String.format 1つで済みます。置換と空白の除去は、フォームの入力やCSVを整える前処理で特によく使います。
replaceとreplaceAllの違い
replace は文字をそのまま置き換え、replaceAll は第1引数を正規表現として扱います。どちらも、一致したものを全部置き換えます。
System.out.println("1.2.3".replace(".", "-")); // 1-2-3
System.out.println("1.2.3".replaceAll(".", "-")); // -----
System.out.println("tel: 090-1234-5678".replaceAll("[^0-9]", "")); // 09012345678
名前から「replace は最初の1つだけ、replaceAll は全部」と思われがちですが、違います。最初の1つだけ置き換えたいときは replaceFirst です。正規表現を使わないなら replace を選ぶほうが、記号での事故がありません。
trimでは全角スペースが消えない
日本語の入力を扱うなら、trim より strip(Java 11以降)を使います。trim は半角スペースと改行・タブなどの制御文字しか消さず、全角スペースは残ります。
String z = " 全角スペース "; // 先頭が全角スペース
System.out.println("[" + z.trim() + "]"); // [ 全角スペース]
System.out.println("[" + z.strip() + "]"); // [全角スペース]
trim()
半角スペース・タブ・改行など(文字コード U+0020 以下)だけを消す。全角スペースは残る。Java 1.0からある。
strip()
Unicodeで空白とされる文字を消す。全角スペースも消える。Java 11以降。前だけ・後ろだけの stripLeading / stripTrailing もある。
フォームから来た値の前後の空白を消すなら、strip を使ってから isBlank で空かどうかを判定する流れが定番です。strip でも消えないノーブレークスペース(U+00A0)など、空白まわりの細かい違いはisBlankとisEmptyの違いで扱っています。
String.formatで0埋め・桁区切り
0埋めや桁区切りは String.format で書きます。Java 15以降は、文字列の側から呼ぶ formatted も使えます。
System.out.println(String.format("%05d", 42)); // 00042
System.out.println("%,d円".formatted(1234567)); // 1,234,567円
System.out.println(String.format("%.2f", 3.14159)); // 3.14
金額の計算で小数を扱うなら、丸めの誤差が出ないBigDecimalを使ってから書式を整えます。
文字列と数値の変換(parseInt・valueOf)
文字列から数値へは Integer.parseInt、数値から文字列へは String.valueOf を使います。変換はどちらも1行で済みますが、変換に失敗したときの扱いを決めておかないと、入力1つでプログラムが止まります。
文字列→数値はparseInt、失敗はNumberFormatException
Integer.parseInt は数字として読めない文字列が来ると NumberFormatException を投げます。ユーザーの入力やファイルの値を変換するなら、try-catch で受けます。
int n = Integer.parseInt("123");
System.out.println(n + 1); // 124
try {
Integer.parseInt("12a");
} catch (NumberFormatException e) {
System.out.println(e.getMessage()); // For input string: "12a"
}
System.out.println(Integer.parseInt("123")); // 123(全角数字も読める)
意外なのは最後の行です。全角の「123」も、例外にならずに123として読めました。入力チェックで「半角数字だけ」を許したいなら、parseInt の成功だけを頼りにせず、正規表現の [0-9]+ で先に確かめます。
小数なら Double.parseDouble、大きな整数なら Long.parseLong と、型ごとにメソッドがあります。
変換メソッドの対応
int → Integer.parseInt / long → Long.parseLong / double → Double.parseDouble / 金額などの小数 → new BigDecimal("1.10")
数値→文字列はString.valueOf
数値を文字列にするなら String.valueOf です。"" + 数値 でも変換できますが、何をしたいのかが読み手に伝わりにくくなります。
System.out.println(String.valueOf(456) + 1); // 4561(文字列の連結になる)
System.out.println(String.valueOf((Object) null)); // null(文字の「null」)
1行目は、文字列に1を足したので「457」ではなく「4561」になります。足し算のつもりで文字列を混ぜると起きる事故です。
String.valueOf に null を渡すと、例外ではなく「null」という4文字が返ります。画面に「null」と表示されてしまう原因はたいていここなので、表示の直前に null かどうかを確かめます。
よくある質問
文字列操作でつまずきやすい疑問をまとめました。どれも本文の該当する見出しで、実際に動かした出力つきで説明しています。答えだけ先に確かめたいときに使ってください。
Q1. Javaで文字列を比較するときに==を使ってはいけないのはなぜですか?
== は中身ではなく「同じインスタンスか」を比べるからです。ソースに直接書いた文字列どうしは true になりますが、入力やファイルから来た文字列は false になります。中身を比べるときは equals を使います。
Q2. 文字列の一部を切り出すにはどうすればいいですか?
substring(開始, 終了) を使います。位置は0から数え、終了位置の文字は含みません。"2026-11-07".substring(0, 4) は「2026」です。
Q3. splitで末尾の空の要素が消えるのはなぜですか?
split は既定で末尾の空文字を取り除くからです。split(",", -1) のように第2引数に -1 を渡すと残ります。CSVの列数をそろえたいときに使います。
Q4. trimとstripの違いは何ですか?
trim は半角スペースや改行などだけを消し、全角スペースは残します。strip(Java 11以降)は全角スペースも消します。日本語の入力を扱うなら strip を使います。
Q5. 数字を0埋めするにはどうすればいいですか?
String.format("%05d", 42) のように書くと「00042」になります。5の部分が桁数です。Java 15以降は "%05d".formatted(42) とも書けます。
Q6. 文字列を数値に変換して失敗するとどうなりますか?
Integer.parseInt は NumberFormatException を投げます。入力値を変換するなら try-catch で受けて、エラーメッセージを返す処理を書きます。全角数字は変換できてしまうので、半角だけを許すなら正規表現で先に確かめます。
まとめ:まずequalsとsplitの癖を覚える
Javaの文字列操作は、Stringが変更できないことと、引数が正規表現になるメソッドがあることの2つを押さえると、ハマる場面が一気に減ります。
- 比較は
equals。null がありうるなら"定数".equals(変数)かObjects.equals substringの終了位置は含まないsplitとreplaceAllの引数は正規表現。末尾の空文字はsplit(",", -1)で残す- 全角スペースを消すなら
strip - 0埋めは
String.format("%05d", n)、数値変換の失敗はNumberFormatException
ほかのJavaの基本文法は、Java入門ロードマップからたどれます。キーボードから入力した文字列を扱うならScannerの使い方、URLに文字列を載せるならURLエンコードも合わせてどうぞ。
見つかったら equals に置き換えるだけです。ついでに split の引数に「.」や「|」がないかも見ておくと安心です。
続きを追う:X(@Tom_Java_Tech) / RSS
途中経過は、また書きます。

