Regex.EnumerateSplits Método
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
| 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. |
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.ValueSplitEnumeratorPublic Function EnumerateSplits (input As ReadOnlySpan(Of Char)) As Regex.ValueSplitEnumeratorParâmetros
- input
- ReadOnlySpan<Char>
O intervalo para procurar uma correspondência.
Retornos
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.
Aplica-se a
.NET 10 e .NET 9
| Produto | Versões |
|---|---|
| .NET | 9, 10 |
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.ValueSplitEnumeratorPublic Function EnumerateSplits (input As ReadOnlySpan(Of Char), count As Integer) As Regex.ValueSplitEnumeratorParâ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
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.
Aplica-se a
.NET 10 e .NET 9
| Produto | Versões |
|---|---|
| .NET | 9, 10 |
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.ValueSplitEnumeratorPublic Shared Function EnumerateSplits (input As ReadOnlySpan(Of Char), pattern As String) As Regex.ValueSplitEnumeratorParâmetros
- input
- ReadOnlySpan<Char>
O intervalo para procurar uma correspondência.
- pattern
- String
O padrão de expressão regular a ser correspondido.
Retornos
Um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.
Exceções
pattern é null.
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.
Aplica-se a
.NET 10 e .NET 9
| Produto | Versões |
|---|---|
| .NET | 9, 10 |
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.ValueSplitEnumeratorPublic Function EnumerateSplits (input As ReadOnlySpan(Of Char), count As Integer, startat As Integer) As Regex.ValueSplitEnumeratorParâ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
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.
Aplica-se a
.NET 10 e .NET 9
| Produto | Versões |
|---|---|
| .NET | 9, 10 |
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.ValueSplitEnumeratorPublic Shared Function EnumerateSplits (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions) As Regex.ValueSplitEnumeratorParâ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
Um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.
Exceções
pattern é null.
options não é uma combinação bit a bit válida de valores RegexOptions.
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.
Aplica-se a
.NET 10 e .NET 9
| Produto | Versões |
|---|---|
| .NET | 9, 10 |
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.ValueSplitEnumeratorPublic Shared Function EnumerateSplits (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As Regex.ValueSplitEnumeratorParâ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
Um Regex.ValueSplitEnumerator para iterar sobre as divisões em torno de correspondências.
Exceções
pattern é null.
options não é uma combinação bit a bit válida de valores RegexOptions ou matchTimeout é negativo, zero ou maior que aproximadamente 24 dias.
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.
Aplica-se a
.NET 10 e .NET 9
| Produto | Versões |
|---|---|
| .NET | 9, 10 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: