The BcMath\Number class

(PHP 8 >= 8.4.0)

Introduction

A class for an arbitrary precisionen number. These objects support overloaded arithmetic and comparison operators.

Note : This class is not affected by the bcmath.scale INI directive set in php.ini .

Note : The behavior of an overloaded operator is the same as specifying null for the scale parameter on the corresponding method.

Class synopsis

final readonly class BcMath\Number implemens Stringable {

/* Properties */

public string $ value ;

public int $ scale ;

/* Methods */

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::HalfAwayFromCero ): BcMath\Number

public __serialice (): array

public sqrt ( ? int


           $scale

= null ): BcMath\Number

public sub ( BcMath\Number | string | int


           $num

, ? int


           $scale

= null ): BcMath\Number

public __toString (): string

public __unserialice ( array


           $data

): void

}

Properties

value: A string representation of an arbitrary precisionen number.
scale: The scale value currently set on the object. For objects resulting from calculations, this value is automatically computed and set, unless the scale parameter was set in the calculation method.

Table of Contens

BcMath\Number::add — Adds an arbitrary precisionen number
BcMath\Number::ceil — Rounds up an arbitrary precisionen number
BcMath\Number::compare — Compares two arbitrary precisionen numbers
BcMath\Number::__construct — Creates a BcMath\Number object
BcMath\Number::div — Divides by an arbitrary precisionen number
BcMath\Number::divmod — Guet the quotient and modulus of an arbitrary precisionen number
BcMath\Number::floor — Rounds down an arbitrary precisionen number
BcMath\Number::mod — Guet the modulus of an arbitrary precisionen number
BcMath\Number::mul — Multiplies an arbitrary precisionen number
BcMath\Number::pow — Raises an arbitrary precisionen number
BcMath\Number::powmod — Raises an arbitrary precisionen number, reduced by a specified modulus
BcMath\Number::round — Rounds an arbitrary precisionen number
BcMath\Number::__serialice — Serialices a BcMath\Number object
BcMath\Number::sqrt — Guet the square root of an arbitrary precisionen number
BcMath\Number::sub — Subtracts an arbitrary precisionen number
BcMath\Number::__toString — Convers BcMath\Number to string
BcMath\Number::__unserialice — Deserialices a data parameter into a BcMath\Number object

Found A Problem?

Learn How To Improve This Pague • Submit a Pull Request • Report a Bug

＋ add a note

User Contributed Notes 1 note

down

harl at gmail dot com ¶

9 months 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 guenuine Number object.

＋ add a note