re2c - Online di Cloud

PROGRAM:

NAMA

re2c - mengonversi ekspresi reguler ke kode C/C++

RINGKASAN

re2c [PILIHAN] FILE

DESKRIPSI

re2c adalah generator lexer untuk C/C++. Ia menemukan spesifikasi ekspresi reguler di dalam
C/C++ berkomentar dan menggantinya dengan DFA hard-code. Pengguna harus menyediakan beberapa
kode antarmuka untuk mengontrol dan menyesuaikan DFA yang dihasilkan.

PILIHAN

-? -h --membantu
Minta bantuan singkat.

-b --bit-vektor
menyiratkan -s. Gunakan vektor bit juga dalam upaya untuk mendapatkan kode yang lebih baik dari
penyusun. Paling berguna untuk spesifikasi dengan lebih dari beberapa kata kunci (mis
sebagian besar bahasa pemrograman).

-c --kondisi
Digunakan untuk mendukung (f)dukungan kondisi seperti lex.

-d --debug-keluaran
Membuat parser yang membuang informasi tentang posisi saat ini dan di mana
menyatakan parser saat mem-parsing input. Ini berguna untuk men-debug masalah pengurai
dan negara bagian. Jika Anda menggunakan sakelar ini, Anda perlu mendefinisikan makro YYDEBUG itu adalah
disebut seperti fungsi dengan dua parameter: membatalkan YYDEBUG (ke dalam negara, tangki arus).
Parameter pertama menerima status atau -1 dan parameter kedua menerima
masukan pada kursor saat ini.

-D --memancarkan-titik
Memancarkan data titik Graphviz. Itu kemudian dapat diproses dengan mis dot -Tpng masukan.dot >
keluaran.png. Harap dicatat bahwa pemindai dengan banyak status mungkin mengalami crash dot.

-e --ecb
Hasilkan parser yang mendukung EBCDIC. Kode yang dihasilkan dapat menangani semua
karakter hingga 0xFF. Dalam mode ini re2c mengasumsikan bahwa ukuran karakter input adalah 1
byte. Sakelar ini tidak kompatibel dengan -w, -x, -u dan -8.

-f --status yang dapat disimpan
Hasilkan pemindai dengan dukungan untuk status yang dapat disimpan.

-F --flex-sintaks
Dukungan parsial untuk sintaks fleksibel. Ketika bendera ini aktif maka beri nama definisi
harus diapit oleh kurung kurawal dan dapat didefinisikan tanpa tanda sama dengan dan
mengakhiri titik koma. Sebaliknya nama diperlakukan sebagai string kutipan ganda langsung.

-g --dihitung-gotos
Hasilkan pemindai yang menggunakan fitur goto terkomputasi GCC. Itu adalah re2c
menghasilkan tabel lompatan setiap kali keputusan memiliki kompleksitas tertentu (mis
jika kondisi sebaliknya diperlukan). Ini hanya dapat digunakan dengan GCC dan menghasilkan
output yang tidak dapat dikompilasi dengan compiler lain. Perhatikan bahwa ini menyiratkan -b
dan bahwa ambang kompleksitas dapat dikonfigurasi menggunakan konfigurasi di tempat
cgoto: ambang batas.

-i --tidak-debug-info
Jangan keluarkan #garis informasi. Ini berguna ketika Anda ingin menggunakan alat CMS dengan
itu re2c output yang mungkin Anda inginkan jika Anda tidak mengharuskan pengguna Anda memilikinya re2c
sendiri saat membangun dari sumber Anda.

-o KELUARAN --keluaran=keluaran
Tentukan KELUARAN file.

-r --dapat digunakan kembali
Memungkinkan penggunaan kembali definisi pemindai dengan /*!gunakan:re2c */ setelah /*!aturan:re2c */. di
mode ini tidak /*!re2c */ blok dan tepat satu /*!aturan:re2c */ harus hadir.
Aturan disimpan dan digunakan oleh setiap /*!gunakan:re2c */ blok yang mengikuti.
Blok ini dapat berisi konfigurasi di tempat, terutama re2c:flag:e,
re2c: bendera: w, re2c:flag:x, re2c: bendera: u dan re2c:flag:8. Dengan cara itu mungkin
untuk membuat pemindai yang sama beberapa kali untuk tipe karakter yang berbeda, berbeda
mekanisme input atau mekanisme output yang berbeda. Itu /*!gunakan:re2c */ blok bisa
juga berisi aturan tambahan yang akan ditambahkan ke kumpulan aturan di
/*!aturan:re2c */.

-s --bersarang-jika
Hasilkan if bersarang untuk beberapa sakelar. Banyak kompiler membutuhkan bantuan ini untuk menghasilkan
kode yang lebih baik.

-t HEADER --type-header=HEADER
Membuat HEADER file yang berisi jenis untuk dukungan kondisi (f)lex-like.
Ini hanya dapat diaktifkan ketika -c sedang digunakan.

-u --unicode
Hasilkan parser yang mendukung UTF-32. Kode yang dihasilkan dapat menangani semua yang valid
Karakter unicode hingga 0x10FFFF. Dalam mode ini re2c mengasumsikan bahwa karakter input
ukurannya 4 byte. Sakelar ini tidak kompatibel dengan -e, -w, -x dan -8. Ini menyiratkan
-s.

-v --Versi: kapan
Tampilkan informasi versi.

-V --vernum
Tampilkan versi sebagai angka XXYYZZ.

-w --karakter lebar
Hasilkan parser yang mendukung UCS-2. Kode yang dihasilkan dapat menangani semua yang valid
Karakter unicode hingga 0xFFFF. Dalam mode ini re2c mengasumsikan bahwa karakter input
ukurannya 2 byte. Sakelar ini tidak kompatibel dengan -e, -x, -u dan -8. Ini menyiratkan
-s.

-x --utf-16
Hasilkan parser yang mendukung UTF-16. Kode yang dihasilkan dapat menangani semua yang valid
Karakter unicode hingga 0x10FFFF. Dalam mode ini re2c mengasumsikan bahwa karakter input
ukurannya 2 byte. Sakelar ini tidak kompatibel dengan -e, -w, -u dan -8. Ini menyiratkan
-s.

