Multiplica dos números de precisión arbitraria

# bcmul

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

bcmul — Multiplica dos números de precisión arbitraria

### Descripción

function bcmul(string `$num1`, string `$num2`, ?int `$scale` = `null`): string

Multiplica `num1` por `num2`.

### Parámetros

`num1`

  El operador izquierdo, como una cadena.

`num2`

  El operador derecho, como una cadena

`scale`
  Este parámetro se utiliza para establecer el número de dígitos después del punto decimal en el resultado. Si es `null`, se establecerá por defecto en la escala predeterminada establecida con bcscale(), o se utilizará el valor de la directiva INI `bcmath.scale`.

### Valores devueltos

Devuelve el resultado como un string.

### Errores/Excepciones

Esta función lanza una excepción ValueError en los siguientes casos:

- `num1` o `num2` no es una cadena numérica bien formada de BCMath.
- `scale` está fuera del rango válido.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.0 | `scale` ahora es nullable.
7.3.0 | bcmul() ahora devuelve números con la escala solicitada. Anteriormente, los números devueltos podían omitir los ceros decimales finales.

### Ejemplos

Ejemplo #1 Ejemplo de bcmul()

    <?php
    echo bcmul('1.34747474747', '35', 3); // 47.161
    echo bcmul('2', '4'); // 8
    ?>

### Notas

> Nota:

> Antes de PHP 7.3.0, bcmul() podría devolver un resultado con menos dígitos después del punto decimal que el parámetro `scale` indicaría. Esto solo ocurre cuando el resultado no requiere toda la precisión permitida por `scale`. Por ejemplo:

> Ejemplo #2 Ejemplo de scale en bcmul()

>     <?php
>     echo bcmul('5', '2', 2);     // Imprime "10", no "10.00"
>     ?>

### Ver también

- bcdiv() - Divide dos números de precisión arbitraria
- BcMath\Number::mul() - Multiplica un número de precisión arbitraria

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open