Manuel PHP
Précédent |  | Suivant

# 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 sont fonctionnellement identiques. 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 and $b are equal to each other. ?>`

## Voir aussi

bcpow()
bcmod()

Précédent | Sommaire | Suivant
bcpow | Niveau supérieur | bcscale