String.PadLeft Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

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

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

String

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

ArgumentOutOfRangeException

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é

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

PadLeft(Int32)

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

String

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

ArgumentOutOfRangeException

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.

Viz také

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