{{fbdoc item="title" value="LSET"}}----
Left-justifies a string

{{fbdoc item="syntax"}}##
	[[KeyPgDeclare|declare]] [[KeyPgSub|sub]] **Lset** ( [[KeyPgByref|byref]] //dst// [[KeyPgAs|as]] [[KeyPgString|string]], [[KeyPgByref|byref]] //src// [[KeyPgAs|as]] [[KeyPgConstQualifier|const]] [[KeyPgString|string]] )
	[[KeyPgDeclare|declare]] [[KeyPgSub|sub]] **Lset** ( [[KeyPgByval|byval]] //dst// [[KeyPgAs|as]] [[KeyPgWstring|wstring]] [[KeyPgPtr|ptr]], [[KeyPgByval|byval]] //src// [[KeyPgAs|as]] [[KeyPgConstQualifier|const]] [[KeyPgWstring|wstring]] [[KeyPgPtr|ptr]] )
##
{{fbdoc item="usage"}}##
	**Lset** //dst//, //src//
	**Lset** //dst_udt//, //src_udt//
##
{{fbdoc item="param"}}
	##//dst//##
		String ##[[KeyPgString|String]]## to receive the data.
	##//src//##
		Source ##[[KeyPgString|String]]## to get the data.
	##//dst_udt//##
		User defined ##[[KeyPgType|Type]]## to receive the data.	
	##//src_udt//##
		User defined ##[[KeyPgType|Type]]## to copy the data from.

{{fbdoc item="desc"}}
	##**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.

{{fbdoc item="ex"}}
{{fbdoc item="filename" value="examples/manual/strings/lset.bas"}}%%(freebasic)
dim buffer as string
buffer = space(10)
lset buffer, "91.5"
print "-[" & buffer & "]-"
%%	Output:
%%
-[91.5      ]-
%%

{{fbdoc item="filename" value="examples/manual/strings/lset-udt.bas"}}%%(freebasic)
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
%%

{{fbdoc item="diff"}}
	-In QB, the syntax was ##**Lset** //dst// = //src//##. That syntax is also supported by FB.

{{fbdoc item="see"}}
	- ##[[KeyPgRset|Rset]]##
	- ##[[KeyPgSpace|Space]]##
	- ##[[KeyPgPutfileio|Put (File I/O)]]##
	- ##[[KeyPgMkd|Mkd]]##
	- ##[[KeyPgMki|Mki]]##
	- ##[[KeyPgMkl|Mkl]]##
	- ##[[KeyPgMks|Mks]]##

{{fbdoc item="back" value="CatPgString|String Functions"}}