# bcdiv

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

bcdiv — Divise deux nombres de grande taille

### Description

bcdiv(string `$num1`, string `$num2`, ?int `$scale` = `null`): string

Divise `num1` par `num2`.

### Liste de paramètres

`num1`

  Le dividende, sous la forme d'une chaîne de caractères.

`num2`

  Le diviseur, sous la forme d'une chaîne de caractères.

`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 le résultat de la division, sous la forme d'une chaîne de caractères.

### Erreurs / Exceptions

Cette fonction lève une exception ValueError dans les cas suivants :

- `num1` ou `num2` n'est pas une chaîne numérique BCMath correctement formée.
- `scale` est en dehors de la plage valide.

Cette fonction lève une exception DivisionByZeroError si `num2` est égal à `0`.

### Historique

Version | Description
--- | ---
8.0.0 | `scale` est désormais nullable.
8.0.0 | La division par `0` lève désormais une exception DivisionByZeroError au lieu de retourner `null`.

### Exemples

Exemple #1 Exemple avec bcdiv()

`<?php
echo bcdiv('105', '6.55957', 3); // 16.007
?>`

### Voir aussi

- bcmul() - Multiplie deux nombres de grande taille
- bcdivmod() - Renvoie le quotient et le reste d'un nombre de précision arbitraire
- bcmod() - Retourne le reste d'une division entre nombres de grande taille
- BcMath\Number::div() - Divise par un nombre de précision arbitraire