String.Trim Método

Definición

Devuelve una nueva cadena en la que se quitan todas las apariciones iniciales y finales de un conjunto de caracteres especificados de la cadena actual.

Sobrecargas

Trim(Char)

Quita todas las instancias iniciales y finales de un carácter de la cadena actual.

Trim(ReadOnlySpan<Char>)

Quita todas las apariciones iniciales y finales de un conjunto de caracteres especificados en un intervalo de la cadena actual.

Trim()

Quita todos los caracteres de espacio en blanco iniciales y finales de la cadena actual.

Trim(Char[])

Quita todas las apariciones iniciales y finales de un conjunto de caracteres especificados en una matriz de la cadena actual.

Trim(Char)

Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs

Quita todas las instancias iniciales y finales de un carácter de la cadena actual.

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

Carácter Unicode que se va a quitar.

Devoluciones

La cadena que permanece después de que todas las instancias del carácter trimChar se quiten del inicio y el final de la cadena actual. Si no se puede recortar ningún carácter de la instancia actual, el método devuelve la instancia actual sin cambios.

Comentarios

El método Trim(System.Char) quita de la cadena actual todas las instancias iniciales y finales del carácter trimChar. Cada operación de recorte inicial y final se detiene cuando se encuentra un carácter diferente de trimChar. Por ejemplo, si trimChar es - y la cadena actual es "---abc---xyz----", el método Trim(System.Char) devuelve "abc---xyz". Para quitar caracteres entre palabras de una cadena, use expresiones regulares de .NET.

Nota

Si el método Trim(System.Char) quita los caracteres de la instancia actual, este método no modifica el valor de la instancia actual. En su lugar, devuelve una nueva cadena en la que se quitan todos los caracteres iniciales y finales trimChar encontrados en la instancia actual.

Si la cadena actual es igual a Empty o todos los caracteres de la instancia actual constan de trimChar caracteres, el método devuelve Empty.

Se aplica a

Trim(ReadOnlySpan<Char>)

Quita todas las apariciones iniciales y finales de un conjunto de caracteres especificados en un intervalo de la cadena actual.

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>

Intervalo de caracteres Unicode que se van a quitar.

Devoluciones

La cadena que permanece después de todas las apariciones de los caracteres del parámetro trimChars se quita del inicio y el final de la cadena actual. Si trimChars está vacío, los caracteres de espacio en blanco se quitan en su lugar. Si no se puede recortar ningún carácter de la instancia actual, el método devuelve la instancia actual sin cambios.

Se aplica a

Trim()

Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs

Quita todos los caracteres de espacio en blanco iniciales y finales de la cadena actual.

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

Devoluciones

Cadena que permanece después de quitar todos los caracteres de espacio en blanco del inicio y el final de la cadena actual. Si no se puede recortar ningún carácter de la instancia actual, el método devuelve la instancia actual sin cambios.

Ejemplos

En el ejemplo siguiente se usa el método String.Trim() para quitar cualquier espacio en blanco adicional de las cadenas especificadas por el usuario antes de concatenarlas.

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.

Comentarios

El método Trim quita de la cadena actual todos los caracteres de espacio en blanco iniciales y finales. Cada operación de recorte inicial y final se detiene cuando se encuentra un carácter que no es de espacio en blanco. Por ejemplo, si la cadena actual es " abc xyz ", el método Trim devuelve "abc xyz". Para quitar caracteres de espacio en blanco entre palabras de una cadena, use expresiones regulares de .NET.

Nota

Si el método Trim quita los caracteres de la instancia actual, este método no modifica el valor de la instancia actual. En su lugar, devuelve una nueva cadena en la que se quitan todos los caracteres de espacio en blanco iniciales y finales que se encuentran en la instancia actual.

Si la cadena actual es igual a Empty o todos los caracteres de la instancia actual constan de caracteres de espacio en blanco, el método devuelve Empty.

Los caracteres de espacio en blanco se definen mediante el estándar Unicode. El método Trim quita los caracteres iniciales y finales que generan un valor devuelto de true cuando se pasan al método Char.IsWhiteSpace.

