RSet

RSet()

Syntax

Result$ = RSet(String$, Length [, Character$])

Description

Pads a string to the right by adding extra characters to fit the specified length.

Parameters

String$ The string to pad.

Length The total length (in characters) of the new string.

Character$ (optional) The character used to pad extra space in the new string. The default character is 'space'. 'Character$' has to be a one character length string.

Return value

A new string holding the original string padded with the specified character to fit the length.

Remarks

If the string is longer than the specified length, it will be truncated starting from the right side of the string.

Example

  Debug RSet("R", 8)          ; will display "       R"
  Debug RSet("R", 8, "-")     ; will display "-------R"
  Debug RSet("LongString", 4) ; will display "Long"

See Also

LSet(), LTrim(), RTrim()

Supported OS

All

<- Mid() - String Index - RTrim() ->

String$	The string to pad.
Length	The total length (in characters) of the new string.
Character$ (optional)	The character used to pad extra space in the new string. The default character is 'space'. 'Character$' has to be a one character length string.