Hilfsfunktionen
***************

.[perex]
[api:Nette\Utils\Helpers] ist eine statische Klasse mit nützlichen Hilfsfunktionen.


Installation:

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

Alle Beispiele setzen voraus, dass der folgende Alias definiert wurde:

```php
use Nette\Utils\Helpers;
```


capture(callable $cb): string .[method]
---------------------------------------

Führt einen Callback `$cb` aus und gibt dessen erfasste Ausgabe als String zurück.

```php
$res = Helpers::capture(function () use ($template) {
	$template->render();
});
```


clamp(int|float $value, int|float $min, int|float $max): int|float .[method]
----------------------------------------------------------------------------

Schränkt einen Wert `$value` auf den angegebenen inklusiven Bereich zwischen `$min` und `$max` ein.

```php
Helpers::clamp($level, 0, 255);
```


compare(mixed $left, string $operator, mixed $right): bool .[method]
--------------------------------------------------------------------

Vergleicht zwei Werte (`$left`, `$right`) auf die gleiche Weise wie PHP, unter Verwendung des angegebenen `$operator`. Unterstützt die Operatoren `>`, `>=`, `<`, `<=`, `=`, `==`, `===`, `!=`, `!==`, `<>`. Die Methode ist nützlich in Situationen, in denen der Operator variabel ist.

```php
Helpers::compare(10, '<', 20); // true
```


falseToNull(mixed $value): mixed .[method]
------------------------------------------

Konvertiert `false` zu `null`, andere Werte bleiben unverändert.

```php
Helpers::falseToNull(false); // null
Helpers::falseToNull(123);   // 123
```


getLastError(): string .[method]
--------------------------------

Gibt den letzten PHP-Fehler als String zurück oder einen leeren String, wenn kein Fehler aufgetreten ist. Im Gegensatz zu `error_get_last()` wird das Ergebnis nicht von der PHP-Direktive `html_errors` beeinflusst und ist immer Text (kein HTML).

```php
Helpers::getLastError();
```


getSuggestion(string[] $possibilities, string $value): ?string .[method]
------------------------------------------------------------------------

Sucht in den `$possibilities` nach dem String, der `$value` am ähnlichsten, aber nicht identisch ist. Unterstützt nur 8-Bit-Kodierungen.

Dies ist nützlich, wenn eine angegebene Option ungültig ist und man dem Benutzer eine ähnliche vorschlagen möchte (aber eine *andere*, weshalb der identische String ignoriert wird). Auf diese Weise erstellt Nette die `Did you mean ...?`-Meldungen.

```php
$items = ['foo', 'bar', 'baz'];
Helpers::getSuggestion($items, 'fo');   // 'foo'
Helpers::getSuggestion($items, 'barr'); // 'bar'
Helpers::getSuggestion($items, 'baz');  // 'bar', nicht 'baz'
```