halaman - Online di Cloud

PROGRAM:

NAMA

halaman - Generator Parser

RINGKASAN

halaman ?Pilihan...? ?memasukkan ?keluaran??

_________________________________________________________________________________________________

DESKRIPSI

Aplikasi yang dijelaskan oleh dokumen ini, halaman, sebenarnya bukan hanya generator parser,
seperti namanya, tetapi alat generik untuk eksekusi transformasi sewenang-wenang pada
teks.

Sifat generiknya datang melalui penggunaan plugin untuk membaca, mengubah, dan menulis
data, dan set plugin yang telah ditentukan sebelumnya yang disediakan oleh Tcllib adalah untuk menghasilkan
memoizing parser keturunan rekursif (alias paket pengurai) dari spesifikasi tata bahasa
(Penguraian Ekspresi Tata bahasa).

halaman tertulis di atas paket halaman::pluginmgr, membungkus fungsinya menjadi a
aplikasi berbasis baris perintah. Semua yang lain halaman::* paket adalah plugin dan/atau
paket pendukung untuk pembuatan parser. Pengurai itu sendiri didasarkan pada
paket tata bahasa::peg, tata bahasa::pasak::interp, dan tata bahasa::mengine.

COMMAND GARIS
halaman ?Pilihan...? ?memasukkan ?keluaran??
Ini adalah bentuk umum untuk memanggil halaman. Aplikasi akan membaca isi dari
file memasukkan, memprosesnya di bawah kendali yang ditentukan Pilihan, Dan kemudian
tulis hasilnya ke file keluaran.

If memasukkan adalah string - data yang akan diproses akan dibaca dari stdin bukannya a
mengajukan. Secara analog hasilnya akan ditulis ke stdout alih-alih file jika keluaran
adalah string -. Keluaran atau spesifikasi masukan yang hilang menyebabkan aplikasi untuk
menganggap -.

Spesifikasi rinci dari yang diakui Pilihan disediakan di bagian
PILIHAN.

path memasukkan (di)
Argumen ini menentukan jalur ke file yang akan diproses oleh
aplikasi, atau -. Nilai terakhir menyebabkan aplikasi membaca teks
dari stdin. Kalau tidak, itu harus ada, dan dapat dibaca. Jika argumennya adalah
hilang - diasumsikan.

path keluaran (di)
Argumen ini menentukan tempat untuk menulis teks yang dihasilkan. Ini bisa menjadi
jalur ke file, atau -. Nilai terakhir menyebabkan aplikasi menulis
dihasilkan didokumentasikan ke stdout.

Jika file keluaran tidak ada maka [file dirname $output] harus ada
dan harus berupa direktori yang dapat ditulis, karena aplikasi akan membuat fileto
menulis ke.

Jika argumennya hilang - diasumsikan.

OPERASI
... membaca ... mengubah ... menulis - plugin - pipa ...

PILIHAN
Bagian ini menjelaskan semua opsi yang tersedia bagi pengguna aplikasi. Pilihan
selalu diproses secara berurutan. Yaitu keduanya --membantu dan --Versi: kapan ditentukan pilihannya
ditemui lebih dulu memiliki prioritas.

Opsi tidak dikenal ditentukan sebelum opsi mana pun -rd, -wr, atau -tr akan menyebabkan pemrosesan
untuk membatalkan dengan kesalahan. Opsi tidak dikenal masuk di antara opsi ini, atau setelah yang terakhir
dari mereka diasumsikan selalu mengambil argumen tunggal dan dikaitkan dengan yang terakhir
opsi plugin datang sebelum mereka. Mereka akan diperiksa setelah semua plugin yang relevan, dan
dengan demikian pilihan yang mereka pahami, diketahui. Yaitu opsi yang tidak diketahui menyebabkan kesalahan jika dan
hanya jika opsi plugin yang terkait dengannya tidak memahaminya, dan tidak
digantikan oleh opsi plugin yang datang setelahnya.

Opsi default digunakan jika dan hanya jika baris perintah tidak berisi opsi apa pun di
semua. Mereka akan mengatur aplikasi sebagai generator parser berbasis PEG. Daftar yang tepat dari
pilihannya adalah

-c pasak

Dan sekarang opsi yang dikenali dan argumennya, jika ada:

--membantu

-h

-? Ketika salah satu opsi ini ditemukan di baris perintah, semua argumen datang sebelumnya
atau setelah diabaikan. Aplikasi akan mencetak deskripsi singkat tentang
opsi yang dikenali dan keluar.

--Versi: kapan

-V Ketika salah satu opsi ini ditemukan di baris perintah, semua argumen datang sebelumnya
atau setelah diabaikan. Aplikasi akan mencetak revisinya sendiri dan keluar.

-P Opsi ini memberi sinyal pada aplikasi untuk mengaktifkan umpan balik visual saat membaca
memasukkan.

-T Opsi ini menandakan aplikasi untuk mengumpulkan statistik saat membaca input
dan untuk mencetaknya setelah pembacaan selesai, sebelum pemrosesan dimulai.

-D Opsi ini menandakan aplikasi untuk mengaktifkan logging di Safe base, untuk
debugging masalah dengan plugin.

