Használata
- Illessz be egy JSON-objektumot, vagy próbáld ki a példát.
- Kapcsold be a Null értékek kihagyása opciót, ha a JSON-od olyan null értékeket tartalmaz, amelyekre nincs szükséged.
- Másold ki a TOML-t, vagy töltsd le .toml fájlként.
Hogyan működik
A JSON-t szigorúan elemzi a rendszer, majd a nyílt forráskódú smol-toml könyvtár TOML 1.0 formátumban írja ki. A beágyazott objektumok [tables], az objektumtömbök [[arrays of tables]] lesznek, a nem egyszerű szavakból álló kulcsok pedig idézőjelbe kerülnek.
A TOML nem tud mindent kifejezni, amit a JSON. A dokumentum gyökerének táblának kell lennie, ezért a JSON-tömb vagy egyetlen érték elutasításra kerül. A TOML-ban nincs null: alapértelmezés szerint az első null az elérési útjával együtt jelenik meg; választhatja azt is, hogy a null értékű objektumtagok kimaradjanak. A tömbön belüli null mindig hiba, mert az eltávolítása megváltoztatná a többi elem pozícióját. A kevert típusú tömbök (például számok és szövegek) a TOML 1.0-ban érvényesek, de a régebbi 0.5 verzióban nem, ezért egy megjegyzésben szerepelnek.
A JSON nem különbözteti meg az 1-et az 1.0-tól, ezért az egész számok TOML egész számként íródnak. A dátumnak tűnő szövegek szövegek maradnak. A másik irány a TOML-ból JSON-ba.
Példák
Alkalmazásbeállítások
A {"server": {"host": "0.0.0.0", "port": 8080}} JSON [server] táblává válik host és port kulcsokkal.
Dolgozók listája
A "workers": [{"queue": "mail"}, {"queue": "images"}] két [[workers]] blokk lesz.
Gyakori kérdések
Miért nem engedélyezett a null?
A TOML-ban nincs null érték. Hagyja el a kulcsot, vagy használjon például üres szöveget, attól függően, hogy a feldolgozó program mit vár.
Miért jelenik meg megjegyzés egy számokat és karakterláncokat tartalmazó tömbnél?
A vegyes típusú tömbök a TOML 1.0 óta engedélyezettek, de a TOML 0.5-öt támogató eszközök elutasítják őket. A megjegyzés segít, ha a cél-eszközöd régebbi.
Az 1.0 lebegőpontos szám marad?
Nem. A JSON az 1.0-t és az 1-et ugyanazzal a számmal tárolja, így az egész szám 1 lesz. Ha az olvasóprogramnak lebegőpontos számra van szüksége, írj 1.5-öt vagy szerkeszd a TOML-t.
Adatvédelem
Az átalakítás teljes egészében a böngésződben fut. A JSON-od és a TOML-od nem kerül feltöltésre vagy tárolásra.