info.mailtraq.com > Management > Script Functions A-Z > CJ() CJ()Pads text to a specified length using characters taken sequentially from a given pad string evenly to both ends of the input text. If the text is longer than the specified length, it is trimmed from the right as necessary.
output := CJ( text [ , length [ , pad ] ] )
- text
- The string to which the padding characters are to be added
- length
- Optional; the required length, as an integer, of the output string. If length is shorter than text , text is reduced to length for the output, otherwise characters are taken successively from pad until output reaches length. If length is not provided, a default of 70 characters is used.
- pad
- Optional; the characters with which to pad text until length is reached. If pad is not given, the text is padded, if required, with spaces (ASCII 32) by default.
- output
- The string result of the function which is always length characters long.
//Example of usage
"-=-text=-=" := CJ("text", 10, "-=")
//Centres a line in a message
CJ("Message Title") |