String.Trim Método

Definição

Retorna uma nova cadeia de caracteres na qual todas as ocorrências à esquerda e à direita de um conjunto de caracteres especificados da cadeia de caracteres atual são removidas.

Sobrecargas

Trim(Char)

Remove todas as instâncias à esquerda e à direita de um caractere da cadeia de caracteres atual.

Trim(ReadOnlySpan<Char>)

Remove todas as ocorrências à esquerda e à direita de um conjunto de caracteres especificado em um intervalo da cadeia de caracteres atual.

Trim()

Remove todos os caracteres de espaço em branco à esquerda e à direita da cadeia de caracteres atual.

Trim(Char[])

Remove todas as ocorrências à esquerda e à direita de um conjunto de caracteres especificado em uma matriz da cadeia de caracteres atual.

Trim(Char)

Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs

Remove todas as instâncias à esquerda e à direita de um caractere da cadeia de caracteres atual.

public:
 System::String ^ Trim(char trimChar);
public string Trim (char trimChar);
member this.Trim : char -> string
Public Function Trim (trimChar As Char) As String

Parâmetros

trimChar
Char

Um caractere Unicode a ser removido.

Retornos

A cadeia de caracteres que permanece depois que todas as instâncias do caractere trimChar são removidas do início e do final da cadeia de caracteres atual. Se nenhum caractere puder ser cortado da instância atual, o método retornará a instância atual inalterada.

Comentários

O método Trim(System.Char) remove da cadeia de caracteres atual todas as instâncias à esquerda e à direita do caractere trimChar. Cada operação de corte à esquerda e à direita é interrompida quando um caractere diferente de trimChar é encontrado. Por exemplo, se trimChar for - e a cadeia de caracteres atual for "---abc---xyz----", o método Trim(System.Char) retornará "abc---xyz". Para remover caracteres entre palavras em uma cadeia de caracteres, use expressões regulares do .NET.

Nota

Se o método Trim(System.Char) remover quaisquer caracteres da instância atual, esse método não modificará o valor da instância atual. Em vez disso, retorna uma nova cadeia de caracteres na qual todos os caracteres trimChar à esquerda e à direita encontrados na instância atual são removidos.

Se a cadeia de caracteres atual for igual a Empty ou todos os caracteres na instância atual consistirem em caracteres trimChar, o método retornará Empty.

Aplica-se a

Trim(ReadOnlySpan<Char>)

Remove todas as ocorrências à esquerda e à direita de um conjunto de caracteres especificado em um intervalo da cadeia de caracteres atual.

public:
 System::String ^ Trim(ReadOnlySpan<char> trimChars);
public string Trim (scoped ReadOnlySpan<char> trimChars);
member this.Trim : ReadOnlySpan<char> -> string
Public Function Trim (trimChars As ReadOnlySpan(Of Char)) As String

Parâmetros

trimChars
ReadOnlySpan<Char>

Um intervalo de caracteres Unicode a serem removidos.

Retornos

A cadeia de caracteres que permanece depois que todas as ocorrências dos caracteres no parâmetro trimChars são removidas do início e do final da cadeia de caracteres atual. Se trimChars estiver vazio, os caracteres de espaço em branco serão removidos. Se nenhum caractere puder ser cortado da instância atual, o método retornará a instância atual inalterada.

Aplica-se a

Trim()

Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs

Remove todos os caracteres de espaço em branco à esquerda e à direita da cadeia de caracteres atual.

public:
 System::String ^ Trim();
public string Trim ();
member this.Trim : unit -> string
Public Function Trim () As String

Retornos

A cadeia de caracteres que permanece depois que todos os caracteres de espaço em branco são removidos do início e do final da cadeia de caracteres atual. Se nenhum caractere puder ser cortado da instância atual, o método retornará a instância atual inalterada.

Exemplos

O exemplo a seguir usa o método String.Trim() para remover qualquer espaço em branco extra das cadeias de caracteres inseridas pelo usuário antes de concatená-las.

using namespace System;

void main()
{
   Console::Write("Enter your first name: ");
   String^ firstName = Console::ReadLine();
   
   Console::Write("Enter your middle name or initial: ");
   String^ middleName = Console::ReadLine();
   
   Console::Write("Enter your last name: ");
   String^ lastName = Console::ReadLine();
   
   Console::WriteLine();
   Console::WriteLine("You entered '{0}', '{1}', and '{2}'.",
                      firstName, middleName, lastName);
   
   String^ name = ((firstName->Trim() + " " + middleName->Trim())->Trim() + " " +
                  lastName->Trim())->Trim();
   Console::WriteLine("The result is " + name + ".");
}
// The following is possible output from this example:
//       Enter your first name:    John
//       Enter your middle name or initial:
//       Enter your last name:    Doe
//       
//       You entered '   John  ', '', and '   Doe'.
//       The result is John Doe.
using System;

