Operator &= (Concatenate And Assign)

Appends and assigns a string onto another string

Syntax
	KeyPgDeclareDeclare KeyPgOperatorOperator &= ( KeyPgByrefByRef lhs KeyPgAsAs KeyPgStringString, KeyPgByrefByRef rhs KeyPgAsAs T2 )
	KeyPgDeclareDeclare KeyPgOperatorOperator &= ( KeyPgByrefByRef lhs KeyPgAsAs KeyPgWstringWString, KeyPgByrefByRef rhs KeyPgAsAs T2 )

Usage
	lhs &= rhs

Parameters
	lhs
		The string to assign to.
	rhs
		The value to append to lhs.
	T2
		Any numeric, string or user-defined type that can be converted to a 
		string.

Description
	This operator appends one string onto another. The right-hand side 
	expression (rhs) is converted to a string before concatenation. It is 
	functionally equivalent to,

		lhs = lhs KeyPgOpConcatConvert& rhs

	where the result is assigned back to the left-hand side string.

	This operator can be overloaded for user-defined types as a member 
	KeyPgOperatorOperator using the appropriate syntax.

	Note: This operator exists in C/C++ with a different meaning - there it 
	performs a bitwise KeyPgOpCombineAndAnd=.
	Note: Similarly to the operator '=[>]' (assign), the alternative symbol 
	'&=>' can be also used.

Example
	Dim s As String = "Hello, "
	s &= " world!"
	Print s

	will produce the output:


	Hello, world!

Dialect Differences
	* In the CompilerOptlang-lang qb dialect, this operator cannot be overloaded.

Differences from QB
	* New to FreeBASIC

See also
	* KeyPgOpConcatConvertOperator & (String Concatenation With Conversion)
	* KeyPgOpCombineAddOperator +=  (Add And Assign)