-r pengurai

-rd pengurai

--pembaca pengurai
Opsi ini menentukan plugin yang harus digunakan aplikasi untuk membaca memasukkan.
Jika opsi digunakan beberapa kali, opsi terakhir akan digunakan.

-w generator

-wr generator

--penulis generator
Opsi ini menentukan plugin yang harus digunakan aplikasi untuk menghasilkan dan
menulis final keluaran. Jika opsi digunakan beberapa kali, opsi terakhir akan
digunakan.

-t proses

-tr proses

--mengubah proses
Opsi ini menentukan plugin untuk dijalankan pada input. Berbeda dengan pembaca dan
penulis masing-masing menggunakan akan tidak menggantikan penggunaan sebelumnya, tetapi tambahkan setiap plugin yang dipilih ke a
daftar transformasi, baik di depan, atau di akhir, per penggunaan yang terakhir terlihat
salah satu pilihan -p or -a. Default awal adalah menambahkan transformasi baru.

-a

--menambahkan
Opsi-opsi ini menandakan aplikasi bahwa semua transformasi berikut harus:
ditambahkan di akhir daftar transformasi.

-p

--tambahkan
Opsi-opsi ini menandakan aplikasi bahwa semua transformasi berikut harus:
ditambahkan di awal daftar transformasi.

--mengatur ulang
Opsi ini menandakan aplikasi untuk menghapus daftar transformasi. Ini adalah
diperlukan untuk menghapus transformasi default yang digunakan.

-c fillet

--konfigurasi fillet
Opsi ini menyebabkan aplikasi memuat file konfigurasi dan/atau plugin. Ini
adalah plugin yang pada dasarnya menyediakan serangkaian opsi baris perintah yang telah ditentukan sebelumnya.
Mereka diproses persis seolah-olah mereka telah ditentukan sebagai pengganti opsi
dan argumennya. Ini berarti bahwa opsi yang tidak diketahui ditemukan di awal
file konfigurasi dikaitkan dengan plugin terakhir, bahkan jika plugin itu
ditentukan sebelum file konfigurasi itu sendiri. Sebaliknya, opsi yang tidak diketahui datang
setelah file konfigurasi dapat dikaitkan dengan plugin yang ditentukan dalam file.

