Saltar para o conteúdo
Dialova

Documentação IRC · Iniciante

Comando TOPIC: consultar ou alterar o tópico de um canal

TOPIC consulta ou altera o tópico de um canal. O tópico ajuda quem chega a perceber o tema ou as regras; não é uma mensagem privada nem uma definição de toda a página web.

A equipa do Dialova · Verificado em

Sintaxe e parâmetros #

Sintaxe do protocolo, sem a / do cliente
TOPIC <salon> [:<nouveau-sujet>]
ParâmetroSignificado
canalCanal em questão.
novo-tópicoOmite-se para consultar; envia-se um último parâmetro vazio para apagar ou um texto para substituir.

Exemplo comentado #

Troca IRC: C = cliente, S = servidor
C: TOPIC #atelier
S: :irc.example 332 Alice #atelier :On parle création
C: TOPIC #atelier :Bienvenue, présentez vos projets
S: :Alice!alice@cloak.example TOPIC #atelier :Bienvenue, présentez vos projets

Os pseudónimos, hosts e textos desta troca são fictícios. O cliente pode apresentar as respostas de forma mais legível do que as linhas de protocolo aqui mostradas.

Respostas e erros possíveis #

RespostaSignificado
332 / 331Tópico atual ou ausência de tópico.
333Alguns servidores também fornecem autor e data.
TOPICNovo tópico transmitido aos clientes.
ErroCausa habitual
403O canal não existe.
442Não és membro.
482A alteração exige um nível que não tens.

Permissões, compatibilidade e cuidados #

Se o tópico estiver protegido por um modo, só os membros autorizados o podem alterar. O limite de comprimento pode ser anunciado por TOPICLEN em ISUPPORT.

Não incluas segredos no tópico: pode aparecer em listas, registos ou outros clientes. Uma ligação apresentada em TOPIC continua a ser um URL a verificar antes de abrir.

Perguntas frequentes #

Como apago o tópico? No protocolo, envia TOPIC #atelier : com o último parâmetro vazio; as interfaces podem disponibilizar um campo próprio.

A data do tópico é sempre apresentada? Não. A resposta adicional ou a apresentação enriquecida dependem do servidor e do cliente.

Fontes e verificação

Os exemplos usam alcunhas e domínios fictícios, salvo os pontos de ligação expressamente documentados. As extensões e definições específicas de uma rede são assinaladas no texto.