C# String.Split() – Examples
String.Split() method is used to split a string into a maximum number of substrings based on a specified delimiting character and, optionally, options. Splits a string into a maximum number of substrings based on the provided character separator, optionally omitting empty substrings from the result.
In this tutorial, we will learn about the syntax and examples for the following variants of C# String.Split() method based on the set of parameters.
- String.Split(separator, count, options)
- String.Split(separator, options)
- String.Split(separators)
- String.Split(separators, count)
- String.Split(separators, count, options)
- String.Split(separators, options)
- String.Split(separator, count, options)
- String.Split(separator, options)
- String.Split(separators, count, options)
- String.Split(separators, options)
Split(separator, count, options)
String.Split(separator, count, options) splits this string into a maximum of count number of substrings based on a specified delimiting character separator and, optionally, options.
Empty substrings would be emitted from the result.
Syntax
The syntax of Split() method with separator, count and options as parameters is
String.Split(char separator, int count, StringSplitOptions options = System.StringSplitOptions.None)
where
| Parameter | Description |
|---|---|
| separator | [Mandatory] The delimiter character to split the given string. |
| count | [Mandatory] The maximum number of elements expected in the resulting array. |
| options | [Optional] Options that specify whether to trim substrings and include empty substrings. Possible values are:1. System.StringSplitOptions.None2. System.StringSplitOptions.TrimEntries3. System.StringSplitOptions.RemoveEmptyEntries |
Return Value
This method returns String Array.
Example 1 – Split(separator, count, options)
In this example, we will take a string and split it using separator character '-' into maximum of 3 splits with an option to trim substrings.
C# Program
using System;
class Example {
static void Main(string[] args) {
String str = "ab- c - def-gh-ijk";
Char separator = '-';
Int32 count = 3;
StringSplitOptions options = System.StringSplitOptions.TrimEntries;
String[] result = str.Split(separator, count, options);
for (int i = 0; i < result.Length; i++) {
Console.WriteLine(result[i]);
}
}
} Output
ab c def-gh-ijk
Example 2 – Split(separator, count, options)
If the count is greater than the possible number of splits, then the resulting array consists of only the possible splits whose number is less than the given count.
C# Program
using System;
class Example {
static void Main(string[] args) {
String str = "ab- c - def-gh-ijk";
Char separator = '-';
Int32 count = 100;
StringSplitOptions options = System.StringSplitOptions.TrimEntries;
String[] result = str.Split(separator, count, options);
Console.WriteLine(result);
for (int i = 0; i < result.Length; i++) {
Console.WriteLine(result[i]);
}
}
} Output
ab c def gh ijk
Split(separator, options)
String.Split(separator) splits a string into substrings based on a specified delimiting character and, optionally, options.
Syntax
The syntax of Split() method with separator and options as parameters is
String.Split(Char separator, StringSplitOptions options)
where
| Parameter | Description |
|---|---|
| separator | [Mandatory] The character that separates the substrings in this string. |
| options | [Optional] Options that specify whether to trim substrings and include empty substrings. Possible values are:1. System.StringSplitOptions.None2. System.StringSplitOptions.TrimEntries3. System.StringSplitOptions.RemoveEmptyEntries |
Return Value
This method returns String Array.
Example 3 – Split(separator, options)
In this example, we will take a string and split it using separator character '-' with an option to trim substrings.
C# Program
using System;
class Example {
static void Main(string[] args) {
String str = "ab- c - def-gh-ijk";
Char separator = '-';
StringSplitOptions options = System.StringSplitOptions.TrimEntries;
String[] result = str.Split(separator, options);
for (int i = 0; i < result.Length; i++) {
Console.WriteLine(result[i]);
}
}
} Output
ab c def gh ijk
Example 4 – Split(separator, options) – No options parameter
options parameter is optional. In the following program, we do not pass any argument for options parameter.
C# Program
using System;
class Example {
static void Main(string[] args) {
String str = "ab- c - def-gh-ijk";
Char separator = '-';
String[] result = str.Split(separator);
for (int i = 0; i < result.Length; i++) {
Console.WriteLine(result[i]);
}
}
} Output
ab c def gh ijk
Split(separators)
String.Split(separators) splits a string into substrings based on specified delimiting characters in separators char array.
Syntax
The syntax of Split() method with char array of separators is
String.Split(Char[] separators)
where
| Parameter | Description |
|---|---|
| separators | [Mandatory] An array of delimiting characters. |
If separators is empty char array or null, then the split happens based on white space characters as delimiters.
Return Value
This method returns String Array.
Example 5 – Split(separators)
In this example, we will take a string and split it with two delimiters '-' and '*'.
C# Program
using System;
class Example {
static void Main(string[] args) {
String str = "ab- c * def*gh-ijk";
Char[] separators = {'-', '*'};
String[] result = str.Split(separators);
for (int i = 0; i < result.Length; i++) {
Console.WriteLine(result[i]);
}
}
} Output
ab c def gh ijk
Example 6 – Split(separators) – separators is null
In this example, we will take a string and split it with two delimiters '-' and '*'.
C# Program
using System;
class Example {
static void Main(string[] args) {
String str = "ab- c * def*gh-ijk";
Char[] separators = null;
String[] result = str.Split(separators);
for (int i = 0; i < result.Length; i++) {
Console.WriteLine(result[i]);
}
}
} Output
ab- c * def*gh-ijk
Split(separators, count)
String.Split(separators, count) splits a string into a maximum count number of substrings based on specified separators.
Syntax
The syntax of Split() method with separators char array and count as paramters is
String.Split(Char[] separators, Int32 count)
where
| Parameter | Description |
|---|---|
| separators | [Mandatory] An array of delimiting characters. |
| count | [Mandatory] The maximum number of substrings to return. |
Return Value
This method returns String Array.
Example 7 – Split(separators, count)
In this example, we will
C# Program
using System;
class Example {
static void Main(string[] args) {
String str = "ab-c*def*gh-ijk";
Char[] separators = {'-', '*'};
Int32 count = 4;
String[] result = str.Split(separators, count);
for (int i = 0; i < result.Length; i++) {
Console.WriteLine(result[i]);
}
}
} Output
ab c def gh-ijk
Split(separators, count, options)
String.Split(separators, count, options) splits a string into a maximum count number of substrings based on specified delimiting characters separators and, optionally, options.
Syntax
The syntax of Split() method with separators, count and options as parameters is
String.Split(Char[] separators, Int32 count, StringSplitOptions options)
where
| Parameter | Description |
|---|---|
| separators | [Mandatory] An array of delimiting characters. |
| count | [Mandatory] The maximum number of substrings to return. |
| options | [Optional] Options that specify whether to trim substrings and include empty substrings. Possible values are:1. System.StringSplitOptions.None2. System.StringSplitOptions.TrimEntries3. System.StringSplitOptions.RemoveEmptyEntries |
Return Value
This method returns String Array.
Example 8 – Split(separators, count, options)
In this example, we will take a string and split it using separator characters '-' and '*' into maximum of 3 splits with an option to trim substrings.
C# Program
using System;
class Example {
static void Main(string[] args) {
String str = "ab-c* def*gh-ijk";
Char[] separators = {'-', '*'};
Int32 count = 3;
StringSplitOptions options = System.StringSplitOptions.TrimEntries;
String[] result = str.Split(separators, count, options);
for (int i = 0; i < result.Length; i++) {
Console.WriteLine(result[i]);
}
}
} Output
ab c def*gh-ijk
Split(separators, options)
String.Split(separators, options) splits a string into substrings based on specified delimiting characters separators and options whether to remove empty entries or trim the substrings.
Syntax
The syntax of Split() method with separators char array and options as parameters is
String.Split(Char[] separators, StringSplitOptions options)
where
| Parameter | Description |
|---|---|
| separators | [Mandatory] An array of delimiting characters. |
| options | [Optional] Options that specify whether to trim substrings and include empty substrings. Possible values are:1. System.StringSplitOptions.None2. System.StringSplitOptions.TrimEntries3. System.StringSplitOptions.RemoveEmptyEntries |
Return Value
This method returns String Array.
Example 9 – Split(separators, options)
In this example, we will take a string and slit it based on multiple delimiting characters '-', '*' with option to trim substrings.
C# Program
using System;
class Example {
static void Main(string[] args) {
String str = "ab-c* def*gh-ijk";
Char[] separators = {'-', '*'};
StringSplitOptions options = System.StringSplitOptions.TrimEntries;
String[] result = str.Split(separators, options);
for (int i = 0; i < result.Length; i++) {
Console.WriteLine(result[i]);
}
}
} Output
ab c def gh ijk
Split(separator, count, options)
String.Split(separator, count, options) splits a string into a maximum count number of substrings based on a specified delimiting separator string and, optionally, options.
Syntax
The syntax of Split() method with separator string, maximum count and options as parameters is
String.Split(String separator, Int32 count, StringSplitOptions options)
where
| Parameter | Description |
|---|---|
| separator | [Mandatory] The delimiter string to split the given string. |
| count | [Mandatory] The maximum number of elements expected in the resulting array. |
| options | [Optional] Options that specify whether to trim substrings and include empty substrings. Possible values are:1. System.StringSplitOptions.None2. System.StringSplitOptions.TrimEntries3. System.StringSplitOptions.RemoveEmptyEntries |
Return Value
This method returns String Array.
Example 10 – Split(separator, count, options)
In this example, we will take a string and split it using separator string "mm" into maximum of 3 splits with an option to trim substrings.
C# Program
using System;
class Example {
static void Main(string[] args) {
String str = "abmmcmmdefmmghmmijk";
String separator = "mm";
Int32 count = 3;
StringSplitOptions options = System.StringSplitOptions.TrimEntries;
String[] result = str.Split(separator, count, options);
for (int i = 0; i < result.Length; i++) {
Console.WriteLine(result[i]);
}
}
} Output
ab c defmmghmmijk
Split(separator, options)
String.Split(separator, options) splits a string into substrings that are based on the provided string separator and optionally, options.
Syntax
The syntax of Split() method separator String and options as parameters is
String.Split(String separator, StringSplitOptions options)
where
| Parameter | Description |
|---|---|
| separator | [Mandatory] The delimiter string to split the given string. |
| options | [Optional] Options that specify whether to trim substrings and include empty substrings. Possible values are:1. System.StringSplitOptions.None2. System.StringSplitOptions.TrimEntries3. System.StringSplitOptions.RemoveEmptyEntries |
Return Value
This method returns String Array.
Example 11 – Split(separator, options)
In this example, we will take a string and split it using separator string "mm" with an option to trim substrings.
C# Program
using System;
class Example {
static void Main(string[] args) {
String str = "abmmcmm defmmghmmijk";
String separator = "mm";
StringSplitOptions options = System.StringSplitOptions.TrimEntries;
String[] result = str.Split(separator, options);
for (int i = 0; i < result.Length; i++) {
Console.WriteLine(result[i]);
}
}
} Output
ab c def gh ijk
Split(separators, count, options)
String.Split(separator, count, options) splits a string into a maximum count number of substrings based on specified delimiting strings in the string array separators and, optionally, options.
Syntax
The syntax of Split() method with separators String Array, maximum number of splits, and options is
String.Split(String[] separators, Int32 count, StringSplitOptions options)
where
| Parameter | Description |
|---|---|
| separators | [Mandatory] An array of delimiting characters. |
| count | [Mandatory] The maximum number of elements expected in the resulting array. |
| options | [Optional] Options that specify whether to trim substrings and include empty substrings. Possible values are:1. System.StringSplitOptions.None2. System.StringSplitOptions.TrimEntries3. System.StringSplitOptions.RemoveEmptyEntries |
Return Value
This method returns String Array.
Example 12 – Split(separators, count, options)
In this example, we will take a string and split it using separator strings "mm" and "--" into maximum of 4 splits with an option to trim substrings.
C# Program
using System;
class Example {
static void Main(string[] args) {
String str = "ab--cmm defmmghmmijk";
String[] separators = {"mm", "--"};
Int32 count = 4;
StringSplitOptions options = System.StringSplitOptions.TrimEntries;
String[] result = str.Split(separators, count, options);
for (int i = 0; i < result.Length; i++) {
Console.WriteLine(result[i]);
}
}
} Output
ab c def ghmmijk
Split(separators, options)
String.Split(separators, options) splits a string into substrings based on a specified delimiting strings separators and, optionally, options.
Syntax
The syntax of Split() method with separators String array and options as parameters is
String.Split(String[] separators, StringSplitOptions options)
where
| Parameter | Description |
|---|---|
| separators | [Mandatory] An array of delimiting characters. |
| options | [Optional] Options that specify whether to trim substrings and include empty substrings. Possible values are:1. System.StringSplitOptions.None2. System.StringSplitOptions.TrimEntries3. System.StringSplitOptions.RemoveEmptyEntries |
Return Value
This method returns String Array.
Example 13 – Split(separators, options)
In this example, we will take a string and split it using separator strings "mm" and "--" with an option to trim substrings.
C# Program
using System;
class Example {
static void Main(string[] args) {
String str = "ab--cmm defmmghmmijk";
String[] separators = {"mm", "--"};
StringSplitOptions options = System.StringSplitOptions.TrimEntries;
String[] result = str.Split(separators, options);
for (int i = 0; i < result.Length; i++) {
Console.WriteLine(result[i]);
}
}
} Output
ab c def gh ijk
Conclusion
In this C# Tutorial, we have learnt the syntax of C# String.Split() method, and also learnt how to use this method with the help of C# example programs.