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 zadané délky, ve kterém je začátek aktuálního řetězce vyplněn mezerami nebo zadaným znakem Unicode.
Přetížení
PadLeft(Int32, Char) |
Vrátí nový řetězec, který zarovná znaky v této instanci doprava tak, že je vlevo odsadí zadaným znakem Unicode pro zadanou celkovou délku. |
PadLeft(Int32) |
Vrátí nový řetězec, který zarovná znaky v této instanci doprava tak, že je odsadí mezerami nalevo pro zadanou celkovou délku. |
PadLeft(Int32, Char)
- Zdroj:
- String.Manipulation.cs
- Zdroj:
- String.Manipulation.cs
- Zdroj:
- String.Manipulation.cs
Vrátí nový řetězec, který zarovná znaky v této instanci doprava tak, že je vlevo odsadí 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í unicode.
Návraty
Nový řetězec, který je ekvivalentní této instanci, ale zarovnaný doprava a v levé části s tolika znaky, kolik paddingChar
je potřeba k vytvoření délky totalWidth
. Pokud je však totalWidth
menší než délka této instance, vrátí metoda odkaz na existující instanci. Pokud totalWidth
se rovná délce této instance, vrátí metoda nový řetězec, který je identický s touto instancí.
Výjimky
Hodnota totalWidth
je menší než nula.
Příklady
Následující příklad ukazuje metodu PadLeft .
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
Poznámky
Metoda PadLeft(Int32, Char) vysadí začátek vráceného řetězce. To znamená, že při použití s jazyky se zprava doleva použije pravou část řetězce.
Poznámka
PadLeft Pokud metoda vysadí aktuální instanci prázdnými znaky, tato metoda nezmění hodnotu aktuální instance. Místo toho vrátí nový řetězec, který je vyplněn úvodními paddingChar
znaky tak, aby jeho celková délka byla totalWidth
znaky.
Viz také
Platí pro
PadLeft(Int32)
- Zdroj:
- String.Manipulation.cs
- Zdroj:
- String.Manipulation.cs
- Zdroj:
- String.Manipulation.cs
Vrátí nový řetězec, který zarovná znaky v této instanci doprava tak, že je odsadí mezerami nalevo 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 je zarovnaný doprava a vysunout vlevo s tolika mezerami, kolik je potřeba k vytvoření délky totalWidth
. Pokud je však totalWidth
menší než délka této instance, vrátí metoda odkaz na existující instanci. Pokud totalWidth
se rovná délce této instance, vrátí metoda nový řetězec, který je identický s touto instancí.
Výjimky
Hodnota totalWidth
je menší než nula.
Příklady
Následující příklad ukazuje metodu PadLeft .
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".
Poznámky
Prostor Unicode je definován jako šestnáctkové 0x0020.
Metoda PadLeft(Int32) vysadí začátek vráceného řetězce. To znamená, že při použití s jazyky se zprava doleva použije pravou část řetězce.
Poznámka
PadLeft Pokud metoda vysadí aktuální instanci prázdnými znaky, tato metoda nezmění hodnotu aktuální instance. Místo toho vrátí nový řetězec, který je vyplněný počátečními prázdnými znaky tak, aby jeho celková délka byla totalWidth
znaky.