本文へ移動
Dialova

IRCドキュメント · 中級

IRCの数値応答を理解する

数値応答は、コマンド部分が三桁の数字になっているメッセージです。構造はコードとパラメーターで表されます。最後の説明文は表示用で、サーバーやその使用言語によって変わる場合があります。

Dialova運営チーム · 確認日

文章の一致ではなく構造を読む #

クライアントAliceに宛てたNAMES応答
:irc.example 353 Alice = #atelier :@Alice Bob
:irc.example 366 Alice #atelier :End of /NAMES list

この例では353が数値コマンド、Aliceが応答先です。#atelierやニックネーム一覧は、クライアントが使うパラメーターです。末尾の一覧終了の文章を、一字一句同じ識別子として判定しないでください。

よく使う応答 #

コード用途注意点
001登録完了後の歓迎応答TCP接続が開いただけの状態とは区別します。
005ISUPPORTサーバーの特性を通知します。CAP ACKではありません。
311 / 318WHOIS情報の開始と終了ほかの応答が途中に挟まる場合があります。
332 / 333トピックと関連情報333は広く使われますが、それだけでTOPIC応答全体を表すものではありません。
353 / 366NAMES一覧と終了一覧は複数行に分かれる場合があります。
401宛先が見つからないネットワークの規則を回避する権利が得られるわけではありません。
482チャンネルの権限不足クライアントのメニューだけでなく、実際の権限を確認します。
903 / 904SASLの成功と失敗9xxのコードがすべて成功というわけではありません。

歴史的な応答と拡張 #

RFCは歴史的な基本を示しており、現在のすべての応答を網羅しているわけではありません。IRCdや拡張機能がコードを追加します。クライアントは意味を推測して決めつけず、表示または適切に無視できる必要があります。WHOISにも、ネットワークや権限に応じた追加情報が含まれる場合があります。

4xxと5xxには多くのエラーがありますが、この傾向だけで機能の資料を代用することはできません。現在の拡張には、FAIL、WARN、NOTEなど構造化された応答もあります。

応答を正しい操作に結び付ける #

クライアントはイベントや複数の応答を同時に受け取れます。「次に届くメッセージ」が直前のコマンドへの応答だとは限りません。宛先のパラメーターと終了の印を確認してください。labeled-responseに対応していれば、より高度な要求と応答の対応付けに利用できます。

出典と確認

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