String.TrimEnd Méthode

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

public:
 System::String ^ TrimEnd();

public string TrimEnd ();

member this.TrimEnd : unit -> string

Public Function TrimEnd () As String

Retours

Chaîne qui reste après que tous les espaces blancs sont supprimés 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 TrimEnd supprime de la chaîne actuelle tous les espaces blancs de fin. L’opération de découpage s’arrête lorsque le premier caractère non blanc est rencontré à la fin de la chaîne. Par exemple, si la chaîne actuelle est « abc xyz », la méthode TrimEnd retourne « abc xyz ».

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

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

public string TrimEnd (char trimChar);

member this.TrimEnd : char -> string

Public Function TrimEnd (trimChar As Char) As String

Paramètres

Retours

Chaîne qui reste après toutes les occurrences du caractère trimChar sont supprimées 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 TrimEnd(System.Char) supprime de la chaîne actuelle tous les caractères de fin trimChar. L’opération de découpage s’arrête lorsque le premier caractère qui n’est pas trimChar est rencontré à la fin de la chaîne. Par exemple, si trimChar est - et que la chaîne actuelle est « ---abc---xyz---- », la méthode TrimEnd(System.Char) retourne « ---abc---xyz ».

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

Source:

String.Manipulation.cs

public:
 System::String ^ TrimEnd(... cli::array <char> ^ trimChars);

public string TrimEnd (params char[] trimChars);

public string TrimEnd (params char[]? trimChars);

member this.TrimEnd : char[] -> string

Public Function TrimEnd (ParamArray trimChars As Char()) As String

Paramètres

Retours

La chaîne qui reste après toutes les occurrences des caractères du paramètre trimChars sont supprimées de la fin de la chaîne actuelle. Si trimChars est null ou un tableau vide, les caractères d’espace blanc Unicode 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 montre comment utiliser la méthode TrimEnd(System.Char[]) pour découper des marques de ponctuation ou d’espace blanc à partir de la fin d’une chaîne.

string sentence = "The dog had a bone, a ball, and other toys.";
char[] charsToTrim = {',', '.', ' '};
string[] words = sentence.Split();
foreach (string word in words)
   Console.WriteLine(word.TrimEnd(charsToTrim));

// The example displays the following output:
//       The
//       dog
//       had
//       a
//       bone
//       a
//       ball
//       and
//       other
//       toys

let sentence = "The dog had a bone, a ball, and other toys."
let charsToTrim = [| ','; '.'; ' ' |]
let words = sentence.Split()
for word in words do
    printfn $"{word.TrimEnd charsToTrim}"

// The example displays the following output:
//       The
//       dog
//       had
//       a
//       bone
//       a
//       ball
//       and
//       other
//       toys

Module TrimEnd
   Public Sub Main()
      Dim sentence As String = "The dog had a bone, a ball, and other toys."
      Dim charsToTrim() As Char = {","c, "."c, " "c}
      Dim words() As String = sentence.Split()
      For Each word As String In words
         Console.WriteLine(word.TrimEnd(charsToTrim))
      Next
   End Sub
End Module
' The example displays the following output:
'       The
'       dog
'       had
'       a
'       bone
'       a
'       ball
'       and
'       other
'       toys

Remarques

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

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

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

public:
 System::String ^ TrimEnd(ReadOnlySpan<char> trimChars);

public string TrimEnd (scoped ReadOnlySpan<char> trimChars);

member this.TrimEnd : ReadOnlySpan<char> -> string

Public Function TrimEnd (trimChars As ReadOnlySpan(Of Char)) As String

Paramètres

Retours

La chaîne qui reste après toutes les occurrences de caractères dans le paramètre trimChars sont supprimées de la fin de la chaîne actuelle. 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.