Click above to get retro games delivered to your door ever month!

  Name:     untrim() - pad a string with spaces
  Usage:    <string> = untrim(<string>,<len>)
  Params:   string <string> - the string to pad
            integer <len> - the number of spaces to add to <string>,
            if <num> is less than the length of <string>, then
            <string> is truncated at <len> characters.

  Returns:  a string equal to <string> with trailing spaces added
            to fill it out to <len> length, or truncated to equal
            <len> length.

 ---------------------------------- Example ---------------------------------

                 ? untrim("string one",20)
                 ? untrim("char 1",20)

                 * prints "string one         "
                 *        "char 1             "

                 ? untrim("string one",4)
                 * prints "stri"

  Note:     Untrim() is equivalent to the pad() function found in
            the file examplep.prg, it is however much faster.