String.PadLeft Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna uma nova cadeia de caracteres de um comprimento especificado no qual o início da cadeia de caracteres atual é preenchido com espaços ou com um caractere Unicode especificado.
Sobrecargas
| PadLeft(Int32, Char) |
Retorna uma nova cadeia de caracteres que alinha os caracteres à direita nessa instância, preenchendo-os à esquerda com um caractere Unicode especificado, para um tamanho total especificado. |
| PadLeft(Int32) |
Retorna uma nova cadeia de caracteres que alinha os caracteres à direita nessa instância, preenchendo-os com espaços à esquerda, para um tamanho total especificado. |
PadLeft(Int32, Char)
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
Retorna uma nova cadeia de caracteres que alinha os caracteres à direita nessa instância, preenchendo-os à esquerda com um caractere Unicode especificado, para um tamanho total especificado.
public:
System::String ^ PadLeft(int totalWidth, char paddingChar);public string PadLeft (int totalWidth, char paddingChar);member this.PadLeft : int * char -> stringPublic Function PadLeft (totalWidth As Integer, paddingChar As Char) As StringParâmetros
- totalWidth
- Int32
O número de caracteres na cadeia de caracteres resultante, igual ao número de caracteres originais mais alguns caracteres de preenchimento adicionais.
- paddingChar
- Char
Um caractere de preenchimento de Unicode.
Retornos
Uma nova cadeia de caracteres equivalente a essa instância, mas alinhada à direita e preenchida à esquerda com o máximo de caracteres paddingChar necessários para criar um tamanho totalWidth. No entanto, se totalWidth for menor que o tamanho dessa instância, o método retornará uma referência à instância existente. Caso totalWidth seja igual ao tamanho desta instância, o método retorna uma nova cadeia de caracteres idêntica a essa instância.
Exceções
totalWidth é menor que zero.
Exemplos
O exemplo a seguir demonstra o PadLeft método.
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
Comentários
O PadLeft(Int32, Char) método preenche o início da cadeia de caracteres retornada. Isso significa que, quando usado com idiomas da direita para a esquerda, ele preenche a parte direita da cadeia de caracteres.
Observação
Se o PadLeft método preencher a instância atual com caracteres de espaço em branco, esse método não modificará o valor da instância atual. Em vez disso, ele retorna uma nova cadeia de caracteres que é preenchida com caracteres à esquerda paddingChar para que seu comprimento total seja totalWidth de caracteres.
Confira também
Aplica-se a
PadLeft(Int32)
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
- Origem:
- String.Manipulation.cs
Retorna uma nova cadeia de caracteres que alinha os caracteres à direita nessa instância, preenchendo-os com espaços à esquerda, para um tamanho total especificado.
public:
System::String ^ PadLeft(int totalWidth);public string PadLeft (int totalWidth);member this.PadLeft : int -> stringPublic Function PadLeft (totalWidth As Integer) As StringParâmetros
- totalWidth
- Int32
O número de caracteres na cadeia de caracteres resultante, igual ao número de caracteres originais mais alguns caracteres de preenchimento adicionais.
Retornos
Uma nova cadeia de caracteres equivalente a essa instância, mas alinhada à direita e preenchida à esquerda com o máximo de espaços necessários para criar um tamanho totalWidth. No entanto, se totalWidth for menor que o tamanho dessa instância, o método retornará uma referência à instância existente. Caso totalWidth seja igual ao tamanho desta instância, o método retorna uma nova cadeia de caracteres idêntica a essa instância.
Exceções
totalWidth é menor que zero.
Exemplos
O exemplo a seguir demonstra o PadLeft método.
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".
Comentários
Um espaço Unicode é definido como 0x0020 hexadecimal.
O PadLeft(Int32) método preenche o início da cadeia de caracteres retornada. Isso significa que, quando usado com idiomas da direita para a esquerda, ele preenche a parte direita da cadeia de caracteres.
Observação
Se o PadLeft método preencher a instância atual com caracteres de espaço em branco, esse método não modificará o valor da instância atual. Em vez disso, ele retorna uma nova cadeia de caracteres que é preenchida com espaço em branco à esquerda para que seu comprimento total seja totalWidth de caracteres.
