C# string e StringBuilder

Esta é a página de consulta dos textos no C#: todos os métodos de string que você vai usar no dia a dia e os do StringBuilder, cada um com exemplo e resultado. Para aprender com calma, veja as aulas Strings, Métodos de String, Interpolação e StringBuilder.

Os resultados vêm dos programas desta página, rodados no dotnet 10.0.112 da máquina da Ana (pasta ~/cs/str, cultura pt-BR) e no editor do guia, que deram a mesma saída (a não ser numa linha do rastro de uma exceção, indicada abaixo).

Atalhos: A string não muda · Métodos de string · Métodos de string. · Comparar e ordenar · char · StringBuilder · string ou StringBuilder? · Quando dá errado · Experimente

Antes de tudo: a string não muda

Nenhum método de string muda o texto original. ToUpper, Trim, Replace e todos os outros devolvem uma string nova. Se você não guardar o resultado, ele se perde:

string nome = "ana";
nome.ToUpper();
Console.WriteLine(nome);
nome = nome.ToUpper();
Console.WriteLine(nome);

$ dotnet run imut.cs
ana
ANA

A linha 2 criou "ANA" e jogou fora; só a linha 4, que guarda o resultado em nome, mudou o que a variável mostra. Essa regra (a string é imutável) é o motivo de existir o StringBuilder, no fim desta página.

Métodos de string

Este programa usa os métodos mais comuns. Cada linha da saída começa com o número da linha da tabela:

// metodos.cs — os métodos de string mais usados
string s = "  Ana Maria da Silva  ";
string nome = "Ana Maria";
Console.WriteLine($"1  [{s.Trim()}] [{s.TrimStart()}] [{s.TrimEnd()}]");
Console.WriteLine($"2  {nome.Length} {nome[0]} {nome[^1]} {nome[4..9]}");
Console.WriteLine($"3  {nome.ToUpper()} {nome.ToLower()} {"ação".ToUpper()}");
Console.WriteLine($"4  {nome.Contains("Maria")} {nome.Contains("maria")} {nome.Contains("maria", StringComparison.OrdinalIgnoreCase)}");
Console.WriteLine($"5  {nome.StartsWith("Ana")} {nome.EndsWith("ia")} {nome.IndexOf('a')} {nome.LastIndexOf('a')} {nome.IndexOf("Maria")} {nome.IndexOf("José")}");
Console.WriteLine($"6  {nome.Substring(4)} | {nome.Substring(0, 3)} | {nome.Replace("Maria", "Clara")} | {nome.Replace('a', 'o')}");
Console.WriteLine($"7  {nome.Insert(3, " Paula")} | {nome.Remove(3)} | {nome.Remove(0, 4)}");
Console.WriteLine($"8  [{"7".PadLeft(3, '0')}] [{"Ana".PadRight(6)}] [{"Ana".PadLeft(6)}]");
string[] partes = "arroz,feijão,,ovos".Split(',');
Console.WriteLine($"9  {partes.Length} [{string.Join("|", partes)}]");
string[] limpas = "arroz, feijão,, ovos".Split(',', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
Console.WriteLine($"10 {limpas.Length} [{string.Join("|", limpas)}]");
Console.WriteLine($"11 {string.Concat("a", "b", "c")} {string.Join(", ", ["x", "y", "z"])} {string.Format("{0} tem {1} anos", "Ana", 29)} {new string('-', 5)}");
Console.WriteLine($"12 {string.IsNullOrEmpty("")} {string.IsNullOrEmpty(" ")} {string.IsNullOrWhiteSpace(" ")} {string.IsNullOrWhiteSpace(null)}");
Console.WriteLine($"13 {"ana" == "Ana"} {"ana".Equals("Ana", StringComparison.OrdinalIgnoreCase)} {string.Compare("abacate", "banana")} {string.Compare("b", "a")} {"a".CompareTo("a")}");
char[] letras = nome.ToCharArray();
Array.Reverse(letras);
Console.WriteLine($"14 {new string(letras)} {string.Join("-", nome.Split(' '))} {nome.Count(c => c == 'a')}");
Console.WriteLine($"15 {"maçã".Length} {"🍎".Length} {"olá"[2]} {(int)'á'} {char.IsLetter('á')} {char.IsDigit('7')} {char.ToUpper('é')}");
Console.WriteLine($"16 {"Olá".PadRight(5, '.')}{"Mundo"} {"abc".IndexOfAny(['x', 'b'])} {"a-b-c".Split('-', 2)[1]}");

$ dotnet run metodos.cs
1  [Ana Maria da Silva] [Ana Maria da Silva  ] [  Ana Maria da Silva]
2  9 A a Maria
3  ANA MARIA ana maria AÇÃO
4  True False True
5  True True 2 8 4 -1
6  Maria | Ana | Ana Clara | Ano Morio
7  Ana Paula Maria | Ana | Maria
8  [007] [Ana   ] [   Ana]
9  4 [arroz|feijão||ovos]
10 3 [arroz|feijão|ovos]
11 abc x, y, z Ana tem 29 anos -----
12 True False True True
13 False True -1 1 0
14 airaM anA Ana-Maria 3
15 4 2 á 225 True True É
16 Olá..Mundo 1 b-c

Nas tabelas, nome é "Ana Maria" e s é " Ana Maria da Silva " (com dois espaços nas pontas).

Tamanho, posições e pedaços

Repare no IndexOf('a'): o A maiúsculo da posição 0 não conta. Maiúsculas e minúsculas são caracteres diferentes.

Procurar

Aula: Métodos de String. Para procurar padrões (um CPF, um e-mail), veja Expressões Regulares.

Transformar (sempre devolvem uma string nova)

Aulas: Métodos de String e, para alinhar números, Formatar Números.

Cortar e juntar

Métodos de string. (chamados pelo tipo)

Comparar e ordenar

// comparar.cs — comparar e ordenar textos
string[] nomes = ["bruno", "Ana", "álvaro", "Carla", "ana"];
Console.WriteLine(string.Join(" ", nomes.Order()));
Console.WriteLine(string.Join(" ", nomes.Order(StringComparer.Ordinal)));
Console.WriteLine($"{string.Compare("a", "B")} {string.Compare("a", "B", StringComparison.Ordinal)}");
Console.WriteLine($"{"Ana".Equals("ana")} {string.Equals("Ana", "ana", StringComparison.OrdinalIgnoreCase)}");

$ dotnet run comparar.cs
álvaro ana Ana bruno Carla
Ana Carla ana bruno álvaro
-1 31
False True

Na ordem do dicionário (a primeira linha da saída), álvaro fica junto dos a, e ana vem antes de Ana. Na ordem Ordinal (a segunda), as maiúsculas vêm primeiro e o á vai para o fim. Use a cultura para mostrar listas para pessoas e Ordinal para comparar códigos, nomes de arquivo e chaves. Aula: Cultura.

O tipo char

Aula: char e bool.

StringBuilder

O StringBuilder (de System.Text) é um texto que muda: cada Append acrescenta no mesmo objeto, sem criar uma string nova. É o certo para montar um texto em muitos pedaços, num laço.

// sb.cs — StringBuilder
using System.Text;

StringBuilder sb = new();
sb.Append("Lista de compras");
sb.AppendLine(":");
foreach (string item in new[] { "arroz", "feijão", "café" })
{
    sb.Append("- ").AppendLine(item);
}
sb.AppendLine($"Total: {3} itens");
Console.Write(sb.ToString());
Console.WriteLine($"Length: {sb.Length}");

sb.Clear();
sb.Append("Ana");
sb.Insert(0, "Sra. ");
sb.Append('!', 3);
sb.Replace("Ana", "Ana Maria");
Console.WriteLine(sb);
sb.Remove(0, 5);
Console.WriteLine(sb);
sb[0] = 'a';
Console.WriteLine($"{sb} {sb.Length} {sb[0]}");

$ dotnet run sb.cs
Lista de compras:
- arroz
- feijão
- café
Total: 3 itens
Length: 57
Sra. Ana Maria!!!
Ana Maria!!!
ana Maria!!! 12 a

string ou StringBuilder?

Quando dá errado

Experimente

string nome = "  ana  ";
nome.Trim();
nome.ToUpper();
Console.WriteLine($"[{nome}]");

string nome = "  ana  ";
nome = nome.Trim();
nome = nome.ToUpper();
Console.WriteLine($"[{nome}]");

string frase = "  A Ana ama arroz com feijão  ";
Console.WriteLine($"[{frase.Trim()}]");
Console.WriteLine(frase.Trim().ToUpper());
Console.WriteLine(frase.Contains("arroz"));
Console.WriteLine(frase.Trim().Split(' ').Length);
Console.WriteLine(frase.Replace("arroz", "macarrão").Trim());
Console.WriteLine(frase.Count(c => c == 'a'));

Resumo

• A string é imutável: todo método devolve uma string nova. Guarde o resultado.
• Length e [i] (do 0); pedaços com Substring ou [a..b]; posições com IndexOf (-1 = não achou).
• Trim, ToUpper, ToLower, Replace, PadLeft, Insert, Remove transformam; Contains, StartsWith, EndsWith perguntam.
• Split corta (com RemoveEmptyEntries e TrimEntries); string.Join junta.
• Para validar entrada, string.IsNullOrWhiteSpace. Para comparar sem ligar para maiúsculas, StringComparison.OrdinalIgnoreCase.
• Muitos pedaços num laço: StringBuilder com Append/AppendLine e, no fim, ToString().