Práce s callbacky
*****************
.[perex]
[api:Nette\Utils\Callback] je statická třída s funkcemi pro práci s [PHP callbacky |https://www.php.net/manual/en/language.types.callable.php].
Instalace:
```shell
composer require nette/utils
```
Všechny příklady předpokládají vytvořený alias:
```php
use Nette\Utils\Callback;
```
check($callable, bool $syntax=false): callable .[method]
--------------------------------------------------------
Zkontroluje, zda proměnná `$callable` je platný callback. Jinak vyhodí `Nette\InvalidArgumentException`. Pokud `$syntax` je true, funkce jen ověří, že `$callable` má strukturu callbacku, ale neověřuje, zda daná třída nebo metoda skutečně existuje. Vrací `$callable`.
```php
Callback::check('trim'); // nevyhodí výjimku
Callback::check(['NonExistentClass', 'method']); // vyhodí Nette\InvalidArgumentException
Callback::check(['NonExistentClass', 'method'], true); // nevyhodí výjimku
Callback::check(function () {}); // nevyhodí výjimku
Callback::check(null); // vyhodí Nette\InvalidArgumentException
```
toString($callable): string .[method]
-------------------------------------
Převede PHP callback do textové formy. Třída nebo metoda nemusí existovat.
```php
Callback::toString('trim'); // 'trim'
Callback::toString(['MyClass', 'method']); // 'MyClass::method'
```
toReflection($callable): ReflectionMethod|ReflectionFunction .[method]
----------------------------------------------------------------------
Vrací reflexi pro metodu nebo funkci v PHP callbacku.
```php
$ref = Callback::toReflection('trim');
// $ref je ReflectionFunction('trim')
$ref = Callback::toReflection(['MyClass', 'method']);
// $ref je ReflectionMethod('MyClass', 'method')
```
isStatic($callable): bool .[method]
-----------------------------------
Zjišťuje, zda je PHP callback funkcí nebo statickou metodou.
```php
Callback::isStatic('trim'); // true
Callback::isStatic(['MyClass', 'method']); // true
Callback::isStatic([$obj, 'method']); // false
Callback::isStatic(function () {}); // false
```
unwrap(Closure $closure): callable|array .[method]
--------------------------------------------------
Zpětně rozbalí Closure vytvořenou pomocí `Closure::fromCallable`:https://www.php.net/manual/en/closure.fromcallable.php.
```php
$closure = Closure::fromCallable(['MyClass', 'method']);
Callback::unwrap($closure); // ['MyClass', 'method']
```
closure($callable): Closure .[method deprecated]
------------------------------------------------
(nebo `closure($classOrObject, $method): Closure`)
Převede PHP callback na objekt "Closure":https://www.php.net/manual/en/class.closure.php.
```php
$trimmer = Callback::closure('trim');
$trimmer(' hello '); // 'hello'
```
.[note]
Od PHP 7.1 používejte nativní `Closure::fromCallable`:https://www.php.net/manual/en/closure.fromcallable.php.
invoke($callable, ...$args): mixed .[method deprecated]
-------------------------------------------------------
Zavolá `$callable` a předá mu následující parametery jako argumenty a vrátí jím vrácenou hodnotu..
Pokud není callback platný, vyhodí `Nette\InvalidArgumentException`, na rozdíl od `call_user_func`, který jen vygeneruje varování.
```php
$callback = 'trim';
Callback::invoke($callback, ' hello '); // 'hello'
```
.[note]
Od PHP 7.0 používejte nativní `$callback($arg, ...)`.
invokeArgs($callable, array $args = []): mixed .[method deprecated]
-------------------------------------------------------------------
Zavolá `$callable` s argumenty `$args` a vrátí jím vrácenou hodnotu..
Pokud není callback platný, vyhodí `Nette\InvalidArgumentException`, na rozdíl od `call_user_func`, který jen vygeneruje varování.
```php
$callback = 'trim';
Callback::invoke($callback, [' hello ']); // 'hello'
```
.[note]
Od PHP 7.0 používejte nativní `$callback(...$args)`.
{{maintitle: Callbacky v PHP s Nette Utils: kontrola a převod}}
{{description: Práce s PHP callbacky: ověření platnosti, převod na řetězec nebo reflexi a rozbalení closure pomocí statické třídy Callback.}}
Práce s callbacky
Nette\Utils\Callback je statická
třída s funkcemi pro práci s PHP callbacky.
Instalace:
composer require nette/utils
Všechny příklady předpokládají vytvořený alias:
use Nette\Utils\Callback;
check ($callable, bool $syntax=false): callable
Zkontroluje, zda proměnná $callable je platný callback. Jinak vyhodí
Nette\InvalidArgumentException. Pokud $syntax je true, funkce jen ověří, že $callable
má strukturu callbacku, ale neověřuje, zda daná třída nebo metoda skutečně existuje. Vrací $callable.
Callback::check('trim'); // nevyhodí výjimku
Callback::check(['NonExistentClass', 'method']); // vyhodí Nette\InvalidArgumentException
Callback::check(['NonExistentClass', 'method'], true); // nevyhodí výjimku
Callback::check(function () {}); // nevyhodí výjimku
Callback::check(null); // vyhodí Nette\InvalidArgumentException
toString ($callable):
string
Převede PHP callback do textové formy. Třída nebo metoda nemusí existovat.
Callback::toString('trim'); // 'trim'
Callback::toString(['MyClass', 'method']); // 'MyClass::method'
toReflection ($callable): ReflectionMethod|ReflectionFunction
Vrací reflexi pro metodu nebo funkci v PHP callbacku.
$ref = Callback::toReflection('trim');
// $ref je ReflectionFunction('trim')
$ref = Callback::toReflection(['MyClass', 'method']);
// $ref je ReflectionMethod('MyClass', 'method')
isStatic ($callable):
bool
Zjišťuje, zda je PHP callback funkcí nebo statickou metodou.
Callback::isStatic('trim'); // true
Callback::isStatic(['MyClass', 'method']); // true
Callback::isStatic([$obj, 'method']); // false
Callback::isStatic(function () {}); // false
unwrap (Closure $closure): callable|array
Zpětně rozbalí Closure vytvořenou pomocí Closure::fromCallable.
$closure = Closure::fromCallable(['MyClass', 'method']);
Callback::unwrap($closure); // ['MyClass', 'method']
closure ($callable): Closure
(nebo closure($classOrObject, $method): Closure)
Převede PHP callback na objekt Closure.
$trimmer = Callback::closure('trim');
$trimmer(' hello '); // 'hello'
Od PHP 7.1 používejte nativní Closure::fromCallable.
invoke ($callable, …$args): mixed
Zavolá $callable a předá mu následující parametery jako argumenty a vrátí jím vrácenou hodnotu..
Pokud není callback platný, vyhodí Nette\InvalidArgumentException, na rozdíl od call_user_func,
který jen vygeneruje varování.
$callback = 'trim';
Callback::invoke($callback, ' hello '); // 'hello'
Od PHP 7.0 používejte nativní $callback($arg, ...).
invokeArgs ($callable, array $args
= []): mixed
Zavolá $callable s argumenty $args a vrátí jím vrácenou hodnotu..
Pokud není callback platný, vyhodí Nette\InvalidArgumentException, na rozdíl od call_user_func,
který jen vygeneruje varování.
$callback = 'trim';
Callback::invoke($callback, [' hello ']); // 'hello'
Od PHP 7.0 používejte nativní $callback(...$args).