Prototype : int ascii_strcasecmp (t_weechat_plugin *plugin, char *chaine1, char *chaine2)
Effectue une comparaison entre deux chaînes, sans tenir compte des majuscules/minuscules ni de la locale.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
chaine1
: la première chaîne à comparer
chaine2
: la deuxième chaîne à comparer
Valeur renvoyée : la différence entre les deux chaînes : négatif si chaine1 < chaine2, zéro si chaine1 == chaine2, positif si chaine1 > chaine2
Exemple :
if (plugin->ascii_strcasecmp (plugin, "abc", "def") != 0) ...
Prototype : int ascii_strncasecmp (t_weechat_plugin *plugin, char *chaine1, char *chaine2, int max)
Effectue une comparaison entre deux chaînes, sans tenir compte des majuscules/minuscules ni de la locale, en comparant au plus "max" caractères.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
chaine1
: la première chaîne à comparer
chaine2
: la deuxième chaîne à comparer
max
: nombre de caractères max à comparer
Valeur renvoyée : la différence entre les deux chaînes : négatif si chaine1 < chaine2, zéro si chaine1 == chaine 2, positif si chaine1 > chaine2
Exemple :
if (plugin->ascii_strncasecmp (plugin, "abc", "def", 2) != 0) ...
Prototype : char **explode_string (t_weechat_plugin *plugin, char *chaine, char *separateurs, int num_items_max, int *num_items)
Explose une chaîne en plusieurs selon un/des délimiteur(s).
Paramètres :
plugin
: pointeur vers la structure
de l'extension
chaine
: la chaîne à exploser
separateurs
: les délimiteurs utilisés
pour exploser la chaîne
num_items_max
: nombre maximum de
sous-chaînes créées (0 = pas de limite)
num_items
: pointeur vers un entier qui
contiendra le nombre de sous-chaînes créées en retour
Valeur renvoyée : un tableau de chaînes, ou NULL si un problème a été rencontré.
Note : le résultat doit être libéré par un appel à la fonction "free_exploded_string" après utilisation.
Exemple :
char **argv; int argc; argv = plugin->explode_string (plugin, chaine, " ", 0, &argc); ... if (argv != NULL) plugin->free_exploded_string (plugin, argv);
Prototype : char **free_exploded_string (t_weechat_plugin *plugin, char **chaine)
Libère la mémoire utilisée pour une explosion de chaîne.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
chaine
: la chaîne explosée par la fonction
"explode_string"
Valeur renvoyée : aucune.
Exemple :
char *argv; int argc; argv = plugin->explode_string (plugin, chaine, " ", 0, &argc); ... if (argv != NULL) plugin->free_exploded_string (plugin, argv);
Prototype : void exec_on_files (t_weechat_plugin *plugin, char *repertoire, int (*callback)(t_weechat_plugin *, char *))
Exécute une fonction sur tous les fichiers d'un répertoire.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
repertoire
: le répertoire où les fichiers
sont recherchés
callback
: une fonction appelée pour chaque
fichier trouvé
Valeur renvoyée : aucune.
Exemple :
int callback (t_weechat_plugin *plugin, char *fichier) { plugin->print_server (plugin, "fichier: %s", fichier); return 1; } ... plugin->exec_on_files (plugin, "/tmp", &callback);
Prototype : void print (t_weechat_plugin *plugin, char *serveur, char *canal, char *message, ...)
Affiche un message sur un tampon WeeChat, identifié par le serveur et le canal (tous deux pouvant être NULL pour le tampon courant).
Paramètres :
plugin
: pointeur vers la structure
de l'extension
serveur
: nom interne du serveur pour
trouver le tampon dans lequel afficher (peut être NULL)
canal
: nom du canal pour trouver le
tampon dans lequel afficher (peut être NULL)
message
: message à afficher
Valeur renvoyée : aucune.
Exemples :
plugin->print (plugin, NULL, NULL, "hello"); plugin->print (plugin, NULL, "#weechat", "hello"); plugin->print (plugin, "freenode", "#weechat", "hello");
Prototype : void print_server (t_weechat_plugin *plugin, char *message, ...)
Affiche un message sur le tampon du serveur courant.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
message
: message à afficher
Valeur renvoyée : aucune.
Exemple :
plugin->print_server (plugin, "hello");
Prototype : void print_infobar (t_weechat_plugin *plugin, int temps, char *message, ...)
Affiche un message sur la barre d'infos pour un temps déterminé.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
temps
: temps (en secondes) pendant lequel
le message est affiché (0 = jamais effacé)
Valeur renvoyée : aucune.
Exemple :
plugin->print_infobar (plugin, 5, "hello");
Prototype : void infobar_remove (t_weechat_plugin *plugin, int nombre)
Efface un ou plusieurs messages dans la pile de la barre d'infos.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
nombre
: nombre de messages à supprimer
(si paramètre non présent ou <= 0, alors tous les messages
sont effacés)
Valeur renvoyée : aucune.
Exemple :
plugin->infobar_remove (1);
Prototype : void log (t_weechat_plugin *plugin, char *serveur, char *canal, char *message, ...)
Ecrit un message dans le fichier de log pour un serveur ou un canal.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
serveur
: nom interne du serveur pour
trouver le log du tampon (peut être NULL)
canal
: nom du canal pour trouver le
tampon le log du tampon (peut être NULL)
message
: message
Valeur renvoyée : aucune.
Exemple :
plugin->log (plugin, "freenode", "#weechat", "test");
Prototype : t_plugin_handler *msg_handler_add (t_weechat_plugin *plugin, char *message, t_plugin_handler_func *fonction, char *handler_args, void *handler_pointer)
Ajoute un gestionnaire de messages IRC, appelé dès qu'un message IRC est reçu.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
message
: nom du message IRC pour lequel la
fonction est appelée.
Pour connaître la liste des messages IRC disponibles, merci
de consulter les RFCs
1459 et
2812.
De plus, vous pouvez utiliser un nom spécial, préfixé par
"weechat_" pour capturer des évènements spéciaux, comme décrit
dans le tableau ci-dessous :
Nom | Description |
---|---|
weechat_pv | message privé reçu |
weechat_highlight | message avec highlight (sur un canal ou en privé) |
weechat_ctcp | message CTCP reçu (VERSION, PING, etc...) |
weechat_dcc | message DCC reçu (discussion ou fichier) |
fonction
: fonction appelée lorsque le
message est reçu
handler_args
: paramètres passés à la
fonction appelée
handler_pointer
: pointeur passé à la
fonction appelée
Valeur renvoyée : le pointeur vers le nouveau gestionnaire de messages.
Note : la fonction appelée lorsque le message est reçu doit renvoyer une des valeurs suivantes :
PLUGIN_RC_KO
: la fonction a échoué
PLUGIN_RC_OK
: la fonction a réussi
PLUGIN_RC_OK_IGNORE_WEECHAT
: le message
ne sera pas transmis à WeeChat
PLUGIN_RC_OK_IGNORE_PLUGINS
: le message
ne sera pas transmis à d'autres extensions
PLUGIN_RC_OK_IGNORE_ALL
: le message
ne sera ni transmis à WeeChat ni à d'autres extensions
Exemple :
int msg_kick (t_weechat_plugin *plugin, char *serveur, char *commande, char *arguments, char *handler_args, void *handler_pointer) { plugin->print (plugin, serveur, NULL, "KICK reçu"); return PLUGIN_RC_OK; } ... plugin->msg_handler_add (plugin, "KICK", &msg_kick, NULL, NULL);
Prototype : t_plugin_handler *cmd_handler_add (t_weechat_plugin *plugin, char *commande, char *description, char *arguments, char *arguments_description, char *modele_completion, t_plugin_handler_func *fonction, char *handler_args, void *handler_pointer)
Ajoute un gestionnaire de commande WeeChat, appelé dès que l'utilisateur utilise la commande (par exemple /commande).
Paramètres :
plugin
: pointeur vers la structure
de l'extension
commande
: nom de la nouvelle commande,
qui peut être une commande déjà existante (attention la
commande remplacée ne sera plus disponible jusqu'à ce que
l'extension soit déchargée)
description
: brève description de la
commande (affichée par /help commande)
arguments
: brève description des
paramètres de la commande (affichée par /help commande)
arguments_description
: longue description
des paramètres de la commande (affichée par /help commande)
modele_completion
: modèle pour la
complétion sous la forme "abc|%w def|%i
"
qui signifie "abc" ou une commande WeeChat pour le premier
paramètre, et "def" ou une commande IRC pour le deuxième.
Une chaîne vide indique à WeeChat de compléter tout
paramètre avec un pseudo du canal courant, une valeur NULL
désactive toute complétion pour tous les paramètres de la
commande.
Les codes suivants peuvent être utilisés :
Code | Description |
---|---|
%- | aucune complétion pour le paramètre |
%a | alias |
%A | alias et commandes (WeeChat, IRC et extensions) |
%c | canal courant |
%C | canaux du serveur courant |
%h | commandes définies par des extensions |
%i | commandes IRC (envoyées) |
%I | commandes IRC (reçues) |
%k | fonctions associées aux touches |
%n | pseudos du canal courant |
%o | options de configuration |
%p | message de "part" par défaut |
%q | message de "quit" par défaut |
%s | nom du serveur courant |
%S | tous les serveurs |
%t | titre du canal courant |
%v | valeur d'une option de configuration |
%w | commandes WeeChat |
fonction
: fonction appelée lorsque la
commande est exécutée
handler_args
: paramètres passés à la
fonction appelée
handler_pointer
: pointeur passé à la
fonction appelée
Valeur renvoyée : le pointeur vers le nouveau gestionnaire de commande.
Note : la fonction appelée lorsque la commande est exécutée doit renvoyer une des valeurs suivantes :
PLUGIN_RC_KO
: la fonction a échoué
PLUGIN_RC_OK
: la fonction a réussi
Exemple :
int cmd_test (t_weechat_plugin *plugin, char *serveur, char *commande, char *arguments, char *handler_args, void *handler_pointer) { plugin->print (plugin, serveur, NULL, "commande test, pseudo: %s", (arguments) ? arguments : "aucun"); return PLUGIN_RC_OK; } ... plugin->cmd_handler_add (plugin, "test", "Commande test", "[pesudo]", "pseudo: un pseudo du canal", "%n", &cmd_test, NULL, NULL);
Prototype : t_plugin_handler *timer_handler_add (t_weechat_plugin *plugin, int intervalle, t_plugin_handler_func *fonction, char *handler_args, void *handler_pointer)
Ajoute un gestionnaire de temps, qui appelle périodiquement une fonction.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
intervalle
: intervalle (en secondes)
entre deux appels de la fonction.
fonction
: fonction appelée
handler_args
: paramètres passés à la
fonction appelée
handler_pointer
: pointeur passé à la
fonction appelée
Valeur renvoyée : le pointeur vers le nouveau gestionnaire de messages.
Note : la fonction appelée doit renvoyer une des valeurs suivantes :
PLUGIN_RC_KO
: la fonction a échoué
PLUGIN_RC_OK
: la fonction a réussi
Exemple :
int mon_timer (t_weechat_plugin *plugin, char *serveur, char *commande, char *arguments, char *handler_args, void *handler_pointer) { plugin->print (plugin, NULL, NULL, "mon timer"); return PLUGIN_RC_OK; } ... plugin->timer_handler_add (plugin, 60, &mon_timer);
Prototype : void handler_remove (t_weechat_plugin *plugin, t_plugin_handler *handler)
Supprime un gestionnaire.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
handler
: le gestionnaire à supprimer
Valeur renvoyée : aucune.
Exemple :
plugin->handler_remove (plugin, mon_handler);
Prototype : void handler_remove_all (t_weechat_plugin *plugin)
Supprime tous les gestionnaires d'une extension.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
Valeur renvoyée : aucune.
Exemple :
plugin->handler_remove_all (plugin);
Prototype : void exec_command (t_weechat_plugin *plugin, char *serveur, char *canal, char *commande)
Execute une commande WeeChat ou envoie un message à un canal.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
serveur
: nom interne du serveur où
exécuter la commande (peut être NULL)
canal
: nom du canal où exécuter la
commande (peut être NULL)
commande
: la commande à exécuter
Valeur renvoyée : aucune.
Exemples :
plugin->exec_command (plugin, NULL, NULL, "/help nick"); plugin->exec_command (plugin, "freenode", "#weechat", "bonjour");
Prototype : char *get_info (t_weechat_plugin *plugin, char *info, char *serveur)
Renvoie une information sur WeeChat ou un canal.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
info
: nom de l'info à obtenir :
Info | Description |
---|---|
version | version de WeeChat |
nick | pesudo |
channel | nom du canal (NULL pour un serveur ou un privé) |
server | nom du serveur |
away | drapeau "away" |
inactivity | nombre de secondes écoulées depuis que la dernière touche a été appuyée |
weechat_dir | répertoire maison de WeeChat (par défaut: ~/.weechat/) |
weechat_libdir | répertoire "lib" système de WeeChat |
weechat_sharedir | répertoire "share" système de WeeChat |
serveur
: nom interne du serveur où
récupérer l'information (si nécessaire)
Valeur renvoyée : l'information recherchée, NULL si non trouvée.
Note : le résultat doit être libéré par un appel à la fonction "free" après utilisation.
Exemples :
char *version = plugin->get_info (plugin, "version", NULL); char *nick = plugin->get_info (plugin, "nick", "freenode"); char *inactivity = plugin->get_info (plugin, "inactivity", NULL); plugin->print (plugin, NULL, NULL, "WeeChat version %s, vous êtes %s sur freenode " "(inactif depuis %s secondes)", version, nick, inactivity); free (version); free (nick); free (inactivity);
Prototype : t_plugin_info_dcc *get_dcc_info (t_weechat_plugin *plugin)
Renvoie la liste des DCC en cours ou terminés.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
Valeur renvoyée : la liste chaînée des DCC.
Type | Champ | Description |
---|---|---|
char * | server | le serveur IRC |
char * | channel | le canal IRC |
int | type | le type de DCC : 0 = discussion reçue, 1 = discussion envoyée, 2 = fichier reçu, 3 = fichier envoyé |
int | status | le statut du DCC : 0 = en attente, 1 = en cours de connexion, 2 = actif, 3 = terminé, 4 = échoué, 5 = interrompu par l'utilisateur |
time_t | start_time | la date et heure de création du DCC |
time_t | start_transfer | la date et heure de démarrage du transfert |
unsigned long | addr | adresse IP de l'utilisateur distant |
int | port | port utilisé pour le DCC |
char * | nick | pseudo de l'utilisateur distant |
char * | filename | nom de fichier |
char * | local_filename | nom de fichier local |
int | filename_suffix | suffixe si renommage de fichier |
unsigned long | size | taille du fichier |
unsigned long | pos | position actuelle dans le fichier |
unsigned long | start_resume | position de démarrage après une interruption |
unsigned long | bytes_per_sec | nombre d'octets transmis par seconde depuis le début du transfert |
t_plugin_dcc_info * | prev_dcc | pointeur vers l'info DCC précédente |
t_plugin_dcc_info * | next_dcc | pointeur vers l'info DCC suivante |
Note : le résultat doit être libéré par un appel à la fonction "free_dcc_info" après utilisation.
Exemples :
t_plugin_dcc_info *dcc_info = plugin->get_dcc_info (plugin); for (ptr_dcc = dcc_info; ptr_dcc; ptr_dcc = ptr_dcc->next_dcc) { plugin->print_server (plugin, "DCC type=%d, avec: %s", ptr_dcc->type, ptr_dcc->nick); } if (dcc_info) plugin->free_dcc_info (plugin, dcc_info);
Prototype : void free_dcc_info (t_weechat_plugin *plugin, t_plugin_dcc_info *dcc_info)
Libère la mémoire utilisée par une liste de DCC.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
dcc_info
: pointeur vers la liste DCC
renvoyée par la fonction "get_dcc_info"
Valeur renvoyée : aucune.
Exemple :
plugin->free_dcc_info (plugin, dcc_info);
Prototype : t_plugin_server_info *get_server_info (t_weechat_plugin *plugin)
Renvoie la liste des serveurs IRC (connectés ou non).
Paramètres :
plugin
: pointeur vers la structure
de l'extension
Valeur retournée : la liste chaînée des serveurs IRC.
Type | Champ | Description |
---|---|---|
char * | name | nom interne du serveur |
int | autoconnect | 1 si auto-connexion au démarrage, 0 sinon |
int | autoreconnect | 1 si auto-reconnexion quand déconnecté, 0 sinon |
int | autoreconnect_delay | délai avant de tenter une reconnexion |
int | command_line | 1 si le serveur vient de la ligne de commande (donc temporaire), 0 sinon |
char * | address | adresse du serveur (nom ou IP) |
int | port | port |
int | ipv6 | connexion IPv6 |
int | ssl | connexion SSL |
char * | password | mot de passe pour le serveur |
char * | nick1 | premier pseudo |
char * | nick2 | pseudo alternatif |
char * | nick3 | second pseudo alternatif |
char * | username | nom d'utilisateur |
char * | real name | nom réel |
char * | command | commande exécutée une fois connecté |
int | command_delay | délai après exécution de la commande |
char * | autojoin | canaux joints automatiquement |
int | autorejoin | 1 si les canaux sont rejoints après un "kick", 0 sinon |
char * | notify_levels | niveaux de notification des canaux |
char * | charset_decode_iso | jeux de caractères de décodage ISO pour les canaux |
char * | charset_decode_utf | jeux de caractères de décodage UTF pour les canaux |
char * | charset_encode | jeux de caractères d'encodage pour les canaux |
int | is_connected | 1 si connecté au serveur, 0 sinon |
int | ssl_connected | 1 si connecté via SSL, 0 sinon |
char * | nick | pseudo courant |
int | is_away | 1 si absent, 0 sinon |
time_t | away_time | date/heure à laquelle l'utilisateur a été marqué absent |
int | lag | lag (en millisecondes) |
t_plugin_server_info * | prev_server | pointeur vers les infos du serveur précédent |
t_plugin_server_info * | next_server | pointeur vers les infos du serveur suivant |
Note : le résultat doit être libéré par un appel à la fonction "free_server_info" après utilisation.
Exemple :
t_plugin_server_info *server_info, *ptr_server_info; server_info = plugin->get_server_info (plugin); if (server_info) { for (ptr_server_info = server_info; ptr_server_info; ptr_server_info = ptr_server_info->next_server) { plugin->print (plugin, NULL, NULL, "serveur: %s, addresse: %s, port: %d %s", ptr_server_info->name, ptr_server_info->address, ptr_server_info->port, (ptr_server_info->is_connected) ? "(connecté)" : ""); } plugin->free_server_info (plugin, server_info); }
Prototype : void free_server_info (t_weechat_plugin *plugin, t_plugin_server_info *server_info)
Libère la mémoire utilisée par une liste de serveurs.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
server_info
: pointeur vers la liste de
serveurs retournée par la fonction "get_server_info"
Valeur renvoyée : aucune.
Exemple :
plugin->free_server_info (plugin, server_info);
Prototype : t_plugin_channel_info *get_channel_info (t_weechat_plugin *plugin, char *serveur)
Renvoie la liste des canaux IRC pour un serveur.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
serveur
: nom interne du serveur
Valeur renvoyée : la liste chaînée des canaux IRC du serveur.
Type | Field | Description |
---|---|---|
int | type | 0 pour un canal, 1 pour un privé |
char * | name | nom du canal |
char * | topic | titre du canal |
char * | modes | modes du canal |
int | limit | limite d'utilisateurs |
char * | key | clé du canal |
int | nicks_count | nombre de pseudos présents sur le canal |
t_plugin_channel_info * | prev_channel | pointeur vers les infos du canal précédent |
t_plugin_channel_info * | next_channel | pointeur vers les infos du canal suivant |
Note : le résultat doit être libéré par un appel à la fonction "free_channel_info" après utilisation.
Exemple :
t_plugin_channel_info *channel_info, *ptr_chan_info; channel_info = plugin->get_channel_info (plugin, "freenode"); if (channel_info) { for (ptr_chan_info = channel_info; ptr_chan_info; ptr_chan_info = ptr_chan_info->next_channel) { plugin->print (plugin, NULL, NULL, " %s (type %d)", ptr_chan_info->name, ptr_chan_info->type); } plugin->free_channel_info (plugin, channel_info); }
Prototype : void free_channel_info (t_weechat_plugin *plugin, t_plugin_channel_info *channel_info)
Libère la mémoire utilisée par une liste de canaux.
Arguments:
plugin
: pointeur vers la structure
de l'extension
channel_info
: pointeur vers la liste de
canaux retournée par la fonction "get_channel_info"
Valeur renvoyée : aucune.
Exemple :
plugin->free_channel_info (plugin, channel_info);
Prototype : t_plugin_nick_info *get_nick_info (t_weechat_plugin *plugin, char *serveur, char *canal)
Renvoie la liste des pseudos pour un canal.
Arguments:
plugin
: pointeur vers la structure
de l'extension
serveur
: nom interne du serveur
canal
: nom du canal
Valeur renvoyée : la liste chaînée des pseudos présents sur le canal.
Type | Champ | Description |
---|---|---|
char * | nick | pseudo |
int | flags | propriétés du pseudo, "ou" binaire entre plusieurs valeurs (1 =propriétaire du canal, 2 = administrateur du canal, 4 = op, 8 = demi-op, 16 = voix, 32 = absent) |
t_plugin_nick_info * | prev_nick | pointeur vers les infos du pseudo précédent |
t_plugin_nick_info * | next_nick | pointeur vers les infos du pseudo précédent |
Note : le résultat doit être libéré par un appel à la fonction "free_nick_info" après utilisation.
Exemple :
t_plugin_nick_info *nick_info, *ptr_nick_info; nick_info = plugin->get_nick_info (plugin, "freenode", "#weechat"); if (nick_info) { for (ptr_nick_info = nick_info; ptr_nick_info; ptr_nick_info = ptr_nick_info->next_nick) { plugin->print (plugin, NULL, NULL, " %s (flags: %d)", ptr_nick_info->nick, ptr_nick_info->flags); } plugin->free_nick_info (plugin, nick_info); }
Prototype : void free_nick_info (t_weechat_plugin *plugin, t_plugin_nick_info *nick_info)
Libère la mémoire utilisée par une liste de pseudos.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
nick_info
: pointeur vers la liste de
pseudos retournée par la fonction "get_nick_info"
Valeur renvoyée : aucune.
Exemple :
plugin->free_nick_info (plugin, nick_info);
Prototype : char *get_config (t_weechat_plugin *plugin, char *option)
Renvoie la valeur d'une option de configuration WeeChat.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
option
: nom de l'option à lire
Valeur renvoyée : la valeur de l'option, NULL si non trouvée.
Note : le résultat doit être libéré par un appel à la fonction "free" après utilisation.
Exemples :
char *value1 = plugin->get_config (plugin, "look_set_title"); char *value2 = plugin->get_config (plugin, "freenode.server_autojoin");
Prototype : int set_config (t_weechat_plugin *plugin, char *option, char *valeur)
Modifie la valeur d'une option de configuration WeeChat.
Paramètres :
plugin
: pointeur vers la structure
de l'extension
option
: nom de l'option à mettre à jour
valeur
: nouvelle valeur pour l'option
Valeur renvoyée : 1 si l'option a été modifiée avec succès, 0 si une erreur s'est produite.
Exemple :
plugin->set_config (plugin, "look_nicklist", "off");
Prototype : char *get_plugin_config (t_weechat_plugin *plugin, char *option)
Renvoie la valeur d'une option de l'extension.
L'option est lue depuis le fichier
"~/.weechat/plugins.rc
" et est
sous cette forme : "extension.option=valeur
"
(NB : le nom de l'extension est ajouté automatiquement).
Paramètres :
plugin
: pointeur vers la structure
de l'extension
option
: nom de l'option à lire
Valeur renvoyée : la valeur de l'option, NULL si non trouvée.
Note : le résultat doit être libéré par un appel à la fonction "free" après utilisation.
Exemple :
char *value = plugin->get_plugin_config (plugin, "ma_variable");
Prototype : int set_plugin_config (t_weechat_plugin *plugin, char *option, char *valeur)
Modifie la valeur d'une option de l'extension.
L'option est écrite dans le fichier
"~/.weechat/plugins.rc
" et est
sous cette forme : "extension.option=valeur
"
(NB : le nom de l'extension est ajouté automatiquement).
Paramètres :
plugin
: pointeur vers la structure
de l'extension
option
: nom de l'option à mettre à jour
valeur
: nouvelle valeur pour l'option
Valeur renvoyée : 1 si l'option a été modifiée avec succès, 0 si une erreur s'est produite.
Exemple :
plugin->set_plugin_config (plugin, "ma_variable", "valeur");