IRCドキュメント · 上級
IRCメッセージの形式を読む
IRCメッセージはCRLFで終わり、タグ、送信元、コマンド、パラメーターを含む場合があります。TCPで一度に届くデータが、一行分とは限りません。内容を解釈する前に、メッセージの区切りを処理する必要があります。
Dialova運営チーム · 確認日
一行の構造を分解する #
@time=2026-10-29T10:00:00.000Z :Alice!alice@cloak.example PRIVMSG #atelier :Bonjour tout le monde| 部分 | この例の値 | 役割 |
|---|---|---|
| タグ | @time=… | 最初の区切り空白より前にあるメタデータ。 |
| 送信元・プレフィックス | :Alice!alice@cloak.example | サーバーが示す送信者。 |
| コマンド | PRIVMSG | プロトコル上の操作。 |
| 宛先パラメーター | #atelier | 送信先。 |
| 最後のパラメーター | :Bonjour tout le monde | 空白を含む一つのパラメーター。先頭のコロンは本文に含まれません。 |
空白と最後のパラメーター #
基本の区切りはASCIIの空白です。最後のパラメーターはコロンで始められ、その後は空白を含めてすべて同じパラメーターに属します。行全体を単純に空白で分割すると、この情報を失ってしまいます。
TOPIC #atelier :
PRIVMSG Bob :スペースを含むテキスト
PING :jeton-123最初の例は最後のパラメーターが空で、二つ目は空白を含む本文です。ほかの例で使うC/Sは説明用の方向表示であり、実際に送信するバイトには含まれません。
長さ・バイト数・文字コード #
従来のIRCメッセージの上限は、末尾のCRLFを含めて512バイトです。512文字ではありません。UTF-8では一文字に複数バイトを使う場合があります。IRCv3のタグには独自の追加上限がありますが、本文を無制限に長くできるわけではありません。
歴史的なIRCでは、すべての本文に共通の文字コードが保証されていません。現在のクライアントやネットワークではUTF-8がよく使われ、IRCv3のタグ値はUTF-8が必須です。ネットワークの方針と不正な入力の扱いを確認し、自動で文字コードが交渉されると決めつけないでください。
安定したメッセージ解析のために #
- 終端までバイトを蓄積し、残った断片を保持します。
- 一度に複数行が届く場合と、一行が複数回に分かれて届く場合の両方に対応します。
- 改行を待ち続ける前に、保持するメモリーに上限を設けます。
- タグを取り出してデコードし、その後に送信元、コマンド、パラメーターを解析します。
- 過去のイベントを、現在の状態を変更する新しい操作として実行しないでください。
出典と確認
例では、明記した接続先を除き、架空のニックネームとドメインを使用しています。特定のネットワークだけにある拡張や設定は、本文で区別しています。
- Modern IRC — クライアントプロトコル仕様 ↗仕様の出典 · 2026-10-29確認
- RFC 2812 — クライアントプロトコル(2000年) ↗歴史資料の出典 · 2026-10-29確認
- IRCv3 — メッセージタグ ↗仕様の出典 · 2026-10-29確認