Operador ^= (Visual Basic)

Aumenta o valor de uma variável ou propriedade à potência de uma expressão e atribui o resultado de volta à variável ou à propriedade.

Sintaxe

variableorproperty ^= expression  

Partes

variableorproperty
Obrigatórios. Qualquer variável ou propriedade numérica.

expression
Obrigatórios. Qualquer expressão numérica.

Comentários

O elemento no lado esquerdo do operador ^= pode ser uma variável escalar simples, uma propriedade ou um elemento de uma matriz. A variável ou propriedade não pode ser ReadOnly.

Primeiramente, o operador ^= aumenta o valor da variável ou da propriedade (no lado esquerdo do operador) à potência do valor da expressão (no lado direito do operador). Em seguida, o operador atribui o resultado dessa operação à variável ou à propriedade.

O Visual Basic sempre executa exponencialidade no Tipo de Dados Duplo. Operandos de qualquer tipo diferente são convertidos em Double, e o resultado é sempre Double.

O valor de expression pode ser fracionário, negativo ou ambos.

Sobrecarga

O operador ^ pode ser sobrecarregado, o que significa que uma classe ou estrutura pode redefinir o comportamento quando um operando tem o tipo dessa classe ou estrutura. Sobrecarregar o operador ^ afeta o comportamento do operador ^=. Se o seu código usa ^= em uma classe ou estrutura que sobrecarrega ^, certifique-se de entender o comportamento redefinido. Para obter mais informações, confira Procedimentos de operador.

Exemplo

O exemplo a seguir usa o operador ^= para aumentar o valor de uma variável Integer à potência de uma segunda e atribuir o resultado à primeira delas.

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

Confira também