La classe BcMath\Number

    (PHP 8 >= 8.4.0)

    Introduction

    Une classe pour un nombre de précision arbitraire. Ces objets supportent les opérateurs arithmétiques et de comparaison.

    Note: Cette classe n'est pas affectée par la directive INI bcmath.scale définie dans le php.ini.

    Note: Le comportement d'un opérateur surchargé est le même que de spécifier null pour le paramètre scale sur la méthode correspondante.

    Synopsis de la classe

    namespace BcMath;
    final readonly class Number implements Stringable {
    /* Propriétés */
    public string $value;
    public int $scale;
    /* Méthodes */
    public __construct(string|int $num)
    public add(BcMath\Number|string|int $num, ?int $scale = null): BcMath\Number
    public ceil(): BcMath\Number
    public compare(BcMath\Number|string|int $num, ?int $scale = null): int
    public div(BcMath\Number|string|int $num, ?int $scale = null): BcMath\Number
    public divmod(BcMath\Number|string|int $num, ?int $scale = null): array
    public floor(): BcMath\Number
    public mod(BcMath\Number|string|int $num, ?int $scale = null): BcMath\Number
    public mul(BcMath\Number|string|int $num, ?int $scale = null): BcMath\Number
    public pow(BcMath\Number|string|int $exponent, ?int $scale = null): BcMath\Number
    public powmod(BcMath\Number|string|int $exponent, BcMath\Number|string|int $modulus, ?int $scale = null): BcMath\Number
    public round(int $precision = 0, RoundingMode $mode = RoundingMode::HalfAwayFromZero): BcMath\Number
    public __serialize(): array
    public sqrt(?int $scale = null): BcMath\Number
    public sub(BcMath\Number|string|int $num, ?int $scale = null): BcMath\Number
    public __toString(): string
    public __unserialize(array $data): void
    }

    Propriétés

    value
    Une représentation en chaîne d'un nombre de précision arbitraire.
    scale
    La valeur de l'échelle actuellement définie sur l'objet. Pour les objets résultant de calculs, cette valeur est automatiquement calculée et définie, sauf si le paramètre scale a été défini dans la méthode de calcul.

    Sommaire

    Found A Problem?

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

    User Contributed Notes 2 notes

    up
    5
    harl at gmail dot com
    1 year ago
    BcMath\Number is one of those classes that overloads boolean casting.
If $z = new BcMath\Number(0) then $z is considered falsy (and hence, for example, empty($z)==true) even though it is a genuine Number object.
    up
    0
    miken32 at gmail dot com
    19 days ago
    This class overloads many operators so you can do operations more naturally. But a big caveat is that the strict equality operator *does not work* as demonstrated with this code:

<?php
$sum = new BcMath\Number('23.93') + new BcMath\Number(17) - 6;
echo $sum;            // outputs 34.93

if ($sum < 99 && $sum > 34) {
    echo "foo";       // outputs foo
}

$comp = new BcMath\Number('34.93');
if ($sum === $comp) {
    echo "bar";       // outputs nothing!
}

if ($sum == $comp) {
    // yuck, don't do this
}

if ($sum->compare($comp) === 0) {
    echo "baz";       // outputs baz
}
?>
    ＋add a note
    To Top