Jika argumennya adalah file yang tidak dapat dimuat sebagai plugin, aplikasi akan
asumsikan bahwa isinya adalah daftar opsi dan argumennya, dipisahkan oleh
spasi, tab, dan baris baru. Opsi dan argumen yang mengandung spasi dapat dikutip
melalui tanda kutip ganda (") dan tanda kutip ('). Karakter kutipan dapat ditentukan di dalam
dalam string yang dikutip dengan menggandakannya. Baris baru dalam string yang dikutip diterima apa adanya.

PLUGINS
halaman menggunakan empat jenis plugin yang berbeda, yaitu: pembaca, penulis,
transformasi, dan konfigurasi. Di sini kami hanya memberikan pengantar dasar tentang cara
gunakan dari halaman. API persis yang disediakan dan diharapkan dari plugin dapat ditemukan
dalam dokumentasi untuk halaman::pluginmgr, bagi mereka yang ingin menulis plugin sendiri.

Plugin ditentukan sebagai argumen untuk opsi -r, -w, -t, -c, dan padanannya
bentuk yang lebih panjang. Lihat bagian PILIHAN sebagai referensi.

Setiap argumen tersebut pertama-tama akan diperlakukan sebagai nama file dan file ini dimuat sebagai
plugin. Namun jika tidak ada file dengan nama itu, maka itu akan diterjemahkan menjadi
nama paket, dan paket ini kemudian dimuat. Untuk setiap jenis plugin:
manajemen paket tidak hanya mencari jalur reguler, tetapi kumpulan aplikasi dan tipe
jalur tertentu juga. Silakan lihat bagian PLUGIN LOKASI untuk daftar semua jalur
dan sumber mereka.

-c nama
Konfigurasi. Nama paket untuk plugin nama is
"halaman::konfigurasi::nama".

Kami memiliki satu plugin yang telah ditentukan:

pasak Ini mengatur aplikasi sebagai generator parser yang menerima parsing
tata bahasa ekspresi dan menulis parser packrat di Tcl. Sebenarnya
argumen yang ditentukan adalah:

--mengatur ulang
--menambahkan
-- pasak pembaca
--transform jangkauan
--mengubah penggunaan
--tulis aku

-r nama
Pembaca. Nama paket untuk plugin nama adalah "halaman::pembaca::nama".

Kami memiliki lima plugin yang telah ditentukan:

pasak Menafsirkan input sebagai tata bahasa ekspresi parsing (PEG) dan menghasilkan
representasi pohon untuk itu. Baik sintaks PEG dan struktur
representasi pohon dijelaskan dalam halaman manual mereka sendiri.

hb Menafsirkan input sebagai kode Tcl seperti yang dihasilkan oleh plugin penulis hb dan
menghasilkan representasi pohonnya.

melihat Menafsirkan input sebagai serialisasi PEG, seperti yang dihasilkan oleh
plugin penulis melihat, menggunakan paket tata bahasa::peg.

jeruk nipis Menafsirkan input sebagai spesifikasi tata bahasa seperti yang dipahami oleh Richard
Hipp's LEMON generator parser dan menghasilkan representasi pohon untuk itu.
Sintaks input dan struktur representasi pohon adalah
dijelaskan di halaman manual mereka sendiri.

tukang pohon
Menafsirkan input sebagai serialisasi a struktur::pohon. Itu divalidasi
seperti itu, tapi tidak ada yang lain. Dia tidak diasumsikan sebagai representasi pohon
dari sebuah tata bahasa.

-w nama
Penulis. Nama paket untuk plugin nama adalah "halaman::penulis::nama".

Kami memiliki delapan plugin yang telah ditentukan sebelumnya:

identitas
Cukup tulis data yang masuk apa adanya, tanpa melakukan perubahan apa pun. Ini
baik untuk memeriksa hasil mentah dari pembaca atau transformasi.

nol Tidak menghasilkan apa-apa, dan mengabaikan struktur data yang masuk.

pohon Diasumsikan bahwa struktur data yang masuk adalah struktur::pohon dan menghasilkan
representasi tekstual indentasi dari semua node, hubungan induknya,
dan informasi atribut mereka.

pasak Diasumsikan bahwa struktur data yang masuk adalah representasi pohon dari a PEG
atau tata bahasa lainnya dan menuliskannya sebagai PEG. Hasilnya bagus
diformat dan disederhanakan sebagian (string sebagai urutan karakter). A
printer cantik pada dasarnya, tetapi juga dapat digunakan untuk mendapatkan kanonik
representasi dari tata bahasa input.

Tpc Diasumsikan bahwa struktur data yang masuk adalah representasi pohon dari a PEG
atau tata bahasa lainnya dan menulis kode Tcl yang mendefinisikan sebuah paket yang
mendefinisikan tata bahasa::peg objek yang berisi tata bahasa saat dimuat ke
seorang penerjemah.

hb Ini seperti plugin penulis Tpc, tetapi hanya menulis pernyataan yang
mendefinisikan ekspresi stat dan aturan tata bahasa. Kode membuat hasilnya a
paket ditinggalkan.

melihat Diasumsikan bahwa struktur data yang masuk adalah representasi pohon dari a PEG
atau tata bahasa lainnya, mengubahnya secara internal menjadi a tata bahasa::peg obyek
dan menulis serialisasinya.

me Diasumsikan bahwa struktur data yang masuk adalah representasi pohon dari a PEG
atau tata bahasa lainnya dan menulis kode Tcl yang mendefinisikan sebuah paket yang
mengimplementasikan parser keturunan rekursif memoizing berdasarkan mesin pertandingan
(ME) disediakan oleh paket tata bahasa::mengine.

-t nama
Transformer. Nama paket untuk plugin nama is
"halaman::transformasi::nama".

Kami memiliki dua plugin yang telah ditentukan sebelumnya:

mencapai Diasumsikan bahwa struktur data yang masuk adalah representasi pohon dari a PEG
atau tata bahasa lainnya. Ini menentukan simbol dan aturan nonterminal mana
dapat dijangkau dari simbol awal/ekspresi. Semua simbol nonterminal yang
tidak tercapai dihapus.

menggunakan Diasumsikan bahwa struktur data yang masuk adalah representasi pohon dari a PEG
atau tata bahasa lainnya. Ini menentukan simbol dan aturan nonterminal mana
mampu menghasilkan terbatas urutan simbol terminal (dalam arti
untuk Tata Bahasa Bebas Konteks). Semua simbol nonterminal yang tidak dianggap
berguna dalam pengertian ini dihapus.

PLUGIN LOKASI
Jalur khusus aplikasi yang dicari oleh halaman baik adalah, atau berasal dari:

[1] Direktori "~/.halaman/plugin"

[2] Variabel lingkungan PAGE_PLUGIN

[3] Entri registri HKEY_LOCAL_MACHINE\SOFTWARE\PAGE\PLUGINS

[4] Entri registri HKEY_CURRENT_USER\SOFTWARE\PAGE\PLUGINS

Jalur khusus tipe yang dicari oleh halaman baik adalah, atau berasal dari:

[1] Direktori "~/.halaman/plugin/"

[2] Variabel lingkungan HALAMAN_ _PLUGIN

[3] Entri registri HKEY_LOCAL_MACHINE\SOFTWARE\PAGE\ \PLUGIN

[4] Entri registri HKEY_CURRENT_USER\SOFTWARE\PAGE\ \PLUGIN

Tempat penampung selalu salah satu nilai di bawah ini, dikapitalisasi dengan benar.

[1] pembaca

[2] penulis

[3] transformasi

[4] konfigurasi

Entri registri khusus untuk platform Windows(tm), semua platform lain akan
abaikan mereka.

Isi variabel lingkungan dan entri registri ditafsirkan sebagai daftar
jalur, dengan elemen yang dipisahkan oleh titik dua (Unix), atau titik koma (Windows).

Gunakan halaman online menggunakan layanan onworks.net