Käyttöohje
- Liitä JSON-objekti tai kokeile esimerkkiä.
- Ota käyttöön Jätä null-arvot pois -asetus, jos JSON sisältää nulleja, joita et tarvitse.
- Kopioi TOML tai lataa se .toml-tiedostona.
Näin se toimii
JSON jäsennetään tarkasti ja kirjoitetaan sitten TOML 1.0:ksi avoimen lähdekoodin smol-toml-kirjastolla. Sisäkkäisistä objekteista tulee [tables], objektien taulukoista tulee [[arrays of tables]], ja avaimet, jotka eivät ole tavallisia sanoja, laitetaan lainausmerkkeihin.
TOML ei voi ilmaista kaikkea, mitä JSON voi. Asiakirjan juuren on oltava taulukko, joten JSON-taulukko tai yksittäinen arvo hylätään. TOML:ssa ei ole null-arvoa: oletuksena ensimmäinen null ilmoitetaan polkuineen; voit sen sijaan jättää pois objektin jäsenet, joiden arvo on null. Null taulukon sisällä on aina virhe, koska sen poistaminen muuttaisi muiden alkioiden paikkoja. Taulukot, joissa on sekaisin eri tyyppejä (esimerkiksi numeroita ja merkkijonoja), ovat kelvollisia TOML 1.0:ssa mutta eivät vanhemmassa 0.5-versiossa, joten ne mainitaan huomautuksessa.
JSON ei erota lukua 1 luvusta 1.0, joten kokonaisluvut kirjoitetaan TOML-kokonaislukuina. Merkkijonot, jotka näyttävät päivämääriltä, pysyvät merkkijonoina. Vastakkainen suunta on TOML JSON:ksi.
Esimerkit
Sovellusasetukset
{"server": {"host": "0.0.0.0", "port": 8080}} muuttuu [server]-taulukoksi, jossa on host- ja port-avaimet.
Työntekijäluettelo
"workers": [{"queue": "mail"}, {"queue": "images"}] muuttuu kahdeksi [[workers]]-lohkoksi.
Usein kysytyt kysymykset
Miksi null ei ole sallittu?
TOML:ssa ei ole null-arvoa. Jätä avain pois tai käytä arvoa, kuten tyhjää merkkijonoa, sen mukaan, mitä lukijaohjelma odottaa.
Miksi numeroiden ja merkkijonojen taulukosta näytetään huomautus?
Sekatyypin taulukot ovat sallittuja TOML 1.0:sta lähtien, mutta työkalut, jotka toteuttavat vain TOML 0.5:n, hylkäävät ne. Huomautus auttaa, jos kohdetyökalusi on vanhempi.
Pysyykö 1.0 liukulukuna?
Ei. JSON tallentaa luvut 1.0 ja 1 samana lukuna, joten siitä tulee kokonaisluku 1. Kirjoita 1.5 tai muokkaa TOML-tiedostoa, jos lukeva ohjelma tarvitsee liukuluvun.
Tietosuoja
Muunnos tapahtuu kokonaan selaimessasi. JSON- ja TOML-tietojasi ei ladata eikä tallenneta.