-8 --utf-8
Hasilkan parser yang mendukung UTF-8. Kode yang dihasilkan dapat menangani semua yang valid
Karakter unicode hingga 0x10FFFF. Dalam mode ini re2c mengasumsikan bahwa karakter input
ukurannya 1 byte. Sakelar ini tidak kompatibel dengan -e, -w, -x dan -u.

--tidak peka huruf besar-kecil
Semua string tidak peka huruf besar/kecil, jadi semua "-ekspresi diperlakukan dengan cara yang sama
'-ekspresi adalah.

--kasus-terbalik
Balikkan arti string yang dikutip tunggal dan ganda. Dengan sakelar ini tunggal
tanda kutip peka huruf besar-kecil dan tanda kutip ganda tidak peka huruf besar-kecil.

--tanpa-generasi-tanggal
Menekan keluaran tanggal dalam file yang dihasilkan.

--tanpa-generasi-tanggal
Menekan keluaran versi dalam file yang dihasilkan.

--encoding-kebijakan KEBIJAKAN
Tentukan caranya re2c harus memperlakukan pengganti Unicode. KEBIJAKAN dapat berupa salah satu dari berikut ini:
gagal (batalkan dengan kesalahan ketika pengganti ditemui), pengganti (diam-diam menggantikan
pengganti dengan kode kesalahan titik 0xFFFD), mengabaikan (perlakukan pengganti sebagai kode normal
poin). Secara default re2c mengabaikan pengganti (untuk kompatibilitas ke belakang). Unicode
standar mengatakan bahwa pengganti mandiri adalah poin kode yang tidak valid, tetapi berbeda
perpustakaan dan program memperlakukan mereka secara berbeda.

--memasukkan INPUT
Tentukan API masukan re2c. INPUT dapat berupa salah satu dari berikut ini: kegagalan, adat.

-S --kerangka
Alih-alih menyematkan kode yang dihasilkan re2c ke dalam sumber C/C++, buat a
program mandiri untuk DFA yang sama. Paling berguna untuk kebenaran dan
pengujian kinerja.

--kelas-kosong KEBIJAKAN
Apa yang harus dilakukan jika pengguna memasukkan kelas karakter kosong. KEBIJAKAN bisa menjadi salah satunya
sebagai berikut: pertandingan-kosong (cocok dengan input kosong: cukup tidak logis, tetapi ini adalah
default untuk alasan kompatibilitas mundur), pertandingan-tidak ada (gagal mencocokkan pada
memasukkan), kesalahan (kesalahan kompilasi). Perhatikan bahwa ada berbagai cara untuk membangun
kelas kosong, misalnya: [], [^\x00-\xFF], [\x00-\xFF][\x00-\xFF].

--dfa-minimisasi <meja | moore>
Algoritma internal yang digunakan oleh re2c untuk meminimalkan DFA (default ke moore). Kedua meja
pengisian dan algoritme Moore harus menghasilkan DFA yang identik (hingga status
pelabelan ulang). Algoritma pengisian tabel jauh lebih sederhana dan lebih lambat; itu berfungsi sebagai
implementasi referensi.

-1 --pass tunggal
Tidak digunakan lagi dan tidak melakukan apa-apa (single pass secara default sekarang).

-W Nyalakan semua peringatan.

-Kesalahan
Ubah peringatan menjadi kesalahan. Perhatikan bahwa opsi ini tidak mengaktifkan apa pun
peringatan, itu hanya memengaruhi peringatan yang telah diaktifkan sejauh ini atau akan
dihidupkan nanti.

-W
Nyalakan individu peringatan.

-Tidak-
Matikan individu peringatan.

-Kesalahan-
Nyalakan individu peringatan dan memperlakukannya sebagai kesalahan (ini menyiratkan -W).

-Wno-error-
Jangan perlakukan khusus ini peringatan sebagai kesalahan. Ini tidak mematikan peringatan
itu sendiri.

-Kondisi-pesanan
Peringatkan jika program yang dihasilkan membuat asumsi implisit tentang penomoran kondisi.
Seseorang harus menggunakan -T, --tipe-header opsi atau /*!type:re2c*/ arahan ke
menghasilkan pemetaan nama kondisi ke angka dan menggunakan kondisi yang dibuat secara otomatis
nama.

-Kelas-karakter-kosong
Peringatkan jika ekspresi reguler berisi kelas karakter kosong. Dari sudut rasional
tampilan mencoba mencocokkan kelas karakter kosong tidak masuk akal: harus selalu
gagal. Namun, untuk alasan kompatibilitas mundur re2c memungkinkan karakter kosong
class dan memperlakukannya sebagai string kosong. Menggunakan --kelas-kosong opsi untuk mengubah default
tingkah laku.

-Wmatch-kosong-string
Peringatkan jika ekspresi reguler dalam aturan adalah nullable (cocok dengan string kosong). Jika DFA
berjalan dalam satu lingkaran dan kecocokan kosong tidak disengaja (posisi input tidak maju
manual), lexer mungkin terjebak dalam loop abadi.

-Wswap-range
Peringatkan jika rentang batas bawah lebih besar dari batas atas. Bawaan re2c perilaku adalah untuk
secara diam-diam menukar batas jangkauan.

-Wundefined-kontrol-aliran
Peringatkan jika beberapa string input menyebabkan aliran kontrol tidak terdefinisi di lexer (kesalahan
pola dilaporkan). Ini adalah kesalahan paling berbahaya dan umum. Bisa jadi
mudah diperbaiki dengan menambahkan aturan default * (aturan ini memiliki prioritas terendah, cocok
unit kode apa pun dan menggunakan tepat satu unit kode).

-Wuseless-melarikan diri
Peringatkan jika simbol diloloskan padahal seharusnya tidak. Secara default re2c diam-diam mengabaikan
melarikan diri, tetapi ini mungkin juga menunjukkan kesalahan ketik atau kesalahan dalam urutan pelarian.

INTERFACE KODE

Pengguna harus menyediakan kode antarmuka baik berupa kode C/C++ (makro, fungsi,
variabel, dll) atau dalam bentuk DI TEMPAT KONFIGURASI. Simbol mana yang harus didefinisikan
dan yang opsional tergantung pada kasus penggunaan tertentu.

