ヘルパー関数

Nette\Utils\Helpersは、便利な関数を含む静的クラスです。

インストール:

composer require nette/utils

すべての例では、エイリアスが作成されていることを前提としています。

use Nette\Utils\Helpers;

capture (callable $cb): string

コールバックを実行し、キャプチャされた出力を文字列として返します。

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

clamp (int|float $value, int|float $min, int|float $max): int|float

値を指定された包括的な範囲minとmaxに制限します。

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

compare (mixed $left, string $operator, mixed $right): bool

PHPが行うのと同じ方法で2つの値を比較します。演算子>、>=、<、<=、=、==、===、!=、!==、<>を区別します。 この関数は、演算子が変数である場合に便利です。

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

falseToNull (mixed $value): mixed

falseをnullに変換し、他の値は変更しません。

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

getLastError(): string

PHPの最後のエラーを返すか、エラーが発生しなかった場合は空の文字列を返します。error_get_last()とは異なり、PHPディレクティブhtml_errorsの影響を受けず、常にテキストを返し、HTMLは返しません。

Helpers::getLastError();

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

提供されたオプション$possibilitiesから、$valueに最も似ているが同じではない文字列を検索します。8ビットエンコーディングのみをサポートします。

特定のオプションが無効であり、ユーザーに類似した（ただし異なる、したがって同じ文字列は無視される）オプションを提案したい場合に便利です。このようにして、Netteはdid you mean ...?メッセージを作成します。

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