From ac406916194d5cb33963a5a24ec87f255a422439 Mon Sep 17 00:00:00 2001 From: demn98 <79911094+demn98@users.noreply.github.com> Date: Thu, 24 Oct 2024 18:16:03 +0300 Subject: [PATCH] Update helpers.md --- helpers.md | 133 ++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 132 insertions(+), 1 deletion(-) diff --git a/helpers.md b/helpers.md index 5d3ec736..3d594ccc 100644 --- a/helpers.md +++ b/helpers.md @@ -1,5 +1,5 @@ --- -git: bb4650831ec4567c07d72f7a9949a95f90c04035 +git: 8f1a3d074d960178fc00bc91760324336e898822 --- # Глобальные помощники (helpers) @@ -75,6 +75,8 @@ Laravel содержит множество глобальных «вспомо - [Number::abbreviate](#method-number-abbreviate) - [Number::clamp](#method-number-clamp) - [Number::currency](#method-number-currency) +- [Number::defaultCurrency](#method-default-currency) +- [Number::defaultLocale](#method-default-locale) - [Number::fileSize](#method-number-file-size) - [Number::forHumans](#method-number-for-humans) - [Number::format](#method-number-format) @@ -85,6 +87,8 @@ Laravel содержит множество глобальных «вспомо - [Number::trim](#method-number-trim) - [Number::useLocale](#method-number-use-locale) - [Number::withLocale](#method-number-with-locale) +- [Number::useCurrency](#method-number-use-currency) +- [Number::withCurrency](#method-number-with-currency) @@ -181,6 +185,7 @@ Laravel содержит множество глобальных «вспомо - [value](#method-value) - [view](#method-view) - [with](#method-with) +- [when](#method-when) @@ -1213,6 +1218,28 @@ $classes = Arr::toCssStyles($array); // 1.000,00 € + +#### `Number::defaultCurrency()` + +Метод `Number::defaultCurrency` возвращает валюту по умолчанию, используемую классом `Number`: + + use Illuminate\Support\Number; + + $currency = Number::defaultCurrency(); + + // USD + + +#### `Number::defaultLocale()` + +Метод `Number::defaultLocale` возвращает локаль по умолчанию, используемую классом `Number`: + + use Illuminate\Support\Number; + + $locale = Number::defaultLocale(); + + // en + #### `Number::fileSize()` @@ -1409,6 +1436,32 @@ $result = Number::pairs(25, 10, offset: 0); return Number::format(1500); }); + +#### `Number::useCurrency()` + +Метод `Number::useCurrency` устанавливает глобальную числовую валюту по умолчанию, что влияет на форматирование валюты при последующих вызовах методов класса `Number`: + + use Illuminate\Support\Number; + + /** + * Bootstrap any application services. + */ + public function boot(): void + { + Number::useCurrency('GBP'); + } + + +#### `Number::withCurrency()` + +Метод `Number::withCurrency` выполняет данное замыкание, используя указанную валюту, а затем восстанавливает исходную валюту после выполнения обратного вызова: + + use Illuminate\Support\Number; + + $number = Number::withCurrency('GBP', function () { + // ... + }); + ## Пути @@ -2291,6 +2344,23 @@ $secondService->all(); // (cached result) // 5 + +#### `when()` + +Функция `when` возвращает заданное ей значение, если заданное условие имеет значение `true`. В противном случае возвращается `null`. Если замыкание передается в качестве второго аргумента функции, замыкание будет выполнено и будет возвращено его возвращаемое значение: + + $value = when(true, 'Hello World'); + + $value = when(true, fn () => 'Hello World'); + +Функция `when` в первую очередь полезна для условного рендеринга атрибутов HTML: + +```blade +