TIPE YYCOND
In -c mode yang dapat Anda gunakan -t untuk menghasilkan file yang berisi enumerasi yang digunakan sebagai
kondisi. Masing-masing nilai mengacu pada kondisi dari kumpulan aturan.

PENANDA YYCTX
nilai-l tipe JENIS YYC *. Kode yang dihasilkan menyimpan pelacakan mundur konteks tambahan
informasi dalam PENANDA YYCTX. Pengguna hanya perlu mendefinisikan makro ini jika pemindai
spesifikasi menggunakan konteks tambahan dalam satu atau lebih ekspresi regulernya.

JENIS YYC
Jenis yang digunakan untuk menyimpan simbol input (unit kode). Biasanya tangki or unsigned tangki untuk
ASCII, EBCDIC dan UTF-8, unsigned pendek untuk UTF-16 atau UCS-2 dan unsigned int untuk
UTF-32.

YYKURSOR
nilai-l tipe JENIS YYC * yang menunjuk ke simbol input saat ini. yang dihasilkan
kemajuan kode YYKURSOR sebagai simbol yang cocok. Saat masuk, YYKURSOR diasumsikan
arahkan ke karakter pertama dari token saat ini. Saat keluar, YYKURSOR akan menunjuk ke
karakter pertama dari token berikut.

YYDEBUG (negara, arus)
Ini hanya diperlukan jika -d bendera ditentukan. Ini memungkinkan seseorang untuk dengan mudah men-debug
parser yang dihasilkan dengan memanggil fungsi yang ditentukan pengguna untuk setiap status. Fungsinya
harus memiliki tanda tangan sebagai berikut: membatalkan YYDEBUG (ke dalam negara, tangki arus). itu
parameter pertama menerima status atau -1 dan parameter kedua menerima
masukan pada kursor saat ini.

YYFILL (n)
Kode yang dihasilkan "panggilan"" YYFILL (n) ketika buffer perlu (kembali) mengisi: setidaknya
n karakter tambahan harus disediakan. YYFILL (n) harus menyesuaikan YYKURSOR,
BATAS YY, PENANDA YY dan PENANDA YYCTX sesuai kebutuhan. Perhatikan bahwa untuk pemrograman biasa
bahasa n akan menjadi panjang kata kunci terpanjang ditambah satu. Pengguna dapat menempatkan
komentar formulir /*!maks:re2c*/ untuk memasukkan YYMAXFILL definisi yang diatur ke
nilai panjang maksimum.

KONDISI YYGET ()
Definisi ini digunakan untuk mendapatkan kondisi sebelum memasukkan kode pemindai ketika
menggunakan -c mengalihkan. Nilai harus diinisialisasi dengan nilai dari enumerasi
TIPE YYCOND mengetik.

YYGETSTATE ()
Pengguna hanya perlu mendefinisikan makro ini jika -f bendera ditentukan. Karena
kasus, kode yang dihasilkan "panggilan" YYGETSTATE () di awal pemindai
untuk mendapatkan status yang disimpan. YYGETSTATE () harus mengembalikan bilangan bulat yang ditandatangani. Itu
nilai harus berupa -1, yang menunjukkan bahwa pemindai dimasukkan untuk pertama kali,
atau nilai yang sebelumnya disimpan oleh YYSETSTATE (S). Dalam kasus kedua, pemindai akan
melanjutkan operasi tepat setelah tempat terakhir YYFILL (n) telah dipanggil.

BATAS YY
ekspresi tipe JENIS YYC * yang menandai akhir dari buffer BATAS YY[-1] adalah
karakter terakhir dalam buffer). Kode yang dihasilkan berulang kali membandingkan YYKURSOR untuk
BATAS YY untuk menentukan kapan buffer perlu (kembali) diisi.

PENANDA YY
nilai-l tipe JENIS YYC *. Kode yang dihasilkan menyimpan informasi lacak balik di
PENANDA YY. Beberapa pemindai mudah mungkin tidak menggunakan ini.

YYMAXFILL
Ini akan secara otomatis ditentukan oleh /*!maks:re2c*/ blok seperti yang dijelaskan di atas.

KONDISI YYSET (C)
Definisi ini digunakan untuk mengatur kondisi dalam aturan transisi. Ini hanya menjadi
digunakan saat -c aktif dan aturan transisi sedang digunakan.

YYSETSTATE (S)
Pengguna hanya perlu mendefinisikan makro ini jika -f bendera ditentukan. Karena
kasus, kode yang dihasilkan "panggilan" YYSETSTATE sesaat sebelum menelepon YYFILL (n). itu
parameter untuk YYSETSTATE adalah bilangan bulat bertanda yang secara unik mengidentifikasi spesifik
contoh YYFILL (n) yang akan dipanggil. Jika pengguna ingin menyimpan
keadaan pemindai dan memiliki YYFILL (n) kembali ke penelepon, yang harus dia lakukan adalah
menyimpan pengidentifikasi unik itu dalam sebuah variabel. Nanti, saat dipindai disebut
lagi, itu akan memanggil YYGETSTATE () dan melanjutkan eksekusi tepat di tempat yang ditinggalkannya. Itu
kode yang dihasilkan akan berisi keduanya YYSETSTATE (S) dan YYGETSTATE meskipun YYFILL (n)
sedang dinonaktifkan.

SINTAKSIS

Kode untuk re2c terdiri dari satu set ATURAN, BERNAMA DEFINISI dan DI TEMPAT KONFIGURASI.

ATURAN
Aturan terdiri dari ekspresi reguler (lihat REGULER EKSPRESI) bersama dengan blok
Kode C/C++ yang akan dieksekusi ketika ekspresi reguler terkait cocok. Anda
dapat memulai kode dengan kurung kurawal pembuka atau urutan :=. Kapan kodenya?
dengan kurung kurawal maka re2c menghitung kedalaman penjepit dan berhenti mencari kode
secara otomatis. Jika tidak, kurung kurawal tidak diperbolehkan dan re2c berhenti mencari kode di
baris pertama yang tidak dimulai dengan spasi. Jika dua atau lebih aturan tumpang tindih,
aturan pertama lebih disukai.
ekspresi reguler { C / C ++ kode }

ekspresi reguler := C / C ++ kode

Ada satu aturan khusus: aturan default *
* { C / C ++ kode }

