String.Trim Méthode

Source:

String.Manipulation.cs

public:
 System::String ^ Trim(System::Text::Rune trimRune);

public string Trim(System.Text.Rune trimRune);

member this.Trim : System.Text.Rune -> string

Public Function Trim (trimRune As Rune) As String

Paramètres

Retours

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

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

Paramètres

Retours

La chaîne qui reste après toutes les occurrences des caractères du trimChars paramètre sont supprimées du début et de la fin de la chaîne active. S’il trimChars s’agit null ou d’un tableau vide, les caractères d’espace blanc sont supprimés à la place. Si aucun caractère ne peut être supprimé de l’instance actuelle, la méthode retourne l’instance actuelle inchangée.

Exemples

L’exemple suivant utilise la méthode pour supprimer des Trim(System.Char[]) caractères d’espace, d’astérisque (*) et d’apostrophe (') d’une chaîne.

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'

Remarques

La Trim(System.Char[]) méthode supprime de la chaîne actuelle tous les caractères de début et de fin qui se trouvent dans le trimChars paramètre. Chaque opération de découpage de début et de fin s’arrête lorsqu’un caractère qui n’est pas en trimChars cours est rencontré. Par exemple, si la chaîne actuelle est « 123abc456xyz789 » et trimChars contient les chiffres de « 1 » à « 9 », la Trim(System.Char[]) méthode retourne « abc456xyz ».

Si la chaîne actuelle est égale Empty ou si tous les caractères de l’instance actuelle se composent de caractères dans le trimChars tableau, la méthode retourne Empty.

Si trimChars elle est null ou un tableau vide, cette méthode supprime les caractères de début ou de fin qui entraînent le retour true de la méthode lorsqu’elles sont passées à la Char.IsWhiteSpace méthode.

Notes pour les appelants

.NET Framework 3.5 SP1 et les versions antérieures conservent une liste interne de caractères d’espace blanc que cette méthode supprime s’il trimChars s’agit null ou d’un tableau vide. À compter du .NET Framework 4, s’il s’agit trimCharsnull ou d’un tableau vide, la méthode supprime tous les espaces blancs Unicode (autrement dit, les caractères qui produisent une true valeur de retour lorsqu’elles sont passées à la IsWhiteSpace(Char) méthode). En raison de cette modification, la méthode Trim() dans le .NET Framework 3.5 SP1 et les versions antérieures supprime deux caractères, ZERO WIDTH SPACE (U+200B) et ZERO WIDTH NO-BREAK SPACE (U+FEFF), que la méthode Trim() dans la .NET Framework 4 et versions ultérieures ne supprime pas. En outre, la Trim() méthode dans .NET Framework 3.5 SP1 et les versions antérieures ne supprime pas trois caractères d’espace blanc Unicode : SÉPARATEUR DE VOYELLE MONGOLE (U+180E), NARROW NO-BREAK SPACE (U+202F) et ESPACE MATHÉMATIQUE MOYEN (U+205F).

Voir aussi

• Char
• TrimEnd(Char[])
• TrimStart(Char[])
• IsWhiteSpace(Char)

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

public:
 System::String ^ Trim(char trimChar);

public string Trim(char trimChar);

member this.Trim : char -> string

Public Function Trim (trimChar As Char) As String

Paramètres

Retours

Chaîne qui reste après toutes les instances du trimChar caractère sont supprimées du début et de la fin de la chaîne active. Si aucun caractère ne peut être supprimé de l’instance actuelle, la méthode retourne l’instance actuelle inchangée.

Remarques

La Trim(System.Char) méthode supprime de la chaîne actuelle toutes les instances de début et de fin du trimChar caractère. Chaque opération de découpage de début et de fin s’arrête lorsqu’un caractère différent de lui trimChar est rencontré. Par exemple, si trimChar la chaîne actuelle est - « ---abc---xyz---- », la Trim(System.Char) méthode retourne « abc---xyz ». Pour supprimer des caractères entre des mots d’une chaîne, utilisez .NET expressions régulières.

Si la chaîne actuelle est égale Empty ou si tous les caractères de l’instance actuelle se composent de trimChar caractères, la méthode retourne Empty.

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

public:
 System::String ^ Trim();

public string Trim();

member this.Trim : unit -> string

Public Function Trim () As String

Retours

Chaîne qui reste après que tous les espaces blancs sont supprimés du début et de la fin de la chaîne actuelle. Si aucun caractère ne peut être supprimé de l’instance actuelle, la méthode retourne l’instance actuelle inchangée.

Exemples

L’exemple suivant utilise la String.Trim() méthode pour supprimer tout espace blanc supplémentaire des chaînes entrées par l’utilisateur avant de les concaténer.

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.

Remarques

La Trim méthode supprime de la chaîne actuelle tous les caractères d’espace blanc de début et de fin. Chaque opération de découpage de début et de fin s’arrête lorsqu’un caractère d’espace non blanc est rencontré. Par exemple, si la chaîne actuelle est « abc xyz », la Trim méthode retourne « abc xyz ». Pour supprimer des caractères d’espace blanc entre les mots d’une chaîne, utilisez .NET Expressions régulières.

Si la chaîne actuelle est égale Empty ou si tous les caractères de l’instance actuelle se composent de caractères d’espace blanc, la méthode retourne Empty.

Les caractères d’espace blanc sont définis par la norme Unicode. La Trim méthode supprime les caractères de début et de true fin qui produisent une valeur de retour lorsqu’elles sont passées à la Char.IsWhiteSpace méthode.

Notes pour les appelants

Les versions .NET Framework 3.5 SP1 et antérieures conservent une liste interne de caractères d’espace blanc que cette méthode supprime. À compter de .NET Framework 4, la méthode supprime tous les espaces blancs Unicode (autrement dit, les caractères qui produisent une valeur de retour true lorsqu’elles sont passées à la méthode IsWhiteSpace(Char)). En raison de cette modification, la Trim() méthode dans .NET Framework 3.5 SP1 et les versions antérieures supprime deux caractères, ZERO WIDTH SPACE (U+200B) et ZERO WIDTH NO-BREAK SPACE (U+FEFF), que la Trim() méthode dans .NET Framework 4 et versions ultérieures ne supprime pas. En outre, la Trim() méthode dans .NET Framework 3.5 SP1 et les versions antérieures ne supprime pas trois caractères d’espace blanc Unicode : SÉPARATEUR DE VOYELLE MONGOLE (U+180E), NARROW NO-BREAK SPACE (U+202F) et ESPACE MATHÉMATIQUE MOYEN (U+205F).

Voir aussi

• TrimEnd(Char[])
• TrimStart(Char[])
• IsWhiteSpace(Char)