String.PadLeft Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Geçerli dizenin başlangıcının boşluklarla veya belirtilen Unicode karakteriyle doldurulmuş olduğu belirtilen uzunlukta yeni bir dize döndürür.
Aşırı Yüklemeler
PadLeft(Int32) |
Bu örnekteki karakterlerin, belirtilen toplam uzunluk için sol taraftaki boşluklar ile doldurmasını sağlayan yeni bir dize döndürür. |
PadLeft(Int32, Char) |
Belirtilen toplam uzunluk için, belirtilen bir Unicode karakteriyle sola doldurarak bu örnekteki karakterlerin sağına doğru şekilde hizalandığını belirten yeni bir dize döndürür. |
PadLeft(Int32)
Bu örnekteki karakterlerin, belirtilen toplam uzunluk için sol taraftaki boşluklar ile doldurmasını sağlayan yeni bir dize döndürür.
public:
System::String ^ PadLeft(int totalWidth);
public string PadLeft (int totalWidth);
member this.PadLeft : int -> string
Public Function PadLeft (totalWidth As Integer) As String
Parametreler
- totalWidth
- Int32
Özgün karakterlere doldurma karakterleri eklendiğinde çıkan sayıya eşit olan, sonuç dizesindeki karakter sayısı.
Döndürülenler
Bu örneğe eşdeğer, ancak sola hizalanmış ve uzunluğu oluşturmak için gereken sayıda boşluk ile sola doldurulan yeni bir dize totalWidth
. Ancak, totalWidth
Bu örneğin uzunluğundan küçükse, yöntemi mevcut örneğe bir başvuru döndürür. totalWidth
Bu örneğin uzunluğuna eşitse, yöntemi bu örnekle aynı olan yeni bir dize döndürür.
Özel durumlar
totalWidth
, sıfırdan küçüktür.
Örnekler
Aşağıdaki örnek PadLeft yöntemini gösterir.
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".
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".
Açıklamalar
Unicode alanı, onaltılık bir 0x0020 olarak tanımlanır.
PadLeft(Int32)Yöntemi döndürülen dizenin başlangıcını defterler. Bu, sağdan sola dillerin kullanıldığı durumlarda dizenin sağ bölümünün bulunduğu anlamına gelir.
Not
PadLeftYöntem geçerli örneği beyaz boşluk karakterleriyle doldursa, bu yöntem geçerli örneğin değerini değiştirmez. Bunun yerine, toplam uzunluğu karakter olacak şekilde, baştaki boşluk ile doldurulmuş yeni bir dize döndürür totalWidth
.
Ayrıca bkz.
Şunlara uygulanır
PadLeft(Int32, Char)
Belirtilen toplam uzunluk için, belirtilen bir Unicode karakteriyle sola doldurarak bu örnekteki karakterlerin sağına doğru şekilde hizalandığını belirten yeni bir dize döndürür.
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
Parametreler
- totalWidth
- Int32
Özgün karakterlere doldurma karakterleri eklendiğinde çıkan sayıya eşit olan, sonuç dizesindeki karakter sayısı.
- paddingChar
- Char
Unicode doldurma karakteri.
Döndürülenler
Bu örneğe eşdeğer, ancak sola hizalanmış ve paddingChar
uzunluğu oluşturmak için gereken sayıda karakter içeren yeni bir dize totalWidth
. Ancak, totalWidth
Bu örneğin uzunluğundan küçükse, yöntemi mevcut örneğe bir başvuru döndürür. totalWidth
Bu örneğin uzunluğuna eşitse, yöntemi bu örnekle aynı olan yeni bir dize döndürür.
Özel durumlar
totalWidth
, sıfırdan küçüktür.
Örnekler
Aşağıdaki örnek PadLeft yöntemini gösterir.
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
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
Açıklamalar
PadLeft(Int32, Char)Yöntemi döndürülen dizenin başlangıcını defterler. Bu, sağdan sola dillerin kullanıldığı durumlarda dizenin sağ bölümünün bulunduğu anlamına gelir.
Not
PadLeftYöntem geçerli örneği beyaz boşluk karakterleriyle doldursa, bu yöntem geçerli örneğin değerini değiştirmez. Bunun yerine, toplam uzunluğu karakter olacak şekilde öndeki karakterlerle doldurulan yeni bir dize döndürür paddingChar
totalWidth
.