/
helpers.texy
87 lines (56 loc) 路 2.46 KB
/
helpers.texy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
Func葲ii auxiliare
*****************
.[perex]
[api:Nette\Utils\Helpers] este o clas膬 static膬 cu func葲ii utile.
Instalare:
```shell
composer require nette/utils
```
Toate exemplele presupun c膬 este definit urm膬torul alias de clas膬:
```php
use Nette\Utils\Helpers;
```
capture(callable $cb): string .[method]
---------------------------------------
Execut膬 un callback 葯i returneaz膬 ie葯irea capturat膬 sub forma unui 葯ir de caractere.
```php
$res = Helpers::capture(function () use ($template) {
$template->render();
});
```
clamp(int|float $value, int|float $min, int|float $max): int|float .[method]
----------------------------------------------------------------------------
Returneaz膬 valoarea fixat膬 卯n intervalul inclusiv dintre min 葯i max.
```php
Helpers::clamp($level, 0, 255);
```
compare(mixed $left, string $operator, mixed $right): bool .[method]
--------------------------------------------------------------------
Compar膬 dou膬 valori 卯n acela葯i mod 卯n care o face PHP. Distinge 卯ntre operatorii `>`, `>=`, `<`, `<=`, `=`, `==`, , `===`, `!=`, `!==`, `<>`.
Func葲ia este util膬 卯n situa葲iile 卯n care operatorul este variabil.
```php
Helpers::compare(10, '<', 20); // true
```
falseToNull(mixed $value): mixed .[method]
------------------------------------------
Converte葯te `false` 卯n `null`, nu modific膬 alte valori.
```php
Helpers::falseToNull(false); // null
Helpers::falseToNull(123); // 123
```
getLastError(): string .[method]
--------------------------------
Returneaz膬 ultima eroare PHP ap膬rut膬 sau un 葯ir de caractere gol dac膬 nu s-a produs nicio eroare. Spre deosebire de `error_get_last()`, nu este afectat de directiva PHP `html_errors` 葯i returneaz膬 卯ntotdeauna text, nu HTML.
```php
Helpers::getLastError();
```
getSuggestion(string[] $possibilities, string $value): ?string .[method]
------------------------------------------------------------------------
Caut膬 un 葯ir de caractere din `$possibilities` care este cel mai asem膬n膬tor cu `$value`, dar nu acela葯i. Suport膬 numai codific膬ri pe 8 bi葲i.
Este util膬 dac膬 o anumit膬 op葲iune nu este valid膬 葯i dorim s膬 suger膬m utilizatorului una similar膬 (dar diferit膬, deci acela葯i 葯ir este ignorat). 脦n acest fel, Nette creeaz膬 mesajele `did you mean ...?`.
```php
$items = ['foo', 'bar', 'baz'];
Helpers::getSuggestion($items, 'fo'); // 'foo'
Helpers::getSuggestion($items, 'barr'); // 'bar'
Helpers::getSuggestion($items, 'baz'); // 'bar', ne 'baz'
```