Text.PadEnd

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

Sintaxis

Text.PadEnd(
    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 derecha
  • 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 derecha con espacios en blanco) con la siguiente expresión:

Text.PadEnd("BI", 5)

"BI   "

Función Text.PadEnd

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

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

5

Función Text.PadEnd

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.PadEnd("BI", 5, "*")

BI***

Función Text.PadEnd

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

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

Interactive Chaos

Función Text.PadEnd
Categoría
Funciones de texto
Enviado por admin el Jue, 14/05/2020 - 10:01