String.Trim Método

Definición

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

Sobrecargas

Trim(Char[])

Quita todas las repeticiones del principio y el final de un conjunto de caracteres especificado en una matriz de la cadena actual.

Trim(Char)

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

Trim()

Quita todos los caracteres de espacio en blanco del principio y el final de la cadena actual.

Trim(Char[])

Quita todas las repeticiones del principio y el final de un conjunto de caracteres especificado 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

String

Cadena que queda una vez quitadas todas las apariciones de los caracteres especificados por el parámetro trimChars del principio y del final de la cadena actual. Si trimChars es null o una matriz vacía, se quitarán los caracteres de espacio en blanco. Si no se puede quitar 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 Trim(System.Char[]) método para quitar caracteres de espacio, asterisco (*)y 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 Trim(System.Char[]) método quita de la cadena actual todos los caracteres iniciales y finales que están en el trimChars parámetro . 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 Trim(System.Char[]) método devuelve "abc456xyz".

Nota

Si el Trim(System.Char[]) método 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 que se encuentran en la instancia actual.

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

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

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 true valor devuelto cuando se pasan al IsWhiteSpace(Char) método). Debido a este cambio, el Trim() método de .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 Trim() método de .NET Framework 4 y versiones posteriores no quita. Además, el Trim() método de .NET Framework 3.5 SP1 y versiones anteriores no recorta tres caracteres de espacio en blanco Unicode: SEPARADOR DE VOWEL DE MONGOLIA (U+180E), NARROW NO BREAK SPACE (U+202F) y MEDIUM MATHEMATICAL SPACE (U+205F).

Consulte también

Se aplica a

Trim(Char)

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

Un carácter Unicode que se va a quitar.

Devoluciones

String

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

Comentarios

El Trim(System.Char) método quita de la cadena actual todas las instancias iniciales y finales del trimChar carácter. 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 Trim(System.Char) método devuelve "abc---xyz". Para quitar caracteres entre palabras de una cadena, use expresiones regulares de .NET.

Nota

Si el Trim(System.Char) método 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 que se encuentran en la instancia actual.

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

Se aplica a

Trim()

Quita todos los caracteres de espacio en blanco del principio y el final de la cadena actual.

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

Devoluciones

String

Cadena que queda una vez quitados todos los caracteres de espacio en blanco del principio y el final de la cadena actual. Si no se puede quitar 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 String.Trim() método 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 Trim método 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 de espacio no en blanco. Por ejemplo, si la cadena actual es " abc xyz ", el Trim método devuelve "abc xyz". Para quitar caracteres de espacio en blanco entre palabras de una cadena, use expresiones regulares de .NET.

Nota

Si el Trim método 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 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 Trim método quita los caracteres iniciales y finales que generan un valor devuelto de true cuando se pasan al Char.IsWhiteSpace método .

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, caracteres que generan un true valor devuelto cuando se pasan al IsWhiteSpace(Char) método ). Debido a este cambio, el Trim() método de .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 Trim() método de .NET Framework 4 y versiones posteriores no quita. Además, el Trim() método de .NET Framework 3.5 SP1 y versiones anteriores no recorta tres caracteres de espacio en blanco Unicode: SEPARATOR DE VOWEL MONGOLIAN (U+180E), NARROW NO-BREAK SPACE (U+202F) y MEDIUM MATHEMATICAL SPACE (U+205F).

Consulte también

Se aplica a