Matemáticas de precisión arbitraria BCMath

Introducción

Para matemáticas de precisión arbitraria, PHP ofrece BCMath, que admite números de cualquier tamaño y precisión de hasta 2147483647 (o 0x7FFFFFFF) dígitos decimales, si hay suficiente memoria, representados como cadenas.

Números válidos (también conocidos como bien formados) en BCMath son cadenas que coinciden con la expresión regular /^[+-]?[0-9]*(\.[0-9]*)?$/.

Precaución

Pasar valores de tipo float a una función de BCMath que espera un string como operando puede no tener el efecto deseado debido a la forma en que PHP convierte valores de tipo float a string, es decir, que el string puede estar en notación exponencial (que no es compatible con BCMath), y que, antes de PHP 8.0.0, el separador decimal dependía de la configuración regional (mientras que BCMath siempre espera un punto decimal).

<?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'); // Utiliza una coma decimal
$num2 = 1.2; // (string) 1.2 => '1,2'
echo bcsub($num1, $num2, 1); // => '0.0'
?>

Instalación/Configuración
- Instalación
- Configuración en tiempo de ejecución
Funciones de BC Math
- bcadd — Suma dos números de precisión arbitrária
- bcceil — Redondea al alza un número de precisión arbitraria
- bccomp — Comparar dos números de gran tamaño
- bcdiv — Divide dos números de precisión arbitraria
- bcdivmod — Devuelve el cociente y el resto de un número de precisión arbitraria
- bcfloor — Redondea hacia abajo un número de precisión arbitraria
- bcmod — Devuelve el resto de una división entre números de gran tamaño
- bcmul — Multiplica dos números de precisión arbitraria
- bcpow — Elevar un número de precisión arbitraria a otro
- bcpowmod — Eleva un número de precisión arbitraria a otro, reducido por un módulo especificado
- bcround — Redondea un número de precisión arbitraria
- bcscale — Define o recupera la precisión por defecto para todas las funciones bc math
- bcsqrt — Obtiene la raiz cuadrada de un número de precisión arbitraria
- bcsub — Resta un número de precisión arbitraria de otro
BcMath\Number — La clase BcMath\Number
- BcMath\Number::add — Añadir un número de precisión arbitraria
- BcMath\Number::ceil — Redondea al alza un número de precisión arbitraria
- BcMath\Number::compare — Comparar dos números de precisión arbitraria
- BcMath\Number::__construct — Crear un objeto BcMath\Number
- BcMath\Number::div — Divide por un número de precisión arbitraria
- BcMath\Number::divmod — Devuelve el cociente y el módulo de un número de precisión arbitraria
- BcMath\Number::floor — Redondea hacia abajo un número de precisión arbitraria
- BcMath\Number::mod — Devuelve el módulo de un número de precisión arbitraria
- BcMath\Number::mul — Multiplica un número de precisión arbitraria
- BcMath\Number::pow — Eleva un número de precisión arbitraria
- BcMath\Number::powmod — Eleva un número de precisión arbitraria, reducido por un módulo especificado
- BcMath\Number::round — Redondea un número de precisión arbitraria
- BcMath\Number::__serialize — Serializa un objeto BcMath\Number
- BcMath\Number::sqrt — Devuelve la raíz cuadrada de un número de precisión arbitraria
- BcMath\Number::sub — Sustrae un número de precisión arbitraria
- BcMath\Number::__toString — Convierte un BcMath\Number en string
- BcMath\Number::__unserialize — Deserializa un argumento de datos en un objeto BcMath\Number

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