String.PadRight 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 konec aktuálního řetězce doplněn mezerami nebo se zadaným znakem Unicode.

Přetížení

PadRight(Int32)

Vrátí nový řetězec, který vlevo zarovná znaky v tomto řetězci jejich vyplněním mezerami na pravé straně pro zadanou celkovou délku.
PadRight(Int32, Char)

Vrátí nový řetězec, který zarovná znaky v tomto řetězci doleva tak, že je na pravé straně odsaže zadaným znakem Unicode pro zadanou celkovou délku.

PadRight(Int32)

Vrátí nový řetězec, který vlevo zarovná znaky v tomto řetězci jejich vyplněním mezerami na pravé straně pro zadanou celkovou délku.

public:
 System::String ^ PadRight(int totalWidth);
public string PadRight (int totalWidth);
member this.PadRight : int -> string
Public Function PadRight (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 vlevo zarovnané a doplněn na pravé straně s tolika mezerami, 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 PadRight metodu.

String^ str = "BBQ and Slaw";
Console::Write( "|" );
Console::Write( str->PadRight( 15 ) );
Console::WriteLine( "|" ); // Displays "|BBQ and Slaw   |".
Console::Write( "|" );
Console::Write( str->PadRight( 5 ) );
Console::WriteLine( "|" ); // Displays "|BBQ and Slaw|".

string str;
str = "BBQ and Slaw";

Console.Write("|");
Console.Write(str.PadRight(15));
Console.WriteLine("|");       // Displays "|BBQ and Slaw   |".

Console.Write("|");
Console.Write(str.PadRight(5));
Console.WriteLine("|");       // Displays "|BBQ and Slaw|".

Dim str As String
str = "BBQ and Slaw"

Console.Write("|")
Console.Write(str.PadRight(15))
Console.WriteLine("|") ' Displays "|BBQ and Slaw   |".

Console.Write("|")
Console.Write(str.PadRight(5))
Console.WriteLine("|") ' Displays "|BBQ and Slaw|".

Poznámky

Místo Unicode je definováno jako šestnáctkové 0x0020.

PadRight(Int32)Metoda dokončí konec vráceného řetězce. To znamená, že při použití s jazyky se zápisem zprava doleva využije levou část řetězce.

Poznámka

Pokud metoda zavolá PadRight 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 koncovým prázdným znakem, aby jeho celková délka byla totalWidth znaků.

Viz také

Platí pro

PadRight(Int32, Char)

Vrátí nový řetězec, který zarovná znaky v tomto řetězci doleva tak, že je na pravé straně odsaže zadaným znakem Unicode pro zadanou celkovou délku.

public:
 System::String ^ PadRight(int totalWidth, char paddingChar);
public string PadRight (int totalWidth, char paddingChar);
member this.PadRight : int * char -> string
Public Function PadRight (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 zarovnaný doleva a odsazení vpravo s tolika znaky, kolik je potřeba k vytvoření paddingChar délky totalWidth . Pokud je však menší než délka této instance, metoda totalWidth vrátí odkaz na existující instanci. Pokud totalWidth je rovna délce této instance, metoda vrátí nový řetězec, který je stejný jako tato instance.

Výjimky

ArgumentOutOfRangeException

Hodnota totalWidth je menší než nula.

Příklady

Následující příklad ukazuje PadRight metodu .

String^ str = "forty-two";
Console::Write( "|" );
Console::Write( str->PadRight( 15, '.' ) );
Console::WriteLine( "|" ); // Displays "|forty-two......|".
Console::Write( "|" );
Console::Write( str->PadRight( 5, '.' ) );
Console::WriteLine( "|" ); // Displays "|forty-two|".

string str = "forty-two";
char pad = '.';

Console.WriteLine(str.PadRight(15, pad));    // Displays "forty-two......".
Console.WriteLine(str.PadRight(2,  pad));    // Displays "forty-two".

Dim str As String
Dim pad As Char
str = "forty-two"
pad = Convert.ToChar(".") 
Console.WriteLine(str.PadRight(15, pad)) ' Displays "|forty-two......|".
Console.WriteLine(str.PadRight(2,  pad)) ' Displays "|forty-two|".

Poznámky

Metoda PadRight(Int32, Char) odsouvá konec vráceného řetězce. To znamená, že při použití s jazyky se šipkami zprava doleva se odsaží levá část řetězce.

Poznámka

Pokud PadRight metoda zamíchá aktuální instanci mezerami, tato metoda neupraví hodnotu aktuální instance. Místo toho vrátí nový řetězec, který je odsaněný koncovými znaky, takže paddingChar jeho celková délka je totalWidth znaky.

Viz také

Platí pro