StringInfo.GetNextTextElement メソッド

定義

名前空間:

System.Globalization

アセンブリ:

netstandard.dll, System.Runtime.dll

指定した文字列内の最初のテキスト要素を取得します。

オーバーロード

名前	説明
GetNextTextElement(String)	指定した文字列内の最初のテキスト要素を取得します。
GetNextTextElement(String, Int32)	指定した文字列の指定したインデックス位置にあるテキスト要素を取得します。

GetNextTextElement(String)

ソース:

StringInfo.cs

指定した文字列内の最初のテキスト要素を取得します。

public:
 static System::String ^ GetNextTextElement(System::String ^ str);

public static string GetNextTextElement(string str);

static member GetNextTextElement : string -> string

Public Shared Function GetNextTextElement (str As String) As String

パラメーター

str

String

テキスト要素の取得元の文字列。

返品

String

指定した文字列の最初のテキスト要素を含む文字列。

例外

ArgumentNullException

str は nullです。

注釈

.NET では、テキスト要素は、単一の文字 (つまり grapheme) として表示されるテキストの単位として定義されます。 テキスト要素には、基本文字、サロゲート ペア、または結合文字シーケンスを指定できます。 Unicode 標準では、2 つのコード単位のシーケンスで構成される 1 つの抽象文字のコード化された文字表現としてサロゲート ペアが定義されています。この場合、ペアの最初の単位は上位サロゲート、2 番目の単位は低サロゲートです。 Unicode 標準では、基本文字と 1 つ以上の結合文字の組み合わせとして結合文字シーケンスが定義されています。 サロゲート ペアは、基本文字または結合文字を表すことができます。

このメソッドは、最初のテキスト要素のみを返します。 文字列のテキスト要素を反復処理するには、GetTextElementEnumerator メソッドによって生成されたTextElementEnumerator オブジェクトを使用する必要があります。

こちらもご覧ください

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)

GetNextTextElement(String, Int32)

ソース:

StringInfo.cs

指定した文字列の指定したインデックス位置にあるテキスト要素を取得します。

public:
 static System::String ^ GetNextTextElement(System::String ^ str, int index);

public static string GetNextTextElement(string str, int index);

static member GetNextTextElement : string * int -> string

Public Shared Function GetNextTextElement (str As String, index As Integer) As String

パラメーター

str

String

テキスト要素の取得元の文字列。

index

Int32

テキスト要素の開始位置を示す 0 から始まるインデックス。

返品

String

指定した文字列の指定したインデックス位置にあるテキスト要素を含む文字列。

例外

ArgumentNullException

str は nullです。

ArgumentOutOfRangeException

index が、 strの有効なインデックスの範囲外です。

注釈

.NET では、テキスト要素は、単一の文字 (つまり grapheme) として表示されるテキストの単位として定義されます。 テキスト要素には、基本文字、サロゲート ペア、または結合文字シーケンスを指定できます。 Unicode 標準では、2 つのコード単位のシーケンスで構成される 1 つの抽象文字のコード化された文字表現としてサロゲート ペアが定義されています。この場合、ペアの最初の単位は上位サロゲート、2 番目の単位は低サロゲートです。 Unicode 標準では、基本文字と 1 つ以上の結合文字の組み合わせとして結合文字シーケンスが定義されています。 サロゲート ペアは、基本文字または結合文字を表すことができます。

このメソッドは、指定したインデックスから始まる部分文字列の最初のテキスト要素のみを返します。 文字列のテキスト要素を反復処理するには、アプリケーションで GetTextElementEnumerator メソッドによって生成されたTextElementEnumeratorを使用する必要があります。

こちらもご覧ください

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)