StringBuilder.GetChunks メソッド


この ReadOnlyMemory<Char> インスタンスから作成された StringBuilder で表される文字のチャンクを反復処理する目的で利用できるオブジェクトを返します。Returns an object that can be used to iterate through the chunks of characters represented in a ReadOnlyMemory<Char> created from this StringBuilder instance.

 System::Text::StringBuilder::ChunkEnumerator GetChunks();
public System.Text.StringBuilder.ChunkEnumerator GetChunks ();
member this.GetChunks : unit -> System.Text.StringBuilder.ChunkEnumerator
Public Function GetChunks () As StringBuilder.ChunkEnumerator


ReadOnlyMemory<Char> のチャンクの列挙子。An enumerator for the chunks in the ReadOnlyMemory<Char>.


次のようなコードを使用して、メモリ範囲内のチャンクを反復処理できます。You can iterate the chunks in the memory range with code like the following:

foreach (ReadOnlyMemory<char> chunk in sb.GetChunks())
    foreach(char ch in chunk.Span)
        { /* operations on ch */ }

このメソッドの目的は、定数StringBuilderのデータを効率的に抽出することです。The purpose of this method is to efficiently extract the data of a constant StringBuilder. チャンクの列挙が不完全なときに StringBuilder が変更された場合、結果は未定義になります。If the StringBuilder is modified while the chunk enumeration is incomplete, the result is undefined. StringBuilder もスレッドセーフではないため、同時実行スレッドでの操作は無効です。StringBuilder is also not thread-safe, so operating on it with concurrent threads is illegal.

返された ReadOnlyMemory<T> チャンクは、StringBuilder が変更されても変更されないとは限りません。そのため、後で使用できるようにキャッシュしないでください。The ReadOnlyMemory<T> chunks returned are not guaranteed to remain unchanged if the StringBuilder is modified, so do not cache them for later use.

前の例の ReadOnlyMemory<T>.Span メソッドと同様に ReadOnlyMemory<T> から ReadOnlySpan<T> を作成すると、コストが高くなります。そのため、入れ子になった for ステートメントで使用する必要がある場合は、スパンのローカル変数を作成します。Creating a ReadOnlySpan<T> from a ReadOnlyMemory<T> (as the ReadOnlyMemory<T>.Span method does in the previous example, is expensive, so create a local variable for the span if you need to use it in a nested for statement. 例 :For example:

foreach (ReadOnlyMemory<char> chunk in sb.GetChunks())
    var span = chunk.Span;
    for(int i = 0; i < span.Length; i++)
        /* operations on span[i] */