Regex.EnumerateSplits 方法

定義

命名空間:

System.Text.RegularExpressions

組件:

netstandard.dll, System.Text.RegularExpressions.dll

多載

名稱	Description
EnumerateSplits(ReadOnlySpan<Char>)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。
EnumerateSplits(ReadOnlySpan<Char>, Int32)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。
EnumerateSplits(ReadOnlySpan<Char>, String)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。
EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。
EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。
EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)	搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。

EnumerateSplits(ReadOnlySpan<Char>)

來源:

Regex.EnumerateSplits.cs

搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。

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

參數

input

ReadOnlySpan<Char>

尋找匹配的時間。

傳回

Regex.ValueSplitEnumerator

Regex.ValueSplitEnumerator A 用來反覆調整匹配。

備註

的 EnumerateSplits(ReadOnlySpan<Char>) 行為類似於 的 Split(String)行為，都是在迭代結果的列舉器中逐一產生分裂，而非一次性全部作為單一陣列的一部分。 不過，兩者有幾個顯著差異。 Split(String) 會將擷取群的內容納入拆分結果，而 EnumerateSplits(ReadOnlySpan<Char>) 不會。 如果 RightToLeft 指定 ， Split(String) 則會將所得分割的順序反轉為從左到右，而 EnumerateSplits(ReadOnlySpan<Char>) 則會產生從右到左的分割順序。

每個配對直到在列舉器上被呼叫前才會實際發生 MoveNext() ，每次 MoveNext() 通話會執行一次配對。 由於匹配的評估進行得很懶散，呼叫之間 MoveNext() 對輸入的變更可能會影響匹配結果;這類變更應避免且不支援。

EnumerateSplits(ReadOnlySpan<Char>, Int32)

來源:

Regex.EnumerateSplits.cs

搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。

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

參數

input

ReadOnlySpan<Char>

尋找匹配的時間。

count

Int32

分裂最多可發生的次數。 若為 0，則所有分割皆可用。

傳回

Regex.ValueSplitEnumerator

Regex.ValueSplitEnumerator A 用來反覆調整匹配。

備註

的 EnumerateSplits(ReadOnlySpan<Char>, Int32) 行為類似於 的 Split(String, Int32)行為，都是在迭代結果的列舉器中逐一產生分裂，而非一次性全部作為單一陣列的一部分。 不過，兩者有幾個顯著差異。 Split(String, Int32) 會將擷取群的內容納入拆分結果，而 EnumerateSplits(ReadOnlySpan<Char>, Int32) 不會。 如果 RightToLeft 指定 ， Split(String, Int32) 則會將所得分割的順序反轉為從左到右，而 EnumerateSplits(ReadOnlySpan<Char>, Int32) 則會產生從右到左的分割順序。

每個配對直到在列舉器上被呼叫前才會實際發生 MoveNext() ，每次 MoveNext() 通話會執行一次配對。 由於匹配的評估進行得很懶散，呼叫之間 MoveNext() 對輸入的變更可能會影響匹配結果;這類變更應避免且不支援。

EnumerateSplits(ReadOnlySpan<Char>, String)

來源:

Regex.EnumerateSplits.cs

搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。

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

參數

input

ReadOnlySpan<Char>

尋找匹配的時間。

pattern

String

要比對的正則表達式模式。

傳回

Regex.ValueSplitEnumerator

A Regex.ValueSplitEnumerator 是為了反覆調整比賽分段。

例外狀況

ArgumentNullException

pattern 為 null。

RegexParseException

發生正則表達式剖析錯誤。

備註

的 EnumerateSplits(ReadOnlySpan<Char>, String) 行為類似於 的 Split(String, String)行為，都是在迭代結果的列舉器中逐一產生分裂，而非一次性全部作為單一陣列的一部分。 不過，兩者有幾個顯著差異。 Split(String, String) 會將擷取群的內容納入拆分結果，而 EnumerateSplits(ReadOnlySpan<Char>, String) 不會。 如果 RightToLeft 指定 ， Split(String, String) 則會將所得分割的順序反轉為從左到右，而 EnumerateSplits(ReadOnlySpan<Char>, String) 則會產生從右到左的分割順序。

每個配對直到在列舉器上被呼叫前才會實際發生 MoveNext() ，每次 MoveNext() 通話會執行一次配對。 由於匹配的評估進行得很懶散，呼叫之間 MoveNext() 對輸入的變更可能會影響匹配結果;這類變更應避免且不支援。

EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32)

