Operator &= (Concatenate And Assign)

FreeBASIC

Operator &= (Concatenate And Assign)
 
Appends and assigns a string onto another string

Syntax

Declare Operator &= ( ByRef lhs As String, ByRef rhs As T2 )
Declare Operator &= ( ByRef lhs As WString, ByRef rhs 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 & rhs

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

This operator can be overloaded for user-defined types.

Note: This operator exists in C/C++ with a different meaning - there it performs a bitwise And=.


Example

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

will produce the output:

Hello, world!

Dialect Differences

  • In the -lang qb dialect, this operator cannot be overloaded.

Differences from QB

  • New to FreeBASIC

See also