Regex.EnumerateSplits Método

Definição

Namespace:

System.Text.RegularExpressions

Assembly:

System.Text.RegularExpressions.dll

Sobrecargas

EnumerateSplits(ReadOnlySpan<Char>)	Pesquisa um intervalo de entrada para todas as ocorrências de uma expressão regular e retorna um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.
EnumerateSplits(ReadOnlySpan<Char>, Int32)	Pesquisa um intervalo de entrada para todas as ocorrências de uma expressão regular e retorna um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.
EnumerateSplits(ReadOnlySpan<Char>, String)	Pesquisa um intervalo de entrada para todas as ocorrências de uma expressão regular e retorna um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.
EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32)	Pesquisa um intervalo de entrada para todas as ocorrências de uma expressão regular e retorna um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.
EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions)	Pesquisa um intervalo de entrada para todas as ocorrências de uma expressão regular e retorna um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.
EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)	Pesquisa um intervalo de entrada para todas as ocorrências de uma expressão regular e retorna um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.

EnumerateSplits(ReadOnlySpan<Char>)

Pesquisa um intervalo de entrada para todas as ocorrências de uma expressão regular e retorna um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.

public:
 System::Text::RegularExpressions::Regex::ValueSplitEnumerator EnumerateSplits(ReadOnlySpan<char> input);

public System.Text.RegularExpressions.Regex.ValueSplitEnumerator EnumerateSplits (ReadOnlySpan<char> input);

member this.EnumerateSplits : ReadOnlySpan<char> -> System.Text.RegularExpressions.Regex.ValueSplitEnumerator

Public Function EnumerateSplits (input As ReadOnlySpan(Of Char)) As Regex.ValueSplitEnumerator

Parâmetros

input

ReadOnlySpan<Char>

O intervalo para procurar uma correspondência.

Retornos

Regex.ValueSplitEnumerator

Um Regex.ValueSplitEnumerator iterar ao longo das correspondências.

Comentários

O comportamento de EnumerateSplits(ReadOnlySpan<Char>) é semelhante ao comportamento de Split(String), produzindo as divisões uma de cada vez como parte da iteração por meio do enumerador resultante, em vez de tudo de uma vez como parte de uma única matriz. No entanto, há algumas diferenças notáveis. Split(String) incluirá o conteúdo dos grupos de captura nas divisões resultantes, enquanto EnumerateSplits(ReadOnlySpan<Char>) não. E se RightToLeft for especificado, Split(String) reverterá a ordem das divisões resultantes para ser da esquerda para a direita, enquanto EnumerateSplits(ReadOnlySpan<Char>) produzirá as divisões na ordem em que forem encontradas da direita para a esquerda.

Cada correspondência não acontecerá até que MoveNext() seja invocado no enumerador, com uma correspondência sendo executada por MoveNext() chamada. Como a avaliação da correspondência ocorre de forma preguiçosa, qualquer alteração na entrada passada entre chamadas para MoveNext() pode afetar os resultados da correspondência; essas alterações devem ser evitadas e não têm suporte.

EnumerateSplits(ReadOnlySpan<Char>, Int32)

Pesquisa um intervalo de entrada para todas as ocorrências de uma expressão regular e retorna um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.

public:
 System::Text::RegularExpressions::Regex::ValueSplitEnumerator EnumerateSplits(ReadOnlySpan<char> input, int count);

public System.Text.RegularExpressions.Regex.ValueSplitEnumerator EnumerateSplits (ReadOnlySpan<char> input, int count);

member this.EnumerateSplits : ReadOnlySpan<char> * int -> System.Text.RegularExpressions.Regex.ValueSplitEnumerator

Public Function EnumerateSplits (input As ReadOnlySpan(Of Char), count As Integer) As Regex.ValueSplitEnumerator

Parâmetros

input

ReadOnlySpan<Char>

O intervalo para procurar uma correspondência.

count

Int32

O número máximo de vezes que a divisão pode ocorrer. Se 0, todas as divisões estarão disponíveis.

Retornos

Regex.ValueSplitEnumerator

Um Regex.ValueSplitEnumerator iterar ao longo das correspondências.

Comentários

O comportamento de EnumerateSplits(ReadOnlySpan<Char>, Int32) é semelhante ao comportamento de Split(String, Int32), produzindo as divisões uma de cada vez como parte da iteração por meio do enumerador resultante, em vez de tudo de uma vez como parte de uma única matriz. No entanto, há algumas diferenças notáveis. Split(String, Int32) incluirá o conteúdo dos grupos de captura nas divisões resultantes, enquanto EnumerateSplits(ReadOnlySpan<Char>, Int32) não. E se RightToLeft for especificado, Split(String, Int32) reverterá a ordem das divisões resultantes para ser da esquerda para a direita, enquanto EnumerateSplits(ReadOnlySpan<Char>, Int32) produzirá as divisões na ordem em que forem encontradas da direita para a esquerda.

