bccomp

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

bccompCompare deux nombres de grande taille

Description

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

Compare l'opérande num1 avec num2 et retourne le résultat sous forme d'un entier.

Liste de paramètres

num1

L'opérande gauche, sous la forme d'une chaîne de caractères.

num2

L'opérande droite, 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 par défaut la valeur définie par bcscale(), ou, à défaut, la valeur de la directive INI bcmath.scale.

Valeurs de retour

Retourne 0 si les deux opérandes sont égaux, 1 si num1 est supérieur à num2, ou -1 sinon.

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.

Historique

Version Description
8.0.0 scale est désormais nullable.

Exemples

Exemple #1 Exemple avec bccomp()

<?php

echo bccomp('1', '2') . "\n"; // -1
echo bccomp('1.00001', '1', 3); // 0
echo bccomp('1.00001', '1', 5); // 1

?>