Javaのcontainsメソッド徹底解説｜使い方・注意点・他メソッドとの違いもわかりやすく解説

1. はじめに：Javaにおける文字列検索の重要性

2. contains()メソッドの基本構文と特徴

基本構文

boolean result = 対象文字列.contains(検索文字列);

サンプルコード

String message = "Java programming is fun!";
boolean hasKeyword = message.contains("programming");

System.out.println(hasKeyword); // 出力結果: true

メソッドの特性

• 部分一致のみを判定する：完全一致を判定したい場合は、equals()を使用する必要があります。
• 大文字・小文字を区別する：例えば"Java"と"java"は異なるものとして扱われます（詳細は後述）。
• 正規表現は使用できない：あくまで「文字列として含まれているか」を確認するためのメソッドであり、パターンマッチングを行いたい場合はmatches()やPatternクラスの利用が必要です。

nullが引数や対象になった場合の挙動

String text = null;
System.out.println(text.contains("test")); // 例外発生

3. 実用的な使用例と注意点

3-1. 基本的な使用例

String sentence = "今日はJavaの勉強をしています。";

if (sentence.contains("Java")) {
    System.out.println("Javaが含まれています。");
} else {
    System.out.println("Javaは含まれていません。");
}

3-2. 大文字・小文字の区別（case-sensitive）

String text = "Welcome to Java";
System.out.println(text.contains("java")); // false

String text = "Welcome to Java";
System.out.println(text.toLowerCase().contains("java")); // true

3-3. nullや空文字の取り扱い

String text = null;
System.out.println(text.contains("test")); // 実行時エラー

if (text != null && text.contains("test")) {
    // 安全に処理を実行
}

String sample = "test";
System.out.println(sample.contains("")); // true

3-4. 複数キーワードの検索には非対応

String target = "エラーコード123：アクセス拒否";
if (target.contains("エラー") || target.contains("拒否")) {
    System.out.println("問題のあるメッセージです。");
}

List<String> keywords = Arrays.asList("エラー", "障害", "失敗");
boolean found = keywords.stream().anyMatch(target::contains);

4. contains()とよく比較される他のメソッド

4-1. equals()との違い：完全一致か部分一致か

String a = "Java";
String b = "Java";

System.out.println(a.equals(b));      // true：完全一致
System.out.println(a.contains("av")); // true：部分一致

4-2. indexOf()との違い：位置を取得できるかどうか

String text = "Hello, Java World!";
System.out.println(text.indexOf("Java"));    // 7
System.out.println(text.indexOf("Python"));  // -1

if (text.indexOf("Java") >= 0) {
    System.out.println("含まれています");
}

4-3. matches()との違い：正規表現の対応有無

String text = "abc123";
System.out.println(text.matches(".*123")); // true
System.out.println(text.contains(".*123")); // false（正規表現ではないため）

4-4. 各メソッドの機能比較まとめ

5. よく使われるユースケースとサンプルコード

5-1. ユーザー入力のバリデーション（禁止ワードの検出）

String input = "このアプリは最悪だ";
String banned = "最悪";

if (input.contains(banned)) {
    System.out.println("不適切な言葉が含まれています。");
}

List<String> bannedWords = Arrays.asList("最悪", "バカ", "死ね");
for (String word : bannedWords) {
    if (input.contains(word)) {
        System.out.println("不適切な言葉が含まれています: " + word);
        break;
    }
}

5-2. ログファイルの解析（特定メッセージの検出）

List<String> logs = Arrays.asList(
    "[INFO] サーバーが起動しました",
    "[ERROR] データベース接続失敗",
    "[WARN] メモリ使用率が高い"
);

for (String log : logs) {
    if (log.contains("ERROR")) {
        System.out.println("エラー発生ログ: " + log);
    }
}

5-3. リスト内文字列のフィルタ処理（Stream APIとの併用）

List<String> users = Arrays.asList("tanaka@example.com", "sato@gmail.com", "yamada@yahoo.co.jp");

List<String> gmailUsers = users.stream()
    .filter(email -> email.contains("@gmail.com"))
    .collect(Collectors.toList());

System.out.println(gmailUsers); // [sato@gmail.com]

5-4. HTTPリクエストのヘッダーやURL解析

String userAgent = "Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X)";
if (userAgent.contains("iPhone")) {
    System.out.println("スマートフォンからのアクセスです。");
}

5-5. ファイルパスや拡張子のチェック

String filePath = "/usr/local/data/sample.csv";
if (filePath.contains(".csv")) {
    System.out.println("CSVファイルです。");
}

