MENU
  1. ホーム
  2. C#
  3. 基礎構文
  4. 文字列
  5. [C#] String.Equalsメソッドの使い方 – 文字列の一致判定

[C#] String.Equalsメソッドの使い方 – 文字列の一致判定

String.Equalsメソッドは、C#で文字列の一致を判定するために使用されます。

このメソッドは、2つの文字列が同じ内容かどうかを比較し、等しい場合はtrue、異なる場合はfalseを返します。

大文字と小文字を区別するかどうかを指定するオーバーロードもあります。

例えば、String.Equals("abc", "ABC", StringComparison.OrdinalIgnoreCase)のようにStringComparison.OrdinalIgnoreCaseを指定すると、大文字小文字を無視して比較できます。

この記事でわかること
  • String.Equalsメソッドの基本的な使い方
  • 大文字小文字を無視した比較方法
  • 文化依存の比較の注意点
  • null値との比較に関する注意
  • 文字列比較のパフォーマンスの考慮事項

目次から探す

String.Equalsメソッドの基本的な使い方

C#のString.Equalsメソッドは、2つの文字列が等しいかどうかを判定するために使用されます。

このメソッドは、さまざまなオプションを提供し、比較の方法を柔軟に選択できます。

以下では、基本的な使い方を詳しく解説します。

引数に文字列を指定して比較する

String.Equalsメソッドは、2つの文字列を引数として受け取り、それらが等しいかどうかを判定します。

以下はその基本的な使用例です。

using System;
class Program
{
    static void Main()
    {
        string str1 = "こんにちは";
        string str2 = "こんにちは";
        // 文字列を比較する
        bool isEqual = String.Equals(str1, str2);
        Console.WriteLine(isEqual); // 結果: True
    }
}
結果: True

大文字小文字を区別する比較

デフォルトでは、String.Equalsメソッドは大文字小文字を区別して比較します。

以下の例では、異なる大文字小文字の文字列を比較しています。

using System;
class Program
{
    static void Main()
    {
        string str1 = "Hello";
        string str2 = "hello";
        // 大文字小文字を区別して比較する
        bool isEqual = String.Equals(str1, str2);
        Console.WriteLine(isEqual); // 結果: False
    }
}
結果: False

大文字小文字を無視した比較

大文字小文字を無視して比較するには、String.Equalsメソッドのオーバーロードを使用し、StringComparison列挙型を指定します。

以下の例では、大文字小文字を無視して比較しています。

using System;
class Program
{
    static void Main()
    {
        string str1 = "Hello";
        string str2 = "hello";
        // 大文字小文字を無視して比較する
        bool isEqual = String.Equals(str1, str2, StringComparison.OrdinalIgnoreCase);
        Console.WriteLine(isEqual); // 結果: True
    }
}
結果: True

null値との比較

String.Equalsメソッドは、null値との比較も行うことができます。

null値を比較する際には、注意が必要です。

以下の例では、null値と文字列を比較しています。

using System;
class Program
{
    static void Main()
    {
        string str1 = null;
        string str2 = "こんにちは";
        // null値との比較
        bool isEqual = String.Equals(str1, str2);
        Console.WriteLine(isEqual); // 結果: False
    }
}
結果: False

このように、String.Equalsメソッドを使用することで、さまざまな条件で文字列の比較を行うことができます。

StringComparison列挙型を使った高度な比較

StringComparison列挙型は、文字列の比較方法を指定するために使用されます。

この列挙型を利用することで、文化や大文字小文字の区別に基づいた柔軟な比較が可能になります。

以下では、各種StringComparisonの使い方を解説します。

StringComparison.Ordinalの使い方

StringComparison.Ordinalは、バイナリ比較を行います。

文字列のバイト順序に基づいて比較するため、非常に高速です。

以下はその使用例です。

using System;
class Program
{
    static void Main()
    {
        string str1 = "apple";
        string str2 = "apple";
        // Ordinal比較を使用
        bool isEqual = String.Equals(str1, str2, StringComparison.Ordinal);
        Console.WriteLine(isEqual); // 結果: True
    }
}
結果: True

StringComparison.OrdinalIgnoreCaseの使い方

StringComparison.OrdinalIgnoreCaseは、大文字小文字を無視してバイナリ比較を行います。

以下の例では、この比較方法を使用しています。

using System;
class Program
{
    static void Main()
    {
        string str1 = "Apple";
        string str2 = "apple";
        // 大文字小文字を無視したOrdinal比較
        bool isEqual = String.Equals(str1, str2, StringComparison.OrdinalIgnoreCase);
        Console.WriteLine(isEqual); // 結果: True
    }
}
結果: True

StringComparison.InvariantCultureの使い方

StringComparison.InvariantCultureは、文化に依存しない比較を行います。

主に、データの保存や通信において一貫性を保つために使用されます。

以下はその使用例です。

using System;
class Program
{
    static void Main()
    {
        string str1 = "straße";
        string str2 = "strasse";
        // InvariantCulture比較を使用
        bool isEqual = String.Equals(str1, str2, StringComparison.InvariantCulture);
        Console.WriteLine(isEqual); // 結果: False
    }
}
結果: False

StringComparison.CurrentCultureの使い方

StringComparison.CurrentCultureは、現在の文化に基づいて比較を行います。

ユーザーのロケールに依存するため、特定の文化における文字列の比較に適しています。

以下の例では、現在の文化を使用した比較を示しています。

using System;
using System.Globalization;
class Program
{
    static void Main()
    {
        string str1 = "café";
        string str2 = "cafe";
        // CurrentCulture比較を使用
        bool isEqual = String.Equals(str1, str2, StringComparison.CurrentCulture);
        Console.WriteLine(isEqual); // 結果: False
    }
}
結果: False

StringComparison.CurrentCultureIgnoreCaseの使い方

StringComparison.CurrentCultureIgnoreCaseは、現在の文化に基づいて大文字小文字を無視して比較を行います。

以下の例では、この比較方法を使用しています。

using System;
using System.Globalization;
class Program
{
    static void Main()
    {
        string str1 = "CAFE";
        string str2 = "cafe";
        // CurrentCultureIgnoreCase比較を使用
        bool isEqual = String.Equals(str1, str2, StringComparison.CurrentCultureIgnoreCase);
        Console.WriteLine(isEqual); // 結果: True
    }
}
結果: True

このように、StringComparison列挙型を使用することで、さまざまな条件に応じた文字列の比較が可能になります。

これにより、アプリケーションの要件に応じた柔軟な文字列処理が実現できます。

String.Equalsメソッドのパフォーマンス

String.Equalsメソッドは、文字列の比較を行う際に非常に便利ですが、パフォーマンスに関しても考慮する必要があります。

以下では、パフォーマンスの観点からの比較や注意点について解説します。

パフォーマンスの観点からの比較

String.Equalsメソッドは、内部的に文字列の長さや内容を比較するため、比較対象の文字列が長い場合や数が多い場合にはパフォーマンスに影響を与えることがあります。

特に、以下の点に注意が必要です。

  • 文字列の長さ: 長い文字列を比較する場合、比較にかかる時間が増加します。
  • 比較の種類: 大文字小文字を区別するかどうか、文化に依存するかどうかによってもパフォーマンスが変わります。

大量の文字列比較における注意点

大量の文字列を比較する場合、String.Equalsメソッドを繰り返し呼び出すと、パフォーマンスが低下する可能性があります。

以下の点に注意してください。

  • コレクションの使用: 大量の文字列を比較する場合、リストや配列を使用して一度に比較する方法を検討することが重要です。
  • キャッシュの利用: 同じ文字列を何度も比較する場合、結果をキャッシュすることでパフォーマンスを向上させることができます。

String.Equalsと==演算子のパフォーマンス比較

String.Equalsメソッドと==演算子は、どちらも文字列の比較を行いますが、パフォーマンスに若干の違いがあります。

以下のポイントを考慮してください。

スクロールできます
比較方法特徴パフォーマンス
String.Equalsメソッド呼び出しが必要で、オプションが豊富オーバーヘッドにより遅い場合がある
==演算子シンプルで直感的な比較通常は高速

一般的に、==演算子はシンプルな比較においては高速ですが、String.Equalsメソッドはより柔軟な比較が可能です。

使用する場面に応じて適切な方法を選択することが重要です。

このように、String.Equalsメソッドのパフォーマンスを理解し、適切に使用することで、アプリケーションの効率を向上させることができます。

String.Equalsメソッドの応用例

String.Equalsメソッドは、さまざまな場面で文字列の比較を行うために利用されます。

以下では、具体的な応用例をいくつか紹介します。

配列内の文字列を比較する

配列内の文字列を比較する際に、String.Equalsメソッドを使用することで、特定の文字列が配列に存在するかどうかを確認できます。

以下はその例です。

using System;
class Program
{
    static void Main()
    {
        string[] fruits = { "りんご", "ばなな", "みかん" };
        string searchFruit = "ばなな";
        // 配列内の文字列を比較
        bool exists = false;
        foreach (var fruit in fruits)
        {
            if (String.Equals(fruit, searchFruit))
            {
                exists = true;
                break;
            }
        }
        Console.WriteLine(exists); // 結果: True
    }
}
結果: True

リスト内の文字列を検索する

リスト内の文字列を検索する場合にも、String.Equalsメソッドが役立ちます。

以下の例では、リスト内に特定の文字列が存在するかを確認しています。

using System;
using System.Collections.Generic;
class Program
{
    static void Main()
    {
        List<string> colors = new List<string> { "赤", "青", "緑" };
        string searchColor = "青";
        // リスト内の文字列を検索
        bool exists = colors.Exists(color => String.Equals(color, searchColor));
        Console.WriteLine(exists); // 結果: True
    }
}
結果: True

辞書型コレクションでのキー比較

辞書型コレクションでは、キーの比較にString.Equalsメソッドを使用することができます。

以下の例では、辞書内のキーを比較しています。

using System;
using System.Collections.Generic;
class Program
{
    static void Main()
    {
        Dictionary<string, string> dictionary = new Dictionary<string, string>
        {
            { "キー1", "値1" },
            { "キー2", "値2" }
        };
        string searchKey = "キー1";
        // 辞書型コレクションでのキー比較
        bool exists = dictionary.ContainsKey(searchKey) && 
                      String.Equals(dictionary[searchKey], "値1");
        Console.WriteLine(exists); // 結果: True
    }
}
結果: True

ユーザー入力の検証に使用する

ユーザーからの入力を検証する際にも、String.Equalsメソッドが役立ちます。

以下の例では、ユーザーの入力が特定の文字列と一致するかを確認しています。

using System;
class Program
{
    static void Main()
    {
        Console.WriteLine("パスワードを入力してください:");
        string userInput = Console.ReadLine();
        string correctPassword = "securePassword";
        // ユーザー入力の検証
        bool isValid = String.Equals(userInput, correctPassword);
        Console.WriteLine(isValid ? "正しいパスワードです。" : "パスワードが間違っています。"); 
    }
}
結果: パスワードが間違っています。

ファイル名やパスの比較に使用する

ファイル名やパスを比較する際にも、String.Equalsメソッドが有効です。

以下の例では、2つのファイルパスが同じかどうかを確認しています。

using System;
class Program
{
    static void Main()
    {
        string path1 = @"C:\Users\User\Documents\file.txt";
        string path2 = @"C:\Users\User\Documents\file.txt";
        // ファイル名やパスの比較
        bool isSame = String.Equals(path1, path2, StringComparison.OrdinalIgnoreCase);
        Console.WriteLine(isSame); // 結果: True
    }
}
結果: True

このように、String.Equalsメソッドは多様な場面での文字列比較に利用でき、特にデータの検証や検索において非常に便利です。

String.Equalsメソッドの注意点

String.Equalsメソッドを使用する際には、いくつかの注意点があります。

これらの注意点を理解しておくことで、より正確で効率的な文字列比較が可能になります。

以下では、主な注意点について解説します。

null値の扱いに関する注意

String.Equalsメソッドは、null値との比較を行うことができますが、null値を扱う際には注意が必要です。

以下の点に留意してください。

  • nullとの比較: 片方または両方の文字列がnullの場合、String.Equalsメソッドはfalseを返します。

これは、nullと空文字列は異なるためです。

  • 例外の回避: null値を比較する際には、事前にnullチェックを行うことで、例外を回避することができます。
using System;
class Program
{
    static void Main()
    {
        string str1 = null;
        string str2 = "こんにちは";
        // null値との比較
        bool isEqual = String.Equals(str1, str2);
        Console.WriteLine(isEqual); // 結果: False
    }
}
結果: False

文化依存の比較に関する注意

String.Equalsメソッドは、文化に依存した比較を行うことができますが、文化によって比較結果が異なる場合があります。

以下の点に注意してください。

  • 文化の選択: StringComparison.CurrentCultureやStringComparison.InvariantCultureを使用する際には、どの文化に基づいて比較を行うかを明確にする必要があります。
  • 特定の文化における挙動: 文化によっては、特定の文字が異なる扱いを受けることがあります。

例えば、アクセント付きの文字や特定の言語の文字が異なる結果をもたらすことがあります。

using System;
class Program
{
    static void Main()
    {
        string str1 = "café";
        string str2 = "cafe";
        // 文化依存の比較
        bool isEqual = String.Equals(str1, str2, StringComparison.CurrentCulture);
        Console.WriteLine(isEqual); // 結果: False
    }
}
結果: False

文字列のエンコーディングに関する注意

文字列のエンコーディングが異なる場合、String.Equalsメソッドの結果が予期しないものになることがあります。

以下の点に注意してください。

  • エンコーディングの一致: 比較する文字列が異なるエンコーディングで生成されている場合、正しく比較できないことがあります。

特に、UTF-8とUTF-16などの異なるエンコーディングに注意が必要です。

  • バイナリ比較の利用: エンコーディングの違いを考慮する場合、StringComparison.Ordinalを使用してバイナリ比較を行うことが有効です。

これにより、エンコーディングの影響を受けずに比較できます。

using System;
using System.Text;
class Program
{
    static void Main()
    {
        byte[] utf8Bytes = Encoding.UTF8.GetBytes("こんにちは");
        string utf16String = "こんにちは";
        // エンコーディングの違いを考慮した比較
        string utf8String = Encoding.UTF8.GetString(utf8Bytes);
        bool isEqual = String.Equals(utf8String, utf16String);
        Console.WriteLine(isEqual); // 結果: True
    }
}
結果: True

このように、String.Equalsメソッドを使用する際には、null値、文化依存、エンコーディングに関する注意点を理解しておくことが重要です。

これにより、より正確で信頼性の高い文字列比較が実現できます。

よくある質問

String.Equalsと==演算子の違いは何ですか？

String.Equalsメソッドと==演算子は、どちらも文字列の比較を行いますが、いくつかの重要な違いがあります。

  • 比較の方法: String.Equalsは、オプションとして大文字小文字を区別するかどうかや、文化に依存した比較を指定できます。

一方、==演算子は、通常は大文字小文字を区別して比較し、引数によるオプション指定ができません。

  • null値の扱い: String.Equalsメソッドは、null値との比較を行うことができ、nullチェックを行うことができますが、==演算子は、片方がnullの場合でも比較を行います。

これにより、==演算子はnull参照例外を引き起こすことがあります。

大文字小文字を無視して比較するにはどうすればいいですか？

大文字小文字を無視して文字列を比較するには、String.Equalsメソッドのオーバーロードを使用し、StringComparison.OrdinalIgnoreCaseを指定します。

以下のように記述します。

bool isEqual = String.Equals(str1, str2, StringComparison.OrdinalIgnoreCase);

この方法を使用することで、大文字小文字を無視した比較が可能になります。

例えば、”Hello”と”hello”は等しいと判断されます。

null値を比較する際にエラーが発生するのはなぜですか？

String.Equalsメソッドは、null値との比較を行うことができますが、null参照を持つオブジェクトに対してメソッドを呼び出すと、NullReferenceExceptionが発生します。

これは、nullオブジェクトに対してメソッドを呼び出そうとするためです。

このエラーを回避するためには、比較する前にnullチェックを行うことが重要です。

例えば、以下のように記述します。

if (str1 != null && str2 != null)
{
    bool isEqual = String.Equals(str1, str2);
}

このようにすることで、null値を安全に比較することができます。

まとめ

この記事では、C#のString.Equalsメソッドの基本的な使い方から、応用例、注意点まで幅広く解説しました。

特に、文字列の比較におけるパフォーマンスや文化依存の問題、null値の扱いについても触れ、実際のプログラミングに役立つ情報を提供しました。

これを機に、String.Equalsメソッドを活用して、より効率的で正確な文字列比較を行ってみてください。

目次に戻る

当サイトはリンクフリーです。出典元を明記していただければ、ご自由に引用していただいて構いません。

C言語
C++
Python
HTML
Java
HTTP

関連カテゴリーから探す

文字列
  • URLをコピーしました！

関連記事

目次から探す