|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.|
^ Operator (Visual Basic)
Raises a number to the power of another number.
Visual Basic always performs exponentiation in the.
The value of exponent can be fractional, negative, or both.
When more than one exponentiation is performed in a single expression, the ^ operator is evaluated as it is encountered from left to right.
The ^ operator 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. If your code uses this operator on such a class or structure, be sure you understand its redefined behavior. For more information, see.
The following example uses the ^ operator to raise a number to the power of an exponent. The result is the first operand raised to the power of the second.
Dim exp1, exp2, exp3, exp4, exp5, exp6 As Double exp1 = 2 ^ 2 exp2 = 3 ^ 3 ^ 3 exp3 = (-5) ^ 3 exp4 = (-5) ^ 4 exp5 = 8 ^ (1.0 / 3.0) exp6 = 8 ^ (-1.0 / 3.0)
The preceding example produces the following results:
exp1 is set to 4 (2 squared).
exp2 is set to 19683 (3 cubed, then that value cubed).
exp3 is set to -125 (-5 cubed).
exp4 is set to 625 (-5 to the fourth power).
exp5 is set to 2 (cube root of 8).
exp6 is set to 0.5 (1.0 divided by the cube root of 8).
Note the importance of the parentheses in the expressions in the preceding example. Because of operator precedence, Visual Basic normally performs the ^ operator before any others, even the unary – operator. If exp4 and exp6 had been calculated without parentheses, they would have produced the following results:
exp4 = -5 ^ 4 would be calculated as –(5 to the fourth power), which would result in –625.
exp6 = 8 ^ -1.0 / 3.0 would be calculated as (8 to the –1 power, or 0.125) divided by 3.0, which would result in 0.041666666666666666666666666666667.