Funkcije NEON
*************

<div class=perex>

NEON je človeku prijazen jezik za serializacijo podatkov. V Nette se uporablja za konfiguracijske datoteke. [api:Nette\Neon\Neon] je statični razred za delo z NEON.

Spoznajte [format NEON |format] in [ga preizkusite|https://ne-on.org].

</div>

Naslednji primeri uporabljajo te vzdevke:

```php
use Nette\Neon\Neon;
```


. .[#toc-installation]
----------------------

Prenesite in namestite paket s [programom Composer |best-practices:composer]:

```shell
composer require nette/neon
```

S konzolnim ukazom `neon-lint` lahko preverite, ali so v datotekah `*.neon` skladenjske napake:

```shell
vendor/bin/neon-lint <path>
```


encode(mixed $value, bool $blockMode=false, string $indentation="\t"): string .[method]
---------------------------------------------------------------------------------------

Vrne `$value`, pretvorjeno v NEON. Kot parameter `$blockMode` lahko posredujete true, kar bo ustvarilo večvrstični izpis. Parameter `$indentation` določa znake, ki se uporabljajo za odtiskovanje (privzeto je tabulator).

```php
Neon::encode($value); // Vrne $vrednost pretvorjeno v NEON
Neon::encode($value, true); // Vrača $vrednost, pretvorjeno v večvrstični NEON
```

Metoda `encode()` ob napaki vrže `Nette\Neon\Exception`.

```php
try {
	$neon = Neon::encode($value);
} catch (Nette\Neon\Exception $e) {
	// Ravnanje z izjemami
}
```


decode(string $neon): mixed .[method]
-------------------------------------

Pretvori podano vrednost NEON v vrednost PHP.

Vrne skalarje, polja, [datum |format#dates] kot objekte DateTimeImmutable in [entitete |format#Entities] kot objekte [api:Nette\Neon\Entity].

```php
Neon::decode('hello: world'); // Vrne polje ['hello' => 'world']
```

Metoda `decode()` ob napaki vrže `Nette\Neon\Exception`.

```php
try {
	$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
	// Ravnanje z izjemami
}
```


decodeFile(string $file): mixed .[method]
-----------------------------------------

Pretvori vsebino datoteke iz NEON v PHP in odstrani vse BOM.

```php
Neon::decodeFile('config.neon');
```

Metoda `decodeFile()` ob napaki vrže `Nette\Neon\Exception`.


{{leftbar: utils:@left-menu}}