BCSQRT |
Racine carré |
| PHP 4.0+ |
Syntaxe
|
function bcsqrt($operand);
|
|
function bcsqrt($operand,$scale);
|
Paramètres
| Nom |
Description |
| $left_operand |
Ce paramètre permet d'indiquer le nombre à multiplier par lui-mime. |
| $scale |
Ce paramètre permet d'indiquer le nombre de chiffre après la décimale à placer dans le résultat. |
Retour
| Valeur |
Description |
| NULL |
Cette valeur permet d'indiquer que l'opérande est négatif. |
| chaine de caractères |
Ces valeurs permettent d'indiquer le résultat. |
Description
Cette fonction permet d'effectuer le calcul de la racine carré d'un nombre avec un haut niveau de précision arithmétique.
Remarques
- Calcul de racine carrée avec précision arbitraire : La fonction bcsqrt permet de calculer la racine carrée d'un nombre avec une précision arbitraire. Cela
la rend idéale pour manipuler des valeurs très grandes ou très précises, là où les fonctions natives pourraient introduire des erreurs d'arrondi.
- Entrée sous forme de chaîne de caractères : Comme toutes les fonctions BC Math, bcsqrt attend un nombre sous forme de
chaîne de caractères. Cela permet de contourner les limitations des types numériques natifs en PHP et de travailler avec des nombres plus grands que ce que les types
comme float ou int peuvent gérer.
- Contrôle de la précision avec $scale : Le paramètre $scale permet de spécifier le nombre de chiffres à conserver après la virgule dans le résultat. Si
ce paramètre est omis, la précision par défaut définie par bcscale ou zéro sera utilisée, ce qui peut tronquer les décimales.
- Retourne une chaîne de caractères ou NULL en cas d'entrée invalide : Si l'entrée fournie est un nombre négatif ou non valide, bcsqrt retourne NULL. Cela
empêche les erreurs logiques, car les racines carrées des nombres négatifs ne sont pas définies dans les nombres réels (traités par BC Math).
- Utilisation dans des calculs financiers ou scientifiques : bcsqrt est souvent utilisée dans des contextes où la racine carrée est nécessaire avec une
haute précision, comme dans les calculs d'intérêts composés, les statistiques ou la résolution d'équations quadratiques.
- Non compatible avec les nombres complexes : Contrairement à certaines bibliothèques ou fonctions mathématiques avancées, bcsqrt ne peut pas calculer la
racine carrée des nombres négatifs en tant que nombres complexes. Pour ce type de calcul, une autre bibliothèque ou approche est nécessaire.
- Performance dépendant de la précision : Plus la précision demandée est élevée (via $scale), plus le temps de calcul peut augmenter. Cela est particulièrement
vrai pour les très grands nombres, car BC Math effectue des calculs de précision arbitraire en interne.
- Extension BC Math obligatoire : bcsqrt fait partie de l'extension BC Math, devant être activée dans l'environnement
PHP. Si l'extension n'est pas activée, la fonction ne sera pas disponible, et il faudra envisager des alternatives comme GMP ou des fonctions
mathématiques natives.
Dernière mise à jour : Mercredi, le 25 mars 2015