Cada correspondência não acontecerá até que MoveNext() seja invocado no enumerador, com uma correspondência sendo executada por MoveNext() chamada. Como a avaliação da correspondência ocorre de forma preguiçosa, qualquer alteração na entrada passada entre chamadas para MoveNext() pode afetar os resultados da correspondência; essas alterações devem ser evitadas e não têm suporte.

EnumerateSplits(ReadOnlySpan<Char>, String)

Pesquisa um intervalo de entrada para todas as ocorrências de uma expressão regular e retorna um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.

public:
 static System::Text::RegularExpressions::Regex::ValueSplitEnumerator EnumerateSplits(ReadOnlySpan<char> input, System::String ^ pattern);

public static System.Text.RegularExpressions.Regex.ValueSplitEnumerator EnumerateSplits (ReadOnlySpan<char> input, string pattern);

static member EnumerateSplits : ReadOnlySpan<char> * string -> System.Text.RegularExpressions.Regex.ValueSplitEnumerator

Public Shared Function EnumerateSplits (input As ReadOnlySpan(Of Char), pattern As String) As Regex.ValueSplitEnumerator

Parâmetros

input

ReadOnlySpan<Char>

O intervalo para procurar uma correspondência.

pattern

String

O padrão de expressão regular a ser correspondido.

Retornos

Regex.ValueSplitEnumerator

Um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.

Exceções

ArgumentNullException

pattern é null.

RegexParseException

Ocorreu um erro de análise de expressão regular.

Comentários

O comportamento de EnumerateSplits(ReadOnlySpan<Char>, String) é semelhante ao comportamento de Split(String, String), produzindo as divisões uma de cada vez como parte da iteração por meio do enumerador resultante, em vez de tudo de uma vez como parte de uma única matriz. No entanto, há algumas diferenças notáveis. Split(String, String) incluirá o conteúdo dos grupos de captura nas divisões resultantes, enquanto EnumerateSplits(ReadOnlySpan<Char>, String) não. E se RightToLeft for especificado, Split(String, String) reverterá a ordem das divisões resultantes para ser da esquerda para a direita, enquanto EnumerateSplits(ReadOnlySpan<Char>, String) produzirá as divisões na ordem em que forem encontradas da direita para a esquerda.

Cada correspondência não acontecerá até que MoveNext() seja invocado no enumerador, com uma correspondência sendo executada por MoveNext() chamada. Como a avaliação da correspondência ocorre de forma preguiçosa, qualquer alteração na entrada passada entre chamadas para MoveNext() pode afetar os resultados da correspondência; essas alterações devem ser evitadas e não têm suporte.

EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32)

Pesquisa um intervalo de entrada para todas as ocorrências de uma expressão regular e retorna um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.

public:
 System::Text::RegularExpressions::Regex::ValueSplitEnumerator EnumerateSplits(ReadOnlySpan<char> input, int count, int startat);

public System.Text.RegularExpressions.Regex.ValueSplitEnumerator EnumerateSplits (ReadOnlySpan<char> input, int count, int startat);

member this.EnumerateSplits : ReadOnlySpan<char> * int * int -> System.Text.RegularExpressions.Regex.ValueSplitEnumerator

Public Function EnumerateSplits (input As ReadOnlySpan(Of Char), count As Integer, startat As Integer) As Regex.ValueSplitEnumerator

Parâmetros

input

ReadOnlySpan<Char>

O intervalo para procurar uma correspondência.

count

Int32

O número máximo de vezes que a divisão pode ocorrer. Se 0, todas as divisões estarão disponíveis.

startat

Int32

A posição do caractere baseado em zero na qual iniciar a pesquisa.

Retornos

Regex.ValueSplitEnumerator

Um Regex.ValueSplitEnumerator iterar ao longo das correspondências.

Comentários

O comportamento de EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32) é semelhante ao comportamento de Split(String, Int32, Int32), produzindo as divisões uma de cada vez como parte da iteração por meio do enumerador resultante, em vez de tudo de uma vez como parte de uma única matriz. No entanto, há algumas diferenças notáveis. Split(String, Int32, Int32) incluirá o conteúdo dos grupos de captura nas divisões resultantes, enquanto EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32) não. E se RightToLeft for especificado, Split(String, Int32, Int32) reverterá a ordem das divisões resultantes para ser da esquerda para a direita, enquanto EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32) produzirá as divisões na ordem em que forem encontradas da direita para a esquerda.

Cada correspondência não acontecerá até que MoveNext() seja invocado no enumerador, com uma correspondência sendo executada por MoveNext() chamada. Como a avaliação da correspondência ocorre de forma preguiçosa, qualquer alteração na entrada passada entre chamadas para MoveNext() pode afetar os resultados da correspondência; essas alterações devem ser evitadas e não têm suporte.

EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions)

Pesquisa um intervalo de entrada para todas as ocorrências de uma expressão regular e retorna um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.

public:
 static System::Text::RegularExpressions::Regex::ValueSplitEnumerator EnumerateSplits(ReadOnlySpan<char> input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);

public static System.Text.RegularExpressions.Regex.ValueSplitEnumerator EnumerateSplits (ReadOnlySpan<char> input, string pattern, System.Text.RegularExpressions.RegexOptions options);

static member EnumerateSplits : ReadOnlySpan<char> * string * System.Text.RegularExpressions.RegexOptions -> System.Text.RegularExpressions.Regex.ValueSplitEnumerator

Public Shared Function EnumerateSplits (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions) As Regex.ValueSplitEnumerator

Parâmetros

input

ReadOnlySpan<Char>

O intervalo para procurar uma correspondência.

pattern

String

O padrão de expressão regular a ser correspondido.

options

RegexOptions

Uma combinação bit a bit dos valores de enumeração que especificam opções para correspondência.

Retornos

Regex.ValueSplitEnumerator

Um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.

Exceções

ArgumentNullException

pattern é null.

ArgumentOutOfRangeException

options não é uma combinação bit a bit válida de valores RegexOptions.

RegexParseException

Ocorreu um erro de análise de expressão regular.

Comentários

O comportamento de EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions) é semelhante ao comportamento de Split(String, String, RegexOptions), produzindo as divisões uma de cada vez como parte da iteração por meio do enumerador resultante, em vez de tudo de uma vez como parte de uma única matriz. No entanto, há algumas diferenças notáveis. Split(String, String, RegexOptions) incluirá o conteúdo dos grupos de captura nas divisões resultantes, enquanto EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions) não. E se RightToLeft for especificado, Split(String, String, RegexOptions) reverterá a ordem das divisões resultantes para ser da esquerda para a direita, enquanto EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions) produzirá as divisões na ordem em que forem encontradas da direita para a esquerda.

Cada correspondência não acontecerá até que MoveNext() seja invocado no enumerador, com uma correspondência sendo executada por MoveNext() chamada. Como a avaliação da correspondência ocorre de forma preguiçosa, qualquer alteração na entrada passada entre chamadas para MoveNext() pode afetar os resultados da correspondência; essas alterações devem ser evitadas e não têm suporte.

EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)

Pesquisa um intervalo de entrada para todas as ocorrências de uma expressão regular e retorna um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.

public:
 static System::Text::RegularExpressions::Regex::ValueSplitEnumerator EnumerateSplits(ReadOnlySpan<char> input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);

public static System.Text.RegularExpressions.Regex.ValueSplitEnumerator EnumerateSplits (ReadOnlySpan<char> input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

static member EnumerateSplits : ReadOnlySpan<char> * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> System.Text.RegularExpressions.Regex.ValueSplitEnumerator

Public Shared Function EnumerateSplits (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As Regex.ValueSplitEnumerator

Parâmetros

input

ReadOnlySpan<Char>

O intervalo para procurar uma correspondência.

pattern

String

O padrão de expressão regular a ser correspondido.

options

RegexOptions

Uma combinação bit a bit dos valores de enumeração que especificam opções para correspondência.

matchTimeout

TimeSpan

Um intervalo de tempo limite ou InfiniteMatchTimeout para indicar que o método não deve ter tempo limite.

Retornos

Regex.ValueSplitEnumerator

Um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.

Exceções

ArgumentNullException

pattern é null.

ArgumentOutOfRangeException

options não é uma combinação bit a bit válida de valores RegexOptions ou matchTimeout é negativo, zero ou maior que aproximadamente 24 dias.

RegexParseException

Ocorreu um erro de análise de expressão regular.

Comentários

O comportamento de EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan) é semelhante ao comportamento de Split(String, String, RegexOptions, TimeSpan), produzindo as divisões uma de cada vez como parte da iteração por meio do enumerador resultante, em vez de tudo de uma vez como parte de uma única matriz. No entanto, há algumas diferenças notáveis. Split(String, String, RegexOptions, TimeSpan) incluirá o conteúdo dos grupos de captura nas divisões resultantes, enquanto EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan) não. E se RightToLeft for especificado, Split(String, String, RegexOptions, TimeSpan) reverterá a ordem das divisões resultantes para ser da esquerda para a direita, enquanto EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan) produzirá as divisões na ordem em que forem encontradas da direita para a esquerda.

Cada correspondência não acontecerá até que MoveNext() seja invocado no enumerador, com uma correspondência sendo executada por MoveNext() chamada. Como a avaliação da correspondência ocorre de forma preguiçosa, qualquer alteração na entrada passada entre chamadas para MoveNext() pode afetar os resultados da correspondência; essas alterações devem ser evitadas e não têm suporte.