====== PadEnd(text, pad_char, total_len) ======
Category:  Text function

\\ 
=====Description=====
This function pads the end of //text// with //pad_char// up to a total length defined by //total_len//.

\\ 
=====Arguments=====
^Argument^Type^Description^
|text|Text|The text value to be padded.|
|pad_char|Text (a single character)|The character to append to the end of //text// repeatedly until the total string length of //total_len// is reached.|
|total_len|Number|The total length of the result string including //text// plus all repeated instances of //pad_text//.|

**Return value type:** Text

\\ 
=====Remarks=====
//text// and //pad_char// are implicitly converted to text values if required.

Entering a value for //pad_char// longer than a single character results in an error message.

Entering a value for //total_len// equal to or less than the length of //text// simply returns the value of //text//.

\\ 
=====Examples=====

  padend('99', '0', 5) //Returns '99000'

  padend('1000', '0', 3) //Returns '1000'  (Result length entered (3) is less than the length of '1000' (4))

\\ 
===== See also =====
  * [[syntax:functions:padstart|PadStart(text, pad_char, total_len)]]