String.Trim Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne une nouvelle chaîne dans laquelle toutes les occurrences d’un jeu de caractères spécifique sont supprimées au début et à la fin de la chaîne actuelle.
Surcharges
Trim(Char) |
Supprime toutes les instances d’un caractère au début et à la fin de la chaîne actuelle. |
Trim(ReadOnlySpan<Char>) | |
Trim() |
Supprime tous les caractères correspondant à un espace blanc au début et à la fin de la chaîne actuelle. |
Trim(Char[]) |
Supprime toutes les occurrences du jeu de caractères spécifié dans un tableau au début et à la fin de la chaîne actuelle. |
Trim(Char)
- Source:
- String.Manipulation.cs
- Source:
- String.Manipulation.cs
- Source:
- String.Manipulation.cs
Supprime toutes les instances d’un caractère au début et à la fin 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 restante après la suppression de toutes les instances du caractère trimChar
au début et à la fin de la chaîne actuelle. Si aucun caractère ne peut être tronqué dans l'instance active, la méthode retourne l'instance active 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 trimChar
est rencontré. Par exemple, si trimChar
est -
et que la chaîne actuelle est « ---abc---xyz---- », la Trim(System.Char)
méthode retourne « abc---xyz ». Pour supprimer des caractères entre les mots d’une chaîne, utilisez expressions régulières .NET.
Notes
Si la Trim(System.Char)
méthode supprime des caractères de l’instance actuelle, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, il retourne une nouvelle chaîne dans laquelle tous les caractères de début et de trimChar
fin trouvés dans l’instance actuelle sont supprimés.
Si la chaîne actuelle est égale ou si tous les caractères de l’instance actuelle sont constitués Empty de trimChar
caractères, la méthode retourne Empty.
S’applique à
Trim(ReadOnlySpan<Char>)
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>
Retours
S’applique à
Trim()
- Source:
- String.Manipulation.cs
- Source:
- String.Manipulation.cs
- Source:
- String.Manipulation.cs
Supprime tous les caractères correspondant à un espace blanc au début et à la 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 restante après la suppression de tous les espaces blancs de début et de fin de la chaîne actuelle. Si aucun caractère ne peut être tronqué dans l'instance active, la méthode retourne l'instance active 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 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 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 non-espace blanc est rencontré. Par exemple, si la chaîne actuelle est « abc xyz », la Trim
méthode retourne « abc xyz ». Pour supprimer des espaces blancs entre des mots d’une chaîne, utilisez expressions régulières .NET.
Notes
Si la Trim
méthode supprime des caractères de l’instance actuelle, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, il 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 si tous les caractères de l’instance actuelle se composent de caractères d’espace blanc, la méthode retourne Empty.
Les espaces blancs sont définis par la norme Unicode. La Trim
méthode supprime tous les caractères de début et de fin qui produisent une valeur de retour de true
lorsqu’ils sont passés à la Char.IsWhiteSpace méthode.
Notes pour les appelants
Le .NET Framework 3.5 SP1 et les versions antérieures conservent une liste interne d’espaces blancs que cette méthode rognera. À compter de .NET Framework 4, la méthode supprime tous les espaces blancs Unicode (c’est-à-dire, les caractères qui produisent une true
valeur de retour lorsqu’ils sont passés à la IsWhiteSpace(Char) méthode). En raison de cette modification, la Trim() méthode dans .NET Framework 3.5 SP1 et 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 du .NET Framework 3.5 SP1 et des versions antérieures ne supprime pas trois espaces blancs Unicode : SÉPARATEUR DE VOYELLE MONGOL (U+180E), ESPACE ÉTROIT NO-BREAK (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 du jeu de caractères spécifié dans un tableau au début et à la fin 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
Chaîne qui reste après la suppression de toutes les occurrences des caractères contenus dans le paramètre trimChars
du début et de la fin de la chaîne actuelle. Si trimChars
est null
ou est un tableau vide, les espaces blancs sont plutôt supprimés. Si aucun caractère ne peut être tronqué dans l'instance active, la méthode retourne l'instance active inchangée.
Exemples
L’exemple suivant utilise la Trim(System.Char[])
méthode pour supprimer des caractères d’espace, d’astérisque (*) et d’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 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 dans trimChars
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 ».
Notes
Si la Trim(System.Char[])
méthode supprime des caractères de l’instance actuelle, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, il retourne une nouvelle chaîne dans laquelle tous les caractères de début et de trimChars
fin trouvés dans l’instance actuelle sont supprimés.
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
est null
ou un tableau vide, cette méthode supprime tous les caractères de début ou de fin qui entraînent le retour true
de la méthode lorsqu’ils sont passés à la Char.IsWhiteSpace méthode.
Notes pour les appelants
Le .NET Framework 3.5 SP1 et les versions antérieures conserve une liste interne de caractères d’espaces blancs que cette méthode supprime si trimChars
est null
ou un tableau vide. À compter de .NET Framework 4, si trimChars
est null
ou un tableau vide, la méthode supprime tous les espaces blancs Unicode (c’est-à-dire, les caractères qui produisent une true
valeur de retour lorsqu’ils sont passés à la IsWhiteSpace(Char) méthode). En raison de cette modification, la Trim() méthode dans .NET Framework 3.5 SP1 et 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 du .NET Framework 3.5 SP1 et des versions antérieures ne supprime pas trois espaces blancs Unicode : SÉPARATEUR DE VOYELLE MONGOL (U+180E), ESPACE ÉTROIT NO-BREAK (U+202F) et ESPACE MATHÉMATIQUE MOYEN (U+205F).
Voir aussi
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de l’année 2024, nous abandonnerons progressivement le mécanisme de retour d’information GitHub Issues pour le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez :Soumettre et afficher des commentaires pour