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")