LSet
Left-justifies a string
Syntax
`
Declare Sub LSet ( ByRef dst As String, ByRef src As Const String )
Declare Sub LSet ( ByVal dst As WString Ptr, ByVal src As Const WString Ptr )
`
Usage
`
LSet dst, src
LSet dst_udt, src_udt
`
Parameters
`dst`
String `String` to receive the data.
`src`
Source `String` to get the data.
`dst_udt`
User defined `Type` to receive the data.
`src_udt`
User defined `Type` to copy the data from.
Description
`LSet` left justifies text into the string buffer `dst`, filling the left part of the string with `src` and the right part with spaces. The string buffer size is not modified.
If text is too long for the string buffer size, `LSet` truncates characters from the right.
For compatibility with QBasic, `LSet` can also copy a user defined type variable into another one. The copy is made byte for byte, without any care for fields or alignment. It's up to the programmer to take care for the validity of the result.
Example
`
Dim buffer As String
buffer = Space(10)
LSet buffer, "91.5"
Print "-[" & buffer & "]-"
`
`
Type mytype1
x As Integer
y As Integer
End Type
Type mytype2
z As Integer
End Type
Dim a As mytype1 , b As mytype2
b.z = 1234
LSet a, b
Print a.x
`
Differences from QB

- In QB, the syntax was `LSet dst = src`. That syntax is also supported by FB.

See also

- `RSet`
- `Space`
- `Put (File I/O)`
- `MKD`
- `MKI`
- `MKL`
- `MKS`