Chaîne C# PadLeft

Le remplissage n'est rien d'autre que l'insertion d'un espace blanc ou de tout caractère Unicode au début ou à la fin d'une chaîne. L'insertion d'un espace blanc ou d'un caractère Unicode au début d'une chaîne est appelée remplissage de la chaîne à partir de sa gauche. C# fournit une méthode appelée PadLeft() qui peut être utilisée pour y parvenir.

La classe String contient deux formes surchargées de la méthode PadLeft() :

• String.PadLeft(Int32, Char)
• String.PadLeft(Int32)

Comme les chaînes sont de nature immuable, la méthode PadLeft() renvoie une nouvelle chaîne après avoir ajouté le caractère spécifié à sa gauche au lieu d'ajouter des caractères à la chaîne existante.

Syntaxe :

La syntaxe de la méthode String.PadLeft() dans ses deux formes surchargées est la suivante :

public string PadLeft(int totalLength, char paddingChar);

Explication :

La méthode PadLeft() dans la syntaxe ci-dessus prend deux arguments ; le premier est un entier qui spécifie la longueur de la chaîne qui sera renvoyée par cette méthode après avoir ajouté le caractère spécifié à gauche de la chaîne d'origine. Le deuxième paramètre est utilisé pour spécifier un caractère Unicode qui sera utilisé pour le remplissage.

public string PadLeft(int totalLength);

Explication :

La méthode PadLeft() dans la syntaxe ci-dessus ne prend qu'un seul argument qui est un entier utilisé pour spécifier la longueur de la chaîne résultante après avoir ajouté des espaces à gauche de la chaîne d'origine. Les deux formes surchargées ci-dessus de la méthode PadLeft() renvoient une valeur de chaîne dont la longueur sera égale à la longueur spécifiée dans l'argument.

Comment fonctionne la méthode String PadLeft() en C# ?

En C#, l'espace de noms « Système » contient une classe appelée String qui est utilisée pour gérer les manipulations de chaînes et fournit une gamme de méthodes pour effectuer différentes opérations sur une chaîne. L’une de ces méthodes est la méthode String.PadLeft(). Cette méthode est utilisée pour ajouter un caractère spécifié au début, c'est-à-dire à gauche de la chaîne, puis renvoie une nouvelle chaîne de la longueur spécifiée.

Ainsi, la méthode String.PadLeft() décale la chaîne vers la droite.

Exemple :

string str = "Hello";
string resultedString = str.PadLeft(8, '@');

Essayons maintenant de comprendre le concept de remplissage gauche à l'aide de l'exemple ci-dessus. Ici, nous avons appliqué un remplissage gauche à la chaîne (str) en passant la longueur totale de la chaîne résultante comme « 8 » et un caractère de remplissage, c'est-à-dire « @ ». Ici, la longueur de la chaîne d'origine, c'est-à-dire « Bonjour », est de 5 et nous avons besoin que la longueur de la chaîne résultante soit de 8. Ainsi, la chaîne résultante aura trois caractères « @ » ajoutés à sa gauche, ce qui donne la longueur totale (longueur du chaîne d'origine plus un nombre de caractères de remplissage dans la chaîne résultante) égal à la longueur transmise à la méthode en utilisant son argument entier.

Si l'utilisateur n'a spécifié aucun caractère de remplissage Unicode dans la méthode, alors par défaut, un espace sera ajouté à gauche de la chaîne d'origine de la même manière qu'un caractère de remplissage Unicode aurait été ajouté s'il était spécifié. Désormais, si un utilisateur spécifie la longueur totale de la chaîne résultante qui est inférieure à la longueur de la chaîne d'origine, la méthode renverra une référence à l'instance existante.

De la même manière, si un utilisateur spécifie la longueur totale de la chaîne résultante qui est égale à la longueur de la chaîne d'origine alors la méthode renverra une nouvelle chaîne qui sera identique à la chaîne existante. Comme les chaînes sont de nature immuable, les deux formes surchargées de la méthode PadLeft() renvoient une nouvelle chaîne après avoir rempli le caractère spécifié à gauche de la chaîne d'origine. La méthode String.PadLeft() renvoie ArgumentOutOfRangeException si la longueur totale spécifiée est inférieure à zéro.

Exemples d'implémentation de la méthode C# String PadLeft

Vous trouverez ci-dessous les exemples de la méthode C# String PadLeft :

Exemple n°1

Exemple montrant les fonctionnalités de base de la méthode PadLeft().

Code :

using System;
using System.Text;
namespace ConsoleApp4
{
public class Program
{
public static void Main(string[] args)
{
string str = "Hello World!";
try
{
//making the length of the string 15
//by adding 3 '@' characters at the beginning of the string
string resultedStringWithChar = str.PadLeft(15, '@');
Console.WriteLine(resultedStringWithChar);
//making the length of the string 15
//by adding 3 white spaces at the beginning of the string
string resultedStringWithoutChar = str.PadLeft(15);
Console.WriteLine(resultedStringWithoutChar);
Console.ReadLine();
}
catch(Exception ex)
{
Console.WriteLine(ex.Message);
}
}
}
}

Sortie :

Nous pouvons voir dans le résultat que pour atteindre la longueur de la chaîne résultante à 15, trois caractères « @ » sont ajoutés à la chaîne résultante. De la même manière, lorsque nous avons utilisé la méthode String.PadLeft() pour la deuxième fois, nous n'avons spécifié aucun caractère. Ainsi, trois espaces blancs ont été ajoutés à la chaîne résultante.

Exemple n°2

Exemple montrant un scénario dans lequel la longueur totale de la chaîne résultante requise est inférieure ou égale à la longueur de la chaîne d'origine et la longueur totale est inférieure à zéro.

Code :

using System;
using System.Text;
namespace ConsoleApp4
{
public class Program
{
public static void Main(string[] args)
{
string str = "Hello World!";
try
{
//providing total length as 12
//which is equal to the length of the original string
string resultedStringWithChar = str.PadLeft(12, '@');
Console.WriteLine(resultedStringWithChar);
//providing total length as 10
//which is less than the length of the original string
string resultedStringWithoutChar = str.PadLeft(10);
Console.WriteLine(resultedStringWithoutChar);
resultedStringWithoutChar = str.PadLeft(-1);
Console.WriteLine(resultedStringWithoutChar);
Console.ReadLine();
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
Console.ReadLine();
}
}
}
}

Sortie :

Exemple #3

Exemple d'application de la méthode PadLeft() sur plusieurs chaînes d'un tableau.

Code :

using System;
using System.Text;
namespace ConsoleApp4
{
public class Program
{
public static void Main(string[] args)
{
string[] strArray = { "Lily", "Rose", "Jasmine", "Sunflower" };
char paddingChar = '#';
try
{
//accessing each string of the array
//using 'foreach' loop
foreach (string str in strArray)
{
//adding '#' at the start of each string
Console.WriteLine(str.PadLeft(10, paddingChar));
//using PadLeft() method without specifying
//any padding character
Console.WriteLine(str.PadLeft(10));
}
Console.ReadLine();
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
Console.ReadLine();
}
}
}
}

Sortie :

Conclusion

En C#, la méthode String.PadLeft() est utilisée pour ajouter un caractère spécifié ou un espace blanc au début ou on peut dire à gauche d'une chaîne pour obtenir la longueur souhaitée de la chaîne. Cette méthode est présente sous l'espace de noms « Système » et comporte deux formes surchargées.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!