Cara menggunakannya
- Tampal objek JSON, atau cuba contoh.
- Hidupkan 'Tinggalkan nilai null' jika JSON anda mengandungi null yang tidak anda perlukan.
- Salin TOML atau muat turunnya sebagai fail .toml.
Cara ia berfungsi
JSON ditafsirkan dengan ketat, kemudian ditulis sebagai TOML 1.0 menggunakan pustaka sumber terbuka smol-toml. Objek bersarang menjadi [tables], tatasusunan objek menjadi [[arrays of tables]], dan kunci yang bukan perkataan biasa akan diletakkan dalam tanda petik.
TOML tidak dapat menyatakan semua yang boleh dinyatakan oleh JSON. Akar dokumen mestilah jadual, jadi tatasusunan JSON atau nilai tunggal akan ditolak. Tiada null dalam TOML: secara lalai, null pertama dilaporkan bersama laluannya; anda boleh memilih untuk menggugurkan ahli objek null sebaliknya. Null di dalam tatasusunan sentiasa ralat, kerana membuangnya akan mengubah kedudukan elemen lain. Tatasusunan yang mencampurkan jenis (contohnya nombor dan rentetan) sah dalam TOML 1.0 tetapi tidak dalam versi lama 0.5, jadi ia dikira dalam nota.
JSON tidak membezakan 1 daripada 1.0, jadi nombor bulat ditulis sebagai integer TOML. Rentetan yang kelihatan seperti tarikh kekal sebagai rentetan. Arah sebaliknya ialah TOML kepada JSON.
Contoh
Tetapan aplikasi
{"server": {"host": "0.0.0.0", "port": 8080}} menjadi jadual [server] dengan kunci host dan port.
Senarai pekerja
"workers": [{"queue": "mail"}, {"queue": "images"}] menjadi dua blok [[workers]].
Soalan Lazim
Mengapa null tidak dibenarkan?
TOML tidak mempunyai nilai null. Tinggalkan kunci tersebut atau gunakan nilai seperti rentetan kosong, bergantung pada apa yang dijangkakan oleh program yang membaca.
Mengapa tatasusunan nombor dan rentetan menunjukkan nota?
Tatasusunan jenis campuran dibenarkan sejak TOML 1.0, tetapi alat yang melaksanakan TOML 0.5 akan menolaknya. Nota ini membantu jika alat sasaran anda lebih lama.
Adakah 1.0 akan kekal sebagai float?
Tidak. JSON menyimpan 1.0 dan 1 sebagai nombor yang sama, jadi ia menjadi integer 1. Tulis 1.5 atau edit TOML jika program yang membacanya memerlukan float.
Privasi
Penukaran berjalan sepenuhnya dalam pelayar anda. JSON dan TOML anda tidak dimuat naik atau disimpan.