Langsung ke konten
Dialova

Dokumentasi IRC · Lanjutan

Membaca dan mengurai format pesan IRC

Pesan IRC diakhiri CRLF. Pesan dapat memiliki tag, sumber, perintah, dan parameter. Pada TCP, satu bagian data yang diterima belum tentu merupakan baris lengkap: pemisahan pesan harus dilakukan sebelum penafsiran.

Tim Dialova · Diperiksa pada

Menguraikan satu baris #

Contoh pesan; CRLF terakhir tidak ditampilkan
@time=2026-10-29T10:00:00.000Z :Alice!alice@cloak.example PRIVMSG #atelier :Bonjour tout le monde
BagianNilai pada contoh iniPeran
Tags@time=…Metadata, sebelum spasi pemisah pertama.
Sumber / prefiks:Alice!alice@cloak.examplePenulis yang dinyatakan server.
PerintahPRIVMSGTindakan protokol.
Parameter target#atelierTujuan.
Parameter terakhir:Bonjour tout le mondeParameter berisi spasi; tanda titik dua bukan bagian dari teks.

Spasi dan parameter terakhir #

Pemisah dasar adalah spasi ASCII. Parameter terakhir dapat diawali titik dua; semua yang mengikuti menjadi bagian parameter tersebut, termasuk spasi. Memecah seluruh baris berdasarkan spasi saja akan menghilangkan informasi ini.

Tiga pesan terpisah, masing-masing diakhiri CRLF
TOPIC #atelier :
PRIVMSG Bob :teks dengan spasi
PING :jeton-123

Contoh pertama memiliki parameter terakhir kosong; contoh kedua berisi teks dengan spasi. Penanda arah C/S dalam contoh lain di panduan tidak pernah menjadi bagian byte yang dikirim.

Panjang, byte, dan pengodean #

Batas historis pesan IRC adalah 512 byte, termasuk CRLF. Ini bukan 512 karakter: satu karakter UTF-8 dapat memakai beberapa byte. Tag IRCv3 memiliki batas tambahan sendiri, yang tidak membuat bagian pesan lainnya menjadi tanpa batas.

IRC historis tidak menjamin satu pengodean untuk semua teks. Klien dan jaringan modern umum memakai UTF-8, dan nilai tag IRCv3 harus berupa UTF-8. Periksa kebijakan jaringan serta penanganan masukan tidak valid; jangan mengarang negosiasi pengodean otomatis.

Parser yang tangguh #

  • Kumpulkan byte hingga terminator lengkap dan simpan fragmen yang tersisa.
  • Tangani beberapa baris dalam satu pembacaan jaringan dan satu baris yang terpecah dalam beberapa pembacaan.
  • Batasi memori sebelum menunggu akhir baris tanpa batas waktu.
  • Pisahkan dan dekode bagian tag, lalu sumber, perintah, dan parameter.
  • Jangan jalankan peristiwa historis sebagai perubahan keadaan saat ini.

Sumber dan verifikasi

Contoh menggunakan nama panggilan dan domain fiktif, kecuali titik koneksi yang didokumentasikan secara eksplisit. Ekstensi dan pengaturan khusus jaringan dijelaskan dalam teks.