Takes the given string and pads it out, to the length required, using the character specified. For example if you need a string to be 6 characters long, you can call:
pad('bob', 6, '-', 2)
This would return:
bob--- as it has padded it out to 6 characters, using the
- on the right.
You can also use it to pad numbers (they are always returned as strings):
pad(512, 6, '0', 1)
000512 with the string padded to the left.
If you don't specify a direction it'll pad to both sides:
pad('c64', 7, '*')
|str||string | number | object||
The target string.
The number of characters to be added.
The string to pad it out with (defaults to a space).
The direction dir = 1 (left), 2 (right), 3 (both).
The padded string.