Jak používat
- Vložte objekt JSON nebo vyzkoušejte příklad.
- Zapněte možnost Vynechat hodnoty null, pokud váš JSON obsahuje hodnoty null, které nepotřebujete.
- Zkopírujte TOML nebo si ho stáhněte jako soubor .toml.
Jak to funguje
JSON je striktně parsován a poté zapsán jako TOML 1.0 pomocí open-source knihovny smol-toml. Vnořené objekty se změní na [tables], pole objektů na [[arrays of tables]] a klíče, které nejsou běžnými slovy, jsou uzavřeny do uvozovek.
TOML nedokáže vyjádřit vše, co JSON dokáže. Kořen dokumentu musí být tabulka, takže pole JSON nebo jediná hodnota jsou odmítnuty. V TOML neexistuje null: ve výchozím nastavení je první výskyt null nahlášen i s cestou; místo toho můžete zvolit vynechání členů objektu s hodnotou null. Hodnota null uvnitř pole je vždy chyba, protože její odstranění by změnilo pozice ostatních prvků. Pole, která mísí typy (například čísla a řetězce), jsou platná v TOML 1.0, ale ne ve starší verzi 0.5, proto se uvádějí v poznámce.
JSON nerozlišuje 1 od 1.0, takže celá čísla se zapisují jako celá čísla TOML. Řetězce, které vypadají jako data, zůstávají řetězci. Opačný směr je TOML na JSON.
Příklady
Nastavení aplikace
{"server": {"host": "0.0.0.0", "port": 8080}} se změní na tabulku [server] s klíči host a port.
Seznam workerů
"workers": [{"queue": "mail"}, {"queue": "images"}] se změní na dva bloky [[workers]].
Časté dotazy
Proč není hodnota null povolena?
TOML nemá hodnotu null. Klíč vynechejte, nebo použijte hodnotu, jako je prázdný řetězec, podle toho, co očekává program, který data čte.
Proč pole s čísly a řetězci zobrazuje poznámku?
Pole s míšenými typy jsou povolena od TOML 1.0, ale nástroje implementující TOML 0.5 je odmítají. Poznámka pomůže, pokud je váš cílový nástroj starší.
Zůstane 1.0 desetinným číslem?
Ne. JSON ukládá 1.0 a 1 jako stejné číslo, takže se stane celým číslem 1. Pokud program, který data čte, potřebuje desetinné číslo, napište 1.5 nebo upravte TOML.
Soukromí
Převod probíhá zcela ve vašem prohlížeči. Vaše JSON a TOML se nenahrávají ani neukládají.