bcsub

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

bcsubSubtrai 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 do resultado. Se omitido, o padrão será a escala definida globalmente com a função bcscale() ou, em último caso, 0 se a escala não tiver sido definida.

Valor Retornado

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

Registro de Alterações

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

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() - Adicionar dois números de precisão arbitrária

add a note add a note

User Contributed Notes 2 notes

up
5
nd at snackbox dot org
5 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
1
charles dot adrian dot wood at gmail dot com
4 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.
To Top