summaryrefslogtreecommitdiff
path: root/doc/fr/weechat_plugin_api.fr.adoc
diff options
context:
space:
mode:
Diffstat (limited to 'doc/fr/weechat_plugin_api.fr.adoc')
-rw-r--r--doc/fr/weechat_plugin_api.fr.adoc42
1 files changed, 30 insertions, 12 deletions
diff --git a/doc/fr/weechat_plugin_api.fr.adoc b/doc/fr/weechat_plugin_api.fr.adoc
index 54092008b..3df7bc2d8 100644
--- a/doc/fr/weechat_plugin_api.fr.adoc
+++ b/doc/fr/weechat_plugin_api.fr.adoc
@@ -11507,7 +11507,7 @@ weechat.hook_modifier_exec("mon_modifier", mes_donnees, ma_chaine)
==== hook_info
-_Mis à jour dans la 1.5._
+_Mis à jour dans la 1.5, 2.5._
Accrocher une information (la fonction de rappel prend et retourne une chaîne).
@@ -11518,10 +11518,10 @@ Prototype :
struct t_hook *weechat_hook_info (const char *info_name,
const char *description,
const char *args_description,
- const char *(*callback)(const void *pointer,
- void *data,
- const char *info_name,
- const char *arguments),
+ char *(*callback)(const void *pointer,
+ void *data,
+ const char *info_name,
+ const char *arguments),
const void *callback_pointer,
void *callback_data);
----
@@ -11551,16 +11551,20 @@ Valeur de retour :
* pointeur vers le nouveau "hook", NULL en cas d'erreur
+[NOTE]
+Avec WeeChat ≥ 2.5, la fonction de rappel renvoie une chaîne allouée
+(avec WeeChat ≤ 2.4, il s'agissait d'un pointeur vers une chaîne statique).
+
Exemple en C :
[source,C]
----
-const char *
+char *
my_info_cb (const void *pointer, void *data, const char *info_name,
const char *arguments)
{
/* ... */
- return pointeur_vers_chaine;
+ return strdup ("some_info");
}
/* ajoute l'information "mon_info" */
@@ -14904,13 +14908,15 @@ Fonctions pour obtenir des informations.
==== info_get
+_Mis à jour dans la 2.5._
+
Retourner une information, sous forme de chaîne, de WeeChat ou d'une extension.
Prototype :
[source,C]
----
-const char *weechat_info_get (const char *info_name, const char *arguments);
+char *weechat_info_get (const char *info_name, const char *arguments);
----
Paramètres :
@@ -14923,6 +14929,10 @@ Valeur de retour :
* chaîne avec l'information demandée, NULL en cas d'erreur
+[NOTE]
+Avec WeeChat ≥ 2.5, la valeur retournée est une chaîne allouée
+(avec WeeChat ≤ 2.4, il s'agissait d'un pointeur vers une chaîne statique).
+
Infos :
include::autogen/plugin_api/infos.adoc[]
@@ -14931,11 +14941,19 @@ Exemple en C :
[source,C]
----
+char *version = weechat_info_get ("version", NULL);
+char *date = weechat_info_get ("date", NULL);
weechat_printf (NULL, "La version de WeeChat est : %s (compilée le %s)",
- weechat_info_get ("version", NULL),
- weechat_info_get ("date", NULL));
-weechat_printf (NULL, "Le répertoire de WeeChat est : %s",
- weechat_info_get ("weechat_dir", NULL));
+ version, date);
+if (version)
+ free (version);
+if (date)
+ free (date);
+
+weechat_dir = weechat_info_get ("weechat_dir", NULL);
+weechat_printf (NULL, "Le répertoire de WeeChat est : %s", weechat_dir);
+if (weechat_dir)
+ free (weechat_dir);
----
Script (Python) :