本文へスキップ

本ページはプロモーションが含まれています

Java入門

Javaの文字列操作まとめ|比較・切り出し・分割・置換を実例で

CATEGORY
DRAWN BY
TOM
DATE
REV.
READ
約13分
SHEETS
8枚
文字列操作(比較・切り出し・分割・置換)

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

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行目の呼び出しは、変換した結果を誰も受け取っていません。コンパイルエラーにもならないので、「メソッドを呼んだのに変わらない」と悩む原因になります。

ハマりポイント
Stringのメソッドは「結果を返すだけ」

replace・trim・toUpperCase などは、どれも元の文字列を書き換えません。戻り値を変数に入れ直すか、そのまま次の処理に渡すのが基本です。文字を何度も足していく処理だけは、書き換えられる StringBuilder を使います。

よく使うStringメソッド一覧表

よく使うメソッドを、やりたいこと別に並べました。迷ったらこの表から探して、詳しい使い方は各見出しで確認してください。

やりたいことメソッド例と結果
同じ文字列か比べるequals / equalsIgnoreCase"Java".equalsIgnoreCase("JAVA") → true
辞書順で比べるcompareTo"apple".compareTo("banana") → -1
一部を切り出すsubstring"2026-11-07".substring(0, 4) → 2026
含むか調べるcontains / indexOf"Hello Java".indexOf("Java") → 6
前後を調べるstartsWith / endsWith"report.csv".endsWith(".csv") → true
つなぐ+ / String.join / StringBuilderString.join(",", List.of("A","B")) → A,B
分けるsplit"a,b".split(",") → [a, b]
置き換えるreplace / replaceAll"1.2.3".replace(".", "-") → 1-2-3
前後の空白を消すstrip / trim" a ".strip() → a
0埋め・書式String.format / formattedString.format("%05d", 42) → 00042
数値に変えるInteger.parseIntInteger.parseInt("123") → 123
長さを数えるlength"あいう".length() → 3

空文字か空白だけかを判定する 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 を使います。

LOGJava歴12年の中でNullPointerExceptionには何度も悩まされた

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を組み立てるような処理では差が出ます。

書き方向いている場面注意点
+数個を1回だけつなぐループ内で使うと毎回新しい文字列ができる
StringBuilderループで何度も足す最後に toString() が要る
String.joinリストを区切り文字でつなぐ要素がnullだと文字の「null」が入る

複数行の固定の文字列をつなぐなら、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文字」なので、全部の文字が区切りになり、結果は空の配列です。

ハマりポイント
splitの引数は「文字」ではなく正規表現

「.」「|」「+」「*」などで区切るときは、「\.」のようにエスケープします。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
書式意味例
%05d5桁になるまで左を0で埋める42 → 00042
%,d3桁ごとにカンマを入れる1234567 → 1,234,567
%.2f小数点以下2桁にする3.14159 → 3.14
%-10s10文字分の幅で左寄せ表形式の出力をそろえる

金額の計算で小数を扱うなら、丸めの誤差が出ない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エンコードも合わせてどうぞ。

NEXT STEP
自分のコードを「==」で検索して、文字列の比較が混ざっていないか確かめる。

見つかったら equals に置き換えるだけです。ついでに split の引数に「.」や「|」がないかも見ておくと安心です。

途中経過は、また書きます。

NEXT READ本棚から1本

AIで開発を組み直すなら、まずこの5冊から

入門・実践・設計まで、Claude Codeの本をレベル別に5冊選んで比べました。

→ おすすめ5冊を見る

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

Java入門

TOC