Notas a los autores de las llamadas

.NET Framework 3.5 SP1 y versiones anteriores mantienen una lista interna de caracteres de espacio en blanco que recorta este método. A partir de .NET Framework 4, el método recorta todos los caracteres de espacio en blanco Unicode (es decir, los caracteres que generan un valor devuelto true cuando se pasan al método IsWhiteSpace(Char)). Debido a este cambio, el método Trim() en .NET Framework 3.5 SP1 y versiones anteriores quita dos caracteres, ZERO WIDTH SPACE (U+200B) y ZERO WIDTH NO-BREAK SPACE (U+FEFF), que el método Trim() en .NET Framework 4 y versiones posteriores no quita. Además, el método Trim() en .NET Framework 3.5 SP1 y versiones anteriores no recorta tres caracteres de espacio en blanco Unicode: SEPARADOR DE VOWEL MONGOLIAN (U+180E), NARROW NO-BREAK SPACE (U+202F) y ESPACIO MATEMÁTICO MEDIO (U+205F).

Consulte también

Se aplica a

Trim(Char[])

Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs

Quita todas las apariciones iniciales y finales de un conjunto de caracteres especificados en una matriz de la cadena actual.

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[]

Matriz de caracteres Unicode que se van a quitar o null.

Devoluciones

La cadena que permanece después de todas las apariciones de los caracteres del parámetro trimChars se quita del inicio y el final de la cadena actual. Si trimChars es null o una matriz vacía, los caracteres de espacio en blanco se quitan en su lugar. Si no se puede recortar ningún carácter de la instancia actual, el método devuelve la instancia actual sin cambios.

Ejemplos

En el ejemplo siguiente se usa el método Trim(System.Char[]) para quitar el espacio, el asterisco (*), y los caracteres apóstrofo (') de una cadena.

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'

Comentarios

El método Trim(System.Char[]) quita de la cadena actual todos los caracteres iniciales y finales que se encuentran en el parámetro trimChars. Cada operación de recorte inicial y final se detiene cuando se encuentra un carácter que no está en trimChars. Por ejemplo, si la cadena actual es "123abc456xyz789" y trimChars contiene los dígitos de "1" a "9", el método Trim(System.Char[]) devuelve "abc456xyz".

Nota

Si el método Trim(System.Char[]) quita los caracteres de la instancia actual, este método no modifica el valor de la instancia actual. En su lugar, devuelve una nueva cadena en la que se quitan todos los caracteres iniciales y finales trimChars encontrados en la instancia actual.

Si la cadena actual es igual a Empty o todos los caracteres de la instancia actual constan de caracteres de la matriz trimChars, el método devuelve Empty.

Si trimChars es null o una matriz vacía, este método quita los caracteres iniciales o finales que provocan que el método devuelva true cuando se pasan al método Char.IsWhiteSpace.

Notas a los autores de las llamadas

.NET Framework 3.5 SP1 y versiones anteriores mantienen una lista interna de caracteres de espacio en blanco que este método recorta si trimChars es null o una matriz vacía. A partir de .NET Framework 4, si trimChars es null o una matriz vacía, el método recorta todos los caracteres de espacio en blanco Unicode (es decir, caracteres que generan un valor devuelto true cuando se pasan al método IsWhiteSpace(Char)). Debido a este cambio, el método Trim() en .NET Framework 3.5 SP1 y versiones anteriores quita dos caracteres, ZERO WIDTH SPACE (U+200B) y ZERO WIDTH NO-BREAK SPACE (U+FEFF), que el método Trim() en .NET Framework 4 y versiones posteriores no quita. Además, el método Trim() en .NET Framework 3.5 SP1 y versiones anteriores no recorta tres caracteres de espacio en blanco Unicode: SEPARADOR DE VOWEL MONGOLIAN (U+180E), NARROW NO-BREAK SPACE (U+202F) y ESPACIO MATEMÁTICO MEDIO (U+205F).

Consulte también

Se aplica a