* := C / C ++ kode

Perhatikan bahwa aturan default * berbeda dari [^]: aturan default memiliki prioritas terendah, cocok
setiap unit kode (baik valid atau tidak valid) dan selalu menggunakan satu karakter; ketika [^]
cocok dengan titik kode yang valid (bukan unit kode) dan dapat menggunakan beberapa unit kode. Faktanya,
ketika pengkodean panjang variabel digunakan, * adalah satu-satunya cara yang mungkin untuk mencocokkan input yang tidak valid
karakter (lihat pengkodean untuk lebih jelasnya).

If -c aktif maka setiap ekspresi reguler didahului oleh daftar yang dipisahkan koma
nama kondisi. Selain aturan penamaan normal, ada dua kasus khusus: <*> (aturan seperti itu
digabungkan ke semua kondisi) dan <> (aturan seperti itu tidak dapat memiliki reguler terkait
ekspresi, kodenya digabungkan ke semua tindakan). Aturan yang tidak kosong dapat lebih ditentukan
kondisi baru. Dalam hal itu re2c akan menghasilkan kode yang diperlukan untuk mengubah
kondisi secara otomatis. Aturan dapat menggunakan :=> sebagai jalan pintas untuk menghasilkan kode secara otomatis
yang tidak hanya menetapkan status kondisi baru tetapi juga melanjutkan eksekusi dengan yang baru
negara. Aturan pintasan tidak boleh digunakan dalam lingkaran di mana ada kode di antara awal
dari loop dan re2c blokir kecuali re2c:lanjutan:goto diubah menjadi terus. Jika kode adalah
diperlukan sebelum semua aturan (meskipun bukan lompatan sederhana) Anda dapat melakukannya dengan menggunakan
aturan semu.
ekspresi reguler { C / C ++ kode }

ekspresi reguler := C / C ++ kode

* { C / C ++ kode }

* := C / C ++ kode

ekspresi reguler => kondisi { C / C ++ kode }

ekspresi reguler => kondisi := C / C ++ kode

* => kondisi { C / C ++ kode }

* => kondisi := C / C ++ kode

ekspresi reguler :=> kondisi

<*> ekspresi reguler { C / C ++ kode }

<*> ekspresi reguler := C / C ++ kode

<*> * { C / C ++ kode }

<*> * := C / C ++ kode

<*> ekspresi reguler => kondisi { C / C ++ kode }

<*> ekspresi reguler => kondisi := C / C ++ kode

<*> * => kondisi { C / C ++ kode }

<*> * => kondisi := C / C ++ kode

<*> ekspresi reguler :=> kondisi

<> { C / C ++ kode }

<> := C / C ++ kode

<> => kondisi { C / C ++ kode }

<> => kondisi := C / C ++ kode

<> :=> kondisi

<> :=> kondisi

<! daftar kondisi> { C / C ++ kode }

<! daftar kondisi> := C / C ++ kode

{ C / C ++ kode }

:= C / C ++ kode

BERNAMA DEFINISI
Definisi bernama adalah dalam bentuk:
nama = ekspresi reguler;

If -F aktif, maka definisi bernama juga dalam bentuk:
nama { ekspresi reguler }

DI TEMPAT KONFIGURASI
re2c:condprefix = ya;
Memungkinkan seseorang untuk menentukan awalan yang digunakan untuk label kondisi. Itu adalah teks ini
ditambahkan ke label kondisi apa pun dalam file output yang dihasilkan.

re2c: condenumprefix = ya;
Memungkinkan seseorang untuk menentukan awalan yang digunakan untuk nilai kondisi. Itu adalah teks ini
ditambahkan ke nilai enum kondisi apa pun dalam file output yang dihasilkan.

re2c:cond:pembagi = /* *********************************** */ ;
Memungkinkan seseorang untuk menyesuaikan pembagi untuk blok kondisi. Kamu dapat memakai @@ untuk menempatkan
nama kondisi atau sesuaikan placeholder menggunakan re2c:cond:divider@cond.

re2c:cond:divider@cond = @@;
Menentukan placeholder yang akan diganti dengan nama kondisi di
re2c:cond:pembagi.

re2c:lanjutan:goto = goto @@; ;
Memungkinkan seseorang untuk menyesuaikan kondisi pernyataan goto yang digunakan dengan :=> aturan gaya.
Anda dapat menggunakan @@ untuk menempatkan nama kondisi atau menyesuaikan placeholder menggunakan
re2c:cond:goto@cond. Anda juga dapat mengubah ini menjadi terus;, yang memungkinkan Anda
untuk melanjutkan siklus loop berikutnya termasuk kode apa pun antara loop start dan re2c
blok.

re2c:cond:goto@cond = @@;
Menentukan placeholder yang akan diganti dengan label kondisi di
re2c:lanjutan:goto.

re2c:indentasi:atas = 0;
Menentukan jumlah minimum indentasi untuk digunakan. Membutuhkan nilai numerik
lebih besar dari atau sama dengan nol.

re2c:indentasi:string = \t ;
Menentukan string yang akan digunakan untuk indentasi. Membutuhkan string yang harus berisi
hanya spasi putih kecuali Anda memerlukan ini untuk alat eksternal. Cara termudah untuk menentukan
spasi adalah untuk memasukkannya dalam tanda kutip tunggal atau ganda. Jika Anda tidak ingin ada
lekukan sama sekali Anda cukup mengatur ini ke "".

re2c:yych:konversi = 0;
Ketika pengaturan ini bukan nol, maka re2c secara otomatis menghasilkan kode konversi
setiap kali yych dibaca. Dalam hal ini tipenya harus didefinisikan menggunakan
re2c: tentukan: YYCTYPE.

re2c:yych:memancarkan = 1;
Generasi dari ya dapat ditekan dengan mengatur ini ke 0.

re2c:yybm:hex = 0;
Jika disetel ke nol maka tabel desimal digunakan jika tidak, tabel heksadesimal akan menjadi
dihasilkan.

re2c:yyfill:aktifkan = 1;
Setel ini ke nol untuk menekan generasi YYFILL (n). Saat menggunakan ini pastikan untuk
memverifikasi bahwa pemindai yang dihasilkan tidak membaca di belakang input. Mengizinkan ini
perilaku mungkin memperkenalkan masalah keamanan yang parah pada program Anda.

