Explorer

home / zoteqbgb / public_html / vendor / laravel / framework / src / Illuminate / Support

Location: /home/zoteqbgb/public_html/vendor/laravel/framework/src/Illuminate/Support
Root path: /home/zoteqbgb/public_html/config/676626

Editing: Number.php

<?php

namespace Illuminate\Support;

use Illuminate\Support\Traits\Macroable;
use NumberFormatter;
use RuntimeException;

class Number
{
    use Macroable;

/**
     * The current default locale.
     *
     * @var string
     */
    protected static $locale = 'en';

/**
     * Format the given number according to the current locale.
     *
     * @param  int|float  $number
     * @param  int|null  $precision
     * @param  int|null  $maxPrecision
     * @param  string|null  $locale
     * @return string|false
     */
    public static function format(int|float $number, ?int $precision = null, ?int $maxPrecision = null, ?string $locale = null)
    {
        static::ensureIntlExtensionIsInstalled();

$formatter = new NumberFormatter($locale ?? static::$locale, NumberFormatter::DECIMAL);

if (! is_null($maxPrecision)) {
            $formatter->setAttribute(NumberFormatter::MAX_FRACTION_DIGITS, $maxPrecision);
        } elseif (! is_null($precision)) {
            $formatter->setAttribute(NumberFormatter::FRACTION_DIGITS, $precision);
        }

return $formatter->format($number);
    }

/**
     * Spell out the given number in the given locale.
     *
     * @param  int|float  $number
     * @param  string|null  $locale
     * @param  int|null  $after
     * @param  int|null  $until
     * @return string
     */
    public static function spell(int|float $number, ?string $locale = null, ?int $after = null, ?int $until = null)
    {
        static::ensureIntlExtensionIsInstalled();

if (! is_null($after) && $number <= $after) {
            return static::format($number, locale: $locale);
        }

if (! is_null($until) && $number >= $until) {
            return static::format($number, locale: $locale);
        }

$formatter = new NumberFormatter($locale ?? static::$locale, NumberFormatter::SPELLOUT);

return $formatter->format($number);
    }

/**
     * Convert the given number to ordinal form.
     *
     * @param  int|float  $number
     * @param  string|null  $locale
     * @return string
     */
    public static function ordinal(int|float $number, ?string $locale = null)
    {
        static::ensureIntlExtensionIsInstalled();

$formatter = new NumberFormatter($locale ?? static::$locale, NumberFormatter::ORDINAL);

return $formatter->format($number);
    }

/**
     * Convert the given number to its percentage equivalent.
     *
     * @param  int|float  $number
     * @param  int  $precision
     * @param  int|null  $maxPrecision
     * @param  string|null  $locale
     * @return string|false
     */
    public static function percentage(int|float $number, int $precision = 0, ?int $maxPrecision = null, ?string $locale = null)
    {
        static::ensureIntlExtensionIsInstalled();

$formatter = new NumberFormatter($locale ?? static::$locale, NumberFormatter::PERCENT);

if (! is_null($maxPrecision)) {
            $formatter->setAttribute(NumberFormatter::MAX_FRACTION_DIGITS, $maxPrecision);
        } else {
            $formatter->setAttribute(NumberFormatter::FRACTION_DIGITS, $precision);
        }

return $formatter->format($number / 100);
    }

/**
     * Convert the given number to its currency equivalent.
     *
     * @param  int|float  $number
     * @param  string  $in
     * @param  string|null  $locale
     * @return string|false
     */
    public static function currency(int|float $number, string $in = 'USD', ?string $locale = null)
    {
        static::ensureIntlExtensionIsInstalled();

$formatter = new NumberFormatter($locale ?? static::$locale, NumberFormatter::CURRENCY);

return $formatter->formatCurrency($number, $in);
    }

/**
     * Convert the given number to its file size equivalent.
     *
     * @param  int|float  $bytes
     * @param  int  $precision
     * @param  int|null  $maxPrecision
     * @return string
     */
    public static function fileSize(int|float $bytes, int $precision = 0, ?int $maxPrecision = null)
    {
        $units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];

for ($i = 0; ($bytes / 1024) > 0.9 && ($i < count($units) - 1); $i++) {
            $bytes /= 1024;
        }

return sprintf('%s %s', static::format($bytes, $precision, $maxPrecision), $units[$i]);
    }

/**
     * Convert the number to its human-readable equivalent.
     *
     * @param  int|float  $number
     * @param  int  $precision
     * @param  int|null  $maxPrecision
     * @return bool|string
     */
    public static function abbreviate(int|float $number, int $precision = 0, ?int $maxPrecision = null)
    {
        return static::forHumans($number, $precision, $maxPrecision, abbreviate: true);
    }

/**
     * Convert the number to its human-readable equivalent.
     *
     * @param  int|float  $number
     * @param  int  $precision
     * @param  int|null  $maxPrecision
     * @param  bool  $abbreviate
     * @return bool|string
     */
    public static function forHumans(int|float $number, int $precision = 0, ?int $maxPrecision = null, bool $abbreviate = false)
    {
        return static::summarize($number, $precision, $maxPrecision, $abbreviate ? [
            3 => 'K',
            6 => 'M',
            9 => 'B',
            12 => 'T',
            15 => 'Q',
        ] : [
            3 => ' thousand',
            6 => ' million',
            9 => ' billion',
            12 => ' trillion',
            15 => ' quadrillion',
        ]);
    }

/**
     * Convert the number to its human-readable equivalent.
     *
     * @param  int|float  $number
     * @param  int  $precision
     * @param  int|null  $maxPrecision
     * @param  array  $units
     * @return string|false
     */
    protected static function summarize(int|float $number, int $precision = 0, ?int $maxPrecision = null, array $units = [])
    {
        if (empty($units)) {
            $units = [
                3 => 'K',
                6 => 'M',
                9 => 'B',
                12 => 'T',
                15 => 'Q',
            ];
        }

switch (true) {
            case floatval($number) === 0.0:
                return $precision > 0 ? static::format(0, $precision, $maxPrecision) : '0';
            case $number < 0:
                return sprintf('-%s', static::summarize(abs($number), $precision, $maxPrecision, $units));
            case $number >= 1e15:
                return sprintf('%s'.end($units), static::summarize($number / 1e15, $precision, $maxPrecision, $units));
        }

$numberExponent = floor(log10($number));
        $displayExponent = $numberExponent - ($numberExponent % 3);
        $number /= pow(10, $displayExponent);

return trim(sprintf('%s%s', static::format($number, $precision, $maxPrecision), $units[$displayExponent] ?? ''));
    }

/**
     * Clamp the given number between the given minimum and maximum.
     *
     * @param  int|float  $number
     * @param  int|float  $min
     * @param  int|float  $max
     * @return int|float
     */
    public static function clamp(int|float $number, int|float $min, int|float $max)
    {
        return min(max($number, $min), $max);
    }

/**
     * Execute the given callback using the given locale.
     *
     * @param  string  $locale
     * @param  callable  $callback
     * @return mixed
     */
    public static function withLocale(string $locale, callable $callback)
    {
        $previousLocale = static::$locale;

static::useLocale($locale);

return tap($callback(), fn () => static::useLocale($previousLocale));
    }

/**
     * Set the default locale.
     *
     * @param  string  $locale
     * @return void
     */
    public static function useLocale(string $locale)
    {
        static::$locale = $locale;
    }

/**
     * Ensure the "intl" PHP extension is installed.
     *
     * @return void
     */
    protected static function ensureIntlExtensionIsInstalled()
    {
        if (! extension_loaded('intl')) {
            $method = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 2)[1]['function'];

throw new RuntimeException('The "intl" PHP extension is required to use the ['.$method.'] method.');
        }
    }
}

Directory Contents

Name	Size	Perms	Modified	Actions
AggregateServiceProvider.php	995 bytes	0644	2025-01-31 15:04	âï¸
Benchmark.php	1,974 bytes	0644	2025-01-31 15:04	âï¸
Carbon.php	1,282 bytes	0644	2025-01-31 15:04	âï¸
Composer.php	7,020 bytes	0644	2025-01-31 15:04	âï¸
ConfigurationUrlParser.php	4,355 bytes	0644	2025-01-31 15:04	âï¸
DateFactory.php	7,944 bytes	0644	2025-01-31 15:04	âï¸
DefaultProviders.php	3,141 bytes	0644	2025-01-31 15:04	âï¸
Env.php	3,030 bytes	0644	2025-01-31 15:04	âï¸
Exceptions	-	0755	2025-01-31 15:04
Facades	-	0755	2025-01-31 15:04
Fluent.php	4,241 bytes	0644	2025-01-31 15:04	âï¸
HigherOrderTapProxy.php	665 bytes	0644	2025-01-31 15:04	âï¸
HtmlString.php	1,057 bytes	0644	2025-01-31 15:04	âï¸
InteractsWithTime.php	1,588 bytes	0644	2025-01-31 15:04	âï¸
Js.php	3,523 bytes	0644	2025-01-31 15:04	âï¸
LICENSE.md	1,075 bytes	0644	2025-01-31 15:04	âï¸
Lottery.php	5,791 bytes	0644	2025-01-31 15:04	âï¸
Manager.php	4,530 bytes	0644	2025-01-31 15:04	âï¸
MessageBag.php	10,334 bytes	0644	2025-01-31 15:04	âï¸
MultipleInstanceManager.php	4,351 bytes	0644	2025-01-31 15:04	âï¸
NamespacedItemResolver.php	3,428 bytes	0644	2025-01-31 15:04	âï¸
Number.php	8,287 bytes	0644	2025-01-31 15:04	âï¸
Optional.php	2,700 bytes	0644	2025-01-31 15:04	âï¸
Pluralizer.php	2,908 bytes	0644	2025-01-31 15:04	âï¸
ProcessUtils.php	2,050 bytes	0644	2025-01-31 15:04	âï¸
Reflector.php	4,607 bytes	0644	2025-01-31 15:04	âï¸
ServiceProvider.php	11,251 bytes	0644	2025-01-31 15:04	âï¸
Sleep.php	10,810 bytes	0644	2025-01-31 15:04	âï¸
Str.php	53,815 bytes	0644	2025-01-31 15:04	âï¸
Stringable.php	34,165 bytes	0644	2025-01-31 15:04	âï¸
Testing	-	0755	2025-01-31 15:04
Timebox.php	1,663 bytes	0644	2025-01-31 15:04	âï¸
Traits	-	0755	2025-01-31 15:04
ValidatedInput.php	12,365 bytes	0644	2025-01-31 15:04	âï¸
ViewErrorBag.php	2,627 bytes	0644	2025-01-31 15:04	âï¸
composer.json	1,782 bytes	0644	2025-01-31 15:04	âï¸
helpers.php	10,852 bytes	0644	2025-01-31 15:04	âï¸