Поделиться через


String.PadRight Метод

Определение

Возвращает новую строку указанной длины, в которой конец текущей строки заполняется символами-разделителями или указанным знаком Юникода.

Перегрузки

PadRight(Int32)

Возвращает новую строку, в которой знаки данной строки выровнены по левому краю путем добавления справа пробелов до указанной общей длины.

PadRight(Int32, Char)

Возвращает новую строку, в которой знаки данной строки выровнены по левому краю путем добавления справа пробелов или указанного знака Юникода до указанной общей длины.

PadRight(Int32)

Исходный код:
String.Manipulation.cs
Исходный код:
String.Manipulation.cs
Исходный код:
String.Manipulation.cs

Возвращает новую строку, в которой знаки данной строки выровнены по левому краю путем добавления справа пробелов до указанной общей длины.

public:
 System::String ^ PadRight(int totalWidth);
public string PadRight (int totalWidth);
member this.PadRight : int -> string
Public Function PadRight (totalWidth As Integer) As String

Параметры

totalWidth
Int32

Количество знаков в полученной строке, равное числу исходных знаков плюс некоторое количество добавленных для заполнения знаков.

Возвращаемое значение

Новая строка, эквивалентная данному экземпляру, но с выравниванием по левому краю и с добавленными справа пробелами, необходимыми для достижения длины totalWidth. Однако если значение параметра totalWidth меньше длины данного экземпляра, метод возвращает ссылку на имеющийся экземпляр. Если значение параметра totalWidth равно длине данного экземпляра, метод возвращает новую строку, идентичную данному экземпляру.

Исключения

Значение параметра totalWidth меньше нуля.

Примеры

В следующем примере демонстрируется PadRight метод.

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|".
let str = "BBQ and Slaw"

printf "|"
printf $"{str.PadRight 15}"
printfn "|"       // Displays "|BBQ and Slaw   |".

printf "|"
printf $"{str.PadRight 5}"
printfn "|"       // 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|".

Комментарии

Пространство Юникода определяется как шестнадцатеричное 0x0020.

Метод PadRight(Int32) заполняет конец возвращаемой строки. Это означает, что при использовании с языками справа налево она заполняет левую часть строки.

Примечание

PadRight Если метод заполняет текущий экземпляр символами пробелов, этот метод не изменяет значение текущего экземпляра. Вместо этого он возвращает новую строку, заполненную пробелами в конце, чтобы ее общая длина была символов totalWidth .

См. также раздел

Применяется к

PadRight(Int32, Char)

Исходный код:
String.Manipulation.cs
Исходный код:
String.Manipulation.cs
Исходный код:
String.Manipulation.cs

Возвращает новую строку, в которой знаки данной строки выровнены по левому краю путем добавления справа пробелов или указанного знака Юникода до указанной общей длины.

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

Параметры

totalWidth
Int32

Количество знаков в полученной строке, равное числу исходных знаков плюс некоторое количество добавленных для заполнения знаков.

paddingChar
Char

Добавляемый в качестве заполнителя знак Юникода.

Возвращаемое значение

Новая строка, эквивалентная данному экземпляру, но с выравниванием по левому краю и с добавленными справа знаками paddingChar, необходимыми для достижения длины totalWidth. Однако если значение параметра totalWidth меньше длины данного экземпляра, метод возвращает ссылку на имеющийся экземпляр. Если значение параметра totalWidth равно длине данного экземпляра, метод возвращает новую строку, идентичную данному экземпляру.

Исключения

Значение параметра totalWidth меньше нуля.

Примеры

В следующем примере демонстрируется PadRight метод.

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".
let str = "forty-two"
let pad = '.'

printfn $"{str.PadRight(15, pad)}"    // Displays "forty-two......".
printfn $"{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|".

Комментарии

Метод PadRight(Int32, Char) заполняет конец возвращаемой строки. Это означает, что при использовании с языками справа налево она заполняет левую часть строки.

Примечание

PadRight Если метод заполняет текущий экземпляр символами пробелов, этот метод не изменяет значение текущего экземпляра. Вместо этого он возвращает новую строку, заполненную конечными paddingChar символами, чтобы ее общая длина была totalWidth символов.

См. также раздел

Применяется к