Help Center
Help CenterFreeBASIC

Operator &= (Concatenate And Assign)operator

Appends and assigns a string onto another string

Operatorsoperatordocumented

Syntax

Declare Operator &= ( ByRef lhs As String, ByRef rhs As T2 )
Declare Operator &= ( ByRef lhs As WString, ByRef rhs As T2 )

Parameters

NameDescription
lhsThe string to assign to.
rhsThe value to append to
lhs.
T2Any 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 as a member Operator using the appropriate syntax.

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

Remarks

Usage


lhs &= rhs

Dialect Differences


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

Differences from QB


  • New to FreeBASIC

See also


Example


Dim s As String = "Hello, "

s &= " world!"

Print s

will produce the output:

Hello, world!

Reference

  • Documented in KeyPgOpCombineConcat.html