Vai al contenuto
Dialova

Documentazione IRC · Principiante

Comando TOPIC: leggere o modificare l’argomento di un canale

TOPIC legge o modifica l’argomento di un canale. L’argomento aiuta chi arriva a comprenderne il tema o le regole; non è un messaggio privato né un’impostazione dell’intera pagina web.

Il team di Dialova · Verificato il

Sintassi e parametri #

Sintassi del protocollo, senza la / del client
TOPIC <salon> [:<nouveau-sujet>]
ParametroSignificato
canaleCanale interessato.
nuovo-argomentoAssente per leggere; ultimo parametro vuoto per cancellare; testo presente per sostituire.

Esempio commentato #

Scambio IRC: C = client, S = server
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

Nickname, host e testi di questo scambio sono fittizi. Il client può mostrare le risposte in una forma più leggibile rispetto alle righe del protocollo qui riportate.

Risposte e possibili errori #

RispostaSignificato
332 / 331Argomento attuale o assenza di un argomento.
333Autore e data possono essere forniti in aggiunta, a seconda del server.
TOPICNuovo argomento trasmesso ai client.
ErroreCausa abituale
403Il canale non esiste.
442Non fai parte del canale.
482La modifica richiede un grado che non possiedi.

Permessi, compatibilità e precauzioni #

Quando l’argomento è protetto da una modalità, solo gli utenti autorizzati possono modificarlo. Il limite di lunghezza può essere annunciato tramite TOPICLEN in ISUPPORT.

Non inserire segreti nell’argomento: può comparire in elenchi, log o altri client. Un link mostrato in TOPIC resta un URL da verificare prima di aprirlo.

Domande frequenti #

Come cancello l’argomento? Nel protocollo, invia TOPIC #atelier : con l’ultimo parametro vuoto; le interfacce possono offrire un campo dedicato.

La data dell’argomento è sempre visibile? No. La risposta aggiuntiva o la visualizzazione arricchita dipendono dal server e dal client.

Fonti e verifica

Gli esempi usano nickname e domini fittizi, tranne gli endpoint esplicitamente documentati. Le estensioni e le impostazioni specifiche di una rete sono indicate nel testo.