[12.x] Add locale-aware number parsing methods to Number class

[informagenie]

Add locale-aware number parsing methods

This PR adds three new methods to the Number class to complement the existing number formatting capabilities:

• Number::parse(string $string, ?int $type = NumberFormatter::TYPE_DOUBLE, ?string $locale = null): Parses a localized number string into its numeric value
• Number::parseInt(string $string, ?string $locale = null): Specifically parses a string into an integer with locale support
• Number::parseFloat(string $string, ?string $locale = null): Specifically parses a string into a float with locale support

Usage

Currently, I need to create something like

App\Helpers\NumberFormatter::parse($request->input('amount'))

or using directly

(new NumberFormatter(config('app.locale'), NumberFormatter::DECIMAL)) ->parse($request->input('number'));

to parse string generated by Number::format().

For eg:

$number = 12345.67;
$string = Number::format($number, locale: 'en'); //12,345.67
$string = Number::format($number, locale: 'de'); //12.345,67
$string = Number::format($number, locale: 'fr'); //12 345,67

$float = App\Helpers\NumberFormatter::parse($request->input($string));

Why should the key to start a car engine be different from the key to turn the engine off ?

Why not this ?

$number = 12345.67;
$string = Number::format($number, locale: 'en'); //12,345.67
$string = Number::format($number, locale: 'de'); //12.345,67
$string = Number::format($number, locale: 'fr'); //12 345,67

$float = Number::parse($request->input($string));

[github-actions]

Thanks for submitting a PR!

Note that draft PR's are not reviewed. If you would like a review, please mark your pull request as ready for review in the GitHub user interface.

Pull requests that are abandoned in draft may be closed due to inactivity.

[shaedrich]

• ?int $type = NumberFormatter::TYPE_DOUBLE
• Number::parseInt
• Number::parseFloat

Why would you need that? If you need to cut off the decimal places, this should be ideally done in a two-step operation by first parsing it and then passing it to round() or the like

[informagenie]

Why would you need that? If you need to cut off the decimal places, this should be ideally done in a two-step operation by first parsing it and then passing it to round() or the like

🤔...

Honestly, for just straightforward code.

Do you think just Number::parse(string $string, ?string $locale = null) will be enough ?

[shaedrich]

Do you think just Number::parse(string $string, ?string $locale = null) will be enough ?

Yep 👍🏻