021/numeric
最新稳定版本:v1.0.2
Composer 安装命令:
composer require 021/numeric
包简介
A PHP library for working with precise numbers.
README 文档
README
A PHP library to convenient work with arbitrary precision numbers.
Requirements
- PHP 8.1 or higher
Library is based on Brick\Math package:
Although the library can work seamlessly on any PHP installation, it is highly recommended that you install the GMP or BCMath extension to speed up calculations. The fastest available calculator implementation will be automatically selected at runtime.
Installation
You can install the package via composer:
composer require 021/numeric
Usage
use function O21\Numeric\Helpers\num; $number = num('123.456'); echo $number->add('0.544')->get();
Calculations
All computational functions accept as an argument a value of one of the following types: string, float, int, \O21\Numeric\Numeric, \Brick\Math\BigNumber.
| Function | Description |
|---|---|
add | Adds a value to a number |
sub | Subtracts a value from a number |
mul | Multiplies a number by a value |
div | Divides a number by a value |
Comparisons
All comparison functions accept as an argument a value of one of the following types: string, float, int, \O21\Numeric\Numeric, \Brick\Math\BigNumber.
| Function | Description |
|---|---|
equals | Checks if two values are equal. It returns true if the values are equal and false otherwise. |
greaterThan | Compares two values and returns true if the first value is greater than the second one. |
lessThan | Compares two values and returns true if the first value is less than the second one. |
greaterThanOrEqual | Compares two values and returns true if the first value is greater than or equal to the second one. |
lessThanOrEqual | Compares two values and returns true if the first value is less than or equal to the second one. |
Formatting
| Function | Description |
|---|---|
positive | Returns a number represented as positive. |
negative | Returns a number represented as negative. |
scale | Converts a number to a given scale, using rounding if necessary. |
get | Returns a number as string. By default removes trailing zeros. Use the raw: true option to disable this. |
__toString | Returns a get function result |
Helpers
Namespace: O21\Numeric\Helpers
| Function | Description |
|---|---|
num | Creates a new Numeric instance |
num_min | Returns a minimum value from a given values. Support any of these types: string, float, int, \O21\Numeric\Numeric, \Brick\Math\BigNumber |
num_max | Returns a maximum value from a given values. Support any of these types: string, float, int, \O21\Numeric\Numeric, \Brick\Math\BigNumber |
to_bn | Converts any of these types string, float, int, \O21\Numeric\Numeric, \Brick\Math\BigNumber to \Brick\Math\BigNumber |
统计信息
- 总下载量: 2.35k
- 月度下载量: 0
- 日度下载量: 0
- 收藏数: 0
- 点击次数: 1
- 依赖项目数: 2
- 推荐数: 0
其他信息
- 授权协议: MIT
- 更新时间: 2026-01-04