文字列API

▶

本稿は Java の文字列に関する API をまとめた記事です。Java で文字列を扱うときの中心は String クラスで、ほかに可変文字列を扱う StringBuilder / StringBuffer、文字列の比較・抽出・分割・整形のためのメソッド・正規表現があります。

子ページから個別の API を選択してください。

本ページの子ページ

String.equals — 等価比較
String.equalsIgnoreCase — 大小無視の等価比較
StringBuffer — 可変文字列 (スレッドセーフ)
String.length — 文字数の取得
String.trim — 前後の空白を取り除く

String / StringBuilder / StringBuffer の違い

クラス	不変か	スレッドセーフ	用途
`String`	不変	スレッドセーフ	通常の文字列 (ほとんどはこれ)
`StringBuilder`	可変	スレッドセーフでない	同一スレッド内で大量の連結
`StringBuffer`	可変	スレッドセーフ (synchronized)	複数スレッドで共有する場合

よく使う String のメソッド

メソッド	用途
`length()`	文字数 (Java の char 単位)
`isEmpty()` / `isBlank()`	空 / 空白のみ判定 (`isBlank` は Java 11+)
`equals(s)` / `equalsIgnoreCase(s)`	等価比較
`compareTo(s)`	辞書順比較
`startsWith(p)` / `endsWith(p)`	接頭辞・接尾辞判定
`contains(c)`	部分一致
`indexOf(c)` / `lastIndexOf(c)`	位置
`charAt(i)`	i 番目の文字
`substring(b, e)`	部分文字列
`toUpperCase()` / `toLowerCase()`	大小変換
`trim()` / `strip()`	前後空白除去 (`strip` は Unicode 対応; Java 11+)
`replace(c1, c2)` / `replaceAll(re, s)`	置換
`split(re)`	正規表現で分割
`concat(s)`	連結 (基本は `+` でよい)
`format(fmt, ...)`	書式文字列 (`%d`、`%s` 等)
`chars()` / `codePoints()`	文字 Stream / コードポイント Stream
`matches(re)`	正規表現と完全一致するか
`String.join(d, ...)`	区切り文字で結合
`String.valueOf(x)`	他の型を文字列に

連結の効率

// 単純な連結 (短い・少回数なら + で OK)
String s = "Hello, " + name + "!";

// ループでの大量連結は StringBuilder
StringBuilder sb = new StringBuilder();
for (String w : words) {
sb.append(w).append(",");
}
String csv = sb.toString();

書式付き整形 (printf / format)

String s = String.format("%-10s = %,d", "count", 1234567);
// "count = 1,234,567"

System.out.printf("%5.2f%n", 3.14159); // 3.14

正規表現 (java.util.regex)

import java.util.regex.*;

Pattern p = Pattern.compile("(\\\\d{3})-(\\\\d{4})");
Matcher m = p.matcher("Tel: 090-1234");
if (m.find()) {
System.out.println(m.group(0)); // 090-1234
System.out.println(m.group(1)); // 090
}

// 置換
String redacted = "ID: 12345".replaceAll("\\\\d+", "***");

文字列の比較 (== と equals)

String a = "hello";
String b = new String("hello");

System.out.println(a == b); // false (参照比較)
System.out.println(a.equals(b)); // true (内容比較)
System.out.println(Objects.equals(a, b)); // true (null 安全)

新世代の文字列機能

Java バージョン	機能
Java 11	`isBlank()`、`strip()`、`lines()`、`repeat(n)`
Java 12	`indent(n)`、`transform(fn)`
Java 13〜	テキストブロック `""" ... """`
Java 15	テキストブロックが正式機能

String json = """
{
"name": "Taro",
"age": 20
}
""";

注意点

String は不変。連結ごとに新しい String が作られる
大量連結は StringBuilder。+= ループはアンチパターン
String.length() はchar (UTF-16) 単位。サロゲートペア (絵文字) では実文字数と一致しない (codePointCount を使う)
== でなく equals。null チェックは Objects.equals または "literal".equals(x)
正規表現のバックスラッシュは二重 (\\\\d)
個人情報・パスワードを String に保持するとGCまでメモリに残る。秘密情報は char[] で扱い、使用後ゼロクリアするのが堅い

ページ一覧

その他