phrity / util-numerics
数值工具库。提供精确度的 ceil()、floor() 和 rand() 的浮点版本。开放式的数值解析器和格式化器。
2.4.0
2024-08-06 08:00 UTC
Requires
- php: ^8.0
Requires (Dev)
- php-coveralls/php-coveralls: ^2.4
- phpunit/phpunit: ^9.0 | ^10.0 | ^11.0
- squizlabs/php_codesniffer: ^3.5
README
数值工具库
数值工具库。提供精确度的 ceil()
、floor()
和 rand()
的浮点版本。开放式的数值解析器、格式化器,以及一些附加功能。
当前版本支持 PHP ^8.0
。
安装
使用 Composer 进行安装;
composer require phrity/util-numerics
数值类
类概要
Phrity\Util\Numerics { /* Methods */ public __construct(int|null $precision = null, string|null $locale = null); public ceil(float $number, int|null $precision = null): float; public floor(float $number, int|null $precision = null): float; public round(float $number, int|null $precision = null): float; public mceil(float $number, float $multipleOf): float; public mfloor(float $number, float $multipleOf): float; public mround(float $number, float $multipleOf): float; public parse(int|float|string $numeric): float|null; public format(float $number, int|null $precision = null): string; public rand(float $min = 0, float[null $max = null, int|null $precision = null): float|null; public precision(float $number, bool $wide = false): int; public setLocale(string $locale): void; }
构造函数
构造函数接受默认精度和/或地区。精度也可以为负以实现整数舍入。
$numerics = new Numerics(); // Default precision is 0 $numerics = new Numerics(3, 'en_US'); // Default precision is 3, default locale en-US
向上取整方法
根据精度指定向上取整,精度为 0
对应 PHP 的 ceil()
函数。精度也可以为负。
// Precison specified on each call $numerics = new Numerics(); $numerics->ceil(1234.5678, 2); // 1234.57 $numerics->ceil(1234.5678, 1); // 1234.60 $numerics->ceil(1234.5678, 0); // 1235.00 $numerics->ceil(1234.5678, -1); // 1240.00 $numerics->ceil(1234.5678, -2); // 1300.00 // Precison specified as default, override is possible $numerics = new Numerics(2); $numerics->ceil(1234.5678); // 1234.57 $numerics->ceil(1234.5678, 0); // 1235.00
向下取整方法
根据精度指定向下取整,精度为 0
对应 PHP 的 floor()
函数。精度也可以为负。
// Precison specified on each call $numerics = new Numerics(); $numerics->floor(1234.5678, 2); // 1234.56 $numerics->floor(1234.5678, 1); // 1234.50 $numerics->floor(1234.5678, 0); // 1234.00 $numerics->floor(1234.5678, -1); // 1230.00 $numerics->floor(1234.5678, -2); // 1200.00 // Precison specified as default, override is possible $numerics = new Numerics(2); $numerics->floor(1234.5678); // 1234.56 $numerics->floor(1234.5678, 0); // 1234.00
标准取整方法
根据精度指定进行标准取整,精度也可以为负。
// Precison specified on each call $numerics = new Numerics(); $numerics->round(1234.5678, 2); // 1234.57 $numerics->round(1234.5678, 1); // 1234.60 $numerics->round(1234.5678, 0); // 1235.00 $numerics->round(1234.5678, -1); // 1230.00 $numerics->round(1234.5678, -2); // 1200.00 // Precison specified as default, override is possible $numerics = new Numerics(2); $numerics->round(1234.5678); // 1234.57 $numerics->round(1234.5678, 0); // 1235.00
向上取整(倍数)方法
根据倍数指定向上取整。
$numerics = new Numerics(); $numerics->mceil(123.123, 0.25); // 123.25 $numerics->mceil(123.123, 2.5); // 125 $numerics->mceil(123.123, 25); // 125 $numerics->mceil(123.123, 250); // 250
向下取整(倍数)方法
根据倍数指定向下取整。
$numerics = new Numerics(); $numerics->mfloor(456.789, 0.25); // 456.75 $numerics->mfloor(456.789, 2.5); // 455 $numerics->mfloor(456.789, 25); // 450 $numerics->mfloor(456.789, 250); // 250
取整(倍数)方法
根据倍数指定取整。
$numerics = new Numerics(); $numerics->mround(456.789, 0.25); // 456.75 $numerics->mround(456.789, 2.5); // 457.5 $numerics->mround(456.789, 25); // 450 $numerics->mround(456.789, 250); // 500
解析方法
数值解析器。通过评估输入而不是使用地区或做出明确假设来解析数字。返回 float
,如果提供的输入无法解析则返回 null
。
$numerics = new Numerics(); // Integer and float input $numerics->parse(1234.56); // 1234.56 $numerics->parse(1234); // 1234.00 // String input $numerics->parse('1234.56'); // 1234.56 $numerics->parse('1234,56'); // 1234.56 $numerics->parse('1 234.56'); // 1234.56 $numerics->parse('1 234,56'); // 1234.56 $numerics->parse('1,234.56'); // 1234.56 $numerics->parse('1.234,56'); // 1234.56 // Evaluated string input $numerics->parse(' 1 234.56 '); // 1234.56 $numerics->parse('-1,234.56'); // -1234.56 $numerics->parse('+1.234,56'); // 1234.56 $numerics->parse('.56'); // 0.56 $numerics->parse(',56'); // 0.56 $numerics->parse('12.'); // 12.0 $numerics->parse('12,'); // 12.0 // Locale support for fringe cases $numerics->setLocale('sv_SE'); $numerics->parse('123,456'); // 123.456 $numerics->setLocale('en_US'); $numerics->parse('123,456'); // 123456.0
格式化方法
数值格式化器。根据精度(舍入和填充)和地区格式化数字。精度也可以为负。
$numerics = new Numerics(); $numerics->setLocale('sv_SE'); $numerics->format(1234.5678, 2); // "1 234,56" $numerics->format(1234, 2); // "1 234,00" $numerics->format(1234.5678, 0); // "1 234" $numerics->format(1234, -2); // "1 200" $numerics->setLocale('en_US'); $numerics->format(1234.5678, 2); // "1,234.56" $numerics->format(1234, 2); // "1,234.00" $numerics->format(1234.5678, 0); // "1,234" $numerics->format(1234, -2); // "1,200"
使用多个小数的格式化
$big = 0.123456789123456789; $numerics->format($big); // "0.123457" - same as below $numerics->format($big, $numerics->precision($big)); // "0.123457" - php decimal precision $numerics->format($big, $numerics->precision($big, true)); // "0.123456789123457" - without precision loss $numerics->format($big, 50); // "0.12345678912345678379658409085095627233386039733887" - with precision loss
随机数方法
具有精确度的浮点随机数。精度也可以为负。如果无法生成结果,则返回 float
或 null
。
// Precison specified on each call $numerics = new Numerics(); $numerics->rand(0, 10); // 0.0 … 10.0 $numerics->rand(0, 100, 2); // 0.00 … 100.00 $numerics->rand(-100, 100, 4); // -100.0000 … 100.0000 $numerics->rand(0.01, 0.97, 4); // 0.0100 … 0.9700 $numerics->rand(9, 11, -1); // 10.0 $numerics->rand(90, 110, -2); // 100.0 // Precison specified as default, override is possible $numerics = new Numerics(2); $numerics->rand(0, 100); // 0.00 … 100.00
精度方法
计算数字中相关小数点的数量。默认返回可序列化的小数点数量(根据 PHP 评估)。
$numerics = new Numerics(); $numerics->precision(12); // 0 $numerics->precision(12.0); // 0 $numerics->precision(12.34); // 2 $numerics->precision(0.123456789123456789); // 6
通过设置 wide
选项,返回在不损失精度的情况下可用的十进制数数量。
$numerics = new Numerics(); $numerics->precision(0.123456789123456789, true); // 15
setLocale 方法
影响 format()
方法和 parse()
方法中的边缘情况。如果没有设置,则在这些方法中使用当前地区。
$numerics = new Numerics(); $numerics->setLocale('sv_SE'); // Set to Swedish