bcpow
bcscale
Fonctions BC Math
PHP Manual

# bcpowmod

(PHP 5)

bcpowmod — Calcule le reste modulo d'un nombre élevé à une puissance

### Description

string bcpowmod ( string `$left_operand` , string `$right_operand` , string `$modulus` [, int `$scale` ] )

Utilise la méthode d'exponentiation rapide pour élever le nombre `left_operand` à la puissance `right_operand` , et en calculant le reste modulo `modulus` .

### Liste de paramètres

`left_operand`

  L'opérande de gauche, sous la forme d'une chaîne de caractères.

`right_operand`

  L'opérande de droite, sous la forme d'une chaîne de caractères.

`modulus`

  Le modulo, sous la forme d'une chaîne de caractères.

`scale`

  Ce paramètre optionnel est utilisé pour définir le nombre de digits après la décimale à placer dans le résultat. Vous pouvez également définire la précision globale par défaut pour toutes les fonctions en utilisant la fonction bcscale().

### Valeurs de retour

Retourne le résultat, sous la forme d'une chaîne de caractères, ou `NULL` si `modulus` vaut 0.

### Notes

> Note: Comme cette méthode utilise les opérations de modulo, les nombres non naturels risquent de donner des résultats inattendus. Un nombre naturel est un entier positif non-nul.

### Exemples

Les deux lignes suivantes produisent le même résultat. La version qui utilise bcpowmod() est bien plus rapide, et accepte des paramètres plus grands.

`<?php
$a = bcpowmod($x, $y, $mod);
$b = bcmod(bcpow($x, $y), $mod);
// $a et $b sont égaux.
?>`

### Voir aussi

- bcpow()
- bcmod()

bcpow
bcscale
Fonctions BC Math
PHP Manual