LSet

LSet()

Syntax

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

Description

Pads a string to the left 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 left side of the string.

Example

  Debug LSet("L", 8)          ; will display "L       "
  Debug LSet("L", 8, "-")     ; will display "L-------"
  Debug LSet("LongString", 4) ; will display "Long"

See Also

RSet(), LTrim(), RTrim()

Supported OS

All

<- LCase() - String Index - LTrim() ->

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.