【Java】StringクラスのcontentEquals()メソッドの使い方と例

Javaプログラミングにおいて、文字列を比較することは非常に一般的です。特定の文字列と同じ内容を持つかどうかを確認するには、JavaのStringクラスのcontentEquals()メソッドが役立ちます。

この記事では、contentEquals()メソッドの使い方と例を詳しく解説します。

contentEquals()メソッドとは

JavaのStringクラスには、文字列が指定されたCharSequence（文字列）またはStringBuilderと等しいかどうかを調べるためのcontentEquals()メソッドがあります。このメソッドは、指定されたCharSequenceやStringBuilderと等しい場合にtrueを返し、そうでない場合にはfalseを返します。

contentEquals()メソッドの構文

public boolean contentEquals(CharSequence cs)

contentEquals()メソッドは、引数としてCharSequence（文字列）を受け取り、対象の文字列と引数で与えられた文字列が等しいかどうかを真偽値で返します。

contentEquals()メソッドの使用例

以下に、contentEquals()メソッドの使用例を示します。

public class Main {
    public static void main(String[] args) {
        String str1 = "hello";
        String str2 = "hello";
        String str3 = "world";
        
        // 文字列が等しいかどうかをチェックする
        boolean result1 = str1.contentEquals(str2);
        System.out.println("Result 1: " + result1); // true
        
        boolean result2 = str1.contentEquals(str3);
        System.out.println("Result 2: " + result2); // false
    }
}

上記の例では、str1とstr2の内容が同じであるため、result1はtrueになります。一方で、str1とstr3の内容は異なるため、result2はfalseになります。

contentEquals()メソッドの注意点

• contentEquals()メソッドは、大文字と小文字を区別します。つまり、比較する文字列が大文字と小文字で異なる場合、等しくないと判断されます。
• 引数にnullを渡すと、NullPointerExceptionが発生します。したがって、引数がnullでないことを確認してからメソッドを呼び出す必要があります。

結論

JavaのStringクラスのcontentEquals()メソッドは、指定された文字列やStringBuilderと等しいかどうかを調べるための便利なメソッドです。大文字と小文字の区別や、引数にnullを渡した場合の注意点を理解した上で、効果的に文字列の比較を行うことができます。

これで、JavaのStringクラスのcontentEquals()メソッドについての基本的な理解が得られたはずです。