String.PadLeft Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Mengembalikan string baru dengan panjang yang ditentukan di mana awal string saat ini diisi dengan spasi atau dengan karakter Unicode tertentu.

Overload

PadLeft(Int32, Char)	Mengembalikan string baru yang meratakan kanan karakter dalam instans ini dengan mengayuhnya di sebelah kiri dengan karakter Unicode tertentu, untuk panjang total yang ditentukan.
PadLeft(Int32)	Mengembalikan string baru yang meratakan kanan karakter dalam instans ini dengan mengayuhnya dengan spasi di sebelah kiri, untuk panjang total yang ditentukan.

PadLeft(Int32, Char)

Sumber:

String.Manipulation.cs

Mengembalikan string baru yang meratakan kanan karakter dalam instans ini dengan mengayuhnya di sebelah kiri dengan karakter Unicode tertentu, untuk panjang total yang ditentukan.

public:
 System::String ^ PadLeft(int totalWidth, char paddingChar);

public string PadLeft (int totalWidth, char paddingChar);

member this.PadLeft : int * char -> string

Public Function PadLeft (totalWidth As Integer, paddingChar As Char) As String

Parameter

totalWidth

Int32

Jumlah karakter dalam string yang dihasilkan, sama dengan jumlah karakter asli ditambah karakter padding tambahan.

paddingChar

Char

Karakter padding Unicode.

Mengembalikan

String

String baru yang setara dengan instans ini, tetapi rata kanan dan diisi di sebelah kiri dengan karakter sebanyak paddingChar yang diperlukan untuk membuat panjang totalWidth. Namun, jika totalWidth kurang dari panjang instans ini, metode mengembalikan referensi ke instans yang ada. Jika totalWidth sama dengan panjang instans ini, metode mengembalikan string baru yang identik dengan instans ini.

Pengecualian

ArgumentOutOfRangeException

totalWidth kurang dari nol.

Contoh

Contoh berikut menunjukkan PadLeft metode .

using namespace System;

void main()
{
   String^ str = "forty-two";
   Console::WriteLine( str->PadLeft( 15, L'.' ) ); 
   Console::WriteLine( str->PadLeft( 2, L'.' ) ); 
}
// The example displays the following output:
//       ......forty-two
//       forty-two

using System;

class Sample
{
   public static void Main()
   {
   string str = "forty-two";
   char pad = '.';

   Console.WriteLine(str.PadLeft(15, pad));
   Console.WriteLine(str.PadLeft(2, pad));
   }
}
// The example displays the following output:
//       ......forty-two
//       forty-two

let str = "forty-two"
let pad = '.'

printfn $"{str.PadLeft(15, pad)}"
printfn $"{str.PadLeft(2, pad)}"
// The example displays the following output:
//       ......forty-two
//       forty-two

Public Class Example
   Public Shared Sub Main()
      Dim str As String
      Dim pad As Char
      str = "forty-two"
      pad = "."c
      Console.WriteLine(str.PadLeft(15, pad)) 
      Console.WriteLine(str.PadLeft(2,  pad))
    End Sub
End Class
' The example displays the following output:
'       ......forty-two
'       forty-two

Keterangan

Metode ini PadLeft(Int32, Char) mengalihkan awal string yang dikembalikan. Ini berarti bahwa, ketika digunakan dengan bahasa kanan-ke-kiri, ia mengalihkan bagian kanan string.

Catatan

Jika metode mengalihkan PadLeft instans saat ini dengan karakter spasi putih, metode ini tidak mengubah nilai instans saat ini. Sebaliknya, ia mengembalikan string baru yang dilapisi dengan karakter terkemuka paddingChar sehingga panjang totalnya adalah totalWidth karakter.

Lihat juga

• Char
• Int32
• PadRight(Int32)
• Trim(Char[])

PadLeft(Int32)

Sumber:

String.Manipulation.cs

Mengembalikan string baru yang meratakan kanan karakter dalam instans ini dengan mengayuhnya dengan spasi di sebelah kiri, untuk panjang total yang ditentukan.

public:
 System::String ^ PadLeft(int totalWidth);

public string PadLeft (int totalWidth);

member this.PadLeft : int -> string

Public Function PadLeft (totalWidth As Integer) As String

Parameter

totalWidth

Int32

Jumlah karakter dalam string yang dihasilkan, sama dengan jumlah karakter asli ditambah karakter padding tambahan.

Mengembalikan

String

String baru yang setara dengan instans ini, tetapi rata kanan dan diisi di sebelah kiri dengan spasi sebanyak yang diperlukan untuk membuat panjang totalWidth. Namun, jika totalWidth kurang dari panjang instans ini, metode mengembalikan referensi ke instans yang ada. Jika totalWidth sama dengan panjang instans ini, metode mengembalikan string baru yang identik dengan instans ini.

Pengecualian

ArgumentOutOfRangeException

totalWidth kurang dari nol.

Contoh

Contoh berikut menunjukkan PadLeft metode .

String^ str = "BBQ and Slaw";
Console::WriteLine( str->PadLeft( 15 ) ); // Displays "   BBQ and Slaw".
Console::WriteLine( str->PadLeft( 5 ) );  // Displays "BBQ and Slaw".

string str = "BBQ and Slaw";
Console.WriteLine(str.PadLeft(15));  // Displays "   BBQ and Slaw".
Console.WriteLine(str.PadLeft(5));   // Displays "BBQ and Slaw".

let str = "BBQ and Slaw"
printfn $"{str.PadLeft 15}"  // Displays "   BBQ and Slaw".
printfn $"{str.PadLeft 5}"   // Displays "BBQ and Slaw".

Dim str As String
str = "BBQ and Slaw"
Console.WriteLine(str.PadLeft(15)) ' Displays "   BBQ and Slaw".
Console.WriteLine(str.PadLeft(5))  ' Displays "BBQ and Slaw".

Keterangan

Ruang Unicode didefinisikan sebagai 0x0020 heksadesimal.

Metode ini PadLeft(Int32) mengalihkan awal string yang dikembalikan. Ini berarti bahwa, ketika digunakan dengan bahasa kanan-ke-kiri, ia mengalihkan bagian kanan string.

Catatan

Jika metode mengalihkan PadLeft instans saat ini dengan karakter spasi putih, metode ini tidak mengubah nilai instans saat ini. Sebaliknya, ia mengembalikan string baru yang dilapisi dengan spasi putih di depannya sehingga panjang totalnya adalah totalWidth karakter.

Lihat juga

• Int32
• PadRight(Int32)
• Trim(Char[])