Class KanjiText

Namespace: KanjiVariants

Assembly: KanjiVariants.dll

文字列中の漢字を置換し、結果の文字集合への所属を調べます。

public static class KanjiText

Inheritance: object

KanjiText

Inherited Members: object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Methods

IsSupported(string, CharacterSet)

文字列の全ての文字が指定文字集合で使用可能かを判定します。

public static bool IsSupported(string text, CharacterSet characterSet)

Parameters

text string: 検証する文字列。ASCII は使用可能として扱います。
characterSet CharacterSet: 所属を確認する文字集合。

Returns

bool: ASCII以外の全ての文字が指定文字集合に所属し、ASCIIを含む全体が使用可能ならtrue。登録済みIVS/SVSであってもVariation Sequenceそのものは使用不可でfalseです。未登録Variation Sequenceや不正UTF-16がある場合もfalseです。

Exceptions

ArgumentNullException: text が null の場合。
ArgumentOutOfRangeException: characterSet が未定義の値の場合。

Replace(string, CharacterSet, KanjiFallbackOptions)

対象集合にない漢字を公式の一意な変換先へ置換し、許可された場合は登録済み IVS/SVS の基底文字へフォールバックします。

public static string Replace(string text, CharacterSet characterSet, KanjiFallbackOptions options = KanjiFallbackOptions.None)

Parameters

text string: 置換する文字列。ASCII はそのまま通過します。
characterSet CharacterSet: 変換先として使用できる文字集合。
options KanjiFallbackOptions: 登録済み IVS/SVS の基底文字へフォールバックするかどうか。

Returns

string: 置換後の文字列。置換がなければ入力と同じ string インスタンスです。

Remarks

元の表現が指定文字集合で使用可能なら維持します。使用可能なMJ一意変換先を優先し、指定されたオプションで許可された場合は登録済みIVS/SVSの基底文字へフォールバックします。置換できない表現と不正UTF-16は元のまま保持して処理を続けます。戻り値全体が指定文字集合で使用可能になることは保証しません。必要に応じてIsSupported(string, CharacterSet)で置換後の文字列を検証してください。

Exceptions

ArgumentNullException: text が null の場合。
ArgumentOutOfRangeException: characterSet が未定義の値の場合。
ArgumentOutOfRangeException: options に未定義の値が含まれる場合。