Перейти к содержимому
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Для изменения требуется статус, которого у вас нет.

Права, совместимость и меры предосторожности #

Если включена защита темы, изменить её могут только участники с необходимыми правами. Максимальная длина может объявляться как TOPICLEN в ISUPPORT.

Не размещайте секреты в теме: она может отображаться в списках, журналах и других клиентах. Ссылка в TOPIC не становится безопасной: проверяйте адрес перед переходом.

Частые вопросы #

Как удалить тему? В протоколе отправьте TOPIC #atelier : с пустым последним параметром. В интерфейсе для этого может быть отдельное поле.

Всегда ли видна дата изменения темы? Нет. Дополнительный ответ сервера и расширенное отображение зависят от сервера и клиента.

Источники и проверка

В примерах используются вымышленные ники и домены, кроме явно указанных реальных точек подключения. Расширения и настройки отдельных сетей отмечены в тексте.