Dans MariaDB, POWER()
est un synonyme de POW()
, qui est une fonction intégrée qui renvoie la valeur de son premier argument élevée à la puissance de son deuxième argument.
Syntaxe
La syntaxe ressemble à ceci :
POWER(X,Y)
Il renvoie X
élevé à la puissance Y
.
Comme mentionné, POWER()
est un synonyme de POW()
, donc cela peut aussi être fait comme ceci :
POW(X,Y)
Exemple
Voici un exemple pour illustrer :
SELECT POWER(2, 3);
Résultat :
+-------------+ | POWER(2, 3) | +-------------+ | 8 | +-------------+
Valeurs négatives
Voici quelques exemples qui utilisent des valeurs négatives :
SELECT
POWER(-2, 3),
POWER(2, -3),
POWER(-2, -3);
Résultat :
+--------------+--------------+---------------+ | POWER(-2, 3) | POWER(2, -3) | POWER(-2, -3) | +--------------+--------------+---------------+ | -8 | 0.125 | -0.125 | +--------------+--------------+---------------+
Arguments non numériques
Voici un exemple de ce qui se passe lorsque nous fournissons des arguments non numériques :
SELECT POWER('Homer', 'Symptom');
Résultat :
+---------------------------+ | POWER('Homer', 'Symptom') | +---------------------------+ | 1 | +---------------------------+ 1 row in set, 2 warnings (0.000 sec)
Voyons l'avertissement :
SHOW WARNINGS;
Résultat :
+---------+------+---------------------------------------------+ | Level | Code | Message | +---------+------+---------------------------------------------+ | Warning | 1292 | Truncated incorrect DOUBLE value: 'Homer' | | Warning | 1292 | Truncated incorrect DOUBLE value: 'Symptom' | +---------+------+---------------------------------------------+
Arguments nuls
POWER()
renvoie null
si un argument est null
:
SELECT
POWER(2, null),
POWER(null, 3),
POWER(null, null);
Résultat :
+----------------+----------------+-------------------+ | POWER(2, null) | POWER(null, 3) | POWER(null, null) | +----------------+----------------+-------------------+ | NULL | NULL | NULL | +----------------+----------------+-------------------+
Arguments manquants
Appel de POWER()
avec le mauvais nombre d'arguments, ou sans aucun argument entraîne une erreur :
SELECT POWER();
Résultat :
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'POWER'
Et :
SELECT POWER(10, 2, 3);
Résultat :
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'POWER'