.NET TIPS

文字数を正確にカウントするには？（サロゲート文字対応）［C#、VB］

デジタルアドバンテージ　一色 政彦
2008/04/03

　文字列の長さを取得する場合、基本的には「TIPS：文字列の長さを取得するには？」で紹介しているように、文字列オブジェクト（＝System名前空間のStringクラスのオブジェクト）のLengthプロパティを利用すればよい。

　しかし、「文字列の長さ」と「文字数」は必ずしも一致しない可能性がある。というのも、Windows Vistaの登場などにより、Unicodeのサロゲート文字が（エンド・ユーザーにより）入力される可能性が出てきているからだ。

　サロゲート文字（もしくはサロゲート・ペア文字）とは、通常「1文字＝2bytes」のところが、「1文字＝4bytes」となることがある文字のことだ。そのような「1文字＝4bytes」のサロゲート文字の「文字列の長さ」を、先ほどのLengthプロパティを使って取得すると、「2」になる。正確な文字数は「1」なのに、文字列の長さは「2」と判定されてしまうのだ。

　そこで本稿では（サロゲート文字を考慮して）正確な文字数を取得する方法を紹介する。

文字数を取得する方法（.NET Framework 2.0以降）

　文字数を取得するには、StringInfoオブジェクト（＝System.Globalization名前空間のStringInfoクラスのオブジェクト）のLengthInTextElementsプロパティを使用すればよい。StringInfoオブジェクトは、パラメータに文字列を指定してStringInfoクラスのコンストラクタを呼び出せば取得できる。

　ただし、このLengthInTextElementsプロパティは.NET Framework 2.0以降でしか利用できない。.NET Framework 1.xで文字数を取得する方法は本TIPS後半で説明する。

　次のコードは、「る」という文字列の文字数を取得するコンソール・アプリケーションのサンプル・プログラムである。

using System;
using System.Globalization;

class Program
{
  static void Main(string[] args)
  {
    // 文字列「叱る」
    string moji = "\uD842\uDF9Fる";

    // StringInfoオブジェクトの取得
    StringInfo si = new StringInfo(moji);

    // 文字列の長さ
    Console.WriteLine("文字列の長さ＝" + moji.Length.ToString());

    // 文字数（サロゲート文字対応）
    Console.WriteLine("文字数＝" + si.LengthInTextElements);

    // 出力結果：
    // 文字列の長さ＝3
    // 文字数＝2
  }
}
Imports System.Globalization

Module Module1

  Sub Main()

    ' 文字列「叱る」
    Dim moji As String = ChrW(&HD842) & ChrW(&HDF9F) & "る"

    ' StringInfoオブジェクトの取得
    Dim si As New StringInfo(moji)

    ' 文字列の長さ
    Console.WriteLine("文字列の長さ＝" & moji.Length.ToString())

    ' 文字数（サロゲート文字対応）
    Console.WriteLine("文字数＝" & si.LengthInTextElements)

    ' 出力結果：
    ' 文字列の長さ＝3
    ' 文字数＝2

  End Sub

End Module
文字数を取得するコンソール・アプリケーションのサンプル・プログラム【.NET Framework 2.0以降】（上：C#、下：VB）

文字数を取得する方法（.NET Framework 1.x以降）

　続いて.NET Framework 1.xで文字数を取得する場合だが、先ほどのコード内にあるStringInfoオブジェクトのLengthInTextElementsプロパティの呼び出しを、（本TIPSで紹介する）GetLengthInTextElementsメソッドの呼び出しに置き換えるだけだ。GetLengthInTextElementsメソッドは、パラメータに文字列を渡すと、戻り値で文字数を返す。

　次のコードは実際にGetLengthInTextElementsメソッドを使用したコンソール・アプリケーションのサンプル・プログラムである。

using System;
using System.Globalization;

class Program
{
  static void Main(string[] args)
  {
    // 文字列「叱る」
    string moji = "\uD842\uDF9Fる";

    // 文字列の長さ（char単位の数）
    Console.WriteLine("文字列の長さ＝" + moji.Length.ToString());

    // 文字数（サロゲート文字対応）
    Console.WriteLine("文字数＝" + GetLengthInTextElements(moji));

    // 出力結果：
    // 文字列の長さ＝3
    // 文字数＝2
  }

  // 文字数を取得するメソッド（.NET Framework 1.x用）
  static int GetLengthInTextElements(string textData)
  {
    int[] indexes =
      StringInfo.ParseCombiningCharacters(textData);

    return indexes.Length;
  }
}
Imports System.Globalization

Module Module1

  Sub Main()

    ' 文字列「叱る」
    Dim moji As String = ChrW(&HD842) & ChrW(&HDF9F) & "る"

    ' 文字列の長さ（Char単位の数）
    Console.WriteLine("文字列の長さ＝" & moji.Length.ToString())

    ' 文字数（サロゲート文字対応）
    Console.WriteLine("文字数＝" & GetLengthInTextElements(moji))

    ' 出力結果：
    ' 文字列の長さ＝3
    ' 文字数＝2

  End Sub

  ' 文字数を取得するメソッド（.NET Framework 1.x用）
  Function GetLengthInTextElements(ByVal moji As String) As Integer

    Dim indexes() As Integer = _
      StringInfo.ParseCombiningCharacters(moji)

    Return indexes.Length

  End Function

End Module
文字数を取得するコンソール・アプリケーションのサンプル・プログラム【.NET Framework 1.x以降】（上：C#、下：VB）

　GetLengthInTextElementsメソッドの内部では、StringInfoクラスの静的メソッドParseCombiningCharactersを呼び出している。ParseCombiningCharactersメソッドは、1文字（制御文字やサロゲート文字を含む）ごとの、（文字列中の）インデックス番号をint／Integer型の配列で返す。従って、この配列の長さ（Lengthプロパティ）を調べれば正確な文字数が判明する。

　ちなみに、文字数ではなく、文字列のバイト数を取得する方法は、「TIPS：文字列のバイト数を取得するには？」を参照してほしい。End of Article

カテゴリ：クラス・ライブラリ　処理対象：文字列
使用ライブラリ：StringInfoクラス（System.Globalization名前空間）
関連TIPS：文字列の長さを取得するには？
関連TIPS：文字列のバイト数を取得するには？

この記事と関連性の高い別の.NET TIPS
サロゲート文字かどうかを判定するには？
文字列の長さを取得するには？
文字列のバイト数を取得するには？
文字と文字列を変換するには？
文字列を1文字ずつ解析するには？（サロゲート文字対応）
このリストは、（株）デジタルアドバンテージが開発した
自動関連記事探索システム Jigsaw（ジグソー） により自動抽出したものです。
generated by

「.NET TIPS」

TechTargetジャパン

Insider.NET フォーラム 新着記事

＠ITメールマガジン　新着情報やスタッフのコラムがメールで届きます（無料）

RSSフィード

＠IT 新着記事

キャリアアップ

- PR -
＠IT Sepcial
→ ＠IT Special ヘ

イベントカレンダー

PickUpイベント

- PR -
もっと見る
- PR -

お勧め求人情報

ホワイトペーパー（TechTargetジャパン）

＠IT Sepcial
→ ＠IT Special ヘ
ソリューションFLASH