^, opérateur (Visual Basic)

Article
09/12/2008

Mise à jour : novembre 2007

Élève un nombre à la puissance d'un autre nombre.

number ^ exponent

Éléments

number
Requis. Toute expression numérique.
exponent
Requis. Toute expression numérique.

Résultat

Le résultat est number élevé à la puissance exponent, toujours comme une valeur Double.

Types pris en charge

Double. Les opérandes de tous types sont converties en Double.

Notes

Visual Basic exécute toujours l'élévation à la puissance dans le Double, type de données (Visual Basic).

La valeur de exponent peut être fractionnaire, négative ou les deux.

Lorsque plusieurs élévations à la puissance sont effectuées dans une même expression, l'opérateur ^ est évalué à mesure qu'il est rencontré, de gauche à droite.

Remarque :
L'opérateur ^ peut être surchargé, ce qui signifie qu'une classe ou une structure peut redéfinir son comportement lorsqu'un opérande a le type de cette classe ou de cette structure. Si votre code utilise cet opérateur sur une telle classe ou structure, assurez-vous que vous comprenez son comportement redéfini. Pour plus d'informations, consultez Procédures d'opérateur.

Exemple

L'exemple suivant utilise l'opérateur ^ pour élever un nombre à la puissance d'un exposant. Le résultat est le premier opérande élevé à la puissance de la deuxième.

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)

L'exemple précédent donne les résultats suivants :

exp1 a la valeur 4 (2 au carré).

exp2 a la valeur 19 683 (3 au cube, puis cette valeur au cube).

exp3 a la valeur -125 (-5 au cube).

exp4 a la valeur 625 (-5 à la puissance quatre).

exp5 a la valeur 2 (racine cubique de 8).

exp6 a la valeur 0,5 (1,0 divisé par la racine cubique de 8).

Notez l'importance des parenthèses dans les expressions de l'exemple précédent. À cause de la priorité des opérateurs, Visual Basic exécute normalement l'opérateur ^ avant tous les autres, même l'opérateur unaire –. Si exp4 et exp6 avaient été calculés sans parenthèses, le résultat obtenu serait le suivant :

exp4 = -5 ^ 4 serait calculé comme -(5 à la puissance quatre), ce qui donnerait -625.

exp6 = 8 ^ -1.0 / 3.0 serait calculé comme (8 à la puissance -1, ou 0,125) divisé par 3,0, ce qui donnerait 0,041666666666666666666666666666667.