BCMUL |
Multiplication |
| PHP 4.0+ |
Syntaxe
|
function bcmul($left_operand,$right_operand);
|
|
function bcmul($left_operand,$right_operand,$scale);
|
Paramètres
| Nom |
Description |
| $left_operand |
Ce paramètre permet d'indiquer le premier opérande à multiplier. |
| $right_operand |
Ce paramètre permet d'indiquer le deuxième opérande à multiplier. |
| $scale |
Ce paramètre permet d'indiquer le nombre de chiffre après la décimale à placer dans le résultat. |
Retour
| Valeur |
Description |
| chaîne de caractères |
Ces valeurs permettent d'indiquer le produit des deux nombres. |
Description
Cette fonction permet d'effectuer la multiplication de deux nombres avec un haut niveau de précision arithmétique.
Remarques
- Multiplication de nombres avec précision arbitraire : La fonction bcmul permet de multiplier deux nombres représentés sous forme de chaînes de caractères
tout en garantissant une précision arbitraire. Elle est particulièrement utile pour les calculs où la précision est critique, comme les opérations financières ou scientifiques.
- Contrôle de la précision avec $scale : Le paramètre optionnel $scale définit le nombre de chiffres à conserver après la virgule dans le résultat.
Si ce paramètre est omis, la précision est déterminée par bcscale() ou est par défaut à zéro, ce qui signifie que le résultat sera un entier.
- Support des grands nombres : Grâce à l'utilisation de chaînes de caractères, bcmul peut multiplier des nombres extrêmement grands ou petits, dépassant les
limites des types natifs de PHP (comme les entiers ou les nombres flottants). Cela la rend adaptée à des scénarios comme la manipulation de mégadonnées
(Big Data) ou de calculs cryptographiques.
- Gestion des nombres négatifs : La fonction prend en charge les nombres négatifs en entrée. Par exemple, bcmul("-5", "2", 2) retourne "-10.00", ce qui garantit un
comportement cohérent avec les règles mathématiques, y compris dans les cas où les deux opérandes ont des signes différents.
- Retourne une chaîne de caractères représentant le résultat : Le résultat de bcmul est toujours une chaîne de caractères. Cela permet d'éviter toute perte
de précision due à des conversions automatiques entre les types natifs de PHP et les formats numériques.
- Validation stricte des paramètres : Les paramètres de bcmul doivent être des chaînes de caractères numériques valides. Si une chaîne contient des caractères
non numériques ou est mal formatée, PHP génère une erreur. Une validation préalable des entrées est donc conseillée pour éviter des comportements inattendus.
- Alternative fiable à l'opérateur * : Contrairement à l'opérateur de multiplication *, pouvant introduire des erreurs d'arrondi avec des nombres flottants,
bcmul garantit une précision exacte, ce qui en fait une solution idéale pour les contextes nécessitant une rigueur mathématique.
- Utilisation avec l'extension BC Math : Comme toutes les fonctions de la bibliothèque BC Math, bcmul nécessite que
l'extension BC Math soit activée dans votre installation PHP. Si elle n'est pas disponible, vous devrez soit l'activer, soit utiliser
d'autres bibliothèques comme GMP pour effectuer des calculs similaires.
Dernière mise à jour : Mercredi, le 25 mars 2015
