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 -> stringPublic 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 -> stringPublic 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 символов.
