String.Trim Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System
Zestaw:
System.Runtime.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll

Zwraca nowy ciąg, w którym usuwane są wszystkie wystąpienia wiodące i końcowe zestawu określonych znaków z bieżącego ciągu.

Przeciążenia

Trim()

Usuwa wszystkie wiodące i końcowe znaki odstępu z bieżącego ciągu.
Trim(Char[])

Usuwa wszystkie wystąpienia wiodące i końcowe zestawu znaków określonych w tablicy z bieżącego ciągu.
Trim(Char)

Usuwa wszystkie wystąpienia wiodące i końcowe znaku z bieżącego ciągu.

Trim()

Źródło:
String.Manipulation.cs
Źródło:
String.Manipulation.cs
Źródło:
String.Manipulation.cs

Usuwa wszystkie wiodące i końcowe znaki odstępu z bieżącego ciągu.

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

Zwraca

String

Ciąg, który pozostaje po usunięciu wszystkich znaków odstępu od początku i końca bieżącego ciągu. Jeśli nie można przycinać znaków z bieżącego wystąpienia, metoda zwraca bieżące wystąpienie bez zmian.

Przykłady

W poniższym przykładzie użyto String.Trim() metody , aby usunąć wszelkie dodatkowe białe znaki z ciągów wprowadzonych przez użytkownika przed ich połączeniem.

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.

Uwagi

Metoda Trim usuwa z bieżącego ciągu wszystkie znaki wiodące i końcowe znaki odstępu. Każda operacja przycinania wiodącego i końcowego zatrzymuje się po napotkaniu znaku innego niż biały odstęp. Jeśli na przykład bieżący ciąg to " abc xyz", Trim metoda zwraca wartość "abc xyz". Aby usunąć znaki odstępu między wyrazami w ciągu, użyj wyrażeń regularnych platformy .NET.

Uwaga

Trim Jeśli metoda usunie wszystkie znaki z bieżącego wystąpienia, ta metoda nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, w którym zostaną usunięte wszystkie wiodące i końcowe znaki odstępu znajdujące się w bieżącym wystąpieniu.

Jeśli bieżący ciąg jest równy Empty lub wszystkie znaki w bieżącym wystąpieniu składają się z białych znaków, metoda zwraca wartość Empty.

Znaki odstępu są definiowane przez standard Unicode. Metoda Trim usuwa wszystkie znaki wiodące i końcowe, które generują wartość zwracaną true po przekazaniu Char.IsWhiteSpace ich do metody.

Uwagi dotyczące wywoływania

Wersja .NET Framework 3.5 z dodatkiem SP1 i starszymi wersjami utrzymuje wewnętrzną listę znaków odstępów, które ta metoda przycina. Począwszy od .NET Framework 4, metoda przycina wszystkie znaki znaków Znaków Unicode (czyli znaków, które generują wartość zwracaną true po przekazaniu ich do IsWhiteSpace(Char) metody). Ze względu na tę zmianę Trim() metoda w .NET Framework 3.5 SP1 i wcześniejszych wersjach usuwa dwa znaki, ZERO WIDTH SPACE (U+200B) i ZERO WIDTH NO-BREAK SPACE (U+FEFF), że Trim() metoda w .NET Framework 4 i nowszych wersjach nie usuwa. Ponadto Trim() metoda w .NET Framework 3.5 z dodatkiem SP1 i wcześniejszych wersjach nie przycina trzech znaków odstępów Unicode: MONGOLSKI SEPARATOR WEL (U+180E), WĄSKIE MIEJSCE BEZ PRZERWY (U+202F) i ŚREDNIA PRZESTRZEŃ MATEMATYCZNA (U+205F).

Zobacz też

Dotyczy

Trim(Char[])

Źródło:
String.Manipulation.cs
Źródło:
String.Manipulation.cs
Źródło:
String.Manipulation.cs

Usuwa wszystkie wystąpienia wiodące i końcowe zestawu znaków określonych w tablicy z bieżącego ciągu.

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

Parametry

trimChars
Char[]

Tablica znaków Unicode do usunięcia lub null.

Zwraca

String

Ciąg, który pozostaje po wszystkich wystąpieniach znaków w parametrze trimChars , zostanie usunięty z początku i końca bieżącego ciągu. Jeśli trimChars jest lub null pusta tablica, zamiast tego zostaną usunięte znaki odstępu. Jeśli nie można przycinać znaków z bieżącego wystąpienia, metoda zwraca bieżące wystąpienie bez zmian.

