Βοηθητικές συναρτήσεις

Η Nette\Utils\Helpers είναι μια στατική κλάση με χρήσιμες συναρτήσεις.

Εγκατάσταση:

composer require nette/utils

Όλα τα παραδείγματα προϋποθέτουν τη δημιουργία ενός ψευδώνυμου:

use Nette\Utils\Helpers;

capture (callable $cb): string

Εκτελεί το callback και επιστρέφει την παγιδευμένη έξοδο ως 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. Διακρίνει τους τελεστές >, >=, <, <=, =, ==, ===, !=, !==, <>. Η συνάρτηση είναι χρήσιμη σε καταστάσεις όπου ο τελεστής είναι μεταβλητός.

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

falseToNull (mixed $value): mixed

Μετατρέπει το false σε null, δεν αλλάζει άλλες τιμές.

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

getLastError(): string

Επιστρέφει το τελευταίο σφάλμα στην PHP ή ένα κενό string αν δεν προέκυψε κανένα σφάλμα. Σε αντίθεση με το error_get_last(), δεν επηρεάζεται από την οδηγία PHP html_errors και επιστρέφει πάντα κείμενο, όχι HTML.

Helpers::getLastError();

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

Από τις προσφερόμενες επιλογές $possibilities, αναζητά το string που είναι το πιο παρόμοιο με το $value, αλλά όχι το ίδιο. Υποστηρίζει μόνο κωδικοποίηση 8-bit.

Είναι χρήσιμο σε περίπτωση που μια συγκεκριμένη επιλογή δεν είναι έγκυρη και θέλουμε να συμβουλεύσουμε τον χρήστη για μια παρόμοια (αλλά διαφορετική, γι' αυτό αγνοείται το ίδιο string). Με αυτόν τον τρόπο η Nette δημιουργεί τα μηνύματα “μήπως εννοούσατε …?”;

$items = ['foo', 'bar', 'baz'];
Helpers::getSuggestion($items, 'fo');   // 'foo'
Helpers::getSuggestion($items, 'barr'); // 'bar'
Helpers::getSuggestion($items, 'baz');  // 'bar', ne 'baz' - 'bar', όχι 'baz'