String.PadLeft Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí nový řetězec o zadané délce, ve kterém je začátek aktuálního řetězce doplněn mezerami nebo se zadaným znakem Unicode.
Přetížení
PadLeft(Int32) |
Vrátí nový řetězec, který vpravo zarovná znaky v této instanci jejich vyplněním mezerami na levé straně pro zadanou celkovou délku. |
PadLeft(Int32, Char) |
Vrátí nový řetězec, který vpravo zarovná znaky v této instanci jejich vyplněním na levé straně se zadaným znakem Unicode pro zadanou celkovou délku. |
PadLeft(Int32)
Vrátí nový řetězec, který vpravo zarovná znaky v této instanci jejich vyplněním mezerami na levé straně pro zadanou celkovou délku.
public:
System::String ^ PadLeft(int totalWidth);
public string PadLeft (int totalWidth);
member this.PadLeft : int -> string
Public Function PadLeft (totalWidth As Integer) As String
Parametry
- totalWidth
- Int32
Počet znaků ve výsledném řetězci, který se rovná počtu původních znaků plus všech dalších znaků odsazení.
Návraty
Nový řetězec, který je ekvivalentní této instanci, ale vpravo zarovnaný a doplněný o tolik mezer, kolik jich je potřeba k vytvoření délky totalWidth
. Pokud je však totalWidth
menší než délka této instance, metoda vrátí odkaz na existující instanci. Pokud totalWidth
se rovná délce této instance, vrátí metoda nový řetězec, který je totožný s touto instancí.
Výjimky
Hodnota totalWidth
je menší než nula.
Příklady
Následující příklad ukazuje PadLeft metodu.
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".
Poznámky
Místo Unicode je definováno jako šestnáctkové 0x0020.
Metoda rozpustí PadLeft(Int32) začátek vráceného řetězce. To znamená, že při použití s jazyky se zápisem zprava doleva se tato pravá část řetězce.
Poznámka
Pokud metoda zavolá PadLeft aktuální instanci s prázdnými znaky, tato metoda neupraví hodnotu aktuální instance. Místo toho vrátí nový řetězec, který je doplněn počáteční mezerou, takže jeho celková délka je totalWidth
znaků.
Viz také
Platí pro
PadLeft(Int32, Char)
Vrátí nový řetězec, který vpravo zarovná znaky v této instanci jejich vyplněním na levé straně se zadaným znakem Unicode pro zadanou celkovou délku.
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
Parametry
- totalWidth
- Int32
Počet znaků ve výsledném řetězci, který se rovná počtu původních znaků plus všech dalších znaků odsazení.
- paddingChar
- Char
Znak odsazení sady Unicode.
Návraty
Nový řetězec, který je ekvivalentní této instanci, ale vpravo zarovnaný a doplněný o tolik znaků, kolik paddingChar
je potřeba k vytvoření délky totalWidth
. Pokud je však totalWidth
menší než délka této instance, metoda vrátí odkaz na existující instanci. Pokud totalWidth
se rovná délce této instance, vrátí metoda nový řetězec, který je totožný s touto instancí.
Výjimky
Hodnota totalWidth
je menší než nula.
Příklady
Následující příklad ukazuje PadLeft metodu.
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
Poznámky
Metoda rozpustí PadLeft(Int32, Char) začátek vráceného řetězce. To znamená, že při použití s jazyky se zápisem zprava doleva se tato pravá část řetězce.
Poznámka
Pokud metoda zavolá PadLeft aktuální instanci s prázdnými znaky, tato metoda neupraví hodnotu aktuální instance. Místo toho vrátí nový řetězec, který je doplněn o úvodní paddingChar
znaky, takže jeho celková délka je totalWidth
znaků.