StringBuilder.GetChunks Metodo

Definizione

Spazio dei nomi:

System.Text

Assembly:

System.Runtime.dll

Origine:

StringBuilder.cs

Restituisce un oggetto che può essere utilizzato per scorrere i blocchi di caratteri rappresentati in un ReadOnlyMemory<Char> creato da questa istanza di StringBuilder.

public:
 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

Restituisce

StringBuilder.ChunkEnumerator

Enumeratore per i blocchi nel ReadOnlyMemory<Char>.

Commenti

È possibile eseguire l'iterazione dei blocchi nell'intervallo di memoria con codice simile al seguente:

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

Lo scopo di questo metodo è estrarre in modo efficiente i dati di una costante StringBuilder. Se la StringBuilder viene modificata mentre l'enumerazione del blocco è incompleta, il risultato non è definito. StringBuilder non è inoltre thread-safe, quindi operare su di esso con thread simultanei è illegale.

I blocchi ReadOnlyMemory<T> restituiti non rimangono invariati se il StringBuilder viene modificato, quindi non memorizzarli nella cache per usarli in un secondo momento.

La creazione di un ReadOnlySpan<T> da un ReadOnlyMemory<T> (come nel metodo ReadOnlyMemory<T>.Span nell'esempio precedente) è costosa, quindi creare una variabile locale per l'intervallo se è necessario usarla in un'istruzione for annidata. Per esempio:

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