bccomp

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

bccomp — Сравнивает два числа произвольной точности

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

Функция сравнивает число num1 с числом num2 и возвращает целочисленный результат сравнения.

num1: Левый операнд (слагаемое) в виде строки.
num2: Правый операнд (слагаемое) в виде строки.
scale: Параметр используется для установки количества цифр после десятичного знака в результате. Если установлено значение null, то по умолчанию будет установлен масштаб по умолчанию, заданный с помощью функции bcscale() или значение INI-директивы bcmath.scale.

Функция возвращает 0, если числа равны, 1, если число num1 больше числа num2, иначе возвращает -1.

Функция выбрасывает исключение ValueError в следующих случаях:

Значение аргумента num1 или num2 оказалось строкой, которую сформировали неправильно с точки зрения допустимого формата числовых строк в модуле BCMath.
Значение аргумента scale выходит за пределы допустимого диапазона.

Версия	Описание
8.0.0	Параметр `scale` теперь принимает значение `null`.

Пример #1 Пример сравнения двух чисел произвольной точности функцией bccomp()

<?php

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

?>