本文へ移動
Dialova

IRCドキュメント · 上級

IRCメッセージの形式を読む

IRCメッセージはCRLFで終わり、タグ、送信元、コマンド、パラメーターを含む場合があります。TCPで一度に届くデータが、一行分とは限りません。内容を解釈する前に、メッセージの区切りを処理する必要があります。

Dialova運営チーム · 確認日

一行の構造を分解する #

メッセージの例。末尾のCRLFは省略しています。
@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の空白です。最後のパラメーターはコロンで始められ、その後は空白を含めてすべて同じパラメーターに属します。行全体を単純に空白で分割すると、この情報を失ってしまいます。

それぞれCRLFで終わる三つの独立したメッセージ
TOPIC #atelier :
PRIVMSG Bob :スペースを含むテキスト
PING :jeton-123

最初の例は最後のパラメーターが空で、二つ目は空白を含む本文です。ほかの例で使うC/Sは説明用の方向表示であり、実際に送信するバイトには含まれません。

長さ・バイト数・文字コード #

従来のIRCメッセージの上限は、末尾のCRLFを含めて512バイトです。512文字ではありません。UTF-8では一文字に複数バイトを使う場合があります。IRCv3のタグには独自の追加上限がありますが、本文を無制限に長くできるわけではありません。

歴史的なIRCでは、すべての本文に共通の文字コードが保証されていません。現在のクライアントやネットワークではUTF-8がよく使われ、IRCv3のタグ値はUTF-8が必須です。ネットワークの方針と不正な入力の扱いを確認し、自動で文字コードが交渉されると決めつけないでください。

安定したメッセージ解析のために #

  • 終端までバイトを蓄積し、残った断片を保持します。
  • 一度に複数行が届く場合と、一行が複数回に分かれて届く場合の両方に対応します。
  • 改行を待ち続ける前に、保持するメモリーに上限を設けます。
  • タグを取り出してデコードし、その後に送信元、コマンド、パラメーターを解析します。
  • 過去のイベントを、現在の状態を変更する新しい操作として実行しないでください。

出典と確認

例では、明記した接続先を除き、架空のニックネームとドメインを使用しています。特定のネットワークだけにある拡張や設定は、本文で区別しています。