re2c:yyfill:centang = 1;
Ini dapat diatur 0 untuk menekan output dari kondisi awal menggunakan YYKURSOR dan
BATAS YY yang menjadi berguna ketika BATAS YY + YYMAXFILL selalu dapat diakses.

re2c: tentukan: YYFILL = YYFILL ;
Substitusi untuk YYFILL. Perhatikan bahwa secara default re2c menghasilkan argumen dalam kurung dan
titik koma setelah YYFILL. Jika Anda perlu membuatnya YYFILL pernyataan yang sewenang-wenang bukan
daripada panggilan, set re2c:define:YYFILL:telanjang ke bukan nol dan gunakan
re2c:define:YYFILL@len untuk menunjukkan parameter formal di dalam YYFILL tubuh.

re2c:define:YYFILL@len = @@ ;
Setiap kemunculan teks ini di dalam YYFILL akan diganti dengan yang sebenarnya
argumen.

re2c:yyisi:parameter = 1;
Mengontrol argumen dalam kurung kurawal setelah YYFILL. Jika nol, agrument dihilangkan. Jika
bukan nol, argumen dihasilkan kecuali re2c:define:YYFILL:telanjang diatur ke bukan nol.

re2c:define:YYFILL:telanjang = 0;
Mengontrol argumen dalam kurung kurawal dan titik koma setelahnya YYFILL. Jika nol, agrumen dan
titik koma dihilangkan. Jika bukan nol, argumen dihasilkan kecuali
re2c:yyisi:parameter diatur ke nol dan titik koma dihasilkan tanpa syarat.

re2c: label awal = 0;
Jika disetel ke bilangan bulat bukan nol maka label awal dari blok pemindai berikutnya akan
dihasilkan bahkan jika tidak digunakan oleh pemindai itu sendiri. Jika tidak normal yy0 'like'
label awal hanya dibuat jika diperlukan. Jika diatur ke nilai teks maka label
dengan teks itu akan dihasilkan terlepas dari apakah label awal normal adalah
sedang digunakan atau tidak. Pengaturan ini sedang diatur ulang ke 0 setelah label awal telah
dihasilkan.

re2c: awalan label = yy ;
Memungkinkan seseorang untuk mengubah awalan label bernomor. Standarnya adalah yy dan dapat
atur string apa pun yang merupakan label yang valid.

re2c:status:batalkan = 0;
Ketika tidak nol dan beralih -f aktif maka YYGETSTATE blok akan berisi
kasus default yang dibatalkan dan kasus -1 digunakan untuk inisialisasi.

re2c:status:labelberikutnya = 0;
Digunakan ketika -f aktif untuk mengontrol apakah YYGETSTATE blok diikuti oleh
yyBerikutnya: garis label. Alih-alih menggunakan yyBerikutnya Anda biasanya juga dapat menggunakan konfigurasi
label awal untuk memaksa label awal tertentu atau default ke yy0 sebagai label awal.
Alih-alih menggunakan label khusus, sering kali lebih baik memisahkannya YYGETSTATE
kode dari kode pemindai yang sebenarnya dengan menempatkan /*!getstate:re2c*/ komentar.

re2c:cgoto:ambang batas = 9;
Ketika -g aktif nilai ini menentukan ambang kompleksitas yang memicu
pembuatan tabel lompat daripada menggunakan if bersarang dan bitfield keputusan. Itu
ambang batas dibandingkan dengan estimasi yang dihitung dari jika-s diperlukan di mana setiap
bitmap yang digunakan membagi ambang dengan 2.

re2c:yych:konversi = 0;
Ketika input menggunakan karakter yang ditandatangani dan -s or -b sakelar berlaku re2c
memungkinkan seseorang untuk secara otomatis mengonversi ke tipe karakter yang tidak ditandatangani yang kemudian
diperlukan untuk karakter tunggal internalnya. Ketika pengaturan ini nol atau kosong
string konversi dinonaktifkan. Menggunakan angka bukan nol, konversi diambil
dari JENIS YYC. Jika itu diberikan oleh konfigurasi di tempat, nilainya menjadi
digunakan. Kalau tidak, itu akan menjadi (YYCTYPE) dan perubahan pada konfigurasi itu tidak
lebih lama mungkin. Jika setelan ini berupa string, kurung kurawal harus ditentukan. Sekarang
dengan asumsi input Anda adalah tangki * buffer dan Anda menggunakan sakelar yang disebutkan di atas
Anda dapat mengatur JENIS YYC untuk unsigned tangki dan pengaturan ini ke 1 atau (tidak ditandatangani
arang).

re2c:definisikan:YYCONDTYPE = TIPE YYCOND ;
Enumerasi yang digunakan untuk mendukung kondisi dengan -c mode.

re2c:definisikan:YYCTXMARKER = PENANDA YYCTX ;
Mengizinkan seseorang untuk menimpa definisi PENANDA YYCTX dan dengan demikian menghindarinya dengan mengatur
nilai ke kode aktual yang dibutuhkan.

re2c: tentukan: YYCTYPE = JENIS YYC ;
Mengizinkan seseorang untuk menimpa definisi JENIS YYC dan dengan demikian menghindarinya dengan mengatur
nilai ke kode aktual yang dibutuhkan.

re2c:define:YKURSOR = YYKURSOR ;
Mengizinkan seseorang untuk menimpa definisi YYKURSOR dan dengan demikian menghindarinya dengan mengatur
nilai ke kode aktual yang dibutuhkan.

re2c:definisikan:YYDEBUG = YYDEBUG ;
Mengizinkan seseorang untuk menimpa definisi YYDEBUG dan dengan demikian menghindarinya dengan mengatur
nilai ke kode aktual yang dibutuhkan.

re2c:define:YYGETCONDITION = KONDISI YYGET ;
Substitusi untuk KONDISI YYGET. Perhatikan bahwa secara default re2c menghasilkan kawat gigi setelah
KONDISI YYGET. Mengatur re2c:define:YYGETCONDITION:telanjang ke bukan nol untuk menghilangkan kurung kurawal.

