pronamic / wp-number
WordPress Number library.
Installs: 79 716
Dependents: 7
Suggesters: 0
Security: 0
Stars: 4
Watchers: 5
Forks: 0
Open Issues: 0
Type:wordpress-plugin
Requires
- php: >=7.4
Requires (Dev)
- bamarni/composer-bin-plugin: ^1.4
- koodimonni-language/de_de: *
- koodimonni-language/fr_fr: *
- koodimonni-language/nl_nl: *
- overtrue/phplint: ^4.5
- php-coveralls/php-coveralls: ^2.5
- phpmd/phpmd: ^2.13
- phpstan/phpstan: ^1.11
- pronamic/pronamic-cli: ^1.1
- pronamic/wp-coding-standards: ^2.2
- roots/wordpress: ^6.0
- szepeviktor/phpstan-wordpress: ^1.3
- vimeo/psalm: ^5.24
- wp-phpunit/wp-phpunit: ^6.1
- yoast/phpunit-polyfills: ^1.0
README
WordPress Number library.
Table of contents
Getting Started
Installation
composer require pronamic/wp-number
Usage
$number = Number::from_float( 123.50 )->add( 0.45 );
echo \esc_html( $number->format_i18n( 2 ) );
Design Principles
A number is a number
In general, a number is a number, not a string, and this means that any programming language treats a number as a number. Thus, the number by itself doesn't imply any specific format (like using .000021 instead of 2.1e-5). This is nothing different to displaying a number with leading zeros (like 0.000021) or aligning lists of numbers. This is a general issue you'll find in any programming language: if you want a specific format you need to specify it, using the format functions of your programming language.
Unless you specify the number as string and convert it to a real number when needed, of course. Some languages can do this implicitly.
https://stackoverflow.com/a/1471792
Number in exponential form / scientific notation
2.1E-5 is the same number as 0.000021. That's how it prints numbers below 0.001. Use printf() if you want it in a particular format.
Edit If you're not familiar with the
2.1E-5
syntax, you should know it is shorthand for 2.1×10-5. It is how most programming languages represent numbers in scientific notation.
https://stackoverflow.com/a/1471694
Leading zeros
In https://github.com/moneyphp/money it is not allowed to use leading zeros:
Leading zeros are not allowed
Source: https://github.com/moneyphp/money/search?q=leading+zero
This probably has somehting to do with the following user note:
Be careful with GMP - it considers leading zeros in a number string as meaning the number is in octal, whereas 'bc' doesn't:
gmp_strval("000100", 10) => 64
bcmul("000100", "1") => 100
Source: https://www.php.net/manual/en/book.gmp.php#106521
<?php $a = 1234; // decimal number $a = 0123; // octal number (equivalent to 83 decimal) $a = 0x1A; // hexadecimal number (equivalent to 26 decimal) $a = 0b11111111; // binary number (equivalent to 255 decimal) $a = 1_234_567; // decimal number (as of PHP 7.4.0) ?>
Source: https://www.php.net/manual/en/language.types.integer.php
A leading zero in a numeric literal means "this is octal". But don't be confused: a leading zero in a string does not. Thus:
$x = 0123; // 83
$y = "0123" + 0 // 123
Source: https://www.php.net/manual/en/language.types.integer.php#111523