Callback Fonksiyonları
**********************

.[perex]
[api:Nette\Utils\Callback], [PHP callback'leriyle |https://www.php.net/manual/en/language.types.callable.php] çalışmaya yarayan fonksiyonlar içeren statik bir sınıftır.


Kurulum:

```shell
composer require nette/utils
```

Tüm örnekler, aşağıdaki sınıf takma adının tanımlandığını varsayar:

```php
use Nette\Utils\Callback;
```


check($callable, bool $syntax=false): callable .[method]
--------------------------------------------------------

`$callable` değerinin geçerli bir PHP callback'i olup olmadığını denetler. Değilse `Nette\InvalidArgumentException` fırlatır. `$syntax` değeri `true` ise fonksiyon yalnızca `$callable`'ın geçerli bir callback yapısına sahip olduğunu doğrular, sınıfın veya metodun gerçekten var olup olmadığını denetlemez. Özgün `$callable` değerini döndürür.

```php
Callback::check('trim'); // istisna yok
Callback::check(['NonExistentClass', 'method']); // Nette\InvalidArgumentException fırlatır
Callback::check(['NonExistentClass', 'method'], true); // istisna yok
Callback::check(function () {}); // istisna yok
Callback::check(null); // Nette\InvalidArgumentException fırlatır
```


toString(callable $callable): string .[method]
----------------------------------------------

Bir PHP callback'ini metinsel temsiline dönüştürür. Sınıfın veya metodun var olması gerekmez.

```php
Callback::toString('trim');                // 'trim'
Callback::toString(['MyClass', 'method']); // 'MyClass::method'
```


toReflection(callable $callable): \ReflectionMethod|\ReflectionFunction .[method]
---------------------------------------------------------------------------------

PHP callback'inde kullanılan metot veya fonksiyon için bir reflection döndürür. Başvurulan metot ya da fonksiyon yoksa `\ReflectionException` fırlatır.

```php
$ref = Callback::toReflection('trim');
// $ref, ReflectionFunction('trim') nesnesidir

$ref = Callback::toReflection(['MyClass', 'method']);
// $ref, ReflectionMethod('MyClass', 'method') nesnesidir
```


isStatic(callable $callable): bool .[method]
--------------------------------------------

PHP callback'inin genel bir fonksiyon mu yoksa statik bir metot mu olduğunu denetler.

```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]
---------------------------------------------------

`Closure::fromCallable()` ile oluşturulmuş bir closure'ın sargısını açar. Özgün callable diziyi veya dizeyi döndürür.

```php
$closure = Closure::fromCallable(['MyClass', 'method']);
Callback::unwrap($closure);     // ['MyClass', 'method']
```


invokeSafe(string $function, array $args, callable $onError): mixed .[method]
-----------------------------------------------------------------------------

Yerleşik PHP fonksiyonu `$function`'ı `$args` argümanlarıyla çağırır ve bu sırada ürettiği uyarı ya da hataları kendi işleyicisiyle yakalar. Böylece yerleşik fonksiyonların normalde yalnızca uyarı olarak bildirdiği sorunlara tepki verebilirsiniz. `$onError` callback'i iki argüman alır: hata mesajı (baştaki `function():` öneki kaldırılmış olarak) ve hatanın önem derecesi. `false` döndürürse hata standart hata işleyicisine aktarılır.

```php
$result = Callback::invokeSafe('file_get_contents', ['file.txt'], function (string $message, int $severity) {
	throw new Exception($message);
});
```