Bagikan melalui


String.Trim Metode

Definisi

Mengembalikan string baru di mana semua kemunculan awal dan akhir dari sekumpulan karakter tertentu dari string saat ini dihapus.

Overload

Trim(Char)

Menghapus semua instans karakter di awal dan akhir dari string saat ini.

Trim(ReadOnlySpan<Char>)

Menghapus semua kemunculan awal dan akhir dari sekumpulan karakter yang ditentukan dalam rentang dari string saat ini.

Trim()

Menghapus semua karakter spasi putih di depan dan di belakang dari string saat ini.

Trim(Char[])

Menghapus semua kemunculan awal dan akhir dari sekumpulan karakter yang ditentukan dalam array dari string saat ini.

Trim(Char)

Sumber:
String.Manipulation.cs
Sumber:
String.Manipulation.cs
Sumber:
String.Manipulation.cs

Menghapus semua instans karakter di awal dan akhir dari string saat ini.

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

Parameter

trimChar
Char

Karakter Unicode yang akan dihapus.

Mengembalikan

String yang tetap ada setelah semua instans karakter trimChar dihapus dari awal dan akhir string saat ini. Jika tidak ada karakter yang dapat dipangkas dari instans saat ini, metode mengembalikan instans saat ini yang tidak berubah.

Keterangan

Metode Trim(System.Char) menghapus dari string saat ini semua instans terkemuka dan berikutnya dari karakter trimChar. Setiap operasi pemangkasan di depan dan berikutnya berhenti ketika karakter yang berbeda dari trimChar ditemui. Misalnya, jika trimChar- dan string saat ini adalah "---abc---xyz----", metode Trim(System.Char) mengembalikan "abc---xyz". Untuk menghapus karakter antar kata dalam string, gunakan .NET Regular Expressions.

Nota

Jika metode Trim(System.Char) menghapus karakter apa pun dari instans saat ini, metode ini tidak mengubah nilai instans saat ini. Sebaliknya, ini mengembalikan string baru di mana semua karakter trimChar terkemuka dan berikutnya yang ditemukan dalam instans saat ini dihapus.

Jika string saat ini sama dengan Empty atau semua karakter dalam instans saat ini terdiri dari karakter trimChar, metode mengembalikan Empty.

Berlaku untuk

Trim(ReadOnlySpan<Char>)

Menghapus semua kemunculan awal dan akhir dari sekumpulan karakter yang ditentukan dalam rentang dari string saat ini.

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

Parameter

trimChars
ReadOnlySpan<Char>

Rentang karakter Unicode untuk dihapus.

Mengembalikan

String yang tetap ada setelah semua kemunculan karakter dalam parameter trimChars dihapus dari awal dan akhir string saat ini. Jika trimChars kosong, karakter spasi putih akan dihapus sebagai gantinya. Jika tidak ada karakter yang dapat dipangkas dari instans saat ini, metode mengembalikan instans saat ini yang tidak berubah.

Berlaku untuk

Trim()

Sumber:
String.Manipulation.cs
Sumber:
String.Manipulation.cs
Sumber:
String.Manipulation.cs

Menghapus semua karakter spasi putih di depan dan di belakang dari string saat ini.

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

Mengembalikan

String yang tetap ada setelah semua karakter spasi putih dihapus dari awal dan akhir string saat ini. Jika tidak ada karakter yang dapat dipangkas dari instans saat ini, metode mengembalikan instans saat ini yang tidak berubah.

Contoh

Contoh berikut menggunakan metode String.Trim() untuk menghapus spasi kosong tambahan dari string yang dimasukkan oleh pengguna sebelum menggabungkannya.

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.

Keterangan

Metode Trim dihapus dari string saat ini semua karakter spasi putih di depan dan berikutnya. Setiap operasi pemangkasan di depan dan berikutnya berhenti ketika karakter spasi non-putih ditemui. Misalnya, jika string saat ini adalah " abc xyz ", metode Trim mengembalikan "abc xyz". Untuk menghapus karakter spasi putih antar kata dalam string, gunakan .NET Regular Expressions.

Nota

Jika metode Trim menghapus karakter apa pun dari instans saat ini, metode ini tidak mengubah nilai instans saat ini. Sebaliknya, ini mengembalikan string baru di mana semua karakter spasi putih terkemuka dan berikutnya yang ditemukan dalam instans saat ini dihapus.

Jika string saat ini sama dengan Empty atau semua karakter dalam instans saat ini terdiri dari karakter spasi putih, metode mengembalikan Empty.