実務上のポイント

• 正確性が必要な場合は補助処理を加えること（例：toLowerCase()、trim()）
• 大量データにはStream APIや正規表現の使用も検討
• あくまで部分一致なので、他の条件と組み合わせて使うと安全性が向上

6. パフォーマンスに関する考察

6-1. contains()の内部動作と時間計算量

for (String line : hugeTextList) {
    if (line.contains("error")) {
        // 処理
    }
}

6-2. 頻繁な検索が必要な場合の対策

・すべての文字列を事前に小文字化する

List<String> normalizedList = originalList.stream()
    .map(String::toLowerCase)
    .collect(Collectors.toList());

・Stream APIとparallel()の併用

List<String> result = hugeTextList.parallelStream()
    .filter(line -> line.contains("keyword"))
    .collect(Collectors.toList());

・定型パターンが複雑なら、正規表現で検索

Pattern pattern = Pattern.compile("error|fail|fatal");
for (String log : logs) {
    if (pattern.matcher(log).find()) {
        // マッチした処理
    }
}

6-3. メモリ効率と再利用性の観点から

• 不要な文字列オブジェクトの生成を抑える
• 大量データを扱う場合はバッファ処理やチャンク分割を検討
• リストの先頭からcontains()を何度も呼ぶ処理はキャッシュを利用すると改善することもある

7. 他言語との比較（Javaとの違い）

7-1. Python：in演算子でシンプルな部分一致

text = "Hello, Python!"
if "Python" in text:
    print("含まれています")

• inは構文上の演算子であり、メソッドではない
• 大文字小文字の区別はJavaと同様にあり
• null（None）の扱いにおいては例外が出るため、事前確認は必要

7-2. JavaScript：includes()メソッドで部分一致を確認

const text = "JavaScript is fun";
console.log(text.includes("fun")); // true

• JavaScriptではundefinedを渡しても例外にはならないが、常にfalse
• includes()は配列にも使える（文字列以外への応用が可能）

7-3. C#：Contains()メソッドはJavaに近い

string text = "Welcome to C#";
bool result = text.Contains("C#");

• C#のContains()はデフォルトで大文字小文字を区別しますが、StringComparison.OrdinalIgnoreCaseのようなオプションで無視可能
• C#ではnullを渡すとArgumentNullExceptionが発生

7-4. 各言語の比較表

まとめ：用途に応じて適切な構文を選ぶ

8. よくある質問（FAQ）

Q1. contains()は大文字と小文字を区別しますか？

String input = "Welcome to Java";
boolean result = input.toLowerCase().contains("java");

Q2. 正規表現で部分一致を判定したい場合はどうすればいいですか？

import java.util.regex.Pattern;
import java.util.regex.Matcher;

String text = "注文番号: A123456";
Pattern pattern = Pattern.compile("A\d+");
Matcher matcher = pattern.matcher(text);

if (matcher.find()) {
    System.out.println("パターンに一致しました。");
}

Q3. nullに対してcontains()を使うとどうなりますか？

String target = null;
System.out.println(target.contains("test")); // エラー

if (target != null && target.contains("test")) {
    System.out.println("含まれています。");
}

Q4. 空文字（””）を渡すとどうなりますか？

String text = "Java";
System.out.println(text.contains("")); // true

Q5. contains()で複数のキーワードを一度に検索できますか？

String text = "本日はシステムエラーが発生しました";
if (text.contains("エラー") || text.contains("障害") || text.contains("失敗")) {
    System.out.println("問題が検出されました。");
}

List<String> keywords = Arrays.asList("エラー", "障害", "失敗");
boolean found = keywords.stream().anyMatch(text::contains);

Q6. contains()とindexOf()の使い分けは？

• 単に「含まれているかどうか」を知りたい → contains()
• 含まれている場所（位置）も必要 → indexOf()

String text = "Error: Disk full";
if (text.contains("Error")) {
    int pos = text.indexOf("Error");
    System.out.println("Errorの位置：" + pos);
}

9. まとめ

• 基本構文と戻り値の理解
• 大文字小文字の扱いとその回避法
• nullや空文字に関する注意点
• 他の文字列操作メソッドとの違いと使い分け
• 実践的な使用例（バリデーション、ログ検索、Stream処理など）
• パフォーマンス面での留意点と最適化の工夫
• PythonやJavaScript、C#との構文・特性比較
• 開発現場でよくある質問と具体的な対応策（FAQ）