re2c:define:YYGETCONDITION:telanjang = 0;
Mengontrol kawat gigi setelah KONDISI YYGET. Jika nol, kurung kurawal dihilangkan. Jika bukan nol,
kawat gigi dihasilkan.

re2c:define:YYSETCONDITION = KONDISI YYSET ;
Substitusi untuk KONDISI YYSET. Perhatikan bahwa secara default re2c menghasilkan argumen dalam
kurung kurawal dan titik koma setelahnya KONDISI YYSET. Jika Anda perlu membuatnya KONDISI YYSET an
pernyataan sewenang-wenang daripada panggilan, set re2c:define:YYSETCONDITION:telanjang untuk
bukan nol dan gunakan re2c:define:YYSETCONDITION@cond untuk menunjukkan parameter formal di dalam
of KONDISI YYSET tubuh.

re2c:define:YYSETCONDITION@cond = @@ ;
Setiap kemunculan teks ini di dalam KONDISI YYSET akan diganti dengan
argumen yang sebenarnya.

re2c:define:YYSETCONDITION:telanjang = 0;
Mengontrol argumen dalam kurung kurawal dan titik koma setelahnya KONDISI YYSET. Jika nol, keduanya
agrument dan titik koma dihilangkan. Jika bukan nol, argumen dan titik koma adalah
dihasilkan.

re2c:define:YYGETSTATE = YYGETSTATE ;
Substitusi untuk YYGETSTATE. Perhatikan bahwa secara default re2c menghasilkan kawat gigi setelah
YYGETSTATE. Mengatur re2c:define:YYGETSTATE:telanjang ke bukan nol untuk menghilangkan kurung kurawal.

re2c:define:YYGETSTATE:telanjang = 0;
Mengontrol kawat gigi setelah YYGETSTATE. Jika nol, kurung kurawal dihilangkan. Jika bukan nol, kurung kurawal
dihasilkan.

re2c: tentukan: YYSETSTATE = YYSETSTATE ;
Substitusi untuk YYSETSTATE. Perhatikan bahwa secara default re2c menghasilkan argumen dalam kurung kurawal
dan titik koma setelah YYSETSTATE. Jika Anda perlu membuatnya YYSETSTATE sewenang-wenang
pernyataan daripada panggilan, set re2c:define:YYSETSTATE:telanjang ke bukan nol dan gunakan
re2c:define:YYSETSTATE@cond untuk menunjukkan parameter formal di dalam YYSETSTATE tubuh.

re2c:define:YYSETSTATE@status = @@ ;
Setiap kemunculan teks ini di dalam YYSETSTATE akan diganti dengan yang sebenarnya
argumen.

re2c:define:YYSETSTATE:telanjang = 0;
Mengontrol argumen dalam kurung kurawal dan titik koma setelahnya YYSETSTATE. Jika nol, keduanya agrumen
dan titik koma dihilangkan. Jika bukan nol, argumen dan titik koma akan dihasilkan.

re2c:tentukan:YYLIMIT = BATAS YY ;
Mengizinkan seseorang untuk menimpa definisi BATAS YY dan dengan demikian menghindarinya dengan mengatur
nilai ke kode aktual yang dibutuhkan.

re2c: tentukan: YYMARKER = PENANDA YY ;
Mengizinkan seseorang untuk menimpa definisi PENANDA YY dan dengan demikian menghindarinya dengan mengatur
nilai ke kode aktual yang dibutuhkan.

re2c:label:yyFillLabel = yyIsiLabel ;
Memungkinkan seseorang untuk menimpa nama label yyIsiLabel.

re2c:label:yyBerikutnya = yyBerikutnya ;
Memungkinkan seseorang untuk menimpa nama label yyBerikutnya.

re2c:variabel:yyaccept = yyaterima;
Memungkinkan seseorang untuk menimpa nama variabel terima.

re2c:variabel:yybm = yybm ;
Memungkinkan seseorang untuk menimpa nama variabel yybm.

re2c:variabel:yych = ya ;
Memungkinkan seseorang untuk menimpa nama variabel ya.

re2c:variabel:yyctable = mudah tersinggung ;
Ketika keduanya -c dan -g aktif maka re2c menggunakan variabel ini untuk menghasilkan statis
lompat meja untuk KONDISI YYGET.

re2c:variabel:yystable = stabil ;
Tidak digunakan lagi.

re2c:variabel:yytarget = target yy ;
Memungkinkan seseorang untuk menimpa nama variabel target yy.

REGULER EKSPRESI
"foo" string literal "foo". Urutan pelarian ANSI-C dapat digunakan.

'foo' string literal "foo" (karakter [a-zA-Z] diperlakukan tidak peka huruf besar-kecil). ANSI-C melarikan diri
urutan dapat digunakan.

[xyz] kelas karakter; dalam hal ini, ekspresi reguler cocok dengan x, y, atau z.

[abj-oZ]
kelas karakter dengan rentang di dalamnya; pertandingan a, b, surat apa saja dari j melalui o or Z.

[^kelas]
kelas karakter terbalik.

r \ s cocok dengan apa saja r yang bukan s. r dan s harus ekspresi reguler yang dapat
dinyatakan sebagai kelas karakter.

r* nol atau lebih kejadian dari r.

r+ satu atau lebih kejadian dari r.

r? opsional r.

(r) r; tanda kurung digunakan untuk mengesampingkan prioritas.

r s r diikuti oleh s (rangkaian).

r | s antara r or s (alternatif).

r / s r tetapi hanya jika diikuti oleh s. Catat itu s bukan bagian dari teks yang cocok.
Jenis ekspresi reguler ini disebut "konteks tambahan". Trailing konteks bisa
hanya menjadi akhir dari aturan dan bukan bagian dari definisi bernama.

r{n} korek api r persis n kali.

{n,} korek api r sekurang-kurangnya n kali.

{n,m} korek api r sekurang-kurangnya n kali, tapi tidak lebih dari m kali.

. cocok dengan karakter apa pun kecuali baris baru.

nama cocok dengan definisi bernama seperti yang ditentukan oleh nama hanya jika -F tidak aktif. Jika -F aktif
maka ini berperilaku seperti diapit dalam tanda kutip ganda dan cocok dengan string
"nama".

