bccomp

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

bccompVergleich zweier Zahlen beliebiger Genauigkeit

Beschreibung

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

Vergleicht num1 mit num2 und gibt das Ergebnis als Integer-Wert zurück.

Parameter-Liste

num1

Der linke Operand als Zeichenkette.

num2

Der rechte Operand als Zeichenkette.

scale
Dieser Parameter wird verwendet, um die Anzahl der Nachkommastellen im Ergebnis festzulegen. Falls null, wird die mit bcscale() definierte Standard-Genauigkeit verwendet oder auf den Wert der INI-Direktive bcmath.scale zurückgegriffen.

Rückgabewerte

Gibt 0 zurück, wenn beide Operatoren gleich sind, 1, wenn num1 größer ist als num2, und andernfalls -1.

Fehler/Exceptions

Diese Funktion löst in den folgenden Fällen einen ValueError aus:

  • num1 oder num2 ist keine wohlgeformte numerische BCMath-Zeichenkette.
  • scale liegt außerhalb des gültigen Bereichs.

Changelog

Version Beschreibung
8.0.0 scale ist jetzt nullbar.

Beispiele

Beispiel #1 bccomp()-Beispiel

<?php

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

?>

Siehe auch