^= Operator (Visual Basic)

Raises the value of a variable or property to the power of an expression and assigns the result back to the variable or property.

variableorproperty ^= expression

Parts

  • variableorproperty
    Required. Any numeric variable or property.

  • expression
    Required. Any numeric expression.

Remarks

The element on the left side of the ^= operator can be a simple scalar variable, a property, or an element of an array. The variable or property cannot be ReadOnly (Visual Basic). The ^= operator assigns the value on its right to the variable or property on its left.

Visual Basic always performs exponentiation in the Double Data Type (Visual Basic). Operands of any different type are converted to Double, and the result is always Double.

The value of expression can be fractional, negative, or both.

Overloading

The ^ Operator (Visual Basic) can be overloaded, which means that a class or structure can redefine its behavior when an operand has the type of that class or structure. Overloading the ^ operator affects the behavior of the ^= operator. If your code uses ^= on a class or structure that overloads ^, be sure you understand its redefined behavior. For more information, see Operator Procedures.

Example

The following example uses the ^= operator to raise the value of one Integer variable to the power of a second variable and assign the result to the first variable.

Dim var1 AsĀ Integer = 10
Dim var2 AsĀ Integer = 3
var1 ^= var2
' The value of var1 is now 1000.

See Also

Concepts

Assignment Statements

Reference

^ Operator (Visual Basic)

Assignment Operators

Arithmetic Operators (Visual Basic)

Operator Precedence in Visual Basic

Operators Listed by Functionality