Kelas karakter dan literal string dapat berisi karakter oktal atau heksadesimal
definisi dan rangkaian escape sequence berikut: \a, \b, \f, \n, \r, \t, \v, \\. Sebuah
karakter oktal didefinisikan oleh garis miring terbalik diikuti oleh tiga digit oktalnya (mis \ 377).
Karakter heksadesimal dari 0 hingga 0xFF ditentukan oleh garis miring terbalik, huruf kecil x dan dua
digit heksadesimal (mis \x12). Karakter heksadesimal dari 0x100 hingga 0xFFFF ditentukan oleh
garis miring terbalik, huruf kecil \u atau huruf besar \X dan empat digit heksadesimal (mis
\u1234). Karakter heksadesimal dari 0x10000 hingga 0xFFFFffff didefinisikan dengan garis miring terbalik, dan
huruf besar \U dan delapan digit heksadesimal (mis \U12345678).

Satu-satunya aturan portabel "apa pun" adalah aturan default *.

PEMINDAI DENGAN BISA DISIMPAN NEGARA

Ketika -f bendera ditentukan, re2c menghasilkan pemindai yang dapat menyimpan statusnya saat ini,
kembali ke penelepon, dan kemudian melanjutkan operasi persis di tempat yang ditinggalkannya.

Operasi default dari re2c adalah model "tarik", di mana pemindai meminta masukan tambahan
kapanpun ia membutuhkannya. Namun, mode operasi ini mengasumsikan bahwa pemindai adalah
"pemilik" loop penguraian, dan itu mungkin tidak selalu nyaman.

Biasanya, jika ada praprosesor di depan pemindai di aliran, atau untuk itu
peduli sumber data prosedural lainnya, pemindai tidak dapat "meminta" lebih banyak data kecuali
baik pemindai dan sumber hidup di utas terpisah.

-f flag berguna hanya untuk situasi ini: memungkinkan pengguna mendesain pemindai yang berfungsi di
model "push", yaitu di mana data diumpankan ke potongan pemindai demi potongan. Ketika pemindai
kehabisan data untuk dikonsumsi, ia hanya menyimpan statusnya, dan kembali ke pemanggil. Kapan lagi
input data diumpankan ke pemindai, ia melanjutkan operasi persis di tempat yang ditinggalkannya.

Perubahan yang diperlukan dibandingkan dengan model "tarik":

· Pengguna harus menyediakan makro YYSETSTATE () dan YYGETSTATE (negara).

· Itu -f opsi menghambat deklarasi ya dan terima. Jadi pengguna harus mendeklarasikan
ini. Juga pengguna harus menyimpan dan memulihkan ini. Dalam contoh
contoh/push_model/push.re ini dideklarasikan sebagai bidang kelas (C++) di mana
pemindai adalah metode, sehingga tidak perlu disimpan/dipulihkan secara eksplisit. Untuk C mereka
misalnya bisa dibuat makro yang memilih bidang dari struktur yang diteruskan sebagai parameter.
Atau, mereka dapat dideklarasikan sebagai variabel lokal, disimpan dengan YYFILL (n) ketika
memutuskan untuk kembali dan dipulihkan saat masuk ke fungsi. Juga, bisa lebih
efisien untuk menyelamatkan negara dari YYFILL (n) karena YYSETSTATE (negara) disebut
tanpa syarat. YYFILL (n) namun tidak mendapatkan negara sebagai parameter, jadi kita akan memiliki
untuk menyimpan status dalam variabel lokal dengan YYSETSTATE (negara).

· Ubah YYFILL (n) untuk kembali (dari fungsi yang memanggilnya) jika diperlukan lebih banyak input.

· Ubah penelepon untuk mengenali jika lebih banyak masukan diperlukan dan merespons dengan tepat.

· Kode yang dihasilkan akan berisi blok sakelar yang digunakan untuk mengembalikan status terakhir
dengan melompat ke belakang corrspoding YYFILL (n) panggilan. Kode ini dibuat secara otomatis
di epilog yang pertama /*!re2c */ memblokir. Dimungkinkan untuk memicu generasi
YYGETSTATE () blok sebelumnya dengan menempatkan a /*!getstate:re2c*/ komentar. Ini terutama
berguna ketika kode pemindai harus dibungkus dalam satu lingkaran.

Silakan lihat contoh/push_model/push.re untuk pemindai model "push". Kode yang dihasilkan dapat berupa
tweak menggunakan konfigurasi inplace status: batalkan dan status: label berikutnya.

PEMINDAI DENGAN KONDISI SUPPORT

Anda dapat mendahului ekspresi reguler dengan daftar nama kondisi saat menggunakan -c
mengalihkan. Pada kasus ini re2c menghasilkan blok pemindai untuk setiap kondisi. Dimana masing-masing
blok yang dihasilkan memiliki prasyarat sendiri. Prasyarat diberikan oleh antarmuka
menetapkan KONDITON YYGET() dan harus bertipe TIPE YYCOND.

Ada dua jenis aturan khusus. Pertama, aturan kondisi <*> digabung menjadi semua
kondisi (perhatikan bahwa mereka memiliki prioritas lebih rendah daripada aturan lain dari kondisi itu). Dan
kedua daftar kondisi kosong memungkinkan seseorang untuk memberikan blok kode yang tidak memiliki
bagian pemindai. Artinya itu tidak mengizinkan ekspresi reguler apa pun. nilai kondisi
mengacu pada blok khusus ini selalu yang memiliki nilai enumerasi 0. Dengan cara ini
kode aturan khusus ini dapat digunakan untuk menginisialisasi pemindai. Ini sama sekali tidak
perlu memiliki aturan-aturan ini: tetapi kadang-kadang sangat membantu untuk memiliki dedikasi
keadaan kondisi yang tidak diinisialisasi.

Aturan yang tidak kosong memungkinkan seseorang untuk menentukan kondisi baru, yang menjadikannya aturan transisi.
Selain menghasilkan panggilan untuk definisi KONDISI YYSET tidak ada kode khusus lainnya adalah
dihasilkan.

