String.PadLeft Metoda

  • Reference

Definice

Obor názvů:
System
Sestavení:
System.Runtime.dll
Sestavení:
netstandard.dll
Sestavení:
mscorlib.dll

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

String

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

ArgumentOutOfRangeException

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

String

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

ArgumentOutOfRangeException

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ů.

Viz také

Platí pro