C# | Método PadLeft() – Part 1

En C#, PadLeft() es un método de string . Este método se usa para alinear a la derecha los caracteres en String al rellenarlos con espacios o el carácter especificado a la izquierda, para una longitud total especificada. Este método se puede sobrecargar pasándole diferentes parámetros.

• Método String.PadLeft (Int32)
• Método String.PadLeft (Int32, Char)

Método String.PadLeft (Int32)

Este método se utiliza para alinear a la derecha los caracteres de esta string rellenándolos con espacios a la izquierda. El parámetro «totalWidth» especificará la cantidad de caracteres de relleno en la string y este método devolverá una nueva string.

Sintaxis:

public string PadLeft(int totalWidth)

• Parámetro: este método aceptará un parámetro » totalWidth » que especifica el número de caracteres de relleno en la string. El tipo de este parámetro es System.Int32 .
• Valor de retorno: este método devolverá la string que rellena la parte derecha de la string. El tipo de valor devuelto es System.String .
• Excepción: si totalWidth es menor que cero, surgirá ArgumentOutOfRangeException .

Ejemplo: Programa para demostrar el método de string pública PadLeft(int totalWidth) . La string se alinea a la derecha y se rellena a la izquierda con espacios en blanco según sea necesario para crear una longitud de totalWidth. Sin embargo, si totalWidth es menor o igual que la longitud de la string, el método devuelve una nueva string que es idéntica a la string. Por ejemplo, si la string actual es «Geeks» y el ancho total es 7, entonces el método PadLeft devuelve «Geeks».

// C# program to illustrate the
// String.PadLeft(totalWidth) method
using System;
class Geeks {
  
    // Main Method
    public static void Main()
    {
        string s1 = "GeeksForGeeks";
   
        Console.WriteLine("String : " + s1);
   
        // totalwidth is less than string length
        Console.WriteLine("Pad  2 :'{0}'", s1.PadLeft(2));
   
        // totalwidth is equal to string length
        Console.WriteLine("Pad 13 :'{0}'", s1.PadLeft(13));
   
        // totalwidth is greater then string length
        Console.WriteLine("Pad 20 :'{0}'", s1.PadLeft(20));
    }
}

Producción:

String : GeeksForGeeks
Pad  2 :'GeeksForGeeks'
Pad 13 :'GeeksForGeeks'
Pad 20 :'       GeeksForGeeks'

Método String.PadLeft (Int32, Char)

Este método se utiliza para alinear a la derecha los caracteres de esta string rellenándolos con el carácter especificado a la izquierda. El parámetro » totalWidth » especificará el número de caracteres de relleno en la string y » paddingChar» es el carácter especificado.

Sintaxis:

public string PadLeft(int totalWidth, char paddingChar)

• Parámetro: este método acepta dos parámetros » totalWidth » y » paddingChar «. El parámetro «totalWidth» especificará la cantidad de caracteres de relleno en la string y el tipo de este parámetro es System.Int32 . El parámetro “paddingChar” especificará el carácter de relleno y el tipo de este parámetro es System.Char .
• Valor devuelto: este método devolverá una nueva string que será equivalente a la string actual, pero alineada a la derecha y rellenada a la izquierda con los caracteres especificados por el parámetro «paddingChar». Si totalWidth es menor que la longitud de la string, el método devuelve la misma string. Si totalWidth es igual a la longitud de la string, el método devuelve una nueva string que es idéntica a la string actual. El tipo de valor devuelto es System.String .
• Excepción: si totalWidth es menor que cero, surgirá ArgumentOutOfRangeException .

Ejemplo: programa para demostrar el método de string pública PadLeft(int totalWidth, char paddingChar) . La string se alinea a la derecha y se rellena a la izquierda con caracteres paddingChar según sea necesario para crear una longitud de totalWidth. Sin embargo, si totalWidth es menor o igual que la longitud de esta instancia, el método devuelve una nueva string que es idéntica a esta instancia. Por ejemplo, si la string actual es «Geeks» y totalWidth es 7 y paddingChar es ‘*’, entonces el método PadLeft devuelve «**Geeks».

// C# program to illustrate the
// String.PadLeft(int totalWidth, 
// char paddingChar) method
using System;
  
class Geeks {
  
    // Main Method
    public static void Main()
    {
          
        string s1 = "GeeksForGeeks";
        char pad = '*';
        Console.WriteLine("String : " + s1);
  
        // totalwidth is less than string length
        Console.WriteLine("Pad 2 :'{0}'", s1.PadLeft(2, pad));
  
        // totalwidth is equal to string length
        Console.WriteLine("Pad 13 :'{0}'", s1.PadLeft(13, pad));
  
        // totalwidth is greater then string length
        Console.WriteLine("Pad 20 :'{0}'", s1.PadLeft(20, pad));
    }
}

Producción:

String : GeeksForGeeks
Pad 2 :'GeeksForGeeks'
Pad 13 :'GeeksForGeeks'
Pad 20 :'*******GeeksForGeeks'

Puntos importantes sobre el método PadLeft():

• Si el método PadLeft rellena la instancia actual con caracteres de espacio en blanco, este método no modifica el valor de la instancia actual. En su lugar, devuelve una nueva string que se rellena con un espacio en blanco inicial para que su longitud total sea totalWidth caracteres.
• Si totalWidth es menor que la longitud de String, el método devuelve una referencia a la instancia existente.

Referencias:

• https://msdn.microsoft.com/en-us/library/system.string.padleft1
• https://msdn.microsoft.com/en-us/library/system.string.padleft2