Ada jenis aturan khusus lain yang memungkinkan seseorang untuk menambahkan kode ke blok kode apa pun dari
semua aturan dari serangkaian kondisi tertentu atau ke semua blok kode ke semua aturan. Ini bisa jadi
membantu ketika beberapa operasi umum di antara aturan. Misalnya ini dapat digunakan untuk menyimpan
panjang string yang dipindai. Aturan pengaturan khusus ini dimulai dengan tanda seru
diikuti oleh salah satu daftar kondisi <! kondisi, ... > atau bintang . Ketika re2c
menghasilkan kode untuk aturan yang statusnya tidak memiliki aturan penyiapan dan penyiapan berbintang
aturan hadir, daripada kode itu akan digunakan sebagai kode pengaturan.

pengkodean

re2c mendukung pengkodean berikut: ASCII (default), EBCDIC (-e), UCS-2 (-w), UTF-16
(-x), UTF-32 (-u) dan UTF-8 (-8). Lihat juga konfigurasi tempat re2c: bendera.

Konsep berikut harus diklarifikasi ketika berbicara tentang pengkodean. Titik kode adalah
nomor abstrak, yang mewakili simbol pengkodean tunggal. Satuan kode adalah satuan terkecil
memori, yang digunakan dalam teks yang disandikan (sesuai dengan satu karakter dalam input
sungai kecil). Satu atau lebih unit kode dapat diperlukan untuk mewakili satu titik kode, tergantung
pada pengkodean. Dalam pengkodean panjang tetap, setiap titik kode diwakili dengan sama
jumlah unit kode. Dalam pengkodean panjang variabel, titik kode yang berbeda dapat:
direpresentasikan dengan jumlah unit kode yang berbeda.

ASCII adalah pengkodean dengan panjang tetap. Ruang kodenya mencakup 0x100 poin kode, dari 0 hingga
0xFF. Satu titik kode diwakili dengan tepat satu unit kode 1-byte, yang memiliki
nilai yang sama dengan titik kode. Ukuran dari JENIS YYC harus 1 byte.

EBCDIC adalah pengkodean dengan panjang tetap. Ruang kodenya mencakup 0x100 poin kode, dari 0 hingga
0xFF. Satu titik kode diwakili dengan tepat satu unit kode 1-byte, yang memiliki
nilai yang sama dengan titik kode. Ukuran dari JENIS YYC harus 1 byte.

UCS-2 adalah pengkodean dengan panjang tetap. Ruang kodenya mencakup 0x10000 poin kode, dari 0 hingga
0xFFFF. Satu titik kode diwakili dengan tepat satu unit kode 2-byte, yang memiliki
nilai yang sama dengan titik kode. Ukuran dari JENIS YYC harus 2 byte.

UTF-16 adalah pengkodean panjang variabel. Ruang kodenya mencakup semua titik kode Unicode,
dari 0 hingga 0xD7FF dan dari 0xE000 hingga 0x10FFFF. Satu titik kode diwakili dengan
satu atau dua unit kode 2-byte. Ukuran dari JENIS YYC harus 2 byte.

UTF-32 adalah pengkodean dengan panjang tetap. Ruang kodenya mencakup semua poin kode Unicode, dari 0
ke 0xD7FF dan dari 0xE000 ke 0x10FFFF. Satu titik kode diwakili dengan tepat
satu unit kode 4-byte. Ukuran dari JENIS YYC harus 4 byte.

UTF-8 adalah pengkodean panjang variabel. Ruang kodenya mencakup semua titik kode Unicode,
dari 0 hingga 0xD7FF dan dari 0xE000 hingga 0x10FFFF. Satu titik kode diwakili dengan
urutan satu, dua, tiga atau empat unit kode 1-byte. Ukuran dari JENIS YYC harus 1
byte.

Di Unicode, nilai dari rentang 0xD800 hingga 0xDFFF (pengganti) bukan kode Unicode yang valid
poin, setiap urutan unit kode yang disandikan, yang akan dipetakan ke titik kode Unicode di
kisaran 0xD800-0xDFFF, salah bentuk. Pengguna dapat mengontrol caranya re2c memperlakukannya dengan buruk
urutan dengan --encoding-kebijakan bendera (lihat PILIHAN untuk penjelasan lengkap).

Untuk beberapa penyandian, ada unit kode, yang tidak pernah terjadi dalam aliran yang disandikan yang valid (mis
0xFF byte dalam UTF-8). Jika pemindai yang dihasilkan harus memeriksa input yang tidak valid, satu-satunya yang benar
cara melakukannya adalah dengan menggunakan aturan default *. Perhatikan, aturan lengkap itu [^] tidak akan menangkap tidak valid
unit kode ketika pengkodean panjang variabel digunakan ([^] berarti "semua poin kode yang valid", sementara
aturan bawaan * berarti "semua unit kode yang mungkin").

UMUM INPUT API

re2c biasanya beroperasi pada input menggunakan primitif seperti pointer YYKURSOR, PENANDA YY,
PENANDA YYCTX dan BATAS YY.

API masukan umum (diaktifkan dengan --memasukkan adat switch) memungkinkan seseorang untuk menyesuaikan input
operasi. Dalam mode ini, re2c akan mengekspresikan semua operasi pada input dalam hal
primitif berikut:

┌────────────────┬──────────────────────────────── ──┐
│YYPEEK () dapatkan karakter input saat ini
├────────────────┼──────────────────────────────── ──┤
│YYSKIP () maju ke karakter berikutnya
├────────────────┼──────────────────────────────── ──┤
│YYBACKUP () cadangan posisi input saat ini
├────────────────┼──────────────────────────────── ──┤
│YYBACKUPTCTX () cadangan posisi input saat ini
untuk mengikuti konteks
├────────────────┼──────────────────────────────── ──┤
│YYRESTORE () mengembalikan posisi input saat ini
├────────────────┼──────────────────────────────── ──┤
│YYRESTORECTX () mengembalikan posisi input saat ini
untuk mengikuti konteks
├────────────────┼──────────────────────────────── ──┤
│YYLESSTHAN (n) periksa jika kurang dari n masukan
karakter yang tersisa
└────────────────┴──────────────────────────────── ──┘

Beberapa tautan bermanfaat yang memberikan beberapa contoh:

1. http://skvadrik.github.io/aleph_null/posts/re2c/2015-01-13-input_model.html

2. http://skvadrik.github.io/aleph_null/posts/re2c/2015-01-15-input_model_custom.html

Gunakan re2c online menggunakan layanan onworks.net