來源:

Regex.EnumerateSplits.cs

搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。

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

參數

input

ReadOnlySpan<Char>

尋找匹配的時間。

count

Int32

分裂最多可發生的次數。 若為 0，則所有分割皆可用。

startat

Int32

要開始搜尋之以零起始的字元位置。

傳回

Regex.ValueSplitEnumerator

Regex.ValueSplitEnumerator A 用來反覆調整匹配。

備註

的 EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32) 行為類似於 的 Split(String, Int32, Int32)行為，都是在迭代結果的列舉器中逐一產生分裂，而非一次性全部作為單一陣列的一部分。 不過，兩者有幾個顯著差異。 Split(String, Int32, Int32) 會將擷取群的內容納入拆分結果，而 EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32) 不會。 如果 RightToLeft 指定 ， Split(String, Int32, Int32) 則會將所得分割的順序反轉為從左到右，而 EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32) 則會產生從右到左的分割順序。

每個配對直到在列舉器上被呼叫前才會實際發生 MoveNext() ，每次 MoveNext() 通話會執行一次配對。 由於匹配的評估進行得很懶散，呼叫之間 MoveNext() 對輸入的變更可能會影響匹配結果;這類變更應避免且不支援。

EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions)

來源:

Regex.EnumerateSplits.cs

搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。

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

參數

input

ReadOnlySpan<Char>

尋找匹配的時間。

pattern

String

要比對的正則表達式模式。

options

RegexOptions

一個位元組合的列舉值，指定匹配選項。

傳回

Regex.ValueSplitEnumerator

A Regex.ValueSplitEnumerator 是為了反覆調整比賽分段。

例外狀況

ArgumentNullException

pattern 為 null。

ArgumentOutOfRangeException

options 不是有效的正則表達選項值的位元組合。

RegexParseException

發生正則表達式剖析錯誤。

備註

的 EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions) 行為類似於 的 Split(String, String, RegexOptions)行為，都是在迭代結果的列舉器中逐一產生分裂，而非一次性全部作為單一陣列的一部分。 不過，兩者有幾個顯著差異。 Split(String, String, RegexOptions) 會將擷取群的內容納入拆分結果，而 EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions) 不會。 如果 RightToLeft 指定 ， Split(String, String, RegexOptions) 則會將所得分割的順序反轉為從左到右，而 EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions) 則會產生從右到左的分割順序。

每個配對直到在列舉器上被呼叫前才會實際發生 MoveNext() ，每次 MoveNext() 通話會執行一次配對。 由於匹配的評估進行得很懶散，呼叫之間 MoveNext() 對輸入的變更可能會影響匹配結果;這類變更應避免且不支援。

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

來源:

Regex.EnumerateSplits.cs

搜尋輸入區間中所有正則表達式的出現，並回傳 a Regex.ValueSplitEnumerator 以遍歷匹配周圍的分割。

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

參數

input

ReadOnlySpan<Char>

尋找匹配的時間。

pattern

String

要比對的正則表達式模式。

options

RegexOptions

一個位元組合的列舉值，指定匹配選項。

matchTimeout

TimeSpan

一個逾時區間，或 InfiniteMatchTimeout 表示方法不應逾時。

傳回

Regex.ValueSplitEnumerator

A Regex.ValueSplitEnumerator 是為了反覆調整比賽分段。

例外狀況

ArgumentNullException

pattern 為 null。

ArgumentOutOfRangeException

options 不是有效的正則表達式選項（RegexOptions）值的位元組合，或 matchTimeout 為負值、零值，或大於約24天。

RegexParseException

發生正則表達式剖析錯誤。

備註

的 EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan) 行為類似於 的 Split(String, String, RegexOptions, TimeSpan)行為，都是在迭代結果的列舉器中逐一產生分裂，而非一次性全部作為單一陣列的一部分。 不過，兩者有幾個顯著差異。 Split(String, String, RegexOptions, TimeSpan) 會將擷取群的內容納入拆分結果，而 EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan) 不會。 如果 RightToLeft 指定 ， Split(String, String, RegexOptions, TimeSpan) 則會將所得分割的順序反轉為從左到右，而 EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan) 則會產生從右到左的分割順序。

每個配對直到在列舉器上被呼叫前才會實際發生 MoveNext() ，每次 MoveNext() 通話會執行一次配對。 由於匹配的評估進行得很懶散，呼叫之間 MoveNext() 對輸入的變更可能會影響匹配結果;這類變更應避免且不支援。