# bcsqrt

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

bcsqrt — Ré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 la valeur par défaut de l'échelle définie avec bcscale(), ou utilisera la valeur de la directive INI `bcmath.scale` si disponible.

### 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
- BcMath\Number::sqrt() - Renvoie la racine carré d'un nombre de précision arbitraire