public class Example
{
    public static void Main()
    {
        Console.Write("Enter your first name: ");
        string firstName = Console.ReadLine();
      
        Console.Write("Enter your middle name or initial: ");
        string middleName = Console.ReadLine();
      
        Console.Write("Enter your last name: ");
        string lastName = Console.ReadLine();
      
        Console.WriteLine();
        Console.WriteLine("You entered '{0}', '{1}', and '{2}'.", 
                        firstName, middleName, lastName);
      
        string name = ((firstName.Trim() + " " + middleName.Trim()).Trim() + " " + 
                    lastName.Trim()).Trim();
        Console.WriteLine("The result is " + name + ".");

        // The following is a possible output from this example:
        //       Enter your first name:    John
        //       Enter your middle name or initial:
        //       Enter your last name:    Doe
        //       
        //       You entered '   John  ', '', and '   Doe'.
        //       The result is John Doe.
    }
}
printf "Enter your first name: "
let firstName = stdin.ReadLine()

printf "Enter your middle name or initial: "
let middleName = stdin.ReadLine()

printf "Enter your last name: "
let lastName = stdin.ReadLine()

printfn $"\nYou entered '{firstName}', '{middleName}', and '{lastName}'." 

let name = ((firstName.Trim() + " " + middleName.Trim()).Trim() + " " + lastName.Trim()).Trim()
printfn $"The result is {name}."

// The following is a possible output from this example:
//       Enter your first name:    John
//       Enter your middle name or initial:
//       Enter your last name:    Doe
//       
//       You entered '   John  ', '', and '   Doe'.
//       The result is John Doe.
Module Example
   Public Sub Main()
      Console.Write("Enter your first name: ")
      Dim firstName As String = Console.ReadLine()
      
      Console.Write("Enter your middle name or initial: ")
      Dim middleName As String = Console.ReadLine()
      
      Console.Write("Enter your last name: ")
      Dim lastName As String = Console.ReadLine
      
      Console.WriteLine()
      Console.WriteLine("You entered '{0}', '{1}', and '{2}'.", _
                        firstName, middleName, lastName)
                        
      Dim name As String = ((firstName.Trim() + " " + middleName.Trim()).Trim() _
                           + " " + lastName.Trim()).Trim()                        
      Console.WriteLine("The result is " + name + ".")
   End Sub
End Module
' The following is possible output from this example:
'       Enter your first name:    John
'       Enter your middle name or initial:
'       Enter your last name:    Doe
'       
'       You entered '   John  ', '', and '   Doe'.
'       The result is John Doe.

Comentários

O método Trim remove da cadeia de caracteres atual todos os caracteres de espaço em branco à esquerda e à direita. Cada operação de corte à esquerda e à direita é interrompida quando um caractere de espaço não branco é encontrado. Por exemplo, se a cadeia de caracteres atual for " abc xyz ", o método Trim retornará "abc xyz". Para remover caracteres de espaço em branco entre palavras em uma cadeia de caracteres, use expressões regulares do .NET.

Nota

Se o método Trim remover quaisquer caracteres da instância atual, esse método não modificará o valor da instância atual. Em vez disso, retorna uma nova cadeia de caracteres na qual todos os caracteres de espaço em branco à esquerda e à direita encontrados na instância atual são removidos.

Se a cadeia de caracteres atual for igual a Empty ou todos os caracteres na instância atual consistirem em caracteres de espaço em branco, o método retornará Empty.

Caracteres de espaço em branco são definidos pelo padrão Unicode. O método Trim remove todos os caracteres à esquerda e à direita que produzem um valor retornado de true quando são passados para o método Char.IsWhiteSpace.

Notas aos Chamadores

O .NET Framework 3.5 SP1 e versões anteriores mantêm uma lista interna de caracteres de espaço em branco que esse método corta. A partir do .NET Framework 4, o método corta todos os caracteres de espaço em branco Unicode (ou seja, caracteres que produzem um valor de retorno true quando são passados para o método IsWhiteSpace(Char)). Devido a essa alteração, o método Trim() no .NET Framework 3.5 SP1 e versões anteriores remove dois caracteres, ZERO WIDTH SPACE (U+200B) e ZERO WIDTH NO-BREAK SPACE (U+FEFF), que o método Trim() no .NET Framework 4 e versões posteriores não remove. Além disso, o método Trim() no .NET Framework 3.5 SP1 e versões anteriores não corta três caracteres de espaço em branco Unicode: SEPARADOR VOGAL MONGOL (U+180E), ESPAÇO ESTREITO NO-BREAK (U+202F) e ESPAÇO MATEMÁTICO MÉDIO (U+205F).

Confira também

Aplica-se a

Trim(Char[])

Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs

Remove todas as ocorrências à esquerda e à direita de um conjunto de caracteres especificado em uma matriz da cadeia de caracteres atual.

