String.TrimStart Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Overload

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

Sumber:

String.Manipulation.cs

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

public:
 System::String ^ TrimStart();

public string TrimStart ();

member this.TrimStart : unit -> string

Public Function TrimStart () As String

Mengembalikan

String

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

Nota

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.

TrimStart(Char)

Sumber:

String.Manipulation.cs

Menghapus semua kemunculan awal karakter tertentu dari string saat ini.

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

public string TrimStart (char trimChar);

member this.TrimStart : char -> string

Public Function TrimStart (trimChar As Char) As String

Parameter

trimChar

Char

Karakter Unicode yang akan dihapus.

Mengembalikan

String

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

Nota

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.

TrimStart(Char[])

Sumber:

String.Manipulation.cs

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

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

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

member this.TrimStart : char[] -> string

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

Parameter

trimChars

Char[]

Array karakter Unicode untuk dihapus, atau null.

Mengembalikan

String

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:

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

// TrimStart examples
let lineWithLeadingSpaces = "   Hello World!"
let lineWithLeadingSymbols = "$$$$Hello World!"
let lineWithLeadingUnderscores = "_____Hello World!"
let lineWithLeadingLetters = "xxxxHello World!"

// Make it easy to print out and work with all of the examples
let lines = [| lineWithLeadingSpaces; lineWithLeadingSymbols; lineWithLeadingUnderscores; lineWithLeadingLetters |]

for line in lines do
    printfn $"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
let lineAfterTrimStart = lineWithLeadingSpaces.TrimStart ' '
printfn $"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,
for lineToEdit in lines do
    printfn $"""{lineToEdit.TrimStart(' ', '$', '_', 'x')}"""
// Result for each: Hello World!

// or handle pieces of data that have multiple kinds of leading characters 
let lineToBeTrimmed = "__###__ John Smith"
let lineAfterTrimStart2 = lineToBeTrimmed.TrimStart('_', '#', ' ')
printfn $"{lineAfterTrimStart2}"
// Result: John Smith

Public Sub Main()
   ' TrimStart Examples
   Dim lineWithLeadingSpaces as String = "   Hello World!"
   Dim lineWithLeadingSymbols as String = "$$$$Hello World!"
   Dim lineWithLeadingUnderscores as String = "_____Hello World!"
   Dim lineWithLeadingLetters as String = "xxxxHello World!"
   Dim lineAfterTrimStart = String.Empty

   ' Make it easy to print out and work with all of the examples
   Dim lines As String() = { lineWithLeadingSpaces, line lineWithLeadingSymbols, lineWithLeadingUnderscores, lineWithLeadingLetters }

   For Each line As String in lines
     Console.WriteLine($"This line has leading characters: {line}")
   Next
   ' 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!

   Console.WriteLine($"This line has leading spaces: {lineWithLeadingSpaces}")
   ' This line has leading spaces:   Hello World!

   ' A basic demonstration of TrimStart in action
   lineAfterTrimStart = lineWithLeadingSpaces.TrimStart(" "c)
   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,
   For Each lineToEdit As String in lines
     Console.WriteLine(lineToEdit.TrimStart(" "c, "$"c, "_"c, "x"c ))
   Next
   ' Result for each: Hello World!

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

 End Sub

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.

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();
}

let stripComments (lines: #seq<string>) =
    [|  for line in lines do
            if line.TrimStart(' ').StartsWith "//" then
                line.TrimStart(' ', '/') |]

Public Shared Function StripComments(lines() As String) As String()
   Dim lineList As New List(Of String)
   For Each line As String In lines
      If line.TrimStart(" "c).StartsWith("'") Then
         linelist.Add(line.TrimStart("'"c, " "c))
      End If
   Next
   Return lineList.ToArray()
End Function

Contoh berikut kemudian mengilustrasikan panggilan ke metode StripComments.

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.

let lines = 
    [| "module HelloWorld"
       ""
       "[<EntryPoint>]"
       "let main _ ="
       "    // This code displays a simple greeting"
       "    // to the console."
       "    printfn \"Hello, World.\""
       "    0" |]
printfn "Before call to StripComments:"
for line in lines do
    printfn $"   {line}"

let strippedLines = stripComments lines
printfn "After call to StripComments:"
for line in strippedLines do
    printfn $"   {line}"
// This code produces the following output to the console:
//    Before call to StripComments:
//       module HelloWorld
//
//       [<EntryPoint>]
//       let main _ =
//           // This code displays a simple greeting
//           // to the console.
//           printfn "Hello, World."
//           0
//    After call to StripComments:
//       This code displays a simple greeting
//       to the console.

Public Shared Sub Main()
   Dim lines() As String = {"Public Module HelloWorld", _
                            "   Public Sub Main()", _
                            "      ' This code displays a simple greeting", _
                            "      ' to the console.", _
                            "      Console.WriteLine(""Hello, World."")", _
                            "   End Sub", _
                            " End Module"}
   Console.WriteLine("Code before call to StripComments:")
   For Each line As String In lines
      Console.WriteLine("   {0}", line)                         
   Next                            
   
   Dim strippedLines() As String = StripComments(lines) 
   Console.WriteLine("Code after call to StripComments:")
   For Each line As String In strippedLines
      Console.WriteLine("   {0}", line)                         
   Next                            
End Sub
' This code produces the following output to the console:
'    Code before call to StripComments:
'       Public Module HelloWorld
'          Public Sub Main()
'             ' This code displays a simple greeting
'             ' to the console.
'             Console.WriteLine("Hello, World.")
'          End Sub
'       End Module
'    Code 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".

Nota

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

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