Przykłady

W poniższym przykładzie użyto Trim(System.Char[]) metody w celu usunięcia spacji, gwiazdki (*)i znaków apostrofu (') z ciągu.

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'

Uwagi

Metoda Trim(System.Char[]) usuwa z bieżącego ciągu wszystkie znaki wiodące i końcowe, które znajdują się w parametrze trimChars . Każda operacja przycinania wiodącego i końcowego zatrzymuje się, gdy napotkano znak, który nie znajduje się w trimChars . Jeśli na przykład bieżący ciąg to "123abc456xyz789" i trimChars zawiera cyfry z "1" do "9", Trim(System.Char[]) metoda zwraca wartość "abc456xyz".

Uwaga

Trim(System.Char[]) Jeśli metoda usunie wszystkie znaki z bieżącego wystąpienia, ta metoda nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, w którym zostaną usunięte wszystkie znaki wiodące i końcowe trimChars znalezione w bieżącym wystąpieniu.

Jeśli bieżący ciąg jest równy Empty lub wszystkie znaki w bieżącym wystąpieniu trimChars składają się z znaków w tablicy, metoda zwraca wartość Empty.

Jeśli trimChars jest lub null pusta tablica, ta metoda usuwa wszystkie znaki wiodące lub końcowe, które powodują zwrócenie true metody po przekazaniu ich do Char.IsWhiteSpace metody.

Uwagi dotyczące wywoływania

.NET Framework 3.5 SP1 i starsze wersje utrzymują wewnętrzną listę znaków odstępów, które ta metoda przycina, jeśli trimChars jest lub jest null pusta tablica. Począwszy od .NET Framework 4, jeśli trimChars jest lub jest null pustą tablicą, metoda przycina wszystkie znaki Unicode odstępami (czyli znaki, które generują wartość zwracaną true podczas przekazywania do IsWhiteSpace(Char) metody). Ze względu na tę zmianę Trim() metoda w .NET Framework 3.5 SP1 i wcześniejszych wersjach usuwa dwa znaki, ZERO WIDTH SPACE (U+200B) i ZERO WIDTH NO-BREAK SPACE (U+FEFF), że Trim() metoda w .NET Framework 4 i nowszych wersjach nie usuwa. Ponadto Trim() metoda w .NET Framework 3.5 z dodatkiem SP1 i wcześniejszych wersjach nie przycina trzech znaków odstępów Unicode: MONGOLSKI SEPARATOR WEL (U+180E), WĄSKIE MIEJSCE BEZ PRZERWY (U+202F) i ŚREDNIA PRZESTRZEŃ MATEMATYCZNA (U+205F).

Zobacz też

Dotyczy

Trim(Char)

Źródło:
String.Manipulation.cs
Źródło:
String.Manipulation.cs
Źródło:
String.Manipulation.cs

Usuwa wszystkie wystąpienia wiodące i końcowe znaku z bieżącego ciągu.

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

Parametry

trimChar
Char

Znak Unicode do usunięcia.

Zwraca

String

Ciąg, który pozostaje po usunięciu wszystkich wystąpień trimChar znaku od początku i końca bieżącego ciągu. Jeśli nie można przycinać znaków z bieżącego wystąpienia, metoda zwraca bieżące wystąpienie bez zmian.

Uwagi

Metoda Trim(System.Char) usuwa z bieżącego ciągu wszystkie wystąpienia wiodącego i końcowego trimChar znaku. Każda operacja przycinania wiodącego i końcowego zatrzymuje się, gdy napotkany jest znak inny niż trimChar . Jeśli na przykład trimChar jest i - bieżący ciąg to "---abc---xyz----", Trim(System.Char) metoda zwraca wartość "abc---xyz". Aby usunąć znaki między wyrazami w ciągu, użyj wyrażeń regularnych platformy .NET.

Uwaga

Trim(System.Char) Jeśli metoda usunie wszystkie znaki z bieżącego wystąpienia, ta metoda nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, w którym zostaną usunięte wszystkie znaki wiodące i końcowe trimChar znalezione w bieżącym wystąpieniu.

Jeśli bieżący ciąg jest równy Empty lub wszystkie znaki w bieżącym wystąpieniu składają się z trimChar znaków, metoda zwraca wartość Empty.

Dotyczy