# gmp_pow

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

gmp_pow — Puissance

### Description

gmp_pow(GMP|int|string `$num`, int `$exponent`): GMP

Élève `num` à la puissance `exponent`.

### Liste de paramètres

`num`

  La base.

  Un objet GMP, un entier, ou un chaîne de caractères qui peut être interprété comme un nombre suivant la même logique que si la chaîne était utilisée dans gmp_init() avec détection automatique de la base (c'est-à-dire lorsque `base` est égal à 0).

`exponent`

  La puissance positive utilisée pour élever `num`.

### Valeurs de retour

Le nouveau nombre, sous la forme d'un nombre GMP. Dans le cas de `0^0`, gmp_pow() retourne 1.

### Exemples

Exemple #1 Exemple avec gmp_pow()

`<?php
$pow1 = gmp_pow("2", 31);
echo gmp_strval($pow1) . "\n";
$pow2 = gmp_pow("0", 0);
echo gmp_strval($pow2) . "\n";
$pow3 = gmp_pow("2", -1); // Négatif, génère un warning
echo gmp_strval($pow3) . "\n";
?>`

L'exemple ci-dessus va afficher :

    2147483648
    1