Partage via


String.Trim Méthode

Définition

Retourne une nouvelle chaîne dans laquelle toutes les occurrences de début et de fin d’un jeu de caractères spécifiés de la chaîne actuelle sont supprimées.

Surcharges

Trim(Char)

Supprime toutes les instances de début et de fin d’un caractère de la chaîne actuelle.

Trim(ReadOnlySpan<Char>)

Supprime toutes les occurrences de début et de fin d’un jeu de caractères spécifié dans une étendue de la chaîne actuelle.

Trim()

Supprime tous les espaces blancs de début et de fin de la chaîne actuelle.

Trim(Char[])

Supprime toutes les occurrences de début et de fin d’un jeu de caractères spécifié dans un tableau de la chaîne actuelle.

Trim(Char)

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

Supprime toutes les instances de début et de fin d’un caractère de la chaîne actuelle.

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

trimChar
Char

Caractère Unicode à supprimer.

Retours

Chaîne qui reste après toutes les instances du caractère trimChar sont supprimées 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.

Remarques

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

Note

Si la méthode Trim(System.Char) supprime les caractères de l’instance actuelle, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, elle retourne une nouvelle chaîne dans laquelle tous les caractères de début et de fin trimChar trouvés dans l’instance actuelle sont supprimés.

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

S’applique à

Trim(ReadOnlySpan<Char>)

Supprime toutes les occurrences de début et de fin d’un jeu de caractères spécifié dans une étendue de la chaîne actuelle.

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

Paramètres

trimChars
ReadOnlySpan<Char>

Étendue de caractères Unicode à supprimer.

Retours

La chaîne qui reste après toutes les occurrences des caractères du paramètre trimChars sont supprimées du début et de la fin de la chaîne active. Si trimChars est vide, les espaces blancs 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.

S’applique à

Trim()

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

Supprime tous les espaces blancs de début et de fin de la chaîne actuelle.

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 méthode String.Trim() pour supprimer tout espace blanc supplémentaire des chaînes entrées par l’utilisateur avant de les concaténer.

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.

Remarques

La méthode Trim 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 méthode Trim retourne « abc xyz ». Pour supprimer des caractères d’espace blanc entre les mots d’une chaîne, utilisez expressions régulières .NET.

Note

Si la méthode Trim supprime les caractères de l’instance actuelle, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, elle retourne une nouvelle chaîne dans laquelle tous les espaces blancs de début et de fin trouvés dans l’instance actuelle sont supprimés.

Si la chaîne actuelle est égale à Empty ou à 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 méthode Trim supprime les caractères de début et de fin qui produisent une valeur de retour de true lorsqu’elles sont passées à la méthode Char.IsWhiteSpace.

Notes pour les appelants

.NET Framework 3.5 SP1 et versions antérieures conservent une liste interne de caractères d’espace blanc que cette méthode supprime. À compter du .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 méthode Trim() 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 méthode Trim() dans .NET Framework 4 et versions ultérieures ne supprime pas. En outre, la méthode Trim() 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

S’applique à

Trim(Char[])

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

Supprime toutes les occurrences de début et de fin d’un jeu de caractères spécifié dans un tableau de la chaîne actuelle.

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

trimChars
Char[]

Tableau de caractères Unicode à supprimer ou null.

Retours

La chaîne qui reste après toutes les occurrences des caractères du paramètre trimChars sont supprimées du début et de la fin de la chaîne active. Si trimChars est null ou un tableau vide, les espaces blancs 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 Trim(System.Char[]) pour supprimer l’espace, l’astérisque (*) et les caractères apostrophe (') d’une chaîne.

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'

Remarques

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

Note

Si la méthode Trim(System.Char[]) supprime les caractères de l’instance actuelle, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, elle retourne une nouvelle chaîne dans laquelle tous les caractères de début et de fin trimChars trouvés dans l’instance actuelle sont supprimés.

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

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

Notes pour les appelants

.NET Framework 3.5 SP1 et versions antérieures conservent une liste interne de caractères d’espace blanc que cette méthode supprime si trimChars est null ou un tableau vide. À compter du .NET Framework 4, si trimChars est null ou un tableau vide, 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 méthode Trim() 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 méthode Trim() dans .NET Framework 4 et versions ultérieures ne supprime pas. En outre, la méthode Trim() 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

S’applique à