C#のChar.IsHighSurrogate（String, Int32）メソッドの使い方を解説

C#のChar.IsHighSurrogate()メソッドは、文字列内の指定された位置にあるCharオブジェクトが上位サロゲートであるかどうかを判定するためのメソッドです。

サロゲートペアは、UTF-16エンコーディングにおいてBMP（基本多言語面）外の文字を表現するために使用される仕組みで、上位サロゲートと下位サロゲートの2つのコード単位で構成されます。このメソッドを使うことで、特定の位置の文字が上位サロゲートに該当するかどうかを簡単に確認できます。

構文

このメソッドの構文は以下の通りです。

public static bool IsHighSurrogate (string str, int index);

パラメータの意味は次の通りです。

• str：判定対象となる文字列
• index：str内で評価する文字の位置（インデックス）

指定位置の文字が上位サロゲートであればtrueを返し、そうでなければfalseを返します。

例1：上位サロゲートが含まれる場合

まず、Char.IsHighSurrogate()メソッドを実装した例を見てみましょう。

using System;
public class Demo {
   public static void Main(){
      string str = new String(new char[] { 'k', 'm', 'g', 't', '\uD800' });
      bool res = Char.IsHighSurrogate(str, 4);
      if (res)
         Console.WriteLine("Contains High Surrogate value!");
      else
         Console.WriteLine("Does not contain High Surrogate value!");
   }
}

出力結果

上記のコードを実行すると、以下の出力が得られます。

Contains High Surrogate value!

この例では、インデックス4の位置にある「\uD800」が上位サロゲートであるため、trueが返されています。

例2：上位サロゲートが含まれない場合

続いて、別の例を見てみましょう。

using System;
public class Demo {
   public static void Main(){
      string str = new String(new char[] { 'k', 'm', 'g', 't', '\uD800' });
      bool res = Char.IsHighSurrogate(str, 2);
      if (res)
         Console.WriteLine("Contains High Surrogate value!");
      else
         Console.WriteLine("Does not contain High Surrogate value!");
   }
}

出力結果

上記のコードを実行すると、以下の出力が得られます。

Does not contain High Surrogate value!

この例では、インデックス2の位置にある文字は「g」であり、上位サロゲートではないため、falseが返されています。

まとめ

Char.IsHighSurrogate(String, Int32)メソッドを使用すると、文字列内の任意の位置にある文字が上位サロゲートかどうかを簡単に判定できます。Unicodeの補助文字を扱う際や、文字列を正しく処理したい場合に役立つメソッドですので、ぜひ活用してみてください。