Karakter spasi putih didefinisikan oleh standar Unicode. Metode Trim menghapus karakter terkemuka dan berikutnya yang menghasilkan nilai pengembalian true ketika diteruskan ke metode Char.IsWhiteSpace.

Catatan Bagi Pemanggil

.NET Framework 3.5 SP1 dan versi yang lebih lama mempertahankan daftar internal karakter spasi putih yang dipangkas metode ini. Dimulai dengan .NET Framework 4, metode memangkas semua karakter spasi putih Unicode (yaitu, karakter yang menghasilkan nilai pengembalian true ketika diteruskan ke metode IsWhiteSpace(Char)). Karena perubahan ini, metode Trim() dalam .NET Framework 3.5 SP1 dan versi yang lebih lama menghapus dua karakter, ZERO WIDTH SPACE (U+200B) dan ZERO WIDTH NO-BREAK SPACE (U+FEFF), bahwa metode Trim() dalam versi .NET Framework 4 dan versi yang lebih baru tidak dihapus. Selain itu, metode Trim() dalam .NET Framework 3.5 SP1 dan versi yang lebih lama tidak memangkas tiga karakter spasi putih Unicode: MONGOLIAN VOWEL SEPARATOR (U+180E), NARROW NO-BREAK SPACE (U+202F), dan MEDIUM MATHEMATICAL SPACE (U+205F).

Lihat juga

Berlaku untuk

Trim(Char[])

Sumber:
String.Manipulation.cs
Sumber:
String.Manipulation.cs
Sumber:
String.Manipulation.cs

Menghapus semua kemunculan awal dan akhir dari sekumpulan karakter yang ditentukan dalam array dari string saat ini.

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

Parameter

trimChars
Char[]

Array karakter Unicode untuk dihapus, atau null.

Mengembalikan

String yang tetap ada setelah semua kemunculan karakter dalam parameter trimChars dihapus dari awal dan akhir string saat ini. Jika trimCharsnull atau array kosong, karakter spasi putih akan dihapus sebagai gantinya. Jika tidak ada karakter yang dapat dipangkas dari instans saat ini, metode mengembalikan instans saat ini yang tidak berubah.

Contoh

Contoh berikut menggunakan metode Trim(System.Char[]) untuk menghapus karakter spasi, tanda bintang (*), dan apostrof (') dari string.

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'

Keterangan

Metode Trim(System.Char[]) dihapus dari string saat ini semua karakter terkemuka dan berikutnya yang ada dalam parameter trimChars. Setiap operasi pemangkasan awal dan berikutnya berhenti ketika karakter yang tidak ada dalam trimChars ditemui. Misalnya, jika string saat ini adalah "123abc456xyz789" dan trimChars berisi digit dari "1" hingga "9", metode Trim(System.Char[]) mengembalikan "abc456xyz".

Nota

Jika metode Trim(System.Char[]) menghapus karakter apa pun dari instans saat ini, metode ini tidak mengubah nilai instans saat ini. Sebaliknya, ini mengembalikan string baru di mana semua karakter trimChars terkemuka dan berikutnya yang ditemukan dalam instans saat ini dihapus.

Jika string saat ini sama dengan Empty atau semua karakter dalam instans saat ini terdiri dari karakter dalam array trimChars, metode akan mengembalikan Empty.

Jika trimCharsnull atau array kosong, metode ini menghapus karakter terkemuka atau berikutnya yang menghasilkan metode yang mengembalikan true ketika diteruskan ke metode Char.IsWhiteSpace.

Catatan Bagi Pemanggil

.NET Framework 3.5 SP1 dan versi yang lebih lama mempertahankan daftar internal karakter spasi putih yang dipangkas metode ini jika trimCharsnull atau array kosong. Dimulai dengan .NET Framework 4, jika trimCharsnull atau array kosong, metode memangkas semua karakter spasi putih Unicode (yaitu, karakter yang menghasilkan nilai pengembalian true ketika diteruskan ke metode IsWhiteSpace(Char)). Karena perubahan ini, metode Trim() dalam .NET Framework 3.5 SP1 dan versi yang lebih lama menghapus dua karakter, ZERO WIDTH SPACE (U+200B) dan ZERO WIDTH NO-BREAK SPACE (U+FEFF), bahwa metode Trim() dalam versi .NET Framework 4dan versi yang lebih baru tidak dihapus. Selain itu, metode Trim() dalam .NET Framework 3.5 SP1 dan versi yang lebih lama tidak memangkas tiga karakter spasi putih Unicode: MONGOLIAN VOWEL SEPARATOR (U+180E), NARROW NO-BREAK SPACE (U+202F), dan MEDIUM MATHEMATICAL SPACE (U+205F).

Lihat juga

Berlaku untuk