PHP 8.4.2 Released!

bcsqrt

(PHP 4, PHP 5, PHP 7, PHP 8)

bcsqrtRécupère la racine carrée d'un nombre de grande taille

Description

bcsqrt(string $num, ?int $scale = null): string

Retourne la racine carrée de num.

Liste de paramètres

num

L'opérande, sous la forme d'une chaîne de caractères BCMath numérique bien formée.

scale
Ce paramètre est utilisé pour définir le nombre de chiffres après la virgule dans le résultat. Si null, il prendra par défaut la valeur définie par bcscale(), ou, à défaut, la valeur de la directive INI bcmath.scale.

Valeurs de retour

Retourne la racine carrée de l'opérande, sous la forme d'une chaîne de caractères, ou null si num est négatif.

Erreurs / Exceptions

Cette fonction lance une erreur ValueError dans les cas suivants :

  • num n'est pas une chaîne numérique BCMath bien formée
  • num est inférieur à 0
  • scale est en dehors de la plage valide

Historique

Version Description
8.0.0 Si num n'est pas une chaîne numérique BCMath bien formée, ou est inférieur à 0, une ValueError est levée. Précédemment, E_WARNING était émis à la place.
8.0.0 scale doit désormais être compris entre 0 et 2147483647. Précédemment, les échelles négatives étaient traitées silencieusement comme 0. scale est désormais nullable.

Exemples

Exemple #1 Exemple avec bcsqrt()

<?php

echo bcsqrt('2', 3); // 1.414

?>

Voir aussi

  • bcpow() - Élève un nombre à une puissance donnée

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top