CFLib.org – Common Function Library Project

Description:
Pads a string with n characters. Padding is from the left.

Return Values:
Returns a string.

Example:

<CFSET x=123>
<CFSET y="test">

<CFOUTPUT>
#PadString(x, 0, 4)#<BR>
#PadString(y, "a", 5)#
</CFOUTPUT>

Parameters:

Full UDF Source:

/**
 * Pads a string with n characters.  Padding is from the left.
 * 
 * @param string      String you want to pad. 
 * @param char      Character to use as the padding. 
 * @param count      Number of characters to pad the string with. 
 * @return Returns a string. 
 * @author Rob Brooks-Bilson (rbils@amkor.com) 
 * @version 1, August 16, 2001 
 */
function PadString(string, char, count)
{
  var Padding = RepeatString(char, count);
  return Padding & string;
}