【Java】
文字列に指定した文字が含まれるかチェックする

JavaのStringクラスはcontains()というメソッドを持っています。このメソッドを使うことで 文字列の中に、引数として渡した文字列が含まれているかどうかを判断することができます。 引数には「String型」を使用します。戻り値は「boolean型」です。 引数に指定した文字列が含まれていれば「true」、含まれていなければ「false」を返します。
参考文献：スッキリわかるJava入門 実践編 第２版

では、さっそく使い方を解説します。

String型の変数に「.（ドット）」をつけてその後ろに「contains("文字列")」 という形で使用します。以下はその使用例です。この例では「"ABCDEFG"」に対し 様々な条件でcontains()を使用した場合の出力結果を見ていきます。

String str = "ABCDEFG";

//例１
boolean b1 = str.contains("A");
System.out.println(b1);
//出力結果：true

//例２
boolean b2 = str.contains("a");
System.out.println(b2);
//出力結果：false

//例３
boolean b3 = str.contains("AB");
System.out.println(b3);
//出力結果：true

//例４
boolean b4 = str.contains("AC");
System.out.println(b4);
//出力結果：false

・例１

「str」に「A」が含まれるかどうかをチェックしています。 もちろん「str」の中身は「ABCDEFG」なので含まれており、戻り値は「true」です。

・例2

「str」に「a」が含まれるかどうかをチェックしています。 contains()は、大文字と小文字を区別するので「a」は含みません。 よって戻り値は「false」です。

・例3

「str」に「AB」が含まれるかどうかをチェックしています。 「str」の中身に「AB」と連続した箇所が存在するので、戻り値は「true」です。

・例4

「str」に「AC」が含まれるかどうかをチェックしています。 「str」の中身は「ABCDEFG」であり、「A」と「C」が連続して含まれているわけではありません。 よって戻り値は「false」です。

String型で宣言した変数の中身が、「空文字」「null」 の場合にcontains()を使用するとどうなるのでしょうか。実際の実行結果を見てみましょう。

String strEmpty = "";
String strNull = null;

//例１
boolean b1 = strEmpty.contains("");
System.out.println(b1);
//出力結果：true

//例２
boolean b2 = strNull.contains("");
System.out.println(b2);
//出力結果：NullPointerException

//例３
boolean b3 = strNull.contains(null);
System.out.println(b3);
//出力結果：NullPointerException

例１

空文字「""」に対してcontains("")を使用すると「true」が返ってきます。 ただ、contains()にこだわらなくても、「isEmpty()」 というメソッドを使用すれば空文字かどうかの判定を行うことができますので、 そちらを使ってもいいと思います。

例２

nullに対してcontains("")を使用すると「NullPointerException」 例外が発生してしまいます。なのでこの判定方法ではnullを判定することはできません。

例３

nullに対してcontains(null)を使用した場合です。この場合も例２同様に 例外が発生してしまいます。これらのことから、nullを判定する場合は 「strNull == null」というように判定するのがいいかと思われます。

以下公式APIリンクです。

Java11 Stringクラス公式APIリンク