String.TrimStart Metode

Definisi

Overload

TrimStart(ReadOnlySpan<Char>)

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

TrimStart()

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

TrimStart(Char)

Menghapus semua kemunculan awal karakter tertentu dari string saat ini.

TrimStart(Char[])

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

TrimStart(ReadOnlySpan<Char>)

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

C#
public string TrimStart (scoped ReadOnlySpan<char> trimChars);

Parameter

trimChars
ReadOnlySpan<Char>

Rentang karakter Unicode untuk dihapus.

Mengembalikan

String yang tetap ada setelah semua kemunculan karakter dalam parameter trimChars dihapus dari awal 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

.NET 9
Produk Versi
.NET 9

TrimStart()

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

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

C#
public string TrimStart ();

Mengembalikan

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

Keterangan

Metode TrimStart dihapus dari string saat ini semua karakter spasi putih terkemuka. Operasi pemangkasan berhenti ketika karakter non spasi putih ditemui. Misalnya, jika string saat ini adalah " abc xyz ", metode TrimStart mengembalikan "abc xyz ".

Catatan

Jika metode TrimStart 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 yang ditemukan dalam instans saat ini dihapus.

Berlaku untuk

.NET 9 dan versi lainnya
Produk Versi
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

TrimStart(Char)

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

Menghapus semua kemunculan awal karakter tertentu dari string saat ini.

C#
public string TrimStart (char trimChar);

Parameter

trimChar
Char

Karakter Unicode yang akan dihapus.

Mengembalikan

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

Keterangan

Metode TrimStart(System.Char) dihapus dari string saat ini semua karakter trimChar depan. Operasi pemangkasan berhenti ketika karakter yang tidak trimChar ditemui. Misalnya, jika trimChar- dan string saat ini adalah "---abc---xyz----", metode TrimStart(System.Char) mengembalikan "abc---xyz----".

Catatan

Jika metode TrimStart(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 yang ditemukan dalam instans saat ini dihapus.

Berlaku untuk

.NET 9 dan versi lainnya
Produk Versi
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

TrimStart(Char[])

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

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

C#
public string TrimStart (params char[] trimChars);
C#
public string TrimStart (params char[]? trimChars);

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 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 menunjukkan fungsionalitas dasar metode TrimStart:

C#
// TrimStart examples
string lineWithLeadingSpaces = "   Hello World!";
string lineWithLeadingSymbols = "$$$$Hello World!";
string lineWithLeadingUnderscores = "_____Hello World!";
string lineWithLeadingLetters = "xxxxHello World!";
string lineAfterTrimStart = string.Empty;

// Make it easy to print out and work with all of the examples
string[] lines = { lineWithLeadingSpaces, lineWithLeadingSymbols, lineWithLeadingUnderscores, lineWithLeadingLetters };

foreach (var line in lines)
{
    Console.WriteLine($"This line has leading characters: {line}");
}
// Output:
// This line has leading characters:    Hello World!
// This line has leading characters: $$$$Hello World!
// This line has leading characters: _____Hello World!
// This line has leading characters: xxxxHello World!

// A basic demonstration of TrimStart in action
lineAfterTrimStart = lineWithLeadingSpaces.TrimStart(' ');
Console.WriteLine($"This is the result after calling TrimStart: {lineAfterTrimStart}");
// This is the result after calling TrimStart: Hello World!   

// Since TrimStart accepts a character array of leading items to be removed as an argument,
// it's possible to do things like trim multiple pieces of data that each have different 
// leading characters,
foreach (var lineToEdit in lines)
{
    Console.WriteLine(lineToEdit.TrimStart(' ', '$', '_', 'x'));
}
// Result for each: Hello World!

// or handle pieces of data that have multiple kinds of leading characters 
var lineToBeTrimmed = "__###__ John Smith";
lineAfterTrimStart = lineToBeTrimmed.TrimStart('_', '#', ' ');
Console.WriteLine(lineAfterTrimStart);
// Result: John Smith

Contoh berikut menggunakan metode TrimStart untuk memangkas spasi putih dan karakter komentar dari baris kode sumber. Metode StripComments membungkus panggilan ke TrimStart dan meneruskannya array karakter yang berisi spasi dan karakter komentar, yang merupakan apostrof ( ' ) di Visual Basic dan garis miring ( / ) di C# atau F#. Metode TrimStart juga dipanggil untuk menghapus spasi putih di depan saat mengevaluasi apakah string adalah komentar.

C#
public static string[] StripComments(string[] lines)
{
    List<string> lineList = new List<string>();
    foreach (string line in lines)
    {
        if (line.TrimStart(' ').StartsWith("//"))
            lineList.Add(line.TrimStart(' ', '/'));
    }
    return lineList.ToArray();
}

Contoh berikut kemudian mengilustrasikan panggilan ke metode StripComments.

C#
public static void Main()
{
    string[] lines = {"using System;",
                   "",
                   "public class HelloWorld",
                   "{",
                   "   public static void Main()",
                   "   {",
                   "      // This code displays a simple greeting",
                   "      // to the console.",
                   "      Console.WriteLine(\"Hello, World.\");",
                   "   }",
                   "}"};
    Console.WriteLine("Before call to StripComments:");
    foreach (string line in lines)
        Console.WriteLine("   {0}", line);

    string[] strippedLines = StripComments(lines);
    Console.WriteLine("After call to StripComments:");
    foreach (string line in strippedLines)
        Console.WriteLine("   {0}", line);
}
// This code produces the following output to the console:
//    Before call to StripComments:
//       using System;
//   
//       public class HelloWorld
//       {
//           public static void Main()
//           {
//               // This code displays a simple greeting
//               // to the console.
//               Console.WriteLine("Hello, World.");
//           }
//       }  
//    After call to StripComments:
//       This code displays a simple greeting
//       to the console.

Keterangan

Metode TrimStart(System.Char[]) dihapus dari string saat ini semua karakter utama yang ada dalam parameter trimChars. Operasi pemangkasan 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 TrimStart(System.Char[]) mengembalikan "abc456xyz789".

Catatan

Jika metode TrimStart(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 utama yang berada dalam parameter trimChars yang ditemukan dalam instans saat ini dihapus.

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 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

.NET 9 dan versi lainnya
Produk Versi
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0