YukkuriMovieMaker.Commons.CompareText クラス

日本語の文字列を、大文字/小文字、ひらがな/カタカナ、全角/半角の違いを無視して比較するための IComparer<T> です。 [詳解]

YukkuriMovieMaker.Commons.CompareText の継承関係図

公開メンバ関数
int	Compare (string x, string y)
	2つの文字列を、大文字/小文字、ひらがな/カタカナ、全角/半角の違いを無視して比較します。
	CompareText ()
	CompareTextクラスの新しいインスタンスを初期化します。

詳解

日本語の文字列を、大文字/小文字、ひらがな/カタカナ、全角/半角の違いを無視して比較するための IComparer<T> です。

この比較クラスは、日本のカルチャ情報(ja-jp)に基づき、以下のオプションを使用して文字列を比較します。

• CompareOptions.IgnoreCase: アルファベットの大文字と小文字を区別しません (例: "Apple" と "apple")。
• CompareOptions.IgnoreKanaType: ひらがなとカタカナを区別しません (例: "りんご" と "リンゴ")。
• CompareOptions.IgnoreWidth: 全角文字と半角文字を区別しません (例: "ＡＢＣ" と "ABC")。

ユーザー入力の検索やソートなど、表記の揺れを吸収したい場合に特に有効です。

var words = new List<string> { "ＶＩＤＥＯ", "ビデオ", "video", "びでお" };
 
// CompareText を使ってソートする
words.Sort(new CompareText());
 
// この時点で、wordsリスト内の順序は変わりませんが、
// 比較上はすべて等価として扱われるため、元の順序が維持される可能性が高いです。
 
var comparer = new CompareText();
Console.WriteLine(comparer.Compare("ｶﾀｶﾅ", "かたかな")); // 0 (等しい)
Console.WriteLine(comparer.Compare("Ｈｅｌｌｏ", "Hello")); // 0 (等しい)

構築子と解体子

CompareText()

YukkuriMovieMaker.Commons.CompareText.CompareText

(

)

CompareTextクラスの新しいインスタンスを初期化します。

メソッド詳解

Compare()

int YukkuriMovieMaker.Commons.CompareText.Compare	(	string	x,
		string	y )

2つの文字列を、大文字/小文字、ひらがな/カタカナ、全角/半角の違いを無視して比較します。

引数

x	比較する1番目の文字列。
y	比較する2番目の文字列。

戻り値

2つの文字列の並べ替え順序における関係を示す 32 ビット符号付き整数。

0未満	x は y より小さい。
0	x と y は等しい。
0より大きい	x は y より大きい。

---

このクラス詳解は次のファイルから抽出されました:

• YukkuriMovieMaker.Plugin/YukkuriMovieMaker/Commons/CompareText.cs