Text.PadStart

La función Text.PadStart devuelve una copia de una cadena de texto tras añadir tantos caracteres por su izquierda como sea necesario para asegurar que el resultado tenga la longitud mínima indicada.

Sintaxis

Text.PadStart(
    text as nullable text,
    count as number,
    optional character as nullable text
) as nullable text

Parámetros
  • text: cadena de texto a rellenar por su izquierda
  • count: longitud mínima del resultado
  • character: (opcional) carácter de relleno
Información adicional

El carácter de relleno por defecto es el espacio en blanco.

Si la cadena de texto text ya tiene una longitud count (o superior), no se le añade ningún carácter.

El parámetro character deberá ser un carácter simple. Si se trata de una cadena de texto de mayor longitud, la función devuelve un error.

Ejemplos

Podemos convertir la cadena de texto "BI" en un texto de 5 caracteres (rellenándola por la izquierda con espacios en blanco) con la siguiente expresión:

Text.PadStart("BI", 5)

"   BI"

Función Text.PadStart

Es posible confirmar la longitud del resultado con la función Text.Length:

Text.Length(
    Text.PadStart("BI", 5)
)

5

Función Text.PadStart

Es posible especificar el carácter de relleno. Por ejemplo, siguiendo con el ejemplo anterior, podemos configurar el relleno para que se realice con asteriscos:

Text.PadStart("BI", 5, "*")

***BI

Función Text.PadStart

Si la cadena de texto a rellenar ya tiene la longitud mínima especificada, no se añade ningún carácter adicional:

Text.PadStart("Interactive Chaos", 5, "*")

Interactive Chaos

Función Text.PadStart
Categoría
Funciones de texto
Enviado por admin el Vie, 15/05/2020 - 10:02