public:
 System::String ^ Trim(... cli::array <char> ^ trimChars);
public string Trim (params char[] trimChars);
public string Trim (params char[]? trimChars);
member this.Trim : char[] -> string
Public Function Trim (ParamArray trimChars As Char()) As String

Parâmetros

trimChars
Char[]

Uma matriz de caracteres Unicode a serem removidos ou null.

Retornos

A cadeia de caracteres que permanece depois que todas as ocorrências dos caracteres no parâmetro trimChars são removidas do início e do final da cadeia de caracteres atual. Se trimChars for null ou uma matriz vazia, os caracteres de espaço em branco serão removidos. Se nenhum caractere puder ser cortado da instância atual, o método retornará a instância atual inalterada.

Exemplos

O exemplo a seguir usa o método Trim(System.Char[]) para remover caracteres de espaço, asterisco (*) e apóstrofo (') de uma cadeia de caracteres.

using namespace System;

void main()
{
   array<Char>^ charsToTrim = { L'*', L' ', L'\\' };
   String^ banner = "*** Much Ado About Nothing ***";
   String^ result = banner->Trim(charsToTrim);
   Console::WriteLine("Trimmmed\n   {0}\nto\n   '{1}'", banner, result);
}
// The example displays the following output:
//       Trimmmed
//          *** Much Ado About Nothing ***
//       to
//          'Much Ado About Nothing'
char[] charsToTrim = { '*', ' ', '\''};
string banner = "*** Much Ado About Nothing ***";
string result = banner.Trim(charsToTrim);
Console.WriteLine("Trimmed\n   {0}\nto\n   '{1}'", banner, result);

// The example displays the following output:
//       Trimmed
//          *** Much Ado About Nothing ***
//       to
//          'Much Ado About Nothing'
let charsToTrim = [| '*'; ' '; '\'' |]
let banner = "*** Much Ado About Nothing ***"
let result = banner.Trim charsToTrim
printfn $"Trimmmed\n   {banner}\nto\n   '{result}'"

// The example displays the following output:
//       Trimmmed
//          *** Much Ado About Nothing ***
//       to
//          'Much Ado About Nothing'
Module Example
   Public Sub Main()
      Dim charsToTrim() As Char = { "*"c, " "c, "'"c}
      Dim banner As String = "*** Much Ado About Nothing ***"
      Dim result As String = banner.Trim(charsToTrim)
      Console.WriteLine("Trimmmed{0}   {1}{0}to{0}   '{2}'", _
                        vbCrLf, banner, result)
   End Sub
End Module
' The example displays the following output:
'       Trimmmed
'          *** Much Ado About Nothing ***
'       to
'          'Much Ado About Nothing'

Comentários

O método Trim(System.Char[]) remove da cadeia de caracteres atual todos os caracteres à esquerda e à direita que estão no parâmetro trimChars. Cada operação de corte à esquerda e à direita é interrompida quando um caractere que não está em trimChars é encontrado. Por exemplo, se a cadeia de caracteres atual for "123abc456xyz789" e trimChars contiver os dígitos de "1" a "9", o método Trim(System.Char[]) retornará "abc456xyz".

Nota

Se o método Trim(System.Char[]) remover quaisquer caracteres da instância atual, esse método não modificará o valor da instância atual. Em vez disso, retorna uma nova cadeia de caracteres na qual todos os caracteres trimChars à esquerda e à direita encontrados na instância atual são removidos.

Se a cadeia de caracteres atual for igual a Empty ou todos os caracteres na instância atual consistirem em caracteres na matriz trimChars, o método retornará Empty.

Se trimChars for null ou uma matriz vazia, esse método removerá quaisquer caracteres à esquerda ou à direita que resultem no método retornando true quando eles são passados para o método Char.IsWhiteSpace.

Notas aos Chamadores

O .NET Framework 3.5 SP1 e versões anteriores mantêm uma lista interna de caracteres de espaço em branco que esse método corta se trimChars é null ou uma matriz vazia. A partir do .NET Framework 4, se trimChars for null ou uma matriz vazia, o método cortará todos os caracteres de espaço em branco Unicode (ou seja, caracteres que produzem um valor de retorno true quando são passados para o método IsWhiteSpace(Char)). Devido a essa alteração, o método Trim() no .NET Framework 3.5 SP1 e versões anteriores remove dois caracteres, ZERO WIDTH SPACE (U+200B) e ZERO WIDTH NO-BREAK SPACE (U+FEFF), que o método Trim() no .NET Framework 4 e versões posteriores não remove. Além disso, o método Trim() no .NET Framework 3.5 SP1 e versões anteriores não corta três caracteres de espaço em branco Unicode: SEPARADOR VOGAL MONGOL (U+180E), ESPAÇO ESTREITO NO-BREAK (U+202F) e ESPAÇO MATEMÁTICO MÉDIO (U+205F).

Confira também

Aplica-se a