padLeft
padLeft(source: text, pad: text, size: number) 🡒 text, const pure function
Prepends pad
- in its entirety - to source
until the resulting text value’s length is equal to or greater than the target size
. If size
is lower than source
’s length, padding is not applied.
show summary "" a1c3 with
padLeft("1234","0", 7) // returns "0001234"
padLeft("1234","0_", 7) // returns "0_0_1234"
padLeft("1234","0__", 7) // returns "0__1234"
padLeft("1234","0__", 3) // returns "1234"
The following restrictions apply, otherwise the function fails:
pad
must be non-empty.size
must be an integer in the segment [1, 256].