String.PadLeft 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 le début de la chaîne actuelle est complété par des espaces ou un caractère Unicode spécifié.

Surcharges

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

PadLeft(Int32, Char)

Source:

String.Manipulation.cs

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

public:
 System::String ^ PadLeft(int totalWidth, char paddingChar);

public string PadLeft (int totalWidth, char paddingChar);

member this.PadLeft : int * char -> string

Public Function PadLeft (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 à droite et complétée à gauche 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 PadLeft méthode.

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

Remarques

La PadLeft(Int32, Char) méthode pads le début de la chaîne retournée. Cela signifie que, lorsqu’il est utilisé avec des langages de droite à gauche, il pade la partie droite de la chaîne.

Notes

Si la PadLeft méthode rembourse le instance actuel avec des espaces blancs, cette méthode ne modifie pas la valeur du instance actuel. Au lieu de cela, il retourne une nouvelle chaîne qui est remplie de caractères principaux paddingChar afin que sa longueur totale soit de totalWidth caractères.

Voir aussi

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

PadLeft(Int32)

Source:

String.Manipulation.cs

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

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

public string PadLeft (int totalWidth);

member this.PadLeft : int -> string

Public Function PadLeft (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 équivalant à cette instance, mais alignée à droite et complétée à gauche par autant de caractères 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 PadLeft méthode.

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

Remarques

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

La PadLeft(Int32) méthode pads le début de la chaîne retournée. Cela signifie que, lorsqu’il est utilisé avec des langages de droite à gauche, il pade la partie droite de la chaîne.

Notes

Si la PadLeft méthode rembourse le instance actuel avec des espaces blancs, cette méthode ne modifie pas la valeur du instance actuel. Au lieu de cela, il retourne une nouvelle chaîne qui est remplie d’espaces blancs de début afin que sa longueur totale soit totalWidth de caractères.

Voir aussi

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