Regex.Split Methode

Definitie

Splitst een invoertekenreeks in een matrix met subtekenreeksen op de posities die zijn gedefinieerd door een reguliere expressieovereenkomst.

Overloads

Name Description
Split(String, String, RegexOptions, TimeSpan)

Splitst een invoertekenreeks in een matrix met subtekenreeksen op de posities die zijn gedefinieerd door een opgegeven patroon voor reguliere expressies. Aanvullende parameters geven opties op waarmee de overeenkomende bewerking en een time-outinterval worden gewijzigd als er geen overeenkomst wordt gevonden.

Split(String, String, RegexOptions)

Splitst een invoertekenreeks in een matrix met subtekenreeksen op de posities die zijn gedefinieerd door een opgegeven patroon voor reguliere expressies. Opgegeven opties wijzigen de overeenkomende bewerking.

Split(String, Int32, Int32)

Splitst een invoertekenreeks een opgegeven maximum aantal keren in een matrix met subtekenreeksen, op de posities die zijn gedefinieerd door een reguliere expressie die is opgegeven in de Regex constructor. Het zoeken naar het reguliere expressiepatroon begint op een opgegeven tekenpositie in de invoertekenreeks.

Split(String, String)

Splitst een invoertekenreeks in een matrix met subtekenreeksen op de posities die zijn gedefinieerd door een normaal expressiepatroon.

Split(String)

Splitst een invoertekenreeks in een matrix met subtekenreeksen op de posities die zijn gedefinieerd door een normaal expressiepatroon dat is opgegeven in de Regex constructor.

Split(String, Int32)

Splitst een invoertekenreeks een opgegeven maximum aantal keren in een matrix met subtekenreeksen, op de posities die zijn gedefinieerd door een reguliere expressie die is opgegeven in de Regex constructor.

Split(String, String, RegexOptions, TimeSpan)

Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs

Splitst een invoertekenreeks in een matrix met subtekenreeksen op de posities die zijn gedefinieerd door een opgegeven patroon voor reguliere expressies. Aanvullende parameters geven opties op waarmee de overeenkomende bewerking en een time-outinterval worden gewijzigd als er geen overeenkomst wordt gevonden.

public:
 static cli::array <System::String ^> ^ Split(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);
public static string[] Split(string input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);
static member Split : string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> string[]
Public Shared Function Split (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As String()

Parameters

input
String

De tekenreeks die moet worden gesplitst.

pattern
String

Het reguliere expressiepatroon dat moet overeenkomen.

options
RegexOptions

Een bitsgewijze combinatie van de opsommingswaarden die opties bieden voor overeenkomende waarden.

matchTimeout
TimeSpan

Een time-outinterval of InfiniteMatchTimeout om aan te geven dat er geen time-out optreedt voor de methode.

Retouren

String[]

Een array van tekenreeksen.

Uitzonderingen

Er is een reguliere expressieparseringsfout opgetreden.

input of pattern is null.

options is geen geldige bitsgewijze combinatie van RegexOptions waarden. -of- matchTimeout is negatief, nul of groter dan ongeveer 24 dagen.

Er is een time-out opgetreden.

Opmerkingen

De statische Split(String, String, RegexOptions, TimeSpan) methoden zijn gelijk aan het maken van een Regex object met het opgegeven reguliere expressiepatroon en het aanroepen van de instantiemethode Split(String).

De Regex.Split-methoden zijn vergelijkbaar met de Split(Char[]) methode, behalve dat Regex.Split de tekenreeks splitst op een scheidingsteken dat wordt bepaald door een reguliere expressie in plaats van een set tekens. Als het reguliere expressiepatroon haakjes bevat, wordt de vastgelegde tekst opgenomen in de resulterende tekenreeksmatrix. Als het patroon haakjes bevat, wordt alle vastgelegde tekst opgenomen in de resulterende tekenreeksmatrix, maar wordt deze niet meegeteld bij het bepalen of de limiet voor het aantal is bereikt.

Als er twee aangrenzende overeenkomsten worden gevonden, wordt er een lege tekenreeks in de matrix geplaatst.

Als u opgeeft RightToLeft voor de options parameter, begint de zoekopdracht naar overeenkomsten aan het einde van de invoertekenreeks en gaat u naar links.

De matchTimeout parameter geeft aan hoe lang een patroonkoppelingsmethode moet proberen een overeenkomst te vinden voordat er een time-out optreedt. matchTimeout Hiermee wordt een standaardtime-outwaarde overschreven die is gedefinieerd voor het toepassingsdomein waarin de methode wordt uitgevoerd.

Notities voor bellers

U wordt aangeraden de matchTimeout parameter in te stellen op een geschikte waarde, zoals twee seconden. Als u time-outs uitschakelt door op te InfiniteMatchTimeoutgeven, biedt de reguliere expressie-engine iets betere prestaties. Schakel echter alleen time-outs uit onder de volgende voorwaarden:

  • Wanneer de invoer die door een reguliere expressie wordt verwerkt, wordt afgeleid van een bekende en vertrouwde bron of bestaat uit statische tekst. Dit sluit tekst uit die dynamisch door gebruikers is ingevoerd.

  • Wanneer het reguliere expressiepatroon grondig is getest om ervoor te zorgen dat er efficiënt overeenkomsten, niet-overeenkomsten en bijna-overeenkomsten worden verwerkt.

  • Wanneer het reguliere expressiepatroon geen taalelementen bevat die bekend zijn dat ze overmatige backtracking veroorzaken bij het verwerken van een bijna-overeenkomst.

Zie ook

Van toepassing op

Split(String, String, RegexOptions)

Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs

Splitst een invoertekenreeks in een matrix met subtekenreeksen op de posities die zijn gedefinieerd door een opgegeven patroon voor reguliere expressies. Opgegeven opties wijzigen de overeenkomende bewerking.

public:
 static cli::array <System::String ^> ^ Split(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);
public static string[] Split(string input, string pattern, System.Text.RegularExpressions.RegexOptions options);
static member Split : string * string * System.Text.RegularExpressions.RegexOptions -> string[]
Public Shared Function Split (input As String, pattern As String, options As RegexOptions) As String()

Parameters

input
String

De tekenreeks die moet worden gesplitst.

pattern
String

Het reguliere expressiepatroon dat moet overeenkomen.

options
RegexOptions

Een bitsgewijze combinatie van de opsommingswaarden die opties bieden voor overeenkomende waarden.

Retouren

String[]

Een array van tekenreeksen.

Uitzonderingen

Er is een reguliere expressieparseringsfout opgetreden.

input of pattern is null.

options is geen geldige bitsgewijze combinatie van RegexOptions waarden.

Er is een time-out opgetreden.

Opmerkingen

De statische Split(String, String, RegexOptions) methoden zijn gelijk aan het maken van een Regex object met het opgegeven reguliere expressiepatroon en het aanroepen van de instantiemethode Split(String).

De Regex.Split-methoden zijn vergelijkbaar met de Split(Char[]) methode, behalve dat Regex.Split de tekenreeks splitst op een scheidingsteken dat wordt bepaald door een reguliere expressie in plaats van een set tekens. Als het reguliere expressiepatroon haakjes bevat, wordt de vastgelegde tekst opgenomen in de resulterende tekenreeksmatrix. Als het patroon haakjes bevat, wordt alle vastgelegde tekst opgenomen in de resulterende tekenreeksmatrix, maar wordt deze niet meegeteld bij het bepalen of de limiet voor het aantal is bereikt.

Als er twee aangrenzende overeenkomsten worden gevonden, wordt er een lege tekenreeks in de matrix geplaatst.

Als u opgeeft RightToLeft voor de options parameter, begint de zoekopdracht naar overeenkomsten aan het einde van de invoertekenreeks en gaat u naar links.

Notities voor bellers

Deze methode treedt op na een interval dat gelijk is aan de standaardtime-outwaarde van het toepassingsdomein waarin de methode wordt aangeroepen. Als er geen time-outwaarde is gedefinieerd voor het toepassingsdomein, wordt de waarde InfiniteMatchTimeout, waardoor er geen time-out optreedt voor de methode, gebruikt. De aanbevolen statische methode voor het splitsen van tekst in een patroonovereenkomst is Split(String, String, RegexOptions, TimeSpan), waarmee u het time-outinterval kunt instellen.

Zie ook

Van toepassing op

Split(String, Int32, Int32)

Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs

Splitst een invoertekenreeks een opgegeven maximum aantal keren in een matrix met subtekenreeksen, op de posities die zijn gedefinieerd door een reguliere expressie die is opgegeven in de Regex constructor. Het zoeken naar het reguliere expressiepatroon begint op een opgegeven tekenpositie in de invoertekenreeks.

public:
 cli::array <System::String ^> ^ Split(System::String ^ input, int count, int startat);
public string[] Split(string input, int count, int startat);
member this.Split : string * int * int -> string[]
Public Function Split (input As String, count As Integer, startat As Integer) As String()

Parameters

input
String

De tekenreeks die moet worden gesplitst.

count
Int32

Het maximum aantal keren dat de splitsing kan optreden.

startat
Int32

De tekenpositie in de invoertekenreeks waar de zoekopdracht begint.

Retouren

String[]

Een array van tekenreeksen.

Uitzonderingen

input is null.

startat is kleiner dan nul of groter dan de lengte van input.

Er is een time-out opgetreden.

Opmerkingen

startatZie de sectie Opmerkingen van Match(String, Int32).

Als haakjes worden vastgelegd in de expressie, wordt alle vastgelegde tekst opgenomen in de resulterende tekenreeksmatrix, maar wordt deze niet meegeteld voor de count limiet.

Lege tekenreeksen die het resultaat zijn van aangrenzende overeenkomsten worden geteld bij het bepalen of het aantal overeenkomsten is bereikt count.

Zie ook

Van toepassing op

Split(String, String)

Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs

Splitst een invoertekenreeks in een matrix met subtekenreeksen op de posities die zijn gedefinieerd door een normaal expressiepatroon.

public:
 static cli::array <System::String ^> ^ Split(System::String ^ input, System::String ^ pattern);
public static string[] Split(string input, string pattern);
static member Split : string * string -> string[]
Public Shared Function Split (input As String, pattern As String) As String()

Parameters

input
String

De tekenreeks die moet worden gesplitst.

pattern
String

Het reguliere expressiepatroon dat moet overeenkomen.

Retouren

String[]

Een array van tekenreeksen.

Uitzonderingen

Er is een reguliere expressieparseringsfout opgetreden.

input of pattern is null.

Er is een time-out opgetreden.

Opmerkingen

De statische Split(String, String) methoden zijn gelijk aan het maken van een Regex object met het opgegeven reguliere expressiepatroon en het aanroepen van de instantiemethode Split(String).

De Regex.Split-methoden zijn vergelijkbaar met de Split(Char[]) methode, behalve dat Regex.Split de tekenreeks splitst op een scheidingsteken dat wordt bepaald door een reguliere expressie in plaats van een set tekens. Als het reguliere expressiepatroon haakjes bevat, wordt de vastgelegde tekst opgenomen in de resulterende tekenreeksmatrix. Als het patroon haakjes bevat, wordt alle vastgelegde tekst opgenomen in de resulterende tekenreeksmatrix, maar wordt deze niet meegeteld bij het bepalen of de limiet voor het aantal is bereikt.

Als er twee aangrenzende overeenkomsten worden gevonden, wordt er een lege tekenreeks in de matrix geplaatst.

Notities voor bellers

Deze methode treedt op na een interval dat gelijk is aan de standaardtime-outwaarde van het toepassingsdomein waarin de methode wordt aangeroepen. Als er geen time-outwaarde is gedefinieerd voor het toepassingsdomein, wordt de waarde InfiniteMatchTimeout, waardoor er geen time-out optreedt voor de methode, gebruikt. De aanbevolen statische methode voor het splitsen van tekst in een patroonovereenkomst is Split(String, String, RegexOptions, TimeSpan), waarmee u het time-outinterval kunt instellen.

Zie ook

Van toepassing op

Split(String)

Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs

Splitst een invoertekenreeks in een matrix met subtekenreeksen op de posities die zijn gedefinieerd door een normaal expressiepatroon dat is opgegeven in de Regex constructor.

public:
 cli::array <System::String ^> ^ Split(System::String ^ input);
public string[] Split(string input);
member this.Split : string -> string[]
Public Function Split (input As String) As String()

Parameters

input
String

De tekenreeks die moet worden gesplitst.

Retouren

String[]

Een array van tekenreeksen.

Uitzonderingen

input is null.

Er is een time-out opgetreden.

Opmerkingen

De Regex.Split-methoden zijn vergelijkbaar met de Split(Char[]) methode, behalve dat Regex.Split de tekenreeks splitst op een scheidingsteken dat wordt bepaald door een reguliere expressie in plaats van een set tekens. De tekenreeks wordt zo vaak mogelijk gesplitst. Als er geen overeenkomst wordt gevonden, bevat de retourwaarde één element waarvan de waarde de oorspronkelijke invoertekenreeks is.

Als de reguliere expressie overeenkomt met de lege tekenreeks, Split(String) wordt de tekenreeks gesplitst in een matrix met tekenreeksen met één teken, omdat het lege tekenreeksscheidingsteken op elke locatie kan worden gevonden.

Als haakjes worden vastgelegd in de expressie, wordt alle vastgelegde tekst opgenomen in de resulterende tekenreeksmatrix.

Als er twee aangrenzende overeenkomsten worden gevonden, wordt er een lege tekenreeks in de matrix geplaatst.

Zie ook

Van toepassing op

Split(String, Int32)

Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs
Bron:
Regex.Split.cs

Splitst een invoertekenreeks een opgegeven maximum aantal keren in een matrix met subtekenreeksen, op de posities die zijn gedefinieerd door een reguliere expressie die is opgegeven in de Regex constructor.

public:
 cli::array <System::String ^> ^ Split(System::String ^ input, int count);
public string[] Split(string input, int count);
member this.Split : string * int -> string[]
Public Function Split (input As String, count As Integer) As String()

Parameters

input
String

De tekenreeks die moet worden gesplitst.

count
Int32

Het maximum aantal keren dat de splitsing kan optreden.

Retouren

String[]

Een array van tekenreeksen.

Uitzonderingen

input is null.

Er is een time-out opgetreden.

Opmerkingen

De Regex.Split-methoden zijn vergelijkbaar met Split(Char[]). De count parameter geeft het maximum aantal subtekenreeksen op waarin de invoertekenreeks kan worden gesplitst. De laatste tekenreeks bevat de rest van de splitsing van de tekenreeks. Een count waarde van nul biedt het standaardgedrag om zo vaak mogelijk te splitsen.

Als haakjes worden vastgelegd in de expressie, wordt alle vastgelegde tekst opgenomen in de resulterende tekenreeksmatrix, maar wordt deze niet meegeteld voor de count limiet.

Lege tekenreeksen die het resultaat zijn van aangrenzende overeenkomsten worden geteld bij het bepalen of het aantal overeenkomsten is bereikt count.

Zie ook

Van toepassing op