String.PadRight Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Retourne une nouvelle chaîne d'une longueur spécifiée dans laquelle la fin de la chaîne actuelle est complétée par des espaces ou un caractère Unicode spécifié.

Surcharges

PadRight(Int32)	Retourne une nouvelle chaîne qui aligne les caractères de cette chaîne à gauche en les complétant par des espaces à droite pour une longueur totale spécifiée.
PadRight(Int32, Char)	Retourne une nouvelle chaîne qui aligne les caractères de cette chaîne à gauche en les complétant par un caractère Unicode spécifié à droite pour une longueur totale spécifiée.

PadRight(Int32)

Source:

String.Manipulation.cs

Retourne une nouvelle chaîne qui aligne les caractères de cette chaîne à gauche en les complétant par des espaces à droite pour une longueur totale spécifiée.

public:
 System::String ^ PadRight(int totalWidth);

public string PadRight (int totalWidth);

member this.PadRight : int -> string

Public Function PadRight (totalWidth As Integer) As String

Paramètres

totalWidth

Int32

Nombre de caractères dans la chaîne qui en résulte, égal au nombre de caractères d'origine plus tout caractère de remplissage supplémentaire.

Retours

String

Nouvelle chaîne équivalente à cette instance, mais alignée à gauche et complétée à droite par autant d'espaces que nécessaire pour créer une longueur de totalWidth. Toutefois, si totalWidth est inférieure à la longueur de cette instance, la méthode retourne une référence à l'instance existante. Si totalWidth est égale à la longueur de cette instance, la méthode retourne une nouvelle chaîne qui est identique à cette instance.

Exceptions

ArgumentOutOfRangeException

totalWidth est inférieur à zéro.

Exemples

L’exemple suivant illustre la PadRight méthode.

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

Remarques

Un espace Unicode est défini comme 0x0020 hexadécimal.

La PadRight(Int32) méthode rembourse la fin de la chaîne retournée. Cela signifie que, lorsqu’il est utilisé avec des langues de droite à gauche, il rembourse la partie gauche de la chaîne.

Notes

Si la PadRight méthode rembourse l’instance actuelle avec des espaces blancs, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, elle retourne une nouvelle chaîne remplie d’espaces blancs de fin afin que sa longueur totale soit totalWidth en caractères.

Voir aussi

• Int32
• PadLeft(Int32)
• Trim(Char[])

PadRight(Int32, Char)

Source:

String.Manipulation.cs

Retourne une nouvelle chaîne qui aligne les caractères de cette chaîne à gauche en les complétant par un caractère Unicode spécifié à droite pour une longueur totale spécifiée.

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

Paramètres

totalWidth

Int32

Nombre de caractères dans la chaîne qui en résulte, égal au nombre de caractères d'origine plus tout caractère de remplissage supplémentaire.

paddingChar

Char

Caractère Unicode de remplissage.

Retours

String

Nouvelle chaîne équivalant à cette instance, mais alignée à gauche et complétée à droite par autant de caractères paddingChar que nécessaire pour créer une longueur de totalWidth. Toutefois, si totalWidth est inférieure à la longueur de cette instance, la méthode retourne une référence à l'instance existante. Si totalWidth est égale à la longueur de cette instance, la méthode retourne une nouvelle chaîne qui est identique à cette instance.

Exceptions

ArgumentOutOfRangeException

totalWidth est inférieur à zéro.

Exemples

L’exemple suivant illustre la PadRight méthode.

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

Remarques

La PadRight(Int32, Char) méthode rembourse la fin de la chaîne retournée. Cela signifie que, lorsqu’il est utilisé avec des langues de droite à gauche, il rembourse la partie gauche de la chaîne.

Notes

Si la PadRight méthode rembourse l’instance actuelle avec des espaces blancs, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, elle retourne une nouvelle chaîne qui est remplie de caractères de paddingChar fin afin que sa longueur totale soit totalWidth des caractères.

Voir aussi

• Char
• Int32
• PadLeft(Int32)
• Trim(Char[])