PHP 8.4.2 Released!

    bcsub

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

    bcsub — Subtrai um número de precisão arbitrária de outro

    Descrição

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

    Subtrai num2 de num1.

    Parâmetros

    num1

    O operando da esquerda, como uma string.

    num2

    O operando da direita, como uma string.

    scale
    Este parâmetro opcional é usado para definir o número de dígitos após a casa decimal no resultado. Se for igual a null o padrão será a escala definida com a função bcscale() ou, em último caso, o valor da diretiva INI bcmath.scale.

    Valor Retornado

    O resultado da subtração, como uma string.

    Erros/Exceções

    Esta função lança uma exceção ValueError nos seguintes casos:

    • num1 ou num2 não for uma string numérica BCMath bem formada.
    • scale estiver fora do intervalo válido.

    Registro de Alterações

    Versão Descrição
    8.0.0 scale agora pode ser nulo.

    Exemplos

    Exemplo #1 Exemplo de bcsub()

    <?php

    $a     = '1.234';
    $b = '5';

    echo     bcsub($a, $b); // -3
    echo bcsub($a, $b, 4); // -3.7660

    ?>

    Veja Também

    • bcadd() - Adiciona dois números de precisão arbitrária

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 2 notes

    up
    7
    nd at snackbox dot org
    6 years ago
    The parameter order here is probably fairly obvious to most people (subtract right from left), but to clarify with a simple use case since I was struggling with this at the end of a long day:

    <?php
    echo bcsub('7', '5'); // 7 - 5 = '2'
    echo bcsub('12', '17'); // 12 - 17 = '-5'
    ?>

    Provide the parameters in the same order you would when using a normal subtraction operator.
    up
    0
    charles dot adrian dot wood at gmail dot com
    5 years ago
    Please note that bcsub will fail in non-obvious ways if it's fed something that cannot be converted to a number. For instance:

    bcsub('yes', 'no') === '0'

    Yes, if you put garbage in, you get garbage out. Just don't expect bcsub to throw an error when you feed it an entirely non-numeric value.
    ＋adicione uma nota
    To Top