本文へ移動
Dialova

IRCドキュメント · 初級

TOPIC:ルームの話題を確認・変更する

TOPICはチャンネルのトピックを確認・変更します。トピックは参加者に話題や注意事項を伝えるものです。個別メッセージでも、ウェブページ全体の設定でもありません。

Dialova運営チーム · 確認日

構文とパラメーター #

プロトコル上の構文。クライアントの / は含みません。
TOPIC <チャンネル> [:<新しいトピック>]
パラメーター意味
チャンネル対象のチャンネル。
新しいトピック省略すると現在の内容を取得します。最後のパラメーターを空にすると削除され、文字列を指定すると置き換わります。

通信例と解説 #

IRCの通信例:Cはクライアント、Sはサーバー
C: TOPIC #atelier
S: :irc.example 332 Alice #atelier :ものづくりについて話しましょう
C: TOPIC #atelier :ようこそ、皆さんのプロジェクトを紹介してください
S: :Alice!alice@cloak.example TOPIC #atelier :ようこそ、皆さんのプロジェクトを紹介してください

この例のニックネーム、ホスト、本文は架空のものです。クライアント上では、生のプロトコルより読みやすい形で表示される場合があります。

主な応答とエラー #

応答説明
332 / 331現在のトピック、または未設定であることを示します。
333サーバーによっては設定者や日時の情報が追加で返されます。
TOPIC新しいトピックがクライアントへ配信されます。
エラー一般的な原因
403チャンネルが存在しません。
442チャンネルに参加していません。
482変更に必要な権限がありません。

権限・互換性・注意点 #

トピック保護モードが設定されている場合は、権限のある参加者だけが変更できます。文字数の上限がISUPPORTのTOPICLENで通知される場合もあります。

トピックには秘密の情報を書かないでください。一覧、ログ、ほかのクライアントなどに表示される可能性があります。トピック内のURLも、開く前に確認する必要があります。

よくある質問 #

トピックを消すには?プロトコルでは TOPIC #atelier : のように、最後のパラメーターを空にして送信します。クライアントには専用の入力欄がある場合もあります。

設定日時は必ず表示されますか?いいえ。追加の応答や詳しい表示があるかどうかは、サーバーとクライアントによって異なります。

出典と確認

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