Como separar cadeias de caracteres usando String.Split em C#

2025-06-27

O String.Split método cria uma matriz de substrings dividindo a string de entrada com base em um ou mais delimitadores. Este método geralmente é a forma mais fácil de separar uma string nos limites de palavras.

Nota

Os exemplos de C# neste artigo são executados no executor de código embutido e playground Try.NET. Selecione o botão Executar para executar um exemplo em uma janela interativa. Depois de executar o código, você pode modificá-lo e executar o código modificado selecionando Executar novamente. O código modificado é executado na janela interativa ou, se a compilação falhar, a janela interativa exibe todas as mensagens de erro do compilador C#.

Sugestão

Você pode usar a assistência de IA para dividir uma cadeia de caracteres.

Dividir uma cadeia de caracteres em palavras

O código a seguir divide uma frase comum em uma matriz de cadeias de caracteres para cada palavra.

string phrase = "The quick brown fox jumps over the lazy dog.";
string[] words = phrase.Split(' ');

foreach (var word in words)
{
    Console.WriteLine($"<{word}>");
}

Cada instância de um caractere separador produz um valor na matriz retornada. Como as matrizes em C# são indexadas a zero, cada cadeia de caracteres na matriz é indexada de 0 ao valor retornado pela Array.Length propriedade menos 1:

string phrase = "The quick brown fox jumps over the lazy dog.";
string[] words = phrase.Split(' ');

for (int i = 0; i < words.Length; i++)
{
    Console.WriteLine($"Index {i}: <{words[i]}>");
}

O String.Split tem muitas sobrecargas. Essas sobrecargas personalizam o comportamento para dividir cadeias de caracteres:

Você pode especificar separadores como char valores ou string valores.
Você pode especificar um separador ou vários separadores. Se você especificar vários separadores, todos eles deverão ser do mesmo tipo (ou charstring).
Você pode especificar o número máximo de substrings a serem retornadas.
Você pode especificar se os caracteres separadores repetidos são ignorados ou produzir substrings vazias no valor de retorno.
Você pode especificar se o espaço em branco à esquerda e à direita será removido das substrings retornadas.

Os exemplos restantes usam sobrecargas diferentes para mostrar cada um desses comportamentos.

Especificar vários separadores

String.Split Pode usar vários caracteres separadores. O exemplo a seguir usa espaços, vírgulas, pontos, dois pontos e tabulações como caracteres de separação, que são passados para Split em uma matriz. O loop na parte inferior do código exibe cada uma das palavras na matriz retornada.

char[] delimiterChars = [' ', ',', '.', ':', '\t'];

string text = "one\ttwo three:four,five six seven";
Console.WriteLine($"Original text: '{text}'");

string[] words = text.Split(delimiterChars);
Console.WriteLine($"{words.Length} words in text:");

foreach (var word in words)
{
    Console.WriteLine($"<{word}>");
}

Instâncias consecutivas de qualquer separador produzem a cadeia de caracteres vazia na matriz de saída:

char[] delimiterChars = [' ', ',', '.', ':', '\t'];

string text = "one\ttwo :,five six seven";
Console.WriteLine($"Original text: '{text}'");

string[] words = text.Split(delimiterChars);
Console.WriteLine($"{words.Length} words in text:");

foreach (var word in words)
{
    Console.WriteLine($"<{word}>");
}

String.Split pode usar uma matriz de cadeias de caracteres (sequências de caracteres que atuam como separadores para analisar a cadeia de caracteres de destino, em vez de caracteres únicos).

string[] separatingStrings = ["<<", "..."];

string text = "one<<two......three<four";
Console.WriteLine($"Original text: '{text}'");

string[] words = text.Split(separatingStrings, StringSplitOptions.RemoveEmptyEntries);
Console.WriteLine($"{words.Length} substrings in text:");

foreach (var word in words)
{
    Console.WriteLine(word);
}

Limitar o tamanho da saída

O exemplo a seguir mostra como limitar a saída para as quatro primeiras substrings na cadeia de caracteres de origem.

string phrase = "The quick brown fox jumps over the lazy dog.";
string[] words = phrase.Split(' ', 4, StringSplitOptions.None);

foreach (var word in words)
{
    Console.WriteLine($"<{word}>");
}

Remover substrings vazias

Caracteres separadores consecutivos produzem a cadeia de caracteres vazia como um valor na matriz retornada. Você pode ver como uma cadeia de caracteres vazia é criada no exemplo a seguir, que usa o caractere de espaço como um separador.

string phrase = "The quick brown    fox     jumps over the lazy dog.";
string[] words = phrase.Split(' ');

foreach (var word in words)
{
    Console.WriteLine($"<{word}>");
}

Esse comportamento facilita para formatos como arquivos CSV (valores separados por vírgula) que representam dados tabulares. As vírgulas consecutivas representam uma coluna em branco.

Você pode passar um parâmetro opcional StringSplitOptions.RemoveEmptyEntries para excluir quaisquer cadeias de caracteres vazias na matriz retornada. Para um processamento mais complicado da coleção retornada, você pode usar o LINQ para manipular a sequência de resultados.

Cortar espaço em branco

O exemplo a seguir mostra o efeito de cortar entradas:

string numerals = "1, 2, 3, 4, 5, 6, 7, 8, 9, 10";
string[] words = numerals.Split(',', StringSplitOptions.TrimEntries);

Console.WriteLine("Trimmed entries:");
foreach (var word in words)
{
    Console.WriteLine($"<{word}>");
}
words = numerals.Split(',', StringSplitOptions.None);
Console.WriteLine("Untrimmed entries:");
foreach (var word in words)
{
    Console.WriteLine($"<{word}>");
}

As entradas não cortadas têm espaço em branco extra antes dos algarismos.

Usar IA para dividir uma cadeia de caracteres

Você pode usar ferramentas de IA, como o GitHub Copilot, para gerar código para dividir cadeias de caracteres usando String.Split em C#. Você pode personalizar o prompt para usar cadeias de caracteres e delimitadores de acordo com suas necessidades.

O texto a seguir mostra um exemplo de prompt para o Copilot Chat:

Generate C# code to use Split.String to split a string into substrings.
Input string is "You win some. You lose some." Delimiters are space and period.
Provide example output.

O GitHub Copilot é alimentado por IA, então surpresas e erros são possíveis. Para obter mais informações, consulte Copilot FAQs.

Partilhar via