BCMath Rechnen mit beliebiger Genauigkeit

Einführung

Für beliebig genaue mathematische Operationen bietet PHP BCMath, das Zahlen von beliebiger Länge und Genauigkeit mit bis zu 2147483647 (oder 0x7FFFFFFF) Dezimalstellen unterstützt, falls genügend Speicherplatz vorhanden ist, dargestellt als String.

Gültige (d. h. wohlgeformte) BCMath-Zahlen sind Strings, die auf den regulären Ausdruck /^[+-]?[0-9]*(\.[0-9]*)?$/ passen.

Achtung

Die Übergabe von Werten vom Typ float an eine BCMath-Funktion, die einen String als Operanden erwartet, funktioniert aufgrund der Art, wie PHP float-Werte in Strings konvertiert, möglicherweise nicht wie erwartet, nämlich dass der String u. U. in exponentieller Notation vorliegt (was von BCMath nicht unterstützt wird), und dass der Dezimaltrenner vor PHP 8.0.0 von der Locale abhängt (wohingegen BCMath immer einen Dezimalpunkt erwartet).

<?php
$num1 = 0; // (string) 0 => '0'
$num2 = -0.000005; // (string) -0.000005 => '-5.05E-6'
echo bcadd($num1, $num2, 6); // => '0.000000'

setlocale(LC_NUMERIC, 'de_DE'); // verwendet ein Dezimalkomma
$num2 = 1.2; // (string) 1.2 => '1,2'
echo bcsub($num1, $num2, 1); // => '0.0'
?>

Installation/Konfiguration
- Installation
- Laufzeit-Konfiguration
BC Math Funktionen
- bcadd — Addition zweier Zahlen beliebiger Genauigkeit
- bcceil — Round up arbitrary precision number
- bccomp — Vergleich zweier Zahlen beliebiger Genauigkeit
- bcdiv — Division zweier Zahlen beliebiger Genauigkeit
- bcdivmod — Get the quotient and modulus of an arbitrary precision number
- bcfloor — Round down arbitrary precision number
- bcmod — Modulo zweier Zahlen mit beliebiger Genauigkeit
- bcmul — Multiplikation zweier Zahlen beliebiger Genauigkeit
- bcpow — Potenz einer Zahl beliebiger Genauigkeit
- bcpowmod — Potenz einer Zahl beliebiger Genauigkeit, vermindert um ein angegebenen Modulo
- bcround — Round arbitrary precision number
- bcscale — Setzt oder holt die Genauigkeit aller BCmath-Funktionen
- bcsqrt — Ermittelt die Quadratwurzel einer Zahl beliebiger Genauigkeit
- bcsub — Subtrahiert zwei Zahlen beliebiger Genauigkeit
BcMath\Number — The BcMath\Number class
- BcMath\Number::add — Adds an arbitrary precision number
- BcMath\Number::ceil — Rounds up an arbitrary precision number
- BcMath\Number::compare — Compares two arbitrary precision numbers
- BcMath\Number::__construct — Creates a BcMath\Number object
- BcMath\Number::div — Divides by an arbitrary precision number
- BcMath\Number::divmod — Gets the quotient and modulus of an arbitrary precision number
- BcMath\Number::floor — Rounds down an arbitrary precision number
- BcMath\Number::mod — Gets the modulus of an arbitrary precision number
- BcMath\Number::mul — Multiplies an arbitrary precision number
- BcMath\Number::pow — Raises an arbitrary precision number
- BcMath\Number::powmod — Raises an arbitrary precision number, reduced by a specified modulus
- BcMath\Number::round — Rounds an arbitrary precision number
- BcMath\Number::__serialize — Serializes a BcMath\Number object
- BcMath\Number::sqrt — Gets the square root of an arbitrary precision number
- BcMath\Number::sub — Subtracts an arbitrary precision number
- BcMath\Number::__toString — Converts BcMath\Number to string
- BcMath\Number::__unserialize — Deserializes a data parameter into a BcMath\Number object

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 3 notes

down

Hayley Watson ¶

10 years ago

This extension is an interface to the GNU implementation as a library of the Basic Calculator utility by Philip Nelson; hence the name.

down

volek at adamv dot cz ¶

11 years ago

Note that when you use implementation of factorial that ClaudiuS made, you get results even if you try to calculate factorial of number that you normally can't, e.g. 2.5, -2, etc. Here is safer implementation:
<?php
/**
 * Calculates a factorial of given number.
 * @param string|int $num
 * @throws InvalidArgumentException
 * @return string
 */
function bcfact($num)
{
    if (!filter_var($num, FILTER_VALIDATE_INT) || $num <= 0) {
        throw new InvalidArgumentException(sprintf('Argument must be natural number, "%s" given.', $num));
    }

    for ($result = '1'; $num > 0; $num--) {
        $result = bcmul($result, $num);
    }

    return $result;
}
?>

down

ClaudiuS ¶

13 years ago

Needed to compute some permutations and found the BC extension great but poor on functions, so untill this gets implemented here's the factorial function:

<?php
/* BC FACTORIAL
 * n! = n * (n-1) * (n-2) .. 1 [eg. 5! = 5 * 4 * 3 * 2 * 1 = 120]
 */
function bcfact($n){
    $factorial=$n;
    while (--$n>1) $factorial=bcmul($factorial,$n);
    return $factorial;
}

print bcfact(50); 
//30414093201713378043612608166064768844377641568960512000000000000
?>

＋add a note