diff --git a/doc/en/weechat_plugin_api.en.adoc b/doc/en/weechat_plugin_api.en.adoc index 14a248a59..5be4ab370 100644 --- a/doc/en/weechat_plugin_api.en.adoc +++ b/doc/en/weechat_plugin_api.en.adoc @@ -15388,7 +15388,7 @@ C example: struct t_gui_lines *own_lines; struct t_gui_line *line; -struct t_gui_line_data *line_data; +struct t_gui_line_data *line_data; struct t_hdata *hdata; struct t_hashtable *hashtable; char str_date[64]; diff --git a/doc/fr/cmdline_options.fr.adoc b/doc/fr/cmdline_options.fr.adoc index 0a5bf6aeb..b24fdbf71 100644 --- a/doc/fr/cmdline_options.fr.adoc +++ b/doc/fr/cmdline_options.fr.adoc @@ -7,8 +7,8 @@ *-d*, *--dir* __:: Définir le répertoire comme étant la base de WeeChat (utilisé pour les fichiers de configuration, logs, extensions - et scripts de l'utilisateur), la valeur par défaut est "~/.weechat" (note : - le répertoire est créé s'il n'est pas trouvé par WeeChat). + et scripts de l'utilisateur), la valeur par défaut est "~/.weechat" + (note : le répertoire est créé s'il n'est pas trouvé par WeeChat). Si cette option n'est pas donnée, la variable d'environnement WEECHAT_HOME est utilisée (si non vide). diff --git a/doc/fr/weechat.1.fr.adoc b/doc/fr/weechat.1.fr.adoc index 1a8ee4a61..91906813f 100644 --- a/doc/fr/weechat.1.fr.adoc +++ b/doc/fr/weechat.1.fr.adoc @@ -36,16 +36,16 @@ consulter la documentation des extensions dans le https://weechat.org/doc[guide utilisateur de WeeChat]. Avec l'extension irc, vous pouvez vous connecter à un serveur de manière -temporaire avec une URL, comme ceci : +temporaire avec une URL, comme ceci : irc[6][s]://[[pseudo][:motdepasse]@]serveur[:port][/#canal1[,#canal2...]] -Pour rejoindre le canal IRC de support WeeChat avec le pseudo "monpseudo" : +Pour rejoindre le canal IRC de support WeeChat avec le pseudo "monpseudo" : irc://monpseudo@chat.freenode.net/#weechat Les adresses IPv6 peuvent être entourées par des crochets pour ajouter un port -après, par exemple : +après, par exemple : irc://monpseudo@[2001:db8:0:85a3::ac1f:8001]:6668/#test @@ -111,8 +111,8 @@ choix) toute version ultérieure. Merci de consulter le fichier COPYING pour plus d'informations. -Site web : https://weechat.org/ +Site web : https://weechat.org/ == SUPPORT / SIGNALER DES BUGS -Pour de l'aide ou signaler un bug : https://weechat.org/dev/support +Pour de l'aide ou signaler un bug : https://weechat.org/dev/support diff --git a/doc/fr/weechat_dev.fr.adoc b/doc/fr/weechat_dev.fr.adoc index e2766dfd2..f5173d6e4 100644 --- a/doc/fr/weechat_dev.fr.adoc +++ b/doc/fr/weechat_dev.fr.adoc @@ -12,7 +12,7 @@ Ce manuel documente le client de messagerie instantanée WeeChat, il fait partie de WeeChat. -La dernière version de ce document peut être téléchargée sur cette page : +La dernière version de ce document peut être téléchargée sur cette page : https://weechat.org/doc @@ -22,7 +22,7 @@ https://weechat.org/doc WeeChat (Wee Enhanced Environment for Chat) est un client de discussion libre, rapide et léger, conçu pour différents systèmes d'exploitation. -Ce manuel documente l'intérieur de WeeChat : +Ce manuel documente l'intérieur de WeeChat : * dépôts * règles de développement @@ -33,10 +33,10 @@ Ce manuel documente l'intérieur de WeeChat : [[repositories]] == Dépôts -Les dépôts de WeeChat sont dans l'organisation "weechat" de GitHub : +Les dépôts de WeeChat sont dans l'organisation "weechat" de GitHub : https://github.com/weechat -Liste des dépôts : +Liste des dépôts : weechat:: dépôt principal avec le code source et la documentation @@ -45,7 +45,7 @@ scripts:: les scripts _officiels_ soumis sur weechat.org weechat.org:: - le code source du site de WeeChat : https://weechat.org/ + le code source du site de WeeChat : https://weechat.org/ weercd:: serveur de test IRC @@ -58,13 +58,13 @@ Ce manuel documente seulement le dépôt _weechat_. [[overview]] === Vue d'ensemble -Les répertoires principaux de WeeChat sont : +Les répertoires principaux de WeeChat sont : [width="100%",cols="1m,3",options="header"] |=== | Répertoire | Description | src/ | Racine des sources. -|    core/ | Fonctions du cœur : point d'entrée, structures internes. +|    core/ | Fonctions du cœur : point d'entrée, structures internes. |    gui/ | Fonctions pour les tampons, fenêtres, ... (utilisées par toutes les interfaces). |       curses/ | Interface Curses. |    plugins/ | API extension/script. @@ -100,15 +100,15 @@ Les répertoires principaux de WeeChat sont : [[sources_core]] ==== Cœur -Le cœur de WeeChat est situé dans les répertoires suivants : +Le cœur de WeeChat est situé dans les répertoires suivants : -* _src/core/_ : fonctions du cœur (pour manipuler des données) -* _src/gui/_ : fonctions pour l'interface (tampons, fenêtres, ...) +* _src/core/_ : fonctions du cœur (pour manipuler des données) +* _src/gui/_ : fonctions pour l'interface (tampons, fenêtres, ...) [width="100%",cols="1m,3",options="header"] |=== | Chemin/fichier | Description -| core/ | Fonctions du cœur : point d'entrée, structures internes. +| core/ | Fonctions du cœur : point d'entrée, structures internes. |    wee-arraylist.c | Listes avec tableau (« arraylists »). |    wee-backtrace.c | Afficher une trace après un plantage. |    wee-command.c | Commandes du cœur de WeeChat. @@ -134,7 +134,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants : |    wee-utf8.c | Fonctions UTF-8. |    wee-util.c | Quelques autres fonctions utilitaires. |    wee-version.c | Fonctions pour la version de WeeChat. -|    weechat.c | Fonctions principales : options de ligne de commande, démarrage. +|    weechat.c | Fonctions principales : options de ligne de commande, démarrage. | gui/ | Fonctions pour les tampons, fenêtres, ... (utilisées par toutes les interfaces). |    gui-bar-item.c | Objets de barre. |    gui-bar-window.c | Fenêtres de barre. @@ -179,7 +179,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants : |    plugin-api.c | Fonctions supplémentaires pour l'API extension (enveloppes autour des fonctions du cœur de WeeChat). |    plugin-config.c | Options de configuration des extensions (fichier plugins.conf). |    plugin-script.c | Fonctions communes utilisés par les extensions pour les scripts. -|    plugin-script-api.c | Fonctions pour l'API script : enveloppes autour de quelques fonctions de l'API extension. +|    plugin-script-api.c | Fonctions pour l'API script : enveloppes autour de quelques fonctions de l'API extension. |    weechat-plugin.h | En-tête destiné à être distribué avec les extensions WeeChat, pour les compiler. |    alias/ | Extension Alias. |       alias.c | Fonctions principales pour les alias. @@ -321,22 +321,22 @@ Le cœur de WeeChat est situé dans les répertoires suivants : |    tests.cpp | Programme utilisé pour lancer les tests. |    unit/ | Racine des tests unitaires. |       core/ | Racine des tests unitaires pour le cœur. -|          test-arraylist.cpp | Tests : listes avec tableau (« arraylists »). -|          test-eval.cpp | Tests : évaluation d'expressions. -|          test-hashtble.cpp | Tests : tables de hachage. -|          test-hdata.cpp | Tests : hdata. -|          test-infolist.cpp | Tests : infolists. -|          test-list.cpp | Tests : listes. -|          test-string.cpp | Tests : chaînes. -|          test-url.cpp | Tests : URLs. -|          test-utf8.cpp | Tests : UTF-8. -|          test-util.cpp | Tests : fonctions utiles. +|          test-arraylist.cpp | Tests : listes avec tableau (« arraylists »). +|          test-eval.cpp | Tests : évaluation d'expressions. +|          test-hashtble.cpp | Tests : tables de hachage. +|          test-hdata.cpp | Tests : hdata. +|          test-infolist.cpp | Tests : infolists. +|          test-list.cpp | Tests : listes. +|          test-string.cpp | Tests : chaînes. +|          test-url.cpp | Tests : URLs. +|          test-utf8.cpp | Tests : UTF-8. +|          test-util.cpp | Tests : fonctions utiles. |=== [[documentation_translations]] === Documentation / traductions -Fichiers de documentation : +Fichiers de documentation : [width="100%",cols="1m,3",options="header"] |=== @@ -344,7 +344,7 @@ Fichiers de documentation : | doc/ | Documentation. |    docinfo.html | Style Asciidoctor. |    docgen.py | Script Python pour construire les fichiers dans le répertoire _autogen/_ (voir ci-dessous). -|    XX/ | Documentation pour la langue XX (langues : en, fr, de, it, ...). +|    XX/ | Documentation pour la langue XX (langues : en, fr, de, it, ...). |       cmdline_options.XX.adoc | Options de ligne de commande (fichier inclus dans la page de manuel et le guide utilisateur). |       weechat.1.XX.adoc | Page de manuel (`man weechat`). |       weechat_dev.XX.adoc | Guide du développeur (ce document). @@ -361,7 +361,7 @@ Fichiers de documentation : |=== Les traductions pour WeeChat et les extensions sont effectuées avec gettext, les -fichiers sont dans le répertoire _po/_ : +fichiers sont dans le répertoire _po/_ : [width="100%",cols="1m,3",options="header"] |=== @@ -379,14 +379,14 @@ fichiers sont dans le répertoire _po/_ : * Dans le code source, vos commentaires, noms de variables, ... doivent être écrits en anglais *uniquement* (aucune autre langue n'est autorisée). -* Utilisez un en-tête de copyright dans chaque nouveau fichier source avec : +* Utilisez un en-tête de copyright dans chaque nouveau fichier source avec : ** une brève description du fichier (une seule ligne), ** la date, ** le nom, ** l'e-mail, ** la licence. -Exemple en C : +Exemple en C : [source,C] ---- @@ -415,7 +415,7 @@ Exemple en C : [[coding_c_style]] === Style C -Quelques règles basiques que vous *devez* suivre quand vous écrivez du code C : +Quelques règles basiques que vous *devez* suivre quand vous écrivez du code C : * Utilisez 4 espaces pour l'indentation. N'utilisez pas de tabulations, c'est le mal. @@ -427,7 +427,7 @@ Quelques règles basiques que vous *devez* suivre quand vous écrivez du code C (utilisez toujours un commentaire multi-lignes, même si la description est très courte). -Exemple : +Exemple : [source,C] ---- @@ -457,10 +457,10 @@ foo () ---- * Utilisez des noms de variable explicites, par exemple "nicks_count" au lieu de - "n" ou "nc". Exception : dans les boucles `for`, où les variables comme "i" ou + "n" ou "nc". Exception : dans les boucles `for`, où les variables comme "i" ou "n" sont OK. * Initialisez les variables locales après la déclaration, dans le corps de la - fonction, exemple : + fonction, exemple : [source,C] ---- @@ -480,7 +480,7 @@ foo () au lieu de `+x + y * z+`. * Disposez les accolades `+{ }+` seules sur la ligne, et indentez les avec le nombre d'espaces utilisés sur la ligne au dessus de l'accolade ouvrante (le - `if` dans l'exemple) : + `if` dans l'exemple) : [source,C] ---- @@ -491,7 +491,7 @@ if (nicks_count == 1) ---- * Utilisez des lignes vides pour séparer différents blocs dans les fonctions, et - si possible ajoutez un commentaire pour chacun, comme ceci : + si possible ajoutez un commentaire pour chacun, comme ceci : [source,C] ---- @@ -535,7 +535,7 @@ irc_server_outqueue_send (struct t_irc_server *server) * Indentez les conditions `if`, et utilisez des parenthèses autour des conditions avec un opérateur (pas nécessaire pour un booléen simple), comme - ceci : + ceci : [source,C] ---- @@ -559,7 +559,7 @@ else } ---- -* Indentez les `switch` comme ceci : +* Indentez les `switch` comme ceci : [source,C] ---- @@ -578,7 +578,7 @@ switch (string[0]) ---- * Utilisez `typedef` pur les prototypes de fonctions mais pas pour les - structures : + structures : [source,C] ---- @@ -601,7 +601,7 @@ new_hook_fd = malloc (sizeof (*new_hook_fd)); ---- * Ce code Lisp peut être utilisé dans votre _~/.emacs.el_ pour indenter - correctement si vous utilisez l'éditeur de texte Emacs : + correctement si vous utilisez l'éditeur de texte Emacs : [source,lisp] ---- @@ -628,14 +628,14 @@ Voir http://www.python.org/dev/peps/pep-0008/ [[naming_convention_files]] ==== Fichiers -Les noms de fichiers sont composés de lettres et tirets, avec le format : +Les noms de fichiers sont composés de lettres et tirets, avec le format : _xxx-yyyyy.[ch]_, où _xxx_ est le répertoire/composant (peut être une abréviation) et _yyyyy_ un nom pour le fichier. Le fichier principal d'un répertoire peut avoir le même nom que le répertoire, par exemple _irc.c_ pour l'extension irc. -Exemples : +Exemples : [width="100%",cols="1m,3",options="header"] |=== @@ -654,13 +654,13 @@ exemple _wee-command.h_ pour le fichier _wee-command.c_. [[naming_convention_structures]] ==== Structures -Les structures ont le nom _t_X_Y_ ou _t_X_Y_Z_ : +Les structures ont le nom _t_X_Y_ ou _t_X_Y_Z_ : -* _X_ : répertoire/composant (peut être une abréviation) -* _Y_ : fin du nom de fichier -* _Z_ : nom de la structure (facultatif) +* _X_ : répertoire/composant (peut être une abréviation) +* _Y_ : fin du nom de fichier +* _Z_ : nom de la structure (facultatif) -Exemple : un pseudo IRC (de _src/plugins/irc/irc-nick.h_) : +Exemple : un pseudo IRC (de _src/plugins/irc/irc-nick.h_) : [source,C] ---- @@ -681,16 +681,16 @@ struct t_irc_nick [[naming_convention_variables]] ==== Variables -Les variables globales (en dehors des fonctions) ont le nom _X_Y_Z_ : +Les variables globales (en dehors des fonctions) ont le nom _X_Y_Z_ : -* _X_ : répertoire/composant (peut être une abréviation) -* _Y_ : fin du nom de fichier -* _Z_ : nom de la variable +* _X_ : répertoire/composant (peut être une abréviation) +* _Y_ : fin du nom de fichier +* _Z_ : nom de la variable -Exception : pour les variables des derniers éléments d'une liste, le nom est +Exception : pour les variables des derniers éléments d'une liste, le nom est _last_X_ (où _X_ est le nom de la variable, en utilisant le singulier). -Exemple : fenêtres (de _src/gui/gui-window.c_) : +Exemple : fenêtres (de _src/gui/gui-window.c_) : [source,C] ---- @@ -702,7 +702,7 @@ struct t_gui_window *gui_current_window = NULL; /* current window */ Il n'y a pas de convention pour les variables locales (dans les fonctions). La seule recommandation est que le nom soit explicite (et pas trop court). + Cependant, les pointeurs vers les structures sont souvent nommés _ptr_xxxx_, par -exemple un pointeur sur _struct t_gui_buffer *_ sera : _*ptr_buffer_. +exemple un pointeur sur _struct t_gui_buffer *_ sera : _*ptr_buffer_. [[naming_convention_functions]] ==== Fonctions @@ -710,7 +710,7 @@ exemple un pointeur sur _struct t_gui_buffer *_ sera : _*ptr_buffer_. La convention pour les noms des fonctions est le même que celui des <>. -Exemple : création d'une nouvelle fenêtre (de _src/gui/gui-window.c_) : +Exemple : création d'une nouvelle fenêtre (de _src/gui/gui-window.c_) : [source,C] ---- @@ -745,10 +745,10 @@ avec un "callback". [[doubly_linked_lists]] === Listes doublement chaînées -La plupart des listes chaînes WeeChat sont doublement chaînées : chaque nœud a +La plupart des listes chaînes WeeChat sont doublement chaînées : chaque nœud a un pointeur vers le nœud précédent/suivant. -Exemple : liste des tampons (de _src/gui/gui-buffer.h_) : +Exemple : liste des tampons (de _src/gui/gui-buffer.h_) : [source,C] ---- @@ -763,7 +763,7 @@ struct t_gui_buffer }; ---- -Et les deux pointeurs vers la tête et la fin de liste : +Et les deux pointeurs vers la tête et la fin de liste : [source,C] ---- @@ -778,37 +778,37 @@ WeeChat utilise ses propres codes couleur dans les chaînes pour afficher les attributs (gras, souligné, ...) et les couleurs à l'écran. Tous les attributs/couleurs sont préfixés par un caractère dans la chaîne, qui -peuvent être : +peuvent être : -* _0x19_ : code couleur (suivi par un/des code(s) couleur) -* _0x1A_ : activer un attribut (suivi par un attribut sur un caractère) -* _0x1B_ : supprimer un attribut (suivi par un attribut sur un caractère) -* _0x1C_ : réinitialiser (rien après) +* _0x19_ : code couleur (suivi par un/des code(s) couleur) +* _0x1A_ : activer un attribut (suivi par un attribut sur un caractère) +* _0x1B_ : supprimer un attribut (suivi par un attribut sur un caractère) +* _0x1C_ : réinitialiser (rien après) -Les attributs autorisés sont (un ou plusieurs caractères) : +Les attributs autorisés sont (un ou plusieurs caractères) : -* `+*+` : gras -* `+!+` : vidéo inverse -* `+/+` : italique -* `+_+` : souligné -* `+|+` : garder les attributs +* `+*+` : gras +* `+!+` : vidéo inverse +* `+/+` : italique +* `+_+` : souligné +* `+|+` : garder les attributs -Les couleurs possibles sont : +Les couleurs possibles sont : -* couleur standard : attributs facultatifs + nombre sur 2 digits -* couleur étendue : `+@+` + attributs facultatifs + nombre sur 5 digits +* couleur standard : attributs facultatifs + nombre sur 2 digits +* couleur étendue : `+@+` + attributs facultatifs + nombre sur 5 digits -Dans le tableau qui suit, les conventions suivantes sont utilisées : +Dans le tableau qui suit, les conventions suivantes sont utilisées : -* `STD` : couleur standard (2 digits) -* `(A)STD` : couleur standard avec des attributs facultatifs +* `STD` : couleur standard (2 digits) +* `(A)STD` : couleur standard avec des attributs facultatifs (attributs + 2 digits) -* `EXT` : couleur étendue (`+@+` + 5 digits) -* `(A)EXT` : couleur étendue avec des attributs facultatifs +* `EXT` : couleur étendue (`+@+` + 5 digits) +* `(A)EXT` : couleur étendue avec des attributs facultatifs (`+@+` + attributs + 5 digits) -* `ATTR` : un caractère d'attribut (`+*+`, `+!+`, `+/+`, `+_+` ou `+|+`) +* `ATTR` : un caractère d'attribut (`+*+`, `+!+`, `+/+`, `+_+` ou `+|+`) -Toutes les combinaisons sont résumées dans ce tableau : +Toutes les combinaisons sont résumées dans ce tableau : [width="100%",cols="4,2,2,8",options="header"] |=== @@ -841,7 +841,7 @@ Toutes les combinaisons sont résumées dans ce tableau : |=== Les codes couleur utilisant des options (voir _t_gui_color_enum_, dans le -fichier _src/gui/gui-color.h_) : +fichier _src/gui/gui-color.h_) : [width="70%",cols="^1m,10",options="header"] |=== @@ -893,7 +893,7 @@ fichier _src/gui/gui-color.h_) : | 44 | weechat.color.chat_value_null _(WeeChat ≥ 1.4)_ |=== -Les couleurs WeeChat sont : +Les couleurs WeeChat sont : [width="70%",cols="^1m,10",options="header"] |=== @@ -917,7 +917,7 @@ Les couleurs WeeChat sont : | 16 | Blanc |=== -Exemples de codes couleur : +Exemples de codes couleur : [width="70%",cols="1,2",options="header"] |=== @@ -945,7 +945,7 @@ WeeChat. Et puis des macros sont utilisées pour appeler ces fonctions. Par exemple, la fonction _hook_timer_ est définie dans la structure -_t_weechat_plugin_ comme ceci : +_t_weechat_plugin_ comme ceci : [source,C] ---- @@ -958,7 +958,7 @@ struct t_hook *(*hook_timer) (struct t_weechat_plugin *plugin, void *callback_data); ---- -Et la macro utilisée pour appeler cette fonction est : +Et la macro utilisée pour appeler cette fonction est : [source,C] ---- @@ -969,7 +969,7 @@ Et la macro utilisée pour appeler cette fonction est : __callback, __data) ---- -Donc dans une extension, l'appel à cette fonction sera par exemple : +Donc dans une extension, l'appel à cette fonction sera par exemple : [source,C] ---- @@ -985,42 +985,42 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000, [[git_repository]] === Dépôt Git -Le dépôt Git est à cette URL : https://github.com/weechat/weechat +Le dépôt Git est à cette URL : https://github.com/weechat/weechat Tout patch pour un bug ou une nouvelle fonctionnalité doit être effectué sur la branche master, le format préféré étant une "pull request" sur GitHub. Un patch peut aussi être envoyé par e-mail (fait avec `git diff` ou `git format-patch`). -Le format du message de commit est le suivant (pour fermer un bug GitHub) : +Le format du message de commit est le suivant (pour fermer un bug GitHub) : ---- component: fix a problem (closes #123) ---- -Pour un bug Savannah : +Pour un bug Savannah : ---- component: fix a problem (bug #12345) ---- -Où _component_ est : +Où _component_ est : -* pour le cœur WeeChat : _core_ (les fichiers dans le répertoire racine, _po/_ +* pour le cœur WeeChat : _core_ (les fichiers dans le répertoire racine, _po/_ et _src/_, sauf _src/plugins/_) -* fichiers de documentation : _doc_ (fichiers dans le répertoire _doc/_) -* nom d'une extension : _irc_, _python_, _relay_, ... (fichiers dans le +* fichiers de documentation : _doc_ (fichiers dans le répertoire _doc/_) +* nom d'une extension : _irc_, _python_, _relay_, ... (fichiers dans le répertoire _src/plugins/_) -Quelques règles à suivre : +Quelques règles à suivre : * Utilisez seulement l'anglais. * Utilisez des verbes à l'infinitif. * Si le commit est relatif au tracker, écrivez-le entre parenthèses après le - message, avec ce format : -** GitHub : closes #123 -** Savannah : bug #12345, task #12345, patch #12345 + message, avec ce format : +** GitHub : closes #123 +** Savannah : bug #12345, task #12345, patch #12345 -Exemples de messages de commit : +Exemples de messages de commit : ---- irc: add command /unquiet (closes #36) @@ -1041,7 +1041,7 @@ Les fichiers gettext sont dans le répertoire _po/_. Si vous souhaitez initialiser une nouvelle langue, utilisez la commande `msginit`. Par exemple pour créer un fichier qui est prêt à traduire en -néerlandais : +néerlandais : ---- $ cd po @@ -1052,7 +1052,7 @@ La langue de base pour WeeChat est l'anglais, donc vous devez évidemment comprendre parfaitement l'anglais pour traduire vers votre langue. Une fois terminé, vous *devez* vérifier votre fichier avec le script -_msgcheck.py_ (https://github.com/flashcode/msgcheck) : +_msgcheck.py_ (https://github.com/flashcode/msgcheck) : ---- $ msgcheck.py xx.po @@ -1067,14 +1067,14 @@ par le script _doc/docgen.py_. Copiez ce script python dans votre répertoire python (par exemple _~/.weechat/python_). Vous pouvez alors charger le script dans votre WeeChat, et configurer le chemin -vers votre répertoire _/doc_ : +vers votre répertoire _/doc_ : ---- /python load docgen.py /set plugins.var.python.docgen.path "~/src/weechat/doc" ---- -Créez alors cet alias pour construire les fichiers : +Créez alors cet alias pour construire les fichiers : ---- /alias add doc /perl unload; /python unload; /ruby unload; /lua unload; /tcl unload; /guile unload; /javascript unload; /python load docgen.py; /wait 1ms /docgen @@ -1097,14 +1097,14 @@ Les fichiers Asciidoc donc dans le répertoire _doc/XX/_ où _XX_ est la langue Faites d'abord une copie du fichier asciidoc en anglais (dans le répertoire _doc/en/_), puis travaillez dessus. -Les traductions manquantes dans les fichiers sont indiquées par cette chaîne : +Les traductions manquantes dans les fichiers sont indiquées par cette chaîne : ---- // TRANSLATION MISSING ---- Vous devez traduire tout le fichier sauf les liens et les mots-clés spéciaux -pour les notes, avertissements, ... Ces mots doivent être gardés tels quels : +pour les notes, avertissements, ... Ces mots doivent être gardés tels quels : ---- [[link_name]] @@ -1117,7 +1117,7 @@ pour les notes, avertissements, ... Ces mots doivent être gardés tels quels : [CAUTION] ---- -Lorsqu'il y a un nom après `<>`, alors vous devez le traduire : +Lorsqu'il y a un nom après `<>`, alors vous devez le traduire : ---- <> diff --git a/doc/fr/weechat_faq.fr.adoc b/doc/fr/weechat_faq.fr.adoc index 5c856ed8b..85f79e8e6 100644 --- a/doc/fr/weechat_faq.fr.adoc +++ b/doc/fr/weechat_faq.fr.adoc @@ -30,7 +30,7 @@ mais elle ne s'applique pas à WeeChat !). Parce que WeeChat est très léger et apporte des fonctionnalités innovantes. -Plus d'infos sur cette page : https://weechat.org/about/features +Plus d'infos sur cette page : https://weechat.org/about/features [[compilation_install]] == Compilation / installation @@ -39,7 +39,7 @@ Plus d'infos sur cette page : https://weechat.org/about/features === J'ai entendu parler de plusieurs interfaces pour WeeChat. Comment puis-je les compiler/utiliser ? Des interfaces distantes sont disponibles, voir les liens sur la page des -fonctionnalités : https://weechat.org/about/features +fonctionnalités : https://weechat.org/about/features [[compile_git]] === Je ne peux pas compiler WeeChat après avoir cloné la base git, pourquoi ? @@ -59,13 +59,13 @@ mises à jour. === Comment puis-je installer WeeChat sous OS X ? Il est recommandé d'utiliser http://brew.sh/[Homebrew], vous pouvez avoir de -l'aide avec : +l'aide avec : ---- brew info weechat ---- -Vous pouvez installer WeeChat avec cette commande : +Vous pouvez installer WeeChat avec cette commande : ---- brew install weechat --with-aspell --with-curl --with-python --with-perl --with-ruby --with-lua --with-guile @@ -78,7 +78,7 @@ Pour obtenir de l'aide tapez `/help`. Pour de l'aide sur une commande, tapez `/help commande`. Les touches et commandes sont listées dans la documentation. Il est recommandé pour les nouveaux utilisateurs de lire le guide de démarrage -rapide : https://weechat.org/doc +rapide : https://weechat.org/doc [[display]] == Affichage @@ -87,10 +87,10 @@ rapide : https://weechat.org/doc === Je ne vois pas bien certains accents dans WeeChat, que faire ? C'est un problème courant, merci de lire attentivement et vérifier *TOUS* les -points ci-dessous : +points ci-dessous : -* Vérifiez que weechat est lié avec libncursesw (attention : nécessaire - sur beaucoup de distributions, mais pas toutes) : +* Vérifiez que weechat est lié avec libncursesw (attention : nécessaire + sur beaucoup de distributions, mais pas toutes) : `ldd /chemin/vers/weechat`. * Vérifiez que l'extension "charset" est chargée avec la commande `/plugin` (s'il ne l'est pas, vous devez peut-être installer le paquet @@ -99,9 +99,9 @@ points ci-dessous : devriez voir _ISO-XXXXXX_ ou _UTF-8_ pour le charset du terminal. Si vous voyez _ANSI_X3.4-1968_ ou d'autres valeurs, votre locale est probablement erronée (corrigez votre $LANG). -* Affectez la valeur pour le décodage global, par exemple : +* Affectez la valeur pour le décodage global, par exemple : `/set charset.default.decode "ISO-8859-15"`. -* Si vous utilisez la locale UTF-8 : +* Si vous utilisez la locale UTF-8 : ** Vérifiez que votre terminal est compatible UTF-8 (un terminal conseillé pour l'UTF-8 est rxvt-unicode). ** Si vous utilisez screen, vérifiez qu'il est lancé en mode UTF-8 @@ -121,10 +121,10 @@ Cela peut être causé par un bug de la libc dans la fonction _wcwidth_ et devrait être corrigé dans la glibc 2.22 (peut-être pas encore disponible dans votre distribution). -Il y a un moyen de contournement pour utiliser la fonction _wcwidth_ corrigée : +Il y a un moyen de contournement pour utiliser la fonction _wcwidth_ corrigée : https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat -Voir ce rapport de bug pour plus d'informations : +Voir ce rapport de bug pour plus d'informations : https://github.com/weechat/weechat/issues/79 [[bars_background]] @@ -133,16 +133,16 @@ https://github.com/weechat/weechat/issues/79 Cela peut être du à la variable TERM qui n'a pas la bonne valeur (regardez la sortie de `echo $TERM` dans votre terminal). -Selon la façon de lancer WeeChat, vous devriez avoir : +Selon la façon de lancer WeeChat, vous devriez avoir : -* Si WeeChat tourne en local ou sur une machine distante sans screen ni tmux : - cela dépend du terminal utilisé : _xterm_, _xterm-256color_, _rxvt-unicode_, +* Si WeeChat tourne en local ou sur une machine distante sans screen ni tmux : + cela dépend du terminal utilisé : _xterm_, _xterm-256color_, _rxvt-unicode_, _rxvt-256color_, etc... * Si WeeChat tourne sous screen, vous devriez avoir _screen_ ou _screen-256color_. * Si WeeChat tourne sous tmux, vous devriez avoir _tmux_, _tmux-256color_, _screen_ ou _screen-256color_. -Si besoin, corrigez la variable TERM : `export TERM="xxx"`. +Si besoin, corrigez la variable TERM : `export TERM="xxx"`. [[screen_weird_chars]] === Quand j'utilise weechat sous screen/tmux, j'ai des caractères bizarres et aléatoires, comment corriger ça ? @@ -153,7 +153,7 @@ sortie de `echo $TERM` dans votre terminal, *en dehors de screen/tmux*). Par exemple _xterm-color_ provoque ce genre de problèmes, utilisez _xterm_ qui est ok (comme plein d'autres valeurs). -Si besoin, corrigez la variable TERM : `export TERM="xxx"`. +Si besoin, corrigez la variable TERM : `export TERM="xxx"`. [[osx_display_broken]] === J'ai compilé WeeChat sous OS X, et je vois des "(null)" partout sur l'écran, pourquoi ? @@ -180,30 +180,30 @@ aucune fenêtre) ou affiché par une ou plusieurs fenêtres. [[buffers_list]] === Comment afficher la liste des tampons sur la gauche ? -Utilisez le script _buffers.pl_ : +Utilisez le script _buffers.pl_ : ---- /script install buffers.pl ---- -Pour limiter la taille de la barre : +Pour limiter la taille de la barre : ---- /set weechat.bar.buffers.size_max 15 ---- -Pour déplacer la barre en bas : +Pour déplacer la barre en bas : ---- /set weechat.bar.buffers.position bottom ---- -Pour faire défiler la barre : si la souris est activée (touche : kbd:[Alt+m]), +Pour faire défiler la barre : si la souris est activée (touche : kbd:[Alt+m]), vous pouvez faire défiler avec la roulette de votre souris. Ou vous pouvez définir des touches, comme les touches déjà existantes pour faire défiler la liste de pseudos. -Par exemple pour utiliser kbd:[F1], kbd:[F2], kbd:[Alt+F1] et kbd:[Alt+F2] : +Par exemple pour utiliser kbd:[F1], kbd:[F2], kbd:[Alt+F1] et kbd:[Alt+F2] : ---- /key bind meta-OP /bar scroll buffers * -100% @@ -219,13 +219,13 @@ Pour trouver le code de la touche appuyez sur kbd:[Alt+k] puis la touche. [[customize_prefix]] === Comment puis-je réduire la longueur des pseudos ou supprimer l'alignement des pseudos dans la zone de discussion ? -Pour réduire la longueur maximum des pseudos dans la zone de discussion : +Pour réduire la longueur maximum des pseudos dans la zone de discussion : ---- /set weechat.look.prefix_align_max 15 ---- -Pour supprimer l'alignement sur les pseudos : +Pour supprimer l'alignement sur les pseudos : ---- /set weechat.look.prefix_align none @@ -235,23 +235,23 @@ Pour supprimer l'alignement sur les pseudos : === Que signifie [H: 3(1,8), 2(4)] dans la barre de statut ? Il s'agit de la "hotlist", une liste de tampons avec le nombre de messages non -lus, par ordre : highlights, messages privés, messages, autres messages +lus, par ordre : highlights, messages privés, messages, autres messages (comme join/part). + Le nombre de "messages non lus" est le nombre de nouveaux messages affichés/reçus depuis que vous avez visité le tampon. -Dans l'exemple `[H: 3(1,8), 2(4)]`, il y a : +Dans l'exemple `[H: 3(1,8), 2(4)]`, il y a : * un highlight et 8 messages non lus sur le tampon n°3, * 4 messages non lus sur le tampon n°2. La couleur du tampon/compter dépend du type de message, les couleurs par défaut -sont : +sont : -* highlight : `lightmagenta` / `magenta` -* message privé : `lightgreen` / `green` -* message : `yellow` / `brown` -* autre message : `default` / `default` (couleur du texte dans le terminal) +* highlight : `lightmagenta` / `magenta` +* message privé : `lightgreen` / `green` +* message : `yellow` / `brown` +* autre message : `default` / `default` (couleur du texte dans le terminal) Ces couleurs peuvent être changées via les options __weechat.color.status_data_*__ (tampons) et __weechat.color.status_count_*__ (compteurs). + @@ -269,13 +269,13 @@ L'option _size_ dans la barre input peut être définie à une valeur supérieur dynamique, et alors l'option _size_max_ définira la taille maximum (0 = pas de limite). -Exemple avec une taille dynamique : +Exemple avec une taille dynamique : ---- /set weechat.bar.input.size 0 ---- -Taille maximum de 2 : +Taille maximum de 2 : ---- /set weechat.bar.input.size_max 2 @@ -287,7 +287,7 @@ Taille maximum de 2 : Oui, vous devez créer une barre de type "root" (avec un objet pour savoir dans quelle fenêtre vous êtes), puis supprimer la barre input courante. -Par exemple : +Par exemple : ---- /bar add rootinput root bottom 1 0 [buffer_name]+[input_prompt]+(away),[input_search],[input_paste],input_text @@ -296,7 +296,7 @@ Par exemple : Si jamais vous n'étiez pas satisfait avec ça, supprimez simplement la nouvelle barre, WeeChat recréera automatiquement la barre par défaut "input" si l'objet -"input_text" n'est utilisé dans aucune barre : +"input_text" n'est utilisé dans aucune barre : ---- /bar del rootinput @@ -306,14 +306,14 @@ barre, WeeChat recréera automatiquement la barre par défaut "input" si l'objet === Comment puis-je copier/coller du texte sans coller la liste des pseudos ? Avec WeeChat ≥ 1.0, vous pouvez utiliser l'affichage dépouillé (touche par -défaut : kbd:[Alt+l]). +défaut : kbd:[Alt+l]). Vous pouvez utiliser un terminal qui propose la sélection rectangulaire (comme rxvt-unicode, konsole, gnome-terminal, etc...). La touche est habituellement kbd:[Ctrl] + kbd:[Alt] + sélection à la souris. Une autre solution est de déplacer la liste des pseudos en haut ou en bas, par -exemple : +exemple : ---- /set weechat.bar.nicklist.position top @@ -323,12 +323,12 @@ exemple : === Comment puis-je cliquer sur les longs URLs (plus d'une ligne) ? Avec WeeChat ≥ 1.0, vous pouvez utiliser l'affichage dépouillé (touche par -défaut : kbd:[Alt+l]). +défaut : kbd:[Alt+l]). Par défaut, WeeChat affiche l'heure et un préfixe pour chaque ligne avec des barres optionnelles autour de la zone de discussion. Pour rendre la le clic d'URL plus facile, vous pouvez déplacer la liste des pseudos en haut et -supprimer l'alignement sur les pseudos : +supprimer l'alignement sur les pseudos : ---- /set weechat.bar.nicklist.position top @@ -338,7 +338,7 @@ supprimer l'alignement sur les pseudos : Avec WeeChat ≥ 0.3.6, vous pouvez activer l'option "eat_newline_glitch", pour éviter qu'un caractère de nouvelle ligne soit affiché après chaque ligne (donc -cela ne cassera pas la sélection d'une URL) : +cela ne cassera pas la sélection d'une URL) : ---- /set weechat.look.eat_newline_glitch on @@ -348,7 +348,7 @@ cela ne cassera pas la sélection d'une URL) : Cette option peut causer des problèmes d'affichage. Si vous rencontrez de tels problèmes, vous devez désactiver cette option. -Une autre solution est d'utiliser un script : +Une autre solution est d'utiliser un script : ---- /script search url @@ -357,14 +357,14 @@ Une autre solution est d'utiliser un script : [[change_locale_without_quit]] === Je souhaite changer la langue des messages affichés par WeeChat, mais sans quitter WeeChat, est-ce possible ? -Oui, avec WeeChat ≥ 1.0 : +Oui, avec WeeChat ≥ 1.0 : ---- /set env LANG fr_FR.UTF-8 /upgrade ---- -Avec un ancien WeeChat : +Avec un ancien WeeChat : ---- /script install shell.py @@ -378,11 +378,11 @@ Avec un ancien WeeChat : Les 256 couleurs sont supportées avec WeeChat ≥ 0.3.4. Premièrement vérifiez que votre variable d'environnement _TERM_ est correcte, -les valeurs recommandées sont : +les valeurs recommandées sont : -* sous screen : _screen-256color_ -* sous tmux : _screen-256color_ ou _tmux-256color_ -* en dehors de screen/tmux : _xterm-256color_, _rxvt-256color_, +* sous screen : _screen-256color_ +* sous tmux : _screen-256color_ ou _tmux-256color_ +* en dehors de screen/tmux : _xterm-256color_, _rxvt-256color_, _putty-256color_, ... [NOTE] @@ -390,14 +390,14 @@ Vous devrez peut-être installer le paquet "ncurses-term" pour utiliser ces valeurs dans la variable _TERM_. Si vous utilisez screen, vous pouvez ajouter cette ligne dans votre -_~/.screenrc_ : +_~/.screenrc_ : ---- term screen-256color ---- Si votre variable _TERM_ a une valeur erronée et que WeeChat est déjà lancé, -vous pouvez la changer avec ces deux commandes (avec WeeChat ≥ 1.0) : +vous pouvez la changer avec ces deux commandes (avec WeeChat ≥ 1.0) : ---- /set env TERM screen-256color @@ -408,7 +408,7 @@ Pour la version 0.3.4, vous devez utiliser la commande `/color` pour ajouter des nouvelles couleurs. Pour les versions ≥ 0.3.5, vous pouvez utiliser un numéro de couleur dans les -options (facultatif : vous pouvez ajouter des alias de couleurs avec la commande +options (facultatif : vous pouvez ajouter des alias de couleurs avec la commande `/color`). Merci de lire le guide utilisateur pour plus d'information sur la gestion des @@ -417,8 +417,8 @@ couleurs. [[search_text]] === Comment puis-je chercher du texte dans le tampon (comme /lastlog dans irssi) ? -La touche par défaut est kbd:[Ctrl+r] (la commande est : `/input search_text_here`). -Et sauter aux highlights : kbd:[Alt+p] / kbd:[Alt+n]. +La touche par défaut est kbd:[Ctrl+r] (la commande est : `/input search_text_here`). +Et sauter aux highlights : kbd:[Alt+p] / kbd:[Alt+n]. Voir le guide utilisateur pour plus d'information sur cette fonctionnalité (raccourcis clavier par défaut). @@ -429,19 +429,19 @@ Voir le guide utilisateur pour plus d'information sur cette fonctionnalité Vous devez activer les évènements du focus avec un code spécial envoyé au terminal. -*Important* : +*Important* : * Actuellement, *seulement* _xterm_ semble supporter cette fonctionnalité. * Cela ne fonctionne *pas* sous screen/tmux. -Pour envoyer le code au démarrage de WeeChat : +Pour envoyer le code au démarrage de WeeChat : ---- /set weechat.startup.command_after_plugins "/print -stdout \033[?1004h\n" ---- Puis associez deux touches pour le focus (remplacez les commandes `/print` par -les commandes de votre choix) : +les commandes de votre choix) : ---- /key bind meta2-I /print -core focus @@ -454,7 +454,7 @@ les commandes de votre choix) : Cela est causé par l'option "bracketed paste" qui est activée par défaut, et pas correctement gérée par screen dans les autres fenêtres. -Vous pouvez simplement désactiver le mode "bracketed paste" : +Vous pouvez simplement désactiver le mode "bracketed paste" : ---- /set weechat.look.paste_bracketed off @@ -468,13 +468,13 @@ Vous pouvez simplement désactiver le mode "bracketed paste" : Si vous utilisez certains terminaux comme xterm ou uxterm, quelques touches meta ne fonctionnent pas par défaut. Vous pouvez ajouter cette ligne dans le -fichier _~/.Xresources_ : +fichier _~/.Xresources_ : -* Pour xterm : +* Pour xterm : ---- XTerm*metaSendsEscape: true ---- -* Pour uxterm : +* Pour uxterm : ---- UXTerm*metaSendsEscape: true ---- @@ -495,7 +495,7 @@ l'inclure dans la ligne de commande. La touche est kbd:[Alt+j] puis 2 chiffres, par exemple kbd:[Alt+j], kbd:[1], kbd:[1] pour sauter au tampon 11. -Vous pouvez définir une touche, par exemple : +Vous pouvez définir une touche, par exemple : ---- /key bind meta-q /buffer *11 @@ -509,7 +509,7 @@ La liste des touches par défaut est dans le Guide utilisateur. Vous pouvez assigner les touches haut et bas sur l'historique global (les touches par défaut pour l'historique global sont kbd:[Ctrl+↑] et kbd:[Ctrl+↓]). -Exemple : +Exemple : ---- /key bind meta2-A /input history_global_previous @@ -528,7 +528,7 @@ Pour trouver le code de la touche appuyez sur kbd:[Alt+k] puis la touche. La souris est supportée avec WeeChat ≥ 0.3.6. -Premièrement essayez d'activer la souris : +Premièrement essayez d'activer la souris : ---- /mouse enable @@ -538,7 +538,7 @@ Si la souris ne fonctionne toujours pas, vérifiez la variable TERM dans votre shell (regardez la sortie de `echo $TERM` dans votre terminal). Selon le terminfo utilisé, la souris peut ne pas être supportée. -Vous pouvez tester le support de la souris dans le terminal : +Vous pouvez tester le support de la souris dans le terminal : ---- $ printf '\033[?1002h' @@ -547,7 +547,7 @@ $ printf '\033[?1002h' Et cliquez sur le premier caractère du terminal (en haut à gauche). Vous devriez voir " !!#!!". -Pour désactiver la souris dans le terminal : +Pour désactiver la souris dans le terminal : ---- $ printf '\033[?1002l' @@ -578,7 +578,7 @@ kbd:[Alt] au lieu de kbd:[Shift]). Si vous utilisez Mac OS X, vous devez installer `openssl` depuis Homebrew. Un fichier CA sera installé avec le le trousseau système. Vous pouvez alors -définie le chemin vers les certificats sous WeeChat : +définie le chemin vers les certificats sous WeeChat : ---- /set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem" @@ -586,21 +586,21 @@ définie le chemin vers les certificats sous WeeChat : Si vous voyez des erreurs à propos de la poignée de main gnutls ("handshake"), vous pouvez utiliser une valeur plus petite pour la clé Diffie-Hellman (par -défaut 2048) : +défaut 2048) : ---- /set irc.server.example.ssl_dhkey_size 1024 ---- Si vous voyez des erreurs à propos du certificat, vous pouvez désactiver -"ssl_verify" (attention, la connexion sera moins sûre en faisant cela) : +"ssl_verify" (attention, la connexion sera moins sûre en faisant cela) : ---- /set irc.server.example.ssl_verify off ---- Si le serveur a un certificat invalide et que vous savez ce que devrait être -le certificat, vous pouvez spécifier l'empreinte (SHA-512, SHA-256 ou SHA-1) : +le certificat, vous pouvez spécifier l'empreinte (SHA-512, SHA-256 ou SHA-1) : ---- /set irc.server.example.ssl_fingerprint 0c06e399d3c3597511dc8550848bfd2a502f0ce19883b728b73f6b7e8604243b @@ -610,7 +610,7 @@ le certificat, vous pouvez spécifier l'empreinte (SHA-512, SHA-256 ou SHA-1) : === Lors de la connexion SSL à un serveur, je vois juste une erreur "TLS handshake failed", que puis-je faire ? Vous pouvez essayer une chaîne de priorité différente (WeeChat ≥ 0.3.5 -seulement), remplacez "xxx" par le nom de votre serveur : +seulement), remplacez "xxx" par le nom de votre serveur : ---- /set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT" @@ -620,7 +620,7 @@ seulement), remplacez "xxx" par le nom de votre serveur : === Comment puis-je me connecter à freenode avec SSL ? Positionnez l'option _weechat.network.gnutls_ca_file_ avec le fichier des -certificats : +certificats : ---- /set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt" @@ -630,7 +630,7 @@ certificats : Vérifiez que vous avez bien ce fichier (fourni généralement par le paquet "ca-certificates"). -Configurez le port du serveur, SSL, puis connectez-vous : +Configurez le port du serveur, SSL, puis connectez-vous : ---- /set irc.server.freenode.addresses "chat.freenode.net/7000" @@ -646,7 +646,7 @@ Des serveurs tels que _twitch_ requièrent oauth pour se connecter. L'oauth est simplement un mot de passe avec la valeur "oauth:XXXX". Vous pouvez ajouter un tel serveur et vous y connecter avec les commandes -suivantes (remplacez le nom et l'adresse par les valeurs appropriées) : +suivantes (remplacez le nom et l'adresse par les valeurs appropriées) : ---- /server add nom irc.server.org -password=oauth:XXXX @@ -657,7 +657,7 @@ suivantes (remplacez le nom et l'adresse par les valeurs appropriées) : === Comment puis-je être identifié avant de rejoindre les canaux ? Si le serveur supporte SASL, vous devriez l'utiliser au lieu d'envoyer une -commande pour l'authentification avec nickserv, par exemple : +commande pour l'authentification avec nickserv, par exemple : ---- /set irc.server.freenode.sasl_username "mynick" @@ -665,7 +665,7 @@ commande pour l'authentification avec nickserv, par exemple : ---- Si le serveur ne supporte pas SASL, vous pouvez ajouter un délai (entre la -commande et le join des canaux) : +commande et le join des canaux) : ---- /set irc.server.freenode.command_delay 5 @@ -693,21 +693,21 @@ active/désactive les filtres). === Comment puis-je filtrer les messages join/part/quit sur les canaux IRC ? Avec le filtre intelligent (pour garder les join/part/quit des utilisateurs qui -ont parlé récemment) : +ont parlé récemment) : ---- /set irc.look.smart_filter on /filter add irc_smart * irc_smart_filter * ---- -Avec un filtre global (pour cacher *tous* les join/part/quit) : +Avec un filtre global (pour cacher *tous* les join/part/quit) : ---- /filter add joinquit * irc_join,irc_part,irc_quit * ---- [NOTE] -Pour l'aide : `/help filter` et `/help irc.look.smart_filter` +Pour l'aide : `/help filter` et `/help irc.look.smart_filter` [[filter_irc_join_channel_messages]] === Comment puis-je filtrer certains messages affichés quand je rejoins un canal IRC ? @@ -731,14 +731,14 @@ voice pour montrer les utilisateurs absents, et vous recevez plein de messages voice. Par conséquent, vous pouvez changer cela et laisser WeeChat utiliser une couleur spéciale pour les pseudos absents dans la liste des pseudos. -Pour Bitlbee ≥ 3, faites ceci sur le canal _&bitlbee_ : +Pour Bitlbee ≥ 3, faites ceci sur le canal _&bitlbee_ : ---- channel set show_users online,away ---- Pour une version plus ancienne de Bitlbee, faites ceci sur le canal -_&bitlbee_ : +_&bitlbee_ : ---- set away_devoice false @@ -749,7 +749,7 @@ Pour vérifier les pseudos absents dans WeeChat, voir la question à propos des Si vous voulez vraiment filtrer les messages voice, vous pouvez utiliser cette commande, mais elle n'est pas parfaite (elle fonctionne seulement si le -premier mode changé est voice) : +premier mode changé est voice) : ---- /filter add hidevoices * irc_mode (\+|\-)v @@ -765,7 +765,7 @@ Vous pouvez aussi positionner l'option _irc.server_default.away_check_max_nicks_ pour limiter la vérification d'absence sur les petits canaux seulement. Par exemple, pour vérifier les pseudos absents toutes les 5 minutes, pour les -canaux avec maximum 25 pseudos : +canaux avec maximum 25 pseudos : ---- /set irc.server_default.away_check 5 @@ -784,7 +784,7 @@ un highlight ou un message privé. Par conséquent vous pouvez configurer votre terminal (ou multiplexeur comme screen/tmux) pour lancer une commande ou jouer un son lorsque le _BEL_ se produit. -Ou vous pouvez ajouter une commande dans le trigger "beep" : +Ou vous pouvez ajouter une commande dans le trigger "beep" : ---- /set trigger.trigger.beep.command "/print -beep;/exec -bg /chemin/vers/commande paramètres" @@ -793,13 +793,13 @@ Ou vous pouvez ajouter une commande dans le trigger "beep" : Avec un WeeChat plus ancien, vous pouvez utiliser un script comme _beep.pl_ ou _launcher.pl_. -Pour _launcher.pl_, vous devez configurer la commande : +Pour _launcher.pl_, vous devez configurer la commande : ---- /set plugins.var.perl.launcher.signal.weechat_highlight "/chemin/vers/commande paramètres" ---- -Autres scripts sur ce sujet : +Autres scripts sur ce sujet : ---- /script search notify @@ -808,7 +808,7 @@ Autres scripts sur ce sujet : [[irc_target_buffer]] === Comment puis-je changer le serveur cible pour les commandes avec des tampons mélangés (comme le tampon avec les serveurs) ? -La touche par défaut est kbd:[Ctrl+x] (la commande est : +La touche par défaut est kbd:[Ctrl+x] (la commande est : `/input switch_active_buffer`). [[plugins_scripts]] @@ -820,7 +820,7 @@ La touche par défaut est kbd:[Ctrl+x] (la commande est : Sous OpenBSD, le nom des extensions se termine par ".so.0.0" (".so" sous Linux). -Vous devez configurer ça : +Vous devez configurer ça : ---- /set weechat.plugin.extension ".so.0.0" @@ -843,7 +843,7 @@ Les scripts ne sont pas compatibles avec d'autres clients IRC. Vous pouvez, mais ce n'est *PAS* recommandé. -La commande `/set` dans WeeChat est recommandée : +La commande `/set` dans WeeChat est recommandée : * Vous pouvez compléter la valeur avec la touche Tab. * La valeur est vérifiée, un message est affiché en cas d'erreur. @@ -851,7 +851,7 @@ La commande `/set` dans WeeChat est recommandée : quoi que ce soit. Si vous souhaitez quand même éditer les fichiers à la main, vous devez faire -attention : +attention : * Si vous mettez une valeur invalide pour une option, WeeChat affichera une erreur au chargement et ne tiendra pas compte de la valeur (la valeur par @@ -862,15 +862,15 @@ attention : [[memory_usage]] === Comment configurer WeeChat pour consommer moins de mémoire ? -Vous pouvez essayer les astuces suivantes pour consommer moins de mémoire : +Vous pouvez essayer les astuces suivantes pour consommer moins de mémoire : * Utiliser la dernière version stable (elle est supposée avoir moins de fuites de mémoire que les versions plus anciennes). -* Ne pas charger les extensions si vous ne les utilisez pas, par exemple : +* Ne pas charger les extensions si vous ne les utilisez pas, par exemple : aspell, fifo, logger, perl, python, ruby, lua, tcl, guile, javascript, xfer (utilisé pour les DCC). * Charger uniquement les scripts dont vous avez vraiment besoin. -* Ne pas charger les certificats si SSL n'est *PAS* utilisé : affecter une +* Ne pas charger les certificats si SSL n'est *PAS* utilisé : affecter une chaîne vide pour l'option _weechat.network.gnutls_ca_file_. * Réduire la valeur de l'option _weechat.history.max_buffer_lines_number_ ou affecter une valeur à l'option _weechat.history.max_buffer_lines_minutes_. @@ -880,27 +880,27 @@ Vous pouvez essayer les astuces suivantes pour consommer moins de mémoire : === Comment configurer WeeChat pour moins utiliser le processeur ? Vous pouvez suivre les mêmes astuces que pour la <>, et -celles-ci : +celles-ci : -* Cacher la barre "nicklist" : `/bar hide nicklist`. -* Supprimer l'affichage des secondes dans l'heure de la barre de statut : +* Cacher la barre "nicklist" : `/bar hide nicklist`. +* Supprimer l'affichage des secondes dans l'heure de la barre de statut : `/set weechat.look.item_time_format "%H:%M"` (ceci est la valeur par défaut). * Désactiver la vérification en temps réel des mots mal orthographiés dans la - ligne de commande (si vous l'avez activée) : `/set aspell.check.real_time off`. -* Définir la variable _TZ_ (par exemple : `export TZ="Europe/Paris"`), pour + ligne de commande (si vous l'avez activée) : `/set aspell.check.real_time off`. +* Définir la variable _TZ_ (par exemple : `export TZ="Europe/Paris"`), pour éviter un accès fréquent au fichier _/etc/localtime_. [[security]] === Je suis paranoïaque sur la sécurité, quels paramètres puis-je changer pour être encore plus sûr ? -Désactivez les messages de part et quit IRC : +Désactivez les messages de part et quit IRC : ---- /set irc.server_default.msg_part "" /set irc.server_default.msg_quit "" ---- -Désactivez les réponses à toutes les demandes CTCP : +Désactivez les réponses à toutes les demandes CTCP : ---- /set irc.ctcp.clientinfo "" @@ -913,7 +913,7 @@ Désactivez les réponses à toutes les demandes CTCP : ---- Déchargez et désactivez le chargement automatique de l'extension "xfer" -(utilisée pour le DCC IRC) : +(utilisée pour le DCC IRC) : ---- /plugin unload xfer @@ -921,11 +921,11 @@ Déchargez et désactivez le chargement automatique de l'extension "xfer" ---- Définissez une phrase de chiffrement et utilisez les données sécurisées partout -où vous le pouvez pour les données sensibles comme les mots de passe : voir +où vous le pouvez pour les données sensibles comme les mots de passe : voir `/help secure` et `/help` sur les options (si vous pouvez utiliser les données sécurisées, cela est mentionné dans l'aide). -Par exemple : +Par exemple : ---- /secure passphrase xxxxxxxxxx @@ -941,12 +941,12 @@ Par exemple : [[bug_task_patch]] === Comment puis-je reporter un bug, demander une nouvelle fonctionnalité ou envoyer un patch ? -Voir : https://weechat.org/dev/support +Voir : https://weechat.org/dev/support [[gdb_error_threads]] === Quand je lance WeeChat sous gdb, il y a une erreur à propos des threads, que puis-je faire ? -Quand vous lancez WeeChat sous gdb, vous pouvez avoir cette erreur : +Quand vous lancez WeeChat sous gdb, vous pouvez avoir cette erreur : ---- $ gdb /path/to/weechat @@ -956,7 +956,7 @@ Cannot find new threads: generic error ---- Pour corriger ça, vous pouvez lancer gdb avec cette commande (remplacez le -chemin vers libpthread et WeeChat avec les chemins sur votre système) : +chemin vers libpthread et WeeChat avec les chemins sur votre système) : ---- $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat @@ -966,7 +966,7 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat [[supported_os]] === Quelle est la liste des plates-formes supportées par WeeChat ? Sera-t-il porté sur d'autres systèmes d'exploitation ? -La liste complète est sur cette page : https://weechat.org/download +La liste complète est sur cette page : https://weechat.org/download Nous faisons le maximum pour supporter le plus de plates-formes possible. Toute aide est la bienvenue pour les systèmes que nous n'avons pas, pour y @@ -978,7 +978,7 @@ tester WeeChat. Il y a plusieurs choses à faire (test, code, documentation, etc...) Merci de prendre contact avec nous par IRC ou mail, consultez la page -support : https://weechat.org/dev/support +support : https://weechat.org/dev/support [[donate]] === Puis-je donner de l'argent ou d'autres choses aux développeurs WeeChat ? diff --git a/doc/fr/weechat_plugin_api.fr.adoc b/doc/fr/weechat_plugin_api.fr.adoc index b00af996b..16a1658ba 100644 --- a/doc/fr/weechat_plugin_api.fr.adoc +++ b/doc/fr/weechat_plugin_api.fr.adoc @@ -13,7 +13,7 @@ Ce manuel documente le client de messagerie instantanée WeeChat, il fait partie de WeeChat. -La dernière version de ce document peut être téléchargée sur cette page : +La dernière version de ce document peut être téléchargée sur cette page : https://weechat.org/doc @@ -47,7 +47,7 @@ WeeChat. [[macros]] === Macros -L'extension doit utiliser des macros (pour définir quelques variables) : +L'extension doit utiliser des macros (pour définir quelques variables) : WEECHAT_PLUGIN_NAME("name"):: nom de l'extension @@ -67,7 +67,7 @@ WEECHAT_PLUGIN_PRIORITY(1000):: [[main_functions]] === Fonctions principales -L'extension doit utiliser deux fonctions : +L'extension doit utiliser deux fonctions : * weechat_plugin_init * weechat_plugin_end @@ -76,7 +76,7 @@ L'extension doit utiliser deux fonctions : Cette fonction est appelée quand l'extension est chargée par WeeChat. -Prototype : +Prototype : [source,C] ---- @@ -84,14 +84,14 @@ int weechat_plugin_init (struct t_weechat_plugin *plugin, int argc, char *argv[]); ---- -Paramètres : +Paramètres : -* _plugin_ : pointeur vers la structure d'extension WeeChat -* _argc_ : nombre de paramètres pour l'extension (donnés sur la ligne de +* _plugin_ : pointeur vers la structure d'extension WeeChat +* _argc_ : nombre de paramètres pour l'extension (donnés sur la ligne de commande par l'utilisateur) -* _argv_ : paramètres pour l'extension +* _argv_ : paramètres pour l'extension -Valeur de retour : +Valeur de retour : * _WEECHAT_RC_OK_ si ok (l'extension sera chargée) * _WEECHAT_RC_ERROR_ si erreur (l'extension ne sera PAS chargée) @@ -107,7 +107,7 @@ Une grande priorité signifie que la fonction _init_ est appelée en premier. La priorité par défaut est 1000 (avec une telle priorité, l'extension est chargée après toutes les extensions par défaut). -Les extensions par défaut de WeeChat sont initialisées dans cet ordre : +Les extensions par défaut de WeeChat sont initialisées dans cet ordre : include::autogen/plugin_api/plugins_priority.adoc[] @@ -115,18 +115,18 @@ include::autogen/plugin_api/plugins_priority.adoc[] Cette fonction est appelée quand l'extension est déchargée par WeeChat. -Prototype : +Prototype : [source,C] ---- int weechat_plugin_end (struct t_weechat_plugin *plugin); ---- -Paramètres : +Paramètres : -* _plugin_ : pointeur vers la structure d'extension WeeChat +* _plugin_ : pointeur vers la structure d'extension WeeChat -Valeur de retour : +Valeur de retour : * _WEECHAT_RC_OK_ si ok * _WEECHAT_RC_ERROR_ si erreur @@ -137,7 +137,7 @@ Valeur de retour : La compilation ne nécessite pas les sources de WeeChat, seul le fichier _weechat-plugin.h_ est requis. -Pour compiler l'extension qui n'a qu'un fichier "toto.c" (sous GNU/Linux) : +Pour compiler l'extension qui n'a qu'un fichier "toto.c" (sous GNU/Linux) : ---- $ gcc -fPIC -Wall -c toto.c @@ -151,7 +151,7 @@ Copiez le fichier _libtoto.so_ dans le répertoire système des extensions (par exemple _/usr/local/lib/weechat/plugins_) ou dans le répertoire utilisateur des extensions (par exemple _/home/xxx/.weechat/plugins_). -Sous WeeChat : +Sous WeeChat : ---- /plugin load toto @@ -160,9 +160,9 @@ Sous WeeChat : [[plugin_example]] === Exemple d'extension -Exemple complet d'extension, qui ajoute une commande `/double` : affiche deux +Exemple complet d'extension, qui ajoute une commande `/double` : affiche deux fois les paramètres sur le tampon courant, ou exécute deux fois une commande -(ok ce n'est pas très utile, mais c'est juste un exemple !) : +(ok ce n'est pas très utile, mais c'est juste un exemple !) : [source,C] ---- @@ -210,8 +210,8 @@ weechat_plugin_init (struct t_weechat_plugin *plugin, "Affiche deux fois un message " "ou exécute deux fois une commande", "message | commande", - "message : message à afficher deux fois\n" - "commande : commande à exécuter deux fois", + "message : message à afficher deux fois\n" + "commande : commande à exécuter deux fois", NULL, &commande_double_cb, NULL, NULL); @@ -234,7 +234,7 @@ weechat_plugin_end (struct t_weechat_plugin *plugin) Les chapitres ci-dessous décrivent les fonctions de l'API, classées par catégorie. -Pour chaque fonction, on donne : +Pour chaque fonction, on donne : * une description de la fonction, * le prototype en C, @@ -253,30 +253,30 @@ Fonctions pour obtenir des informations sur les extensions. Retourner le nom d'une extension. -Prototype : +Prototype : [source,C] ---- const char *weechat_plugin_get_name (struct t_weechat_plugin *plugin); ---- -Paramètres : +Paramètres : -* _plugin_ : pointeur vers la structure d'extension WeeChat (peut être NULL) +* _plugin_ : pointeur vers la structure d'extension WeeChat (peut être NULL) -Valeur de retour : +Valeur de retour : * nom de l'extension, "core" pour le cœur de WeeChat (si le pointeur vers l'extension est NULL) -Exemple en C : +Exemple en C : [source,C] ---- const char *name = weechat_plugin_get_name (plugin); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -301,25 +301,25 @@ Définir le nouveau jeu de caractères (le jeu de caractères par défaut est _UTF-8_, donc si votre extension utilise _UTF-8_, vous n'avez pas besoin d'appeler cette fonction). -Prototype : +Prototype : [source,C] ---- void weechat_charset_set (const char *charset); ---- -Paramètres : +Paramètres : -* _charset_ : nouveau jeu de caractères à utiliser +* _charset_ : nouveau jeu de caractères à utiliser -Exemple en C : +Exemple en C : [source,C] ---- weechat_charset_set ("iso-8859-1"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -334,32 +334,32 @@ weechat.charset_set("iso-8859-1") Convertir une chaîne vers le jeu de caractères interne (UTF-8). -Prototype : +Prototype : [source,C] ---- char *weechat_iconv_to_internal (const char *charset, const char *string); ---- -Paramètres : +Paramètres : -* _charset_ : jeu de caractères à convertir -* _string_ : chaîne à convertir +* _charset_ : jeu de caractères à convertir +* _string_ : chaîne à convertir -Valeur de retour : +Valeur de retour : * chaîne convertie (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- -char *str = weechat_iconv_to_internal ("iso-8859-1", "chaîne iso : é à"); +char *str = weechat_iconv_to_internal ("iso-8859-1", "chaîne iso : é à"); /* ... */ free (str); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -367,39 +367,39 @@ Script (Python) : str = weechat.iconv_to_internal(charset, string) # exemple -str = weechat.iconv_to_internal("iso-8859-1", "chaîne iso : é à") +str = weechat.iconv_to_internal("iso-8859-1", "chaîne iso : é à") ---- ==== iconv_from_internal Convertir une chaîne du jeu de caractères interne (UTF-8) vers un autre. -Prototype : +Prototype : [source,C] ---- char *weechat_iconv_from_internal (const char *charset, const char *string); ---- -Paramètres : +Paramètres : -* _charset_ : jeu de caractères cible -* _string_ : chaîne à convertir +* _charset_ : jeu de caractères cible +* _string_ : chaîne à convertir -Valeur de retour : +Valeur de retour : * chaîne convertie (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- -char *str = weechat_iconv_from_internal ("iso-8859-1", "chaîne utf-8 : é à"); +char *str = weechat_iconv_from_internal ("iso-8859-1", "chaîne utf-8 : é à"); /* ... */ free (str); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -407,36 +407,36 @@ Script (Python) : str = weechat.iconv_from_internal(charset, string) # exemple -str = weechat.iconv_from_internal("iso-8859-1", "chaîne utf-8 : é à") +str = weechat.iconv_from_internal("iso-8859-1", "chaîne utf-8 : é à") ---- ==== gettext Retourner la chaîne traduite (dépend de la langue locale). -Prototype : +Prototype : [source,C] ---- const char *weechat_gettext (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne à traduire +* _string_ : chaîne à traduire -Valeur de retour : +Valeur de retour : * chaîne traduite -Exemple en C : +Exemple en C : [source,C] ---- char *str = weechat_gettext ("hello"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -452,7 +452,7 @@ str = weechat.gettext("hello") Retourner la chaîne traduite, en utilisant le singulier ou le pluriel, selon le paramètre _count_. -Prototype : +Prototype : [source,C] ---- @@ -460,25 +460,25 @@ const char *weechat_ngettext (const char *string, const char *plural, int count); ---- -Paramètres : +Paramètres : -* _string_ : chaîne à traduire, au singulier -* _plural_ : chaîne à traduire, au pluriel -* _count_ : utilisé pour choisir entre le singulier et le pluriel (le choix est +* _string_ : chaîne à traduire, au singulier +* _plural_ : chaîne à traduire, au pluriel +* _count_ : utilisé pour choisir entre le singulier et le pluriel (le choix est fonction de la langue utilisée) -Valeur de retour : +Valeur de retour : * chaîne traduite -Exemple en C : +Exemple en C : [source,C] ---- char *str = weechat_ngettext ("file", "files", num_files); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -494,27 +494,27 @@ str = weechat.ngettext("file", "files", num_files) Retourner la chaîne dupliquée, avec au plus _length_ caractères. -Prototype : +Prototype : [source,C] ---- char *weechat_strndup (const char *string, int length); ---- -Paramètres : +Paramètres : -* _string_ : chaîne à dupliquer -* _length_ : nombre maximum de caractères à dupliquer +* _string_ : chaîne à dupliquer +* _length_ : nombre maximum de caractères à dupliquer -Valeur de retour : +Valeur de retour : * chaîne dupliquée (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- -char *str = weechat_strndup ("abcdef", 3); /* résultat : "abc" */ +char *str = weechat_strndup ("abcdef", 3); /* résultat : "abc" */ /* ... */ free (str); ---- @@ -526,23 +526,23 @@ Cette fonction n'est pas disponible dans l'API script. Convertir une chaîne UTF-8 en minuscules. -Prototype : +Prototype : [source,C] ---- void weechat_string_tolower (char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne à convertir +* _string_ : chaîne à convertir -Exemple en C : +Exemple en C : [source,C] ---- char str[] = "AbCdé"; -weechat_string_tolower (str); /* str vaut maintenant : "abcdé" */ +weechat_string_tolower (str); /* str vaut maintenant : "abcdé" */ ---- [NOTE] @@ -552,23 +552,23 @@ Cette fonction n'est pas disponible dans l'API script. Convertir une chaîne UTF-8 en majuscules. -Prototype : +Prototype : [source,C] ---- void weechat_string_toupper (char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne à convertir +* _string_ : chaîne à convertir -Exemple en C : +Exemple en C : [source,C] ---- char str[] = "AbCdé"; -weechat_string_toupper (str); /* str vaut maintenant : "ABCDé" */ +weechat_string_toupper (str); /* str vaut maintenant : "ABCDé" */ ---- [NOTE] @@ -580,25 +580,25 @@ _Mis à jour dans la 1.0._ Comparer deux chaînes indépendemment de la locale et de la casse. -Prototype : +Prototype : [source,C] ---- int weechat_strcasecmp (const char *string1, const char *string2); ---- -Paramètres : +Paramètres : -* _string1_ : première chaîne à comparer -* _string2_ : seconde chaîne à comparer +* _string1_ : première chaîne à comparer +* _string2_ : seconde chaîne à comparer -Valeur de retour : +Valeur de retour : * -1 si string1 < string2 * 0 si string1 == string2 * 1 si string1 > string2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -615,32 +615,32 @@ _WeeChat ≥ 0.3.7, mis à jour dans la 1.0._ Comparer deux chaînes indépendemment de la locale et de la casse, avec un intervalle pour comparer la casse. -Prototype : +Prototype : [source,C] ---- int weechat_strcasecmp_range (const char *string1, const char *string2, int range); ---- -Paramètres : +Paramètres : -* _string1_ : première chaîne à comparer -* _string2_ : seconde chaîne à comparer -* _range_ : nombre de caractères pour la comparaison de casse, par exemple : -** 26 : `+A-Z+` deviennent en minuscules `a-z` -** 29 : `+A-Z [ \ ]+` deviennent minuscules `+a-z { | }+` -** 30 : `+A-Z [ \ ] ^+` deviennent minuscules `+a-z { | } ~+` +* _string1_ : première chaîne à comparer +* _string2_ : seconde chaîne à comparer +* _range_ : nombre de caractères pour la comparaison de casse, par exemple : +** 26 : `+A-Z+` deviennent en minuscules `a-z` +** 29 : `+A-Z [ \ ]+` deviennent minuscules `+a-z { | }+` +** 30 : `+A-Z [ \ ] ^+` deviennent minuscules `+a-z { | } ~+` [NOTE] Les valeurs 29 et 30 sont utilisés par quelques protocoles comme IRC. -Valeur de retour : +Valeur de retour : * -1 si string1 < string2 * 0 si string1 == string2 * 1 si string1 > string2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -657,26 +657,26 @@ _Mis à jour dans la 1.0._ Comparer deux chaînes indépendemment de la locale et de la casse, pour _max_ caractères. -Prototype : +Prototype : [source,C] ---- int weechat_strncasecmp (const char *string1, const char *string2, int max); ---- -Paramètres : +Paramètres : -* _string1_ : première chaîne à comparer -* _string2_ : seconde chaîne à comparer -* _max_ : nombre maximum de caractères à comparer +* _string1_ : première chaîne à comparer +* _string2_ : seconde chaîne à comparer +* _max_ : nombre maximum de caractères à comparer -Valeur de retour : +Valeur de retour : * -1 si string1 < string2 * 0 si string1 == string2 * 1 si string1 > string2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -693,33 +693,33 @@ _WeeChat ≥ 0.3.7, mis à jour dans la 1.0._ Comparer deux chaînes indépendemment de la locale et de la casse, pour _max_ caractères, avec un intervalle pour comparer la casse. -Prototype : +Prototype : [source,C] ---- int weechat_strncasecmp_range (const char *string1, const char *string2, int max, int range); ---- -Paramètres : +Paramètres : -* _string1_ : première chaîne à comparer -* _string2_ : seconde chaîne à comparer -* _max_ : nombre maximum de caractères à comparer -* _range_ : nombre de caractères pour la comparaison de casse, par exemple : -** 26 : `+A-Z+` deviennent en minuscules `+a-z+` -** 29 : `+A-Z [ \ ]+` deviennent minuscules `+a-z { | }+` -** 30 : `+A-Z [ \ ] ^+` deviennent minuscules `+a-z { | } ~+` +* _string1_ : première chaîne à comparer +* _string2_ : seconde chaîne à comparer +* _max_ : nombre maximum de caractères à comparer +* _range_ : nombre de caractères pour la comparaison de casse, par exemple : +** 26 : `+A-Z+` deviennent en minuscules `+a-z+` +** 29 : `+A-Z [ \ ]+` deviennent minuscules `+a-z { | }+` +** 30 : `+A-Z [ \ ] ^+` deviennent minuscules `+a-z { | } ~+` [NOTE] Les valeurs 29 et 30 sont utilisés par quelques protocoles comme IRC. -Valeur de retour : +Valeur de retour : * -1 si string1 < string2 * 0 si string1 == string2 * 1 si string1 > string2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -736,7 +736,7 @@ _Mis à jour dans la 1.0._ Comparer deux chaînes indépendemment de la locale (et en option de la casse), en ignorant des caractères. -Prototype : +Prototype : [source,C] ---- @@ -745,20 +745,20 @@ int weechat_strcmp_ignore_chars (const char *string1, const char *string2, int case_sensitive); ---- -Paramètres : +Paramètres : -* _string1_ : première chaîne à comparer -* _string2_ : seconde chaîne à comparer -* _chars_ignored_ : chaîne avec les caractères à ignorer -* _case_sensitive_ : 1 pour une comparaison tenant compte de la casse, sinon 0 +* _string1_ : première chaîne à comparer +* _string2_ : seconde chaîne à comparer +* _chars_ignored_ : chaîne avec les caractères à ignorer +* _case_sensitive_ : 1 pour une comparaison tenant compte de la casse, sinon 0 -Valeur de retour : +Valeur de retour : * -1 si string1 < string2 * 0 si string1 == string2 * 1 si string1 > string2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -774,29 +774,29 @@ _Mis à jour dans la 1.3._ Rechercher une chaîne indépendemment de la locale et de la casse. -Prototype : +Prototype : [source,C] ---- const char *weechat_strcasestr (const char *string, const char *search); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _search_ : chaîne à rechercher dans _string_ +* _string_ : chaîne +* _search_ : chaîne à rechercher dans _string_ -Valeur de retour : +Valeur de retour : * pointeur vers la chaîne trouvée, ou NULL si non trouvée - (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un + (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un _char *_) -Exemple en C : +Exemple en C : [source,C] ---- -const char *pos = weechat_strcasestr ("aBcDeF", "de"); /* résultat : pointeur vers "DeF" */ +const char *pos = weechat_strcasestr ("aBcDeF", "de"); /* résultat : pointeur vers "DeF" */ ---- [NOTE] @@ -811,29 +811,29 @@ sur l'écran. Les caractères non affichables ont une longueur de 1 (c'est la différence avec la fonction <<_utf8_strlen_screen,utf8_strlen_screen>>). -Prototype : +Prototype : [source,C] ---- int weechat_strlen_screen (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * nombre de caractères nécessaires pour afficher la chaîne UTF-8 sur l'écran -Exemple en C : +Exemple en C : [source,C] ---- int length_on_screen = weechat_strlen_screen ("é"); /* == 1 */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -850,7 +850,7 @@ _Mis à jour dans la 1.0._ Vérifier si une chaîne correspond à un masque. -Prototype : +Prototype : [source,C] ---- @@ -858,22 +858,22 @@ int weechat_string_match (const char *string, const char *mask, int case_sensitive); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _mask_ : masque avec des caractères joker (`+*+`), chaque joker correspond à 0 +* _string_ : chaîne +* _mask_ : masque avec des caractères joker (`+*+`), chaque joker correspond à 0 ou plusieurs caractères dans la chaîne -* _case_sensitive_ : 1 pour une comparaison tenant compte de la casse, sinon 0 +* _case_sensitive_ : 1 pour une comparaison tenant compte de la casse, sinon 0 [NOTE] Depuis la version 1.0, les caractères joker sont autorisés à l'intérieur du masque (pas seulement au début et à la fin du masque). -Valeur de retour : +Valeur de retour : * 1 si la chaîne correspond au masque, sinon 0 -Exemple en C : +Exemple en C : [source,C] ---- @@ -884,7 +884,7 @@ int match4 = weechat_string_match ("abcdef", "*de*", 0); /* == 1 */ int match5 = weechat_string_match ("abcdef", "*b*d*", 0); /* == 1 */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -906,28 +906,28 @@ _WeeChat ≥ 0.3.3._ Remplacer le `+~+` en début de chaîne par le répertoire "home". Si la chaîne ne débute pas par `+~+`, alors une chaîne identique est retournée. -Prototype : +Prototype : [source,C] ---- char *weechat_string_expand_home (const char *path); ---- -Paramètres : +Paramètres : -* _path_ : chemin +* _path_ : chemin -Valeur de retour : +Valeur de retour : * chemin avec le `+~+` en début remplacé par le répertoire "home" (doit être supprimé par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- char *str = weechat_string_expand_home ("~/fichier.txt"); -/* résultat : "/home/xxx/fichier.txt" */ +/* résultat : "/home/xxx/fichier.txt" */ /* ... */ free (str); ---- @@ -939,14 +939,14 @@ Cette fonction n'est pas disponible dans l'API script. _WeeChat ≥ 1.3._ -Évaluer un chemin en 3 étapes : +Évaluer un chemin en 3 étapes : . remplacer le `%h` du début par le répertoire maison de WeeChat, . remplacer le `+~+` du début par le répertoire maison de l'utilisateur (appel à <<_string_expand_home,string_expand_home>>), . évaluer les variables (voir <<_string_eval_expression,string_eval_expression>>). -Prototype : +Prototype : [source,C] ---- @@ -956,31 +956,31 @@ char *weechat_string_eval_path_home (const char *path, struct t_hashtable *options); ---- -Paramètres : +Paramètres : -* _path_ : chemin -* _pointers_ : table de hachage pour l'appel à la fonction +* _path_ : chemin +* _pointers_ : table de hachage pour l'appel à la fonction <<_string_eval_expression,string_eval_expression>> -* _extra_vars_ : table de hachage pour l'appel à la fonction +* _extra_vars_ : table de hachage pour l'appel à la fonction <<_string_eval_expression,string_eval_expression>> -* _options_ : table de hachage pour l'appel à la fonction +* _options_ : table de hachage pour l'appel à la fonction <<_string_eval_expression,string_eval_expression>> -Valeur de retour : +Valeur de retour : * chemin évalué (doit être supprimé par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- char *str = weechat_string_eval_path_home ("%h/test", NULL, NULL, NULL); -/* résultat : "/home/xxx/.weechat/test" */ +/* résultat : "/home/xxx/.weechat/test" */ /* ... */ free (str); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -997,29 +997,29 @@ path = weechat.string_eval_path_home("%h/test", {}, {}, {}) Supprimer les apostrophes/guillemets au début et à la fin d'une chaîne (les espaces avant la première apostrophe ou après la dernière sont ignorés). -Prototype : +Prototype : [source,C] ---- char *weechat_string_remove_quotes (const char *string, const char *quotes); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _quotes_ : chaîne avec la liste des apostrophes/guillemets à supprimer +* _string_ : chaîne +* _quotes_ : chaîne avec la liste des apostrophes/guillemets à supprimer -Valeur de retour : +Valeur de retour : * chaîne sans les apostrophes/guillemets au début et à la fin (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- char *str = weechat_string_remove_quotes (string, " 'aujourd'hui' ", "'"); -/* résultat : "aujourd'hui" */ +/* résultat : "aujourd'hui" */ /* ... */ free (str); ---- @@ -1031,7 +1031,7 @@ Cette fonction n'est pas disponible dans l'API script. Supprimer des caractères au début et/ou à la fin d'une chaîne. -Prototype : +Prototype : [source,C] ---- @@ -1039,23 +1039,23 @@ char *weechat_string_strip (const char *string, int left, int right, const char *chars); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _left_ : supprime les caractères en début de chaîne si différent de 0 -* _right_ : supprime les caractères en fin de chaîne si différent de 0 -* _chars_ : chaîne avec les caractères à supprimer +* _string_ : chaîne +* _left_ : supprime les caractères en début de chaîne si différent de 0 +* _right_ : supprime les caractères en fin de chaîne si différent de 0 +* _chars_ : chaîne avec les caractères à supprimer -Valeur de retour : +Valeur de retour : * chaîne avec les caractères supprimés (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- -char *str = weechat_string_strip (".abc -", 0, 1, "- ."); /* résultat : ".abc" */ +char *str = weechat_string_strip (".abc -", 0, 1, "- ."); /* résultat : ".abc" */ /* ... */ free (str); ---- @@ -1067,47 +1067,47 @@ Cette fonction n'est pas disponible dans l'API script. _WeeChat ≥ 1.0._ -Convertir les caractères échappés par leur valeur : +Convertir les caractères échappés par leur valeur : -* `+\"+` : double guillemet droit -* `+\\+` : barre oblique inversée -* `+\a+` : alerte (BEL) -* `+\b+` : retour arrière -* `+\e+` : échappement -* `+\f+` : saut de page -* `+\n+` : nouvelle ligne -* `+\r+` : retour chariot -* `+\t+` : tabulation horizontale -* `+\v+` : tabulation verticale -* `+\0ooo+` : caractère sous forme de valeur octale (`ooo` a 0 à 3 chiffres) -* `+\xhh+` : caractère sous forme de valeur hexadécimale (`hh` a 1 à 2 chiffres) -* `+\uhhhh+` : caractère unicode sous forme de valeur hexadécimale +* `+\"+` : double guillemet droit +* `+\\+` : barre oblique inversée +* `+\a+` : alerte (BEL) +* `+\b+` : retour arrière +* `+\e+` : échappement +* `+\f+` : saut de page +* `+\n+` : nouvelle ligne +* `+\r+` : retour chariot +* `+\t+` : tabulation horizontale +* `+\v+` : tabulation verticale +* `+\0ooo+` : caractère sous forme de valeur octale (`ooo` a 0 à 3 chiffres) +* `+\xhh+` : caractère sous forme de valeur hexadécimale (`hh` a 1 à 2 chiffres) +* `+\uhhhh+` : caractère unicode sous forme de valeur hexadécimale (`hhhh` a 1 à 4 chiffres) -* `+\Uhhhhhhhh+` : caractère unicode sous forme de valeur hexadécimale +* `+\Uhhhhhhhh+` : caractère unicode sous forme de valeur hexadécimale (`hhhhhhhh` a 1 à 8 chiffres) -Prototype : +Prototype : [source,C] ---- char *weechat_string_convert_escaped_chars (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * chaîne avec les caractères échappés remplacés par leur valeur (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- -char *str = weechat_string_convert_escaped_chars ("snowman : \\u2603"); -/* str == "snowman : ☃" */ +char *str = weechat_string_convert_escaped_chars ("snowman : \\u2603"); +/* str == "snowman : ☃" */ /* ... */ free (str); ---- @@ -1121,33 +1121,33 @@ Retourner une expression régulière ("regex"), construite avec un masque où le seul caractère spécial est `+*+`. Tous les autres caractères spéciaux d'expression régulière sont échappés. -Prototype : +Prototype : [source,C] ---- char *weechat_string_mask_to_regex (const char *mask); ---- -Paramètres : +Paramètres : -* _mask_ : masque +* _mask_ : masque -Valeur de retour : +Valeur de retour : * expression régulière, sous forme de chaîne (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- char *str_regex = weechat_string_mask_to_regex ("test*mask"); -/* résultat : "test.*mask" */ +/* résultat : "test.*mask" */ /* ... */ free (str_regex); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -1165,42 +1165,42 @@ _WeeChat ≥ 0.3.7._ Retourner un pointeur dans la chaîne après les "flags" et le masque avec les "flags" pour compiler l'expression régulière. -Prototype : +Prototype : [source,C] ---- const char *weechat_string_regex_flags (const char *regex, int default_flags, int *flags) ---- -Paramètres : +Paramètres : -* _regex_ : expression régulière POSIX étendue -* _default_flags_ : combinaison des valeurs suivantes (voir `man regcomp`) : +* _regex_ : expression régulière POSIX étendue +* _default_flags_ : combinaison des valeurs suivantes (voir `man regcomp`) : ** REG_EXTENDED ** REG_ICASE ** REG_NEWLINE ** REG_NOSUB -* _flags_ : la valeur du pointer est alimentée avec les "flags" utilisés dans +* _flags_ : la valeur du pointer est alimentée avec les "flags" utilisés dans l'expression régulière ("flags" par défaut + "flags" définis dans l'expression régulière) -Les "flags" doivent être au début de l'expression régulière. Le format est : +Les "flags" doivent être au début de l'expression régulière. Le format est : "(?eins-eins)chaîne". -Les "flags" autorisés sont : +Les "flags" autorisés sont : -* _e_ : expression régulière POSIX étendue (_REG_EXTENDED_) -* _i_ : insensible à la casse (_REG_ICASE_) -* _n_ : les opérateurs qui cherchent n'importe quel caractère ne trouvent pas +* _e_ : expression régulière POSIX étendue (_REG_EXTENDED_) +* _i_ : insensible à la casse (_REG_ICASE_) +* _n_ : les opérateurs qui cherchent n'importe quel caractère ne trouvent pas les nouvelles lignes (_REG_NEWLINE_) -* _s_ : le support d'adressage des sous-chaînes de correspondance n'est pas +* _s_ : le support d'adressage des sous-chaînes de correspondance n'est pas requis (_REG_NOSUB_) -Valeur de retour : +Valeur de retour : * pointeur dans la _regex_, après les "flags" -Exemple en C : +Exemple en C : [source,C] ---- @@ -1220,29 +1220,29 @@ _WeeChat ≥ 0.3.7._ Compiler une expression régulière avec des "flags" optionnels en début de chaîne (pour le format des "flags", voir <<_string_regex_flags,string_regex_flags>>). -Prototype : +Prototype : [source,C] ---- int weechat_string_regcomp (void *preg, const char *regex, int default_flags) ---- -Paramètres : +Paramètres : -* _preg_ : pointeur vers la structure _regex_t_ -* _regex_ : expression régulière POSIX étendue -* _default_flags_ : combinaison des valeurs suivantes (voir `man regcomp`) : +* _preg_ : pointeur vers la structure _regex_t_ +* _regex_ : expression régulière POSIX étendue +* _default_flags_ : combinaison des valeurs suivantes (voir `man regcomp`) : ** REG_EXTENDED ** REG_ICASE ** REG_NEWLINE ** REG_NOSUB -Valeur de retour : +Valeur de retour : * même code retour que la fonction `regcomp` (0 si ok, autre valeur pour une erreur, voir `man regcomp`) -Exemple en C : +Exemple en C : [source,C] ---- @@ -1261,7 +1261,7 @@ Cette fonction n'est pas disponible dans l'API script. Vérifier si une chaîne a un ou plusieurs "highlights", en utilisant une liste de mots "highlight". -Prototype : +Prototype : [source,C] ---- @@ -1269,23 +1269,23 @@ int weechat_string_has_highlight (const char *string, const char highlight_words); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _highlight_words_ : liste de mots "highlight", séparés par des virgules +* _string_ : chaîne +* _highlight_words_ : liste de mots "highlight", séparés par des virgules -Valeur de retour : +Valeur de retour : * 1 si la chaîne a un ou plusieurs "highlights", sinon 0 -Exemple en C : +Exemple en C : [source,C] ---- int hl = weechat_string_has_highlight ("my test string", "test,word2"); /* == 1 */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -1303,32 +1303,32 @@ _WeeChat ≥ 0.3.4._ Vérifier si une chaîne a un ou plusieurs "highlights", en utilisant une expression régulière POSIX étendue. + Pour au moins une correspondance dans la chaîne, elle doit être entourée de -délimiteurs (caractères différents de : alphanumérique, `+-+`, `+_+` et `+|+`). +délimiteurs (caractères différents de : alphanumérique, `+-+`, `+_+` et `+|+`). -Prototype : +Prototype : [source,C] ---- int weechat_string_has_highlight_regex (const char *string, const char *regex); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _regex_ : expression régulière POSIX étendue +* _string_ : chaîne +* _regex_ : expression régulière POSIX étendue -Valeur de retour : +Valeur de retour : * 1 si la chaîne a un ou plusieurs "highlights", sinon 0 -Exemple en C : +Exemple en C : [source,C] ---- int hl = weechat_string_has_highlight_regex ("my test string", "test|word2"); /* == 1 */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -1343,7 +1343,7 @@ highlight = weechat.string_has_highlight_regex("my test string", "test|word2") Remplacer toutes les occurrences d'une chaîne par une autre chaîne. -Prototype : +Prototype : [source,C] ---- @@ -1351,22 +1351,22 @@ char *weechat_string_replace (const char *string, const char *search, const char *replace); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _search_ : chaîne à remplacer -* _replace_ : remplacement pour la chaîne _search_ +* _string_ : chaîne +* _search_ : chaîne à remplacer +* _replace_ : remplacement pour la chaîne _search_ -Valeur de retour : +Valeur de retour : * chaîne avec _search_ remplacée par _replace_ (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- -char *str = weechat_string_replace ("test, test", "s", "x"); /* résultat : "text" */ +char *str = weechat_string_replace ("test, test", "s", "x"); /* résultat : "text" */ /* ... */ free (str); ---- @@ -1381,7 +1381,7 @@ _WeeChat ≥ 1.0._ Remplacer du texte dans une chaîne en utilisant une expression régulière, du texte de remplacement et un "callback" optionnel. -Prototype : +Prototype : [source,C] ---- @@ -1391,37 +1391,37 @@ char *weechat_string_replace_regex (const char *string, void *regex, void *callback_data); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _regex_ : pointeur vers une expression régulière (structure _regex_t_) +* _string_ : chaîne +* _regex_ : pointeur vers une expression régulière (structure _regex_t_) compilée avec la fonction WeeChat <<_string_regcomp,string_regcomp>> ou regcomp (voir `man regcomp`) -* _replace_ : texte de remplacement, où les références suivantes sont - autorisées : -** `+$0+` à `+$99+` : correspondance 0 à 99 dans l'expression régulière (0 est la +* _replace_ : texte de remplacement, où les références suivantes sont + autorisées : +** `+$0+` à `+$99+` : correspondance 0 à 99 dans l'expression régulière (0 est la correspondance entière, 1 à 99 sont les groupes capturés entre parenthèses) -** `+$++` : la dernière correspondance (avec le numéro le plus élevé) -** `+$.*N+` : correspondance `+N+` (peut être `+++` ou de `+0+` à `+99+`), avec +** `+$++` : la dernière correspondance (avec le numéro le plus élevé) +** `+$.*N+` : correspondance `+N+` (peut être `+++` ou de `+0+` à `+99+`), avec tous les caractères remplacés par `+*+` (le caractère `+*+` peut être n'importe quel caractère entre l'espace (32) et `+~+` (126)) -* _reference_char_ : le caractère utilisé pour les références aux +* _reference_char_ : le caractère utilisé pour les références aux correspondances (en général `+$+`) -* _callback_ : un "callback" optionnel appelé pour chaque référence dans +* _callback_ : un "callback" optionnel appelé pour chaque référence dans _replace_ (sauf pour les correspondances remplacées par un caractère); le - "callback" doit retourner : -** une chaîne nouvellement allouée : elle est utilisée en texte de remplacement + "callback" doit retourner : +** une chaîne nouvellement allouée : elle est utilisée en texte de remplacement (elle est libérée après utilisation) -** NULL : le texte reçu dans le "callback" est utilisé comme texte de +** NULL : le texte reçu dans le "callback" est utilisé comme texte de remplacement (sans changement) -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé -Valeur de retour : +Valeur de retour : * chaîne avec le texte remplacé, NULL en cas de problème (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- @@ -1430,9 +1430,9 @@ char *string; if (weechat_string_regcomp (&my_regex, "([0-9]{4})-([0-9]{2})-([0-9]{2})", REG_EXTENDED) == 0) { - string = weechat_string_replace_regex ("date : 2014-02-14", &my_regex, + string = weechat_string_replace_regex ("date : 2014-02-14", &my_regex, "$3/$2/$1", '$', NULL, NULL); - /* string == "date : 14/02/2014" */ + /* string == "date : 14/02/2014" */ if (string) free (string); regfree (&my_regex); @@ -1446,7 +1446,7 @@ Cette fonction n'est pas disponible dans l'API script. Découper une chaîne à l'aide de délimiteur(s). -Prototype : +Prototype : [source,C] ---- @@ -1455,34 +1455,34 @@ char **weechat_string_split (const char *string, const char *separators, int *num_items); ---- -Paramètres : +Paramètres : -* _string_ : chaîne à découper -* _separators_ : délimiteurs utilisés pour le découpage -* _keep_eol_ : si différent de 0, alors chaque paramètre contiendra toutes les +* _string_ : chaîne à découper +* _separators_ : délimiteurs utilisés pour le découpage +* _keep_eol_ : si différent de 0, alors chaque paramètre contiendra toutes les chaînes jusqu'à la fin de la ligne (voir exemple ci-dessous) -** 0 : chaque chaîne contiendra un mot -** 1 : chaque chaîne contiendra toute la chaîne jusqu'à la fin de la ligne (voir +** 0 : chaque chaîne contiendra un mot +** 1 : chaque chaîne contiendra toute la chaîne jusqu'à la fin de la ligne (voir exemple ci-dessous) -** 2 : comme 1, mais ne supprime pas les séparateurs en fin de chaîne avant le +** 2 : comme 1, mais ne supprime pas les séparateurs en fin de chaîne avant le découpage _(WeeChat ≥ 0.3.6)_ -* _num_items_max_ : nombre maximum de chaînes à créer (0 = pas de limite) -* _num_items_ : pointeur vers un entier qui contiendra le nombre de chaînes +* _num_items_max_ : nombre maximum de chaînes à créer (0 = pas de limite) +* _num_items_ : pointeur vers un entier qui contiendra le nombre de chaînes créées -Valeur de retour : +Valeur de retour : * tableau de chaînes, NULL en cas de problème (doit être supprimé par un appel à <<_string_free_split,string_free_split>> après utilisation) -Exemples en C : +Exemples en C : [source,C] ---- char **argv; int argc; argv = weechat_string_split ("abc de fghi ", " ", 0, 0, &argc); -/* résultat : argv[0] == "abc" +/* résultat : argv[0] == "abc" argv[1] == "de" argv[2] == "fghi" argv[3] == NULL @@ -1491,7 +1491,7 @@ argv = weechat_string_split ("abc de fghi ", " ", 0, 0, &argc); weechat_string_free_split (argv); argv = weechat_string_split ("abc de fghi ", " ", 1, 0, &argc); -/* résultat : argv[0] == "abc de fghi" +/* résultat : argv[0] == "abc de fghi" argv[1] == "de fghi" argv[2] == "fghi" argv[3] == NULL @@ -1500,7 +1500,7 @@ argv = weechat_string_split ("abc de fghi ", " ", 1, 0, &argc); weechat_string_free_split (argv); argv = weechat_string_split ("abc de fghi ", " ", 2, 0, &argc); -/* résultat : argv[0] == "abc de fghi " +/* résultat : argv[0] == "abc de fghi " argv[1] == "de fghi " argv[2] == "fghi " argv[3] == NULL @@ -1519,36 +1519,36 @@ _WeeChat ≥ 1.0._ Découper une chaîne comme le shell le fait pour une commande avec ses paramètres. -Cette fonction est une conversion en C de la classe Python "shlex" (fichier : -Lib/shlex.py dans le dépôt Python), voir : +Cette fonction est une conversion en C de la classe Python "shlex" (fichier : +Lib/shlex.py dans le dépôt Python), voir : http://docs.python.org/3/library/shlex.html. -Prototype : +Prototype : [source,C] ---- char **weechat_string_split_shell (const char *string, int *num_items); ---- -Paramètres : +Paramètres : -* _string_ : chaîne à découper -* _num_items_ : pointeur vers un entier qui contiendra le nombre de chaînes +* _string_ : chaîne à découper +* _num_items_ : pointeur vers un entier qui contiendra le nombre de chaînes créées -Valeur de retour : +Valeur de retour : * tableau de chaînes, NULL en cas de problème (doit être supprimé par un appel à <<_string_free_split,string_free_split>> après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- char **argv; int argc; argv = weechat_string_split_shell ("test 'first arg' \"second arg\"", &argc); -/* résultat : argv[0] == "test" +/* résultat : argv[0] == "test" argv[1] == "first arg" argv[2] == "second arg" argv[3] == NULL @@ -1564,18 +1564,18 @@ Cette fonction n'est pas disponible dans l'API script. Supprimer une chaîne découpée. -Prototype : +Prototype : [source,C] ---- void weechat_string_free_split (char **split_string); ---- -Paramètres : +Paramètres : -* _split_string_ : chaîne découpée par <<_string_split,string_split>> +* _split_string_ : chaîne découpée par <<_string_split,string_split>> -Exemple en C : +Exemple en C : [source,C] ---- @@ -1593,7 +1593,7 @@ Cette fonction n'est pas disponible dans l'API script. Construire une chaîne à partir d'une chaîne découpée. -Prototype : +Prototype : [source,C] ---- @@ -1601,17 +1601,17 @@ char *weechat_string_build_with_split_string (char **split_string const char *separator); ---- -Paramètres : +Paramètres : -* _split_string_ : chaîne découpée par la fonction <<_string_split,string_split>> -* _separator_ : chaîne utilisée pour séparer les différentes chaînes +* _split_string_ : chaîne découpée par la fonction <<_string_split,string_split>> +* _separator_ : chaîne utilisée pour séparer les différentes chaînes -Valeur de retour : +Valeur de retour : * chaîne construite avec la chaîne découpée (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- @@ -1632,29 +1632,29 @@ Cette fonction n'est pas disponible dans l'API script. Découper une liste de commandes séparées par _separator_ (qui peut être échappé par `+\+` dans la chaîne). -Prototype : +Prototype : [source,C] ---- char **weechat_string_split_command (const char *command, char separator); ---- -Paramètres : +Paramètres : -* _command_ : commande à découper -* _separator_ : séparateur +* _command_ : commande à découper +* _separator_ : séparateur -Valeur de retour : +Valeur de retour : * tableau de chaînes, NULL en cas de problème (doit être supprimé par un appel à <<_free_split_command,free_split_command>> après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- char **argv = weechat_string_split_command ("/commande1 arg;/commande2", ';'); -/* résultat : argv[0] == "/commande1 arg" +/* résultat : argv[0] == "/commande1 arg" argv[1] == "/commande2" argv[2] == NULL */ @@ -1668,19 +1668,19 @@ Cette fonction n'est pas disponible dans l'API script. Supprimer une commande découpée. -Prototype : +Prototype : [source,C] ---- void weechat_string_free_split_command (char **split_command); ---- -Paramètres : +Paramètres : -* _split_command_ : commande découpée par +* _split_command_ : commande découpée par <<_string_split_command,string_split_command>> -Exemple en C : +Exemple en C : [source,C] ---- @@ -1697,22 +1697,22 @@ Cette fonction n'est pas disponible dans l'API script. Construire une chaîne avec une taille de fichier formatée et une unité traduite dans la langue locale. -Prototype : +Prototype : [source,C] ---- char *weechat_string_format_size (unsigned long long size); ---- -Paramètres : +Paramètres : -* _size_ : taille (en octets) +* _size_ : taille (en octets) -Valeur de retour : +Valeur de retour : * chaîne formatée (doit être supprimée par un appel à "free" après utilisation) -Exemples en C : +Exemples en C : [source,C] ---- @@ -1746,7 +1746,7 @@ Cette fonction n'est pas disponible dans l'API script. Supprimer les couleurs WeeChat dans une chaîne. -Prototype : +Prototype : [source,C] ---- @@ -1754,19 +1754,19 @@ char *weechat_string_remove_color (const char *string, const char *replacement); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _replacement_ : si non NULL et non vide, les couleurs WeeChat sont remplacées +* _string_ : chaîne +* _replacement_ : si non NULL et non vide, les couleurs WeeChat sont remplacées par le premier caractère de cette chaîne, sinon les codes couleurs WeeChat et les caractères suivants (rattachés à la couleur) sont supprimés de la chaîne -Valeur de retour : +Valeur de retour : * chaîne sans couleur (doit être supprimée par un appel à "free" après utilisation) -Exemples en C : +Exemples en C : [source,C] ---- @@ -1781,7 +1781,7 @@ char *str = weechat_string_remove_color (ma_chaine2, "?"); free (str); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -1798,21 +1798,21 @@ _WeeChat ≥ 0.3.2._ Encoder une chaîne en base64. -Prototype : +Prototype : [source,C] ---- void weechat_string_encode_base64 (const char *from, int length, char *to); ---- -Paramètres : +Paramètres : -* _from_ : chaîne à encoder -* _length_ : longueur de chaîne à encoder (par exemple `strlen(from)`) -* _to_ : pointeur vers la chaîne pour stocker le résultat (doit être +* _from_ : chaîne à encoder +* _length_ : longueur de chaîne à encoder (par exemple `strlen(from)`) +* _to_ : pointeur vers la chaîne pour stocker le résultat (doit être suffisamment long, le résultat est plus long que la chaîne initiale) -Exemple en C : +Exemple en C : [source,C] ---- @@ -1830,24 +1830,24 @@ _WeeChat ≥ 0.3.2._ Décoder une chaîne base64. -Prototype : +Prototype : [source,C] ---- int weechat_string_decode_base64 (const char *from, char *to); ---- -Paramètres : +Paramètres : -* _from_ : chaîne à décoder -* _to_ : pointeur vers la chaîne pour stocker le résultat (doit être +* _from_ : chaîne à décoder +* _to_ : pointeur vers la chaîne pour stocker le résultat (doit être suffisamment long, le résultat est plus court que la chaîne initiale) -Valeur de retour : +Valeur de retour : * longueur de la chaîne stockée dans _*to_ (ne compte pas le _\0_ final) -Exemple en C : +Exemple en C : [source,C] ---- @@ -1866,7 +1866,7 @@ _WeeChat ≥ 1.4._ Afficher les données sous forme d'octets en hexadécimal et ascii. -Prototype : +Prototype : [source,C] ---- @@ -1874,22 +1874,22 @@ char *string_hex_dump (const char *data, int data_size, int bytes_per_line, const char *prefix, const char *suffix); ---- -Paramètres : +Paramètres : -* _data_ : les données à afficher -* _data_size_ : nombre d'octets à afficher dans _data_ -* _bytes_per_line_ : nombre d'octets à afficher sur chaque ligne -* _prefix_ : le préfixe à afficher au début de chaque ligne +* _data_ : les données à afficher +* _data_size_ : nombre d'octets à afficher dans _data_ +* _bytes_per_line_ : nombre d'octets à afficher sur chaque ligne +* _prefix_ : le préfixe à afficher au début de chaque ligne (optionnel, peut être NULL) -* _suffix_ : le suffixe à afficher à la fin de chaque ligne +* _suffix_ : le suffixe à afficher à la fin de chaque ligne (optionnel, peut être NULL) -Valeur de retour : +Valeur de retour : * chaîne avec les données (doit être supprimée par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- @@ -1909,22 +1909,22 @@ _WeeChat ≥ 0.3.2._ Vérifier si le premier caractère de la chaîne est un caractère de commande (le caractère par défaut de commande est `+/+`). -Prototype : +Prototype : [source,C] ---- int weechat_string_is_command_char (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * 1 si le premier caractère de la chaîne est un caractère de commande, sinon 0 -Exemples en C : +Exemples en C : [source,C] ---- @@ -1932,7 +1932,7 @@ int command_char1 = weechat_string_is_command_char ("/test"); /* == 1 */ int command_char2 = weechat_string_is_command_char ("test"); /* == 0 */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -1951,22 +1951,22 @@ _WeeChat ≥ 0.3.2._ Retourner un pointeur vers le texte envoyé vers le tampon (pointeur à l'intérieur du paramètre "string"), ou NULL si c'est une commande. -Prototype : +Prototype : [source,C] ---- const char *weechat_string_input_for_buffer (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * pointeur vers "string", ou NULL -Exemples en C : +Exemples en C : [source,C] ---- @@ -1975,7 +1975,7 @@ const char *str2 = weechat_string_input_for_buffer ("/test"); /* NULL */ const char *str3 = weechat_string_input_for_buffer ("//test"); /* "/test" */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -1997,10 +1997,10 @@ Les variables spéciales avec le format `+${variable}+` sont étendues (voir le tableau ci-dessous). [NOTE] -Depuis la version 1.0, les variables imbriquées sont supportées, par exemple : +Depuis la version 1.0, les variables imbriquées sont supportées, par exemple : `+${color:${variable}}+`. -Prototype : +Prototype : [source,C] ---- @@ -2010,47 +2010,47 @@ char *weechat_string_eval_expression (const char *expr, struct t_hashtable *options); ---- -Paramètres : +Paramètres : -* _expr_ : l'expression à évaluer (voir le tableau ci-dessous) -* _pointers_ : table de hachage avec les pointeurs (les clés doivent être des +* _expr_ : l'expression à évaluer (voir le tableau ci-dessous) +* _pointers_ : table de hachage avec les pointeurs (les clés doivent être des chaînes, les valeurs doivent être des pointeurs); les pointeurs "window" et "buffer" sont automatiquement ajoutés s'ils ne sont pas dans la table de - hachage (avec le pointer vers fenêtre/tampon courants) (peut être NULL) : -** _regex_ : pointeur vers une expression régulière (structure _regex_t_) + hachage (avec le pointer vers fenêtre/tampon courants) (peut être NULL) : +** _regex_ : pointeur vers une expression régulière (structure _regex_t_) compilée avec la fonction WeeChat - <<_string_regcomp,string_regcomp>> ou regcomp (voir `man regcomp`) ; + <<_string_regcomp,string_regcomp>> ou regcomp (voir `man regcomp`) ; cette option est similaire à _regex_ dans la table de hachage _options_ (ci-dessous), mais est utilisée pour de meilleures performances -* _extra_vars_ : variables additionnelles qui seront étendues (peut être NULL) -* _options_ : table de hachage avec des options (les clés et valeurs doivent - être des chaînes) (peut être NULL) : -** _type_ : le comportement par défaut est de juste remplacer les valeurs dans - l'expression, d'autres types peuvent être choisis : -*** _condition_ : l'expression est évaluée comme une condition : les opérateurs +* _extra_vars_ : variables additionnelles qui seront étendues (peut être NULL) +* _options_ : table de hachage avec des options (les clés et valeurs doivent + être des chaînes) (peut être NULL) : +** _type_ : le comportement par défaut est de juste remplacer les valeurs dans + l'expression, d'autres types peuvent être choisis : +*** _condition_ : l'expression est évaluée comme une condition : les opérateurs et parenthèses sont utilisés, le résultat est un booléen ("0" ou "1") -** _prefix_ : préfixe avant les variables à remplacer (par défaut : `+${+`) -** _suffix_ : suffixe après les variables à remplacer (par défaut : `+}+`) -** _extra_ : le comportement par défaut est juste de remplacer les variables - additionnelles (_extra_vars_), un autre comportement peut être sélectionné : -*** _eval_ : les variables additionnelles (_extra_vars_) sont évaluées +** _prefix_ : préfixe avant les variables à remplacer (par défaut : `+${+`) +** _suffix_ : suffixe après les variables à remplacer (par défaut : `+}+`) +** _extra_ : le comportement par défaut est juste de remplacer les variables + additionnelles (_extra_vars_), un autre comportement peut être sélectionné : +*** _eval_ : les variables additionnelles (_extra_vars_) sont évaluées elles-mêmes avant remplacement -** _regex_ : une expression regulière pour remplacer du texte dans _expr_ (qui +** _regex_ : une expression regulière pour remplacer du texte dans _expr_ (qui n'est alors pas évalué) -** _regex_replace_ : le texte de remplacement à utiliser avec _regex_, pour +** _regex_replace_ : le texte de remplacement à utiliser avec _regex_, pour remplacer du texte dans _expr_ (_regex_replace_ est évalué sur chaque correspondance de _regex_ sur _expr_, jusqu'à ce que plus aucune correspondance ne soit trouvée) -Valeur de retour : +Valeur de retour : * expression évaluée (doit être supprimée après un appel à "free" après utilisation), ou NULL si problème (expression invalide ou pas assez de mémoire) Liste des variables étendues dans l'expression (par ordre de priorité, de la -première étendue à la dernière) : +première étendue à la dernière) : [width="100%",cols="2,8,4,4",options="header"] |=== @@ -2083,7 +2083,7 @@ première étendue à la dernière) : `+************+` | `+${re:N}+` | - Groupe regex capturé : `0` = toute la chaîne correspondante, + Groupe regex capturé : `0` = toute la chaîne correspondante, `1` à `99` = groupe capturé, `+++` = dernier groupe capturé. | `+${re:1}+` | `+test+` @@ -2145,7 +2145,7 @@ première étendue à la dernière) : `+1+` |=== -Exemples en C : +Exemples en C : [source,C] ---- @@ -2171,7 +2171,7 @@ struct t_hashtable *options2 = weechat_hashtable_new (8, /* ajout de crochets autour des URLs */ weechat_hashtable_set (options2, "regex", "\\w+://\\S+"); weechat_hashtable_set (options2, "regex_replace", "[ ${re:0} ]"); -char *str4 = weechat_string_eval_expression ("test : https://weechat.org", NULL, NULL, NULL); /* "test : [ https://weechat.org ]" */ +char *str4 = weechat_string_eval_expression ("test : https://weechat.org", NULL, NULL, NULL); /* "test : [ https://weechat.org ]" */ /* masquage des mots de passe */ weechat_hashtable_set (options2, "regex", "(password=)(\\S+)"); @@ -2179,7 +2179,7 @@ weechat_hashtable_set (options2, "regex_replace", "${re:1}${hide:*,${re:2}}"); char *str5 = weechat_string_eval_expression ("password=abc password=def", NULL, NULL, NULL); /* "password=*** password=***" */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -2195,14 +2195,14 @@ str2 = weechat.string_eval_expression("abc =~ def", {}, {}, {"type": "condition" # expression simple str3 = weechat.string_eval_expression("${buffer.full_name}", {}, {}, {}) # "core.weechat" -# remplacement avec regex : ajout de crochets autour des URLs +# remplacement avec regex : ajout de crochets autour des URLs options = { "regex": "\\w+://\\S+", "regex_replace": "[ ${re:0} ]", } -str4 = weechat.string_eval_expression("test : https://weechat.org", {}, {}, options) # "test : [ https://weechat.org ]" +str4 = weechat.string_eval_expression("test : https://weechat.org", {}, {}, options) # "test : [ https://weechat.org ]" -# replace with regex : masquage des mots de passe +# replace with regex : masquage des mots de passe options = { "regex": "(password=)(\\S+)", "regex_replace": "${re:1}${hide:*,${re:2}}", @@ -2219,23 +2219,23 @@ Fonctions pour les chaînes UTF-8. Vérifier si une chaîne a des caractères 8-bits. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_has_8bits (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * 1 si la chaîne a des caractères 8-bits, 0 s'il y a seulement des caractères 7-bits -Exemple en C : +Exemple en C : [source,C] ---- @@ -2254,26 +2254,26 @@ _Mis à jour dans la 1.4._ Vérifier si une chaîne est valide UTF-8. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_is_valid (const char *string, int length, char **error); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _length_ : nombre maximum de caractères UTF-8 à vérifier ; si ≤ 0, la chaîne +* _string_ : chaîne +* _length_ : nombre maximum de caractères UTF-8 à vérifier ; si ≤ 0, la chaîne complète est vérifiée _(WeeChat ≥ 1.4)_ -* _error_ : si non NULL, _*error_ est alimenté avec le pointeur vers le premier +* _error_ : si non NULL, _*error_ est alimenté avec le pointeur vers le premier caractère non valide dans la chaîne, s'il y en a -Valeur de retour : +Valeur de retour : * 1 si la chaîne UTF-8 est valide, sinon 0 -Exemple en C : +Exemple en C : [source,C] ---- @@ -2293,22 +2293,22 @@ Cette fonction n'est pas disponible dans l'API script. ==== utf8_normalize -Normaliser une chaîne UTF-8 : supprimer tous les caractères non valides UTF-8 +Normaliser une chaîne UTF-8 : supprimer tous les caractères non valides UTF-8 en les remplaçant par un caractère. -Prototype : +Prototype : [source,C] ---- void weechat_utf8_normalize (char *string, char replacement); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _replacement_ : caractère de remplacement pour les caractères non valides +* _string_ : chaîne +* _replacement_ : caractère de remplacement pour les caractères non valides -Exemple en C : +Exemple en C : [source,C] ---- @@ -2324,7 +2324,7 @@ _Mis à jour dans la 1.3._ Retourner un pointeur vers le caractère UTF-8 précédent dans une chaîne. -Prototype : +Prototype : [source,C] ---- @@ -2332,20 +2332,20 @@ const char *weechat_utf8_prev_char (const char *string_start, const char *string); ---- -Paramètres : +Paramètres : -* _string_start_ : début de la chaîne (la fonction ne retournera pas un +* _string_start_ : début de la chaîne (la fonction ne retournera pas un caractère situé avant ce pointeur) -* _string_ : pointeur vers la chaîne (doit être ≥ _string_start_) +* _string_ : pointeur vers la chaîne (doit être ≥ _string_start_) -Valeur de retour : +Valeur de retour : * pointeur vers le caractère UTF-8 précédent, NULL si non trouvé (début de chaîne atteint) - (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un + (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un _char *_) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2361,25 +2361,25 @@ _Mis à jour dans la 1.3._ Retourner un pointeur vers le caractère UTF-8 suivant dans une chaîne. -Prototype : +Prototype : [source,C] ---- const char *weechat_utf8_next_char (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * pointeur vers le caractère UTF-8 suivant, NULL si non trouvé (fin de la chaîne atteinte) - (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un + (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un _char *_) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2393,22 +2393,22 @@ Cette fonction n'est pas disponible dans l'API script. Retourner un caractère UTF-8 sous forme d'entier. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_char_int (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * caractère UTF-8 sous forme d'entier -Exemple en C : +Exemple en C : [source,C] ---- @@ -2422,22 +2422,22 @@ Cette fonction n'est pas disponible dans l'API script. Retourner la taille d'un caractère UTF-8 (en octets). -Prototype : +Prototype : [source,C] ---- int weechat_utf8_char_size (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * taille du caractère UTF-8 (en octets) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2451,22 +2451,22 @@ Cette fonction n'est pas disponible dans l'API script. Retourner la taille d'une chaîne UTF-8 (en nombre de caractères UTF-8). -Prototype : +Prototype : [source,C] ---- int weechat_utf8_strlen (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * longueur de la chaîne UTF-8 (nombre de caractères UTF-8) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2481,23 +2481,23 @@ Cette fonction n'est pas disponible dans l'API script. Retourner la taille d'une chaîne UTF-8 (en nombre de caractères UTF-8), pour au maximum _bytes_ octets dans la chaîne. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_strnlen (const char *string, int bytes); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _bytes_ : nombre maximum d'octets +* _string_ : chaîne +* _bytes_ : nombre maximum d'octets -Valeur de retour : +Valeur de retour : * longueur de la chaîne UTF-8 (nombre de caractères UTF-8) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2512,22 +2512,22 @@ Cette fonction n'est pas disponible dans l'API script. Retourner le nombre de caractères nécessaires pour afficher la chaîne UTF-8 sur l'écran. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_strlen_screen (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * nombre de caractères nécessaires pour afficher la chaîne UTF-8 sur l'écran -Exemple en C : +Exemple en C : [source,C] ---- @@ -2543,25 +2543,25 @@ _Mis à jour dans la 1.0._ Comparer deux caractères UTF-8. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_charcmp (const char *string1, const char *string2); ---- -Paramètres : +Paramètres : -* _string1_ : première chaîne pour la comparaison -* _string2_ : seconde chaîne pour la comparaison +* _string1_ : première chaîne pour la comparaison +* _string2_ : seconde chaîne pour la comparaison -Valeur de retour : +Valeur de retour : * -1 si string1 < string2 * 0 si string1 == string2 * 1 si string1 > string2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -2577,25 +2577,25 @@ _Mis à jour dans la 1.0._ Comparer deux caractères UTF-8 en ignorant la casse. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_charcasecmp (const char *string1, const char *string2); ---- -Paramètres : +Paramètres : -* _string1_ : première chaîne pour la comparaison -* _string2_ : seconde chaîne pour la comparaison +* _string1_ : première chaîne pour la comparaison +* _string2_ : seconde chaîne pour la comparaison -Valeur de retour : +Valeur de retour : * -1 si string1 < string2 * 0 si string1 == string2 * 1 si string1 > string2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -2610,22 +2610,22 @@ Cette fonction n'est pas disponible dans l'API script. Retourner le nombre de caractères nécessaires pour afficher le caractère UTF-8 sur l'écran. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_char_size_screen (const char *string); ---- -Paramètres : +Paramètres : -* _string_ : chaîne +* _string_ : chaîne -Valeur de retour : +Valeur de retour : * nombre de caractères nécessaires pour afficher le caractère UTF-8 sur l'écran -Exemple en C : +Exemple en C : [source,C] ---- @@ -2641,26 +2641,26 @@ _Mis à jour dans la 1.3._ Avancer de N caractères dans une chaîne UTF-8. -Prototype : +Prototype : [source,C] ---- const char *weechat_utf8_add_offset (const char *string, int offset); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _offset_ : nombre de caractères +* _string_ : chaîne +* _offset_ : nombre de caractères -Valeur de retour : +Valeur de retour : * pointeur vers la chaîne, N caractères après (NULL s'il est impossible d'atteindre cette position dans la chaîne) - (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un + (_WeeChat ≥ 1.3_ : le pointeur retourné est un _const char *_ au lieu d'un _char *_) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2675,23 +2675,23 @@ Cette fonction n'est pas disponible dans l'API script. Retourner la position réelle dans une chaîne UTF-8. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_real_pos (const char *string, int pos); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _pos_ : position (en nombre de caractères) +* _string_ : chaîne +* _pos_ : position (en nombre de caractères) -Valeur de retour : +Valeur de retour : * position réelle (en octets) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2705,23 +2705,23 @@ Cette fonction n'est pas disponible dans l'API script. Retourner la position dans une chaîne UTF-8. -Prototype : +Prototype : [source,C] ---- int weechat_utf8_pos (const char *string, int real_pos); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _real_pos_ : position (en octets) +* _string_ : chaîne +* _real_pos_ : position (en octets) -Valeur de retour : +Valeur de retour : * position (en nombre de caractères) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2735,24 +2735,24 @@ Cette fonction n'est pas disponible dans l'API script. Retourner une chaîne dupliquée, avec au plus _length_ caractères. -Prototype : +Prototype : [source,C] ---- char *weechat_utf8_strndup (const char *string, int length); ---- -Paramètres : +Paramètres : -* _string_ : chaîne -* _length_ : nombre maximum de caractères à dupliquer +* _string_ : chaîne +* _length_ : nombre maximum de caractères à dupliquer -Valeur de retour : +Valeur de retour : * chaîne dupliquée (doit être supprimée avec un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2773,23 +2773,23 @@ Fonctions liées aux répertoires. Créer un répertoire dans le répertoire de WeeChat. -Prototype : +Prototype : [source,C] ---- int weechat_mkdir_home (char *directory, int mode); ---- -Paramètres : +Paramètres : -* _directory_ : nom du répertoire à créer -* _mode_ : mode pour le répertoire +* _directory_ : nom du répertoire à créer +* _mode_ : mode pour le répertoire -Valeur de retour : +Valeur de retour : * 1 si le répertoire est créé, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -2799,7 +2799,7 @@ if (!weechat_mkdir_home ("temp", 0755)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -2814,23 +2814,23 @@ weechat.mkdir_home("temp", 0755) Créer un répertoire. -Prototype : +Prototype : [source,C] ---- int weechat_mkdir (char *directory, int mode); ---- -Paramètres : +Paramètres : -* _directory_ : nom du répertoire à créer -* _mode_ : mode pour le répertoire +* _directory_ : nom du répertoire à créer +* _mode_ : mode pour le répertoire -Valeur de retour : +Valeur de retour : * 1 si le répertoire est créé, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -2840,7 +2840,7 @@ if (!weechat_mkdir ("/tmp/mydir", 0755)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -2855,23 +2855,23 @@ weechat.mkdir("/tmp/mydir", 0755) Créer un répertoire et ses parents si besoin. -Prototype : +Prototype : [source,C] ---- int weechat_mkdir_parents (char *directory, int mode); ---- -Paramètres : +Paramètres : -* _directory_ : nom du répertoire à créer -* _mode_ : mode pour le répertoire +* _directory_ : nom du répertoire à créer +* _mode_ : mode pour le répertoire -Valeur de retour : +Valeur de retour : * 1 si le répertoire est créé, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -2881,7 +2881,7 @@ if (!weechat_mkdir_parents ("/tmp/my/dir", 0755)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -2899,7 +2899,7 @@ _Mis à jour dans la 1.5._ Balayer les fichiers dans un répertoire et exécuter un "callback" pour chaque fichier. -Prototype : +Prototype : [source,C] ---- @@ -2910,17 +2910,17 @@ void weechat_exec_on_files (const char *directory, void *callback_data); ---- -Paramètres : +Paramètres : -* _directory_ : répertoire où chercher les fichiers -* _hidden_files_ : 1 pour inclure les fichiers cachés, sinon 0 -* _callback_ : fonction appelée pour chaque fichier trouvé, paramètres : -** _void *data_ : pointeur -** _const char *filename_ : nom de fichier trouvé -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _directory_ : répertoire où chercher les fichiers +* _hidden_files_ : 1 pour inclure les fichiers cachés, sinon 0 +* _callback_ : fonction appelée pour chaque fichier trouvé, paramètres : +** _void *data_ : pointeur +** _const char *filename_ : nom de fichier trouvé +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -Exemple en C : +Exemple en C : [source,C] ---- @@ -2941,23 +2941,23 @@ _WeeChat ≥ 0.3.1._ Lire le contenu d'un fichier texte dans une chaîne de caractères. -Prototype : +Prototype : [source,C] ---- char *weechat_file_get_content (const char *filename); ---- -Paramètres : +Paramètres : -* _filename_ : chemin et nom du fichier +* _filename_ : chemin et nom du fichier -Valeur de retour : +Valeur de retour : * contenu du fichier sous forme de chaîne (doit être supprimé par un appel à "free" après utilisation) -Exemple en C : +Exemple en C : [source,C] ---- @@ -2980,25 +2980,25 @@ Quelques fonctions utiles. Comparer deux structures "timeval". -Prototype : +Prototype : [source,C] ---- int weechat_util_timeval_cmp (struct timeval *tv1, struct timeval *tv2); ---- -Paramètres : +Paramètres : -* _tv1_ : première structure "timeval" -* _tv2_ : seconde structure "timeval" +* _tv1_ : première structure "timeval" +* _tv2_ : seconde structure "timeval" -Valeur de retour : +Valeur de retour : * -1 si tv1 < tv2 * zéro si tv1 == tv2 * +1 si tv1 > tv2 -Exemple en C : +Exemple en C : [source,C] ---- @@ -3017,26 +3017,26 @@ _Mis à jour dans la 1.1._ Retourner la différence (en microsecondes) entre deux structures "timeval". -Prototype : +Prototype : [source,C] ---- long long weechat_util_timeval_diff (struct timeval *tv1, struct timeval *tv2); ---- -Paramètres : +Paramètres : -* _tv1_ : première structure "timeval" -* _tv2_ : seconde structure "timeval" +* _tv1_ : première structure "timeval" +* _tv2_ : seconde structure "timeval" -Valeur de retour : +Valeur de retour : * différence en microsecondes [NOTE] Avec WeeChat ≤ 1.0, la valeur retournée était en millisecondes. -Exemple en C : +Exemple en C : [source,C] ---- @@ -3052,22 +3052,22 @@ _Mis à jour dans la 1.1._ Ajouter un intervalle (en microsecondes) à une structure "timeval". -Prototype : +Prototype : [source,C] ---- void weechat_util_timeval_add (struct timeval *tv, long long interval); ---- -Paramètres : +Paramètres : -* _tv_ : structure "timeval" -* _interval_ : intervalle (en microsecondes) +* _tv_ : structure "timeval" +* _interval_ : intervalle (en microsecondes) [NOTE] Avec WeeChat ≤ 1.0, l'intervalle était exprimé en millisecondes. -Exemple en C : +Exemple en C : [source,C] ---- @@ -3084,27 +3084,27 @@ _WeeChat ≥ 0.3.2, mise à jour dans la 1.3._ Retourner la date/heure sous forme de chaîne construite avec "strftime" et le format défini dans l'option _weechat.look.time_format_. -Prototype : +Prototype : [source,C] ---- const char *weechat_util_get_time_string (const time_t *date); ---- -Paramètres : +Paramètres : -* _date_ : pointeur vers la date +* _date_ : pointeur vers la date -Valeur de retour : +Valeur de retour : * pointeur vers une chaîne contenant la date/heure -Exemple en C : +Exemple en C : [source,C] ---- time_t date = time (NULL); -weechat_printf (NULL, "date : %s", +weechat_printf (NULL, "date : %s", weechat_util_get_time_string (&date)); ---- @@ -3117,19 +3117,19 @@ _WeeChat ≥ 0.3.9._ Convertir une chaîne avec la version WeeChat en nombre. -Prototype : +Prototype : [source,C] ---- int weechat_util_version_number (const char *version); ---- -Paramètres : +Paramètres : -* _version_ : version WeeChat sous forme de chaîne (exemple : "0.3.9" ou +* _version_ : version WeeChat sous forme de chaîne (exemple : "0.3.9" ou "0.3.9-dev") -Exemple en C : +Exemple en C : [source,C] ---- @@ -3151,25 +3151,25 @@ Fonctions pour les listes triées. Créer une nouvelle liste. -Prototype : +Prototype : [source,C] ---- struct t_weelist *weechat_list_new (); ---- -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle liste -Exemple en C : +Exemple en C : [source,C] ---- struct t_weelist *list = weechat_list_new (); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3184,7 +3184,7 @@ list = weechat.list_new() Ajouter un élément dans une liste. -Prototype : +Prototype : [source,C] ---- @@ -3194,21 +3194,21 @@ struct t_weelist_item *weechat_list_add (struct t_weelist *weelist, void *user_data); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste -* _data_ : donnée à insérer dans la liste -* _where_ : position dans la liste : -** _WEECHAT_LIST_POS_SORT_ : ajout dans la liste, en gardant la liste triée -** _WEECHAT_LIST_POS_BEGINNING_ : ajout en début de liste -** _WEECHAT_LIST_POS_END_ : ajout en fin de liste -* _user_data_ : un pointeur quelconque +* _weelist_ : pointeur vers la liste +* _data_ : donnée à insérer dans la liste +* _where_ : position dans la liste : +** _WEECHAT_LIST_POS_SORT_ : ajout dans la liste, en gardant la liste triée +** _WEECHAT_LIST_POS_BEGINNING_ : ajout en début de liste +** _WEECHAT_LIST_POS_END_ : ajout en fin de liste +* _user_data_ : un pointeur quelconque -Valeur de retour : +Valeur de retour : * pointeur vers le nouvel élément -Exemple en C : +Exemple en C : [source,C] ---- @@ -3216,7 +3216,7 @@ struct t_weelist_item *my_item = weechat_list_add (list, "ma donnée", WEECHAT_LIST_POS_SORT, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3231,7 +3231,7 @@ item = weechat.list_add(list, "ma donnée", weechat.WEECHAT_LIST_POS_SORT, "") Rechercher un élément dans une liste. -Prototype : +Prototype : [source,C] ---- @@ -3239,23 +3239,23 @@ struct t_weelist_item *weechat_list_search (struct t_weelist *weelist, const char *data); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste -* _data_ : donnée à chercher dans la liste +* _weelist_ : pointeur vers la liste +* _data_ : donnée à chercher dans la liste -Valeur de retour : +Valeur de retour : * pointeur vers l'élément trouvé, NULL si aucun élément n'a été trouvé -Exemple en C : +Exemple en C : [source,C] ---- struct t_weelist_item *item = weechat_list_search (list, "ma donnée"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3272,7 +3272,7 @@ _WeeChat ≥ 0.3.4._ Rechercher la position d'un élément dans une liste. -Prototype : +Prototype : [source,C] ---- @@ -3280,23 +3280,23 @@ int weechat_list_search_pos (struct t_weelist *weelist, const char *data); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste -* _data_ : donnée à chercher dans la liste +* _weelist_ : pointeur vers la liste +* _data_ : donnée à chercher dans la liste -Valeur de retour : +Valeur de retour : * position de l'élément trouvé, -1 si aucun élément n'a été trouvé -Exemple en C : +Exemple en C : [source,C] ---- int pos_item = weechat_list_search_pos (list, "ma donnée"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3311,7 +3311,7 @@ pos_item = weechat.list_search_pos(list, "ma donnée") Rechercher un élément dans la liste, sans tenir compte de la casse. -Prototype : +Prototype : [source,C] ---- @@ -3319,23 +3319,23 @@ struct t_weelist_item *weechat_list_casesearch (struct t_weelist *weelist, const char *data); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste -* _data_ : données à chercher dans la liste +* _weelist_ : pointeur vers la liste +* _data_ : données à chercher dans la liste -Valeur de retour : +Valeur de retour : * pointeur vers l'élément trouvé, NULL si aucun élément n'a été trouvé -Exemple en C : +Exemple en C : [source,C] ---- struct t_weelist_item *item = weechat_list_casesearch (list, "ma donnée"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3353,7 +3353,7 @@ _WeeChat ≥ 0.3.4._ Rechercher la position d'un élément dans la liste, sans tenir compte de la casse. -Prototype : +Prototype : [source,C] ---- @@ -3361,23 +3361,23 @@ int weechat_list_casesearch_pos (struct t_weelist *weelist, const char *data); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste -* _data_ : données à chercher dans la liste +* _weelist_ : pointeur vers la liste +* _data_ : données à chercher dans la liste -Valeur de retour : +Valeur de retour : * position l'élément trouvé, -1 si aucun élément n'a été trouvé -Exemple en C : +Exemple en C : [source,C] ---- int pos_item = weechat_list_casesearch_pos (list, "ma donnée"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3392,7 +3392,7 @@ pos_item = weechat.list_casesearch_pos(list, "ma donnée") Retourner un élément de la liste par sa position. -Prototype : +Prototype : [source,C] ---- @@ -3400,23 +3400,23 @@ struct t_weelist_item *weechat_list_get (struct t_weelist *weelist, int position); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste -* _position_ : position dans la liste (le premier élément est 0) +* _weelist_ : pointeur vers la liste +* _position_ : position dans la liste (le premier élément est 0) -Valeur de retour : +Valeur de retour : * pointeur vers l'élément trouvé, NULL si aucun élément n'a été trouvé -Exemple en C : +Exemple en C : [source,C] ---- struct t_weelist_item *item = weechat_list_get (list, 0); /* premier élément */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3431,26 +3431,26 @@ item = weechat.list_get(list, 0) Affecter une nouvelle valeur pour un élément. -Prototype : +Prototype : [source,C] ---- void weechat_list_set (struct t_weelist_item *item, const char *value); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'élément -* _value_ : nouvelle valeur pour l'élément +* _item_ : pointeur vers l'élément +* _value_ : nouvelle valeur pour l'élément -Exemple en C : +Exemple en C : [source,C] ---- weechat_list_set (item, "nouvelle donnée"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3465,30 +3465,30 @@ weechat.list_set(item, "nouvelle donnée") Retourner l'élément suivant dans la liste. -Prototype : +Prototype : [source,C] ---- struct t_weelist_item *weechat_list_next (struct t_weelist_item *item); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'élément +* _item_ : pointeur vers l'élément -Valeur de retour : +Valeur de retour : * pointeur vers l'élément suivant, NULL si le pointeur était sur le dernier élément de la liste -Exemple en C : +Exemple en C : [source,C] ---- struct t_weelist_item *next_item = weechat_list_next (item); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3503,30 +3503,30 @@ item = weechat.list_next(item) Retourner l'élément précédent dans la liste. -Prototype : +Prototype : [source,C] ---- struct t_weelist_item *weechat_list_prev (struct t_weelist_item *item); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'élément +* _item_ : pointeur vers l'élément -Valeur de retour : +Valeur de retour : * pointeur vers l'élément précédent, NULL si le pointeur était sur le premier élément de la liste -Exemple en C : +Exemple en C : [source,C] ---- struct t_weelist_item *prev_item = weechat_list_prev (item); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3541,29 +3541,29 @@ item = weechat.list_prev(item) Retourner la valeur de l'élément sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- const char *weechat_list_string (struct t_weelist_item *item); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'élément +* _item_ : pointeur vers l'élément -Valeur de retour : +Valeur de retour : * valeur de l'élément -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "valeur de l'item : %s", weechat_list_string (item)); +weechat_printf (NULL, "valeur de l'item : %s", weechat_list_string (item)); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3571,36 +3571,36 @@ Script (Python) : value = weechat.list_string(item) # exemple -weechat.prnt("", "valeur de l'item : %s" % weechat.list_string(item)) +weechat.prnt("", "valeur de l'item : %s" % weechat.list_string(item)) ---- ==== list_size Retourner la taille de la liste (nombre d'éléments). -Prototype : +Prototype : [source,C] ---- char *weechat_list_size (struct t_weelist *weelist); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste +* _weelist_ : pointeur vers la liste -Valeur de retour : +Valeur de retour : * taille de la liste (nombre d'éléments), 0 si la liste est vide -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "taille de la liste : %d", weechat_list_size (list)); +weechat_printf (NULL, "taille de la liste : %d", weechat_list_size (list)); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3608,14 +3608,14 @@ Script (Python) : size = weechat.list_size(list) # exemple -weechat.prnt("", "taille de la liste : %d" % weechat.list_size(list)) +weechat.prnt("", "taille de la liste : %d" % weechat.list_size(list)) ---- ==== list_remove Supprimer un élément de la liste. -Prototype : +Prototype : [source,C] ---- @@ -3623,19 +3623,19 @@ void weechat_list_remove (struct t_weelist *weelist, struct t_weelist_item *item); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste -* _item_ : pointeur vers l'élément +* _weelist_ : pointeur vers la liste +* _item_ : pointeur vers l'élément -Exemple en C : +Exemple en C : [source,C] ---- weechat_list_remove (list, item); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3650,25 +3650,25 @@ weechat.list_remove(list, item) Supprimer tous les éléments de la liste. -Prototype : +Prototype : [source,C] ---- void weechat_list_remove_all (struct t_weelist *weelist); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste +* _weelist_ : pointeur vers la liste -Exemple en C : +Exemple en C : [source,C] ---- weechat_list_remove_all (list); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3683,25 +3683,25 @@ weechat.list_remove_all(list) Supprimer une liste. -Prototype : +Prototype : [source,C] ---- void weechat_list_free (struct t_weelist *weelist); ---- -Paramètres : +Paramètres : -* _weelist_ : pointeur vers la liste +* _weelist_ : pointeur vers la liste -Exemple en C : +Exemple en C : [source,C] ---- weechat_list_free (list); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -3723,7 +3723,7 @@ _WeeChat ≥ 0.3.3._ Créer une nouvelle table de hachage. -Prototype : +Prototype : [source,C] ---- @@ -3737,47 +3737,47 @@ struct t_hashtable *weechat_hashtable_new (int size, const void *key2)); ---- -Paramètres : +Paramètres : -* _size_ : taille du tableau interne pour stocker les clés sous forme de +* _size_ : taille du tableau interne pour stocker les clés sous forme de hachage, une grande valeur utilise plus de mémoire mais présente une meilleure performance (cela n'est *pas* une limite sur le nombre d'entrées de la table de hachage) -* _type_keys_ : type pour les clés dans la table de hachage : +* _type_keys_ : type pour les clés dans la table de hachage : ** _WEECHAT_HASHTABLE_INTEGER_ ** _WEECHAT_HASHTABLE_STRING_ ** _WEECHAT_HASHTABLE_POINTER_ ** _WEECHAT_HASHTABLE_BUFFER_ ** _WEECHAT_HASHTABLE_TIME_ -* _type_values_ : type pour les valeurs dans la table de hachage : +* _type_values_ : type pour les valeurs dans la table de hachage : ** _WEECHAT_HASHTABLE_INTEGER_ ** _WEECHAT_HASHTABLE_STRING_ ** _WEECHAT_HASHTABLE_POINTER_ ** _WEECHAT_HASHTABLE_BUFFER_ ** _WEECHAT_HASHTABLE_TIME_ -* _callback_hash_key_ : fonction appelée pour rendre le hachage d'une clé (la +* _callback_hash_key_ : fonction appelée pour rendre le hachage d'une clé (la clé sous forme de nombre entier), peut être NULL si le type de clé n'est pas "buffer" (une fonction de hachage par défaut est utilisée), paramètres et - valeur de retour : -** _struct t_hashtable *hashtable_ : pointeur vers la table de hachage -** _const void *key_ : clé -** valeur de retour : hachage de la clé -* _callback_keycmp_ : fonction appelée pour comparer deux clés, peut être NULL + valeur de retour : +** _struct t_hashtable *hashtable_ : pointeur vers la table de hachage +** _const void *key_ : clé +** valeur de retour : hachage de la clé +* _callback_keycmp_ : fonction appelée pour comparer deux clés, peut être NULL si le type de clé n'est pas "buffer" (une fonction de comparaison par défaut - est utilisée), paramètres et valeur de retour : -** _struct t_hashtable *hashtable_ : pointeur vers la table de hachage -** _const void *key1_ : première clé -** _const void *key2_ : seconde clé -** valeur de retour : + est utilisée), paramètres et valeur de retour : +** _struct t_hashtable *hashtable_ : pointeur vers la table de hachage +** _const void *key1_ : première clé +** _const void *key2_ : seconde clé +** valeur de retour : *** nombre négatif si _key1_ est inférieur à _key2_ *** 0 si _key1_ est égal à _key2_ *** nombre positif si _key1_ est supérieur à _key2_ -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle table de hachage, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -3798,7 +3798,7 @@ _WeeChat ≥ 0.3.3, mis à jour dans la 0.4.2._ Ajouter ou mettre à jour une entrée dans une table de hachage avec une taille pour la clé et la valeur. -Prototype : +Prototype : [source,C] ---- @@ -3807,21 +3807,21 @@ struct t_hashtable_item *weechat_hashtable_set_with_size (struct t_hashtable *ha const void *value, int value_size); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _key_ : pointeur vers la clé -* _key_size_ : taille de la clé (en octets), utilisée seulement si le type de +* _hashtable_ : pointeur vers la table de hachage +* _key_ : pointeur vers la clé +* _key_size_ : taille de la clé (en octets), utilisée seulement si le type de clés dans la table de hachage est "buffer" -* _value_ : pointeur vers la valeur -* _value_size_ : taille de la valeur (en octets), utilisée seulement si le type +* _value_ : pointeur vers la valeur +* _value_size_ : taille de la valeur (en octets), utilisée seulement si le type de valeurs dans la table de hachage est "buffer" -Valeur de retour : +Valeur de retour : * pointeur vers l'item créé/mis à jour, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -3838,7 +3838,7 @@ _WeeChat ≥ 0.3.3, mis à jour dans la 0.4.2._ Ajouter ou mettre à jour une entrée dans la table de hachage. -Prototype : +Prototype : [source,C] ---- @@ -3846,17 +3846,17 @@ struct t_hashtable_item *weechat_hashtable_set (struct t_hashtable *hashtable, const void *key, const void *value); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _key_ : pointeur vers la clé -* _value_ : pointeur vers la valeur +* _hashtable_ : pointeur vers la table de hachage +* _key_ : pointeur vers la clé +* _value_ : pointeur vers la valeur -Valeur de retour : +Valeur de retour : * pointeur vers l'item créé/mis à jour, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -3872,23 +3872,23 @@ _WeeChat ≥ 0.3.3._ Retourner la valeur associée à une clé dans une table de hachage. -Prototype : +Prototype : [source,C] ---- void *weechat_hashtable_get (struct t_hashtable *hashtable, void *key); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _key_ : pointeur vers la clé +* _hashtable_ : pointeur vers la table de hachage +* _key_ : pointeur vers la clé -Valeur de retour : +Valeur de retour : * valeur pour la clé, NULL si la clé n'est pas trouvée -Exemple en C : +Exemple en C : [source,C] ---- @@ -3904,24 +3904,24 @@ _WeeChat ≥ 0.3.4._ Vérifier si une clé est présente dans la table de hachage. -Prototype : +Prototype : [source,C] ---- int weechat_hashtable_has_key (struct t_hashtable *hashtable, void *key); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _key_ : pointeur vers la clé +* _hashtable_ : pointeur vers la table de hachage +* _key_ : pointeur vers la clé -Valeur de retour : +Valeur de retour : * 1 si la clé est dans la table de hachage, 0 si la clé n'est pas dans la table de hachage -Exemple en C : +Exemple en C : [source,C] ---- @@ -3941,7 +3941,7 @@ _WeeChat ≥ 0.3.3._ Appeller une fonction pour chaque entrée d'une table de hachage. -Prototype : +Prototype : [source,C] ---- @@ -3953,13 +3953,13 @@ void weechat_hashtable_map (struct t_hashtable *hashtable, void *callback_map_data); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _callback_map_ : fonction appelée pour chaque entrée de la table de hachage -* _callback_map_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _hashtable_ : pointeur vers la table de hachage +* _callback_map_ : fonction appelée pour chaque entrée de la table de hachage +* _callback_map_data_ : pointeur donné au "callback" lorsqu'il est appelé -Exemple en C : +Exemple en C : [source,C] ---- @@ -3968,7 +3968,7 @@ map_cb (void *data, struct t_hashtable *hashtable, const void *key, const void *value) { /* afficher la clé et la valeur (elles sont des chaînes ici) */ - weechat_printf (NULL, "clé : '%s', valeur : '%s'", + weechat_printf (NULL, "clé : '%s', valeur : '%s'", (const char *)key, (const char *)value); } @@ -3986,7 +3986,7 @@ _WeeChat ≥ 0.3.7._ Appeller une fonction pour chaque entrée d'une table de hachage, en envoyant les clés et valeurs sous forme de chaînes. -Prototype : +Prototype : [source,C] ---- @@ -3998,17 +3998,17 @@ void weechat_hashtable_map_string (struct t_hashtable *hashtable, void *callback_map_data); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _callback_map_ : fonction appelée pour chaque entrée de la table de hachage -* _callback_map_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _hashtable_ : pointeur vers la table de hachage +* _callback_map_ : fonction appelée pour chaque entrée de la table de hachage +* _callback_map_data_ : pointeur donné au "callback" lorsqu'il est appelé [NOTE] Les chaînes _key_ et _value_ envoyées au "callback" sont des chaînes temporaires, elles sont supprimées après l'appel au "callback". -Exemple en C : +Exemple en C : [source,C] ---- @@ -4017,7 +4017,7 @@ map_cb (void *data, struct t_hashtable *hashtable, const char *key, const char *value) { /* afficher la clé et la valeur */ - weechat_printf (NULL, "clé : '%s', valeur : '%s'", + weechat_printf (NULL, "clé : '%s', valeur : '%s'", key, value); } /* ... */ @@ -4033,22 +4033,22 @@ _WeeChat ≥ 1.0._ Dupliquer une table de hachage. -Prototype : +Prototype : [source,C] ---- struct t_hashtable *weechat_hashtable_dup (struct t_hashtable *hashtable); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage +* _hashtable_ : pointeur vers la table de hachage -Valeur de retour : +Valeur de retour : * table de hachage dupliquée -Exemple en C : +Exemple en C : [source,C] ---- @@ -4064,7 +4064,7 @@ _WeeChat ≥ 0.3.3._ Retourner une valeur entière pour une propriété d'une table de hachage. -Prototype : +Prototype : [source,C] ---- @@ -4072,18 +4072,18 @@ int weechat_hashtable_get_integer (struct t_hashtable *hashtable, void *property); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _property_ : nom de propriété : -** _size_ : taille du tableau interne "htable" dans la table de hachage -** _items_count_ : nombre d'éléments dans la table de hachage +* _hashtable_ : pointeur vers la table de hachage +* _property_ : nom de propriété : +** _size_ : taille du tableau interne "htable" dans la table de hachage +** _items_count_ : nombre d'éléments dans la table de hachage -Valeur de retour : +Valeur de retour : * valeur de la propriété sous forme d'entier -Exemple en C : +Exemple en C : [source,C] ---- @@ -4100,7 +4100,7 @@ _WeeChat ≥ 0.3.4._ Retourner une valeur pour une propriété d'une table de hachage sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- @@ -4108,43 +4108,43 @@ const char *weechat_hashtable_get_string (struct t_hashtable *hashtable, const char *property); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _property_ : nom de la propriété : -** _type_keys_ : type pour les clés : -*** _integer_ : entier -*** _string_ : chaîne -*** _pointer_ : pointeur -*** _buffer_ : buffer -*** _time_ : heure -** _type_values_ : type pour les valeurs : -*** _integer_ : entier -*** _string_ : chaîne -*** _pointer_ : pointeur -*** _buffer_ : buffer -*** _time_ : heure -** _keys_ : chaîne avec la liste des clés (format : "clé1,clé2,clé3") -** _keys_sorted_ : chaîne avec la liste triée des clés (format : +* _hashtable_ : pointeur vers la table de hachage +* _property_ : nom de la propriété : +** _type_keys_ : type pour les clés : +*** _integer_ : entier +*** _string_ : chaîne +*** _pointer_ : pointeur +*** _buffer_ : buffer +*** _time_ : heure +** _type_values_ : type pour les valeurs : +*** _integer_ : entier +*** _string_ : chaîne +*** _pointer_ : pointeur +*** _buffer_ : buffer +*** _time_ : heure +** _keys_ : chaîne avec la liste des clés (format : "clé1,clé2,clé3") +** _keys_sorted_ : chaîne avec la liste triée des clés (format : "clé1,clé2,clé3") -** _values_ : chaîne avec la liste des valeurs (format : +** _values_ : chaîne avec la liste des valeurs (format : "valeur1,valeur2,valeur3") -** _keys_values_ : chaîne avec la liste des clés et valeurs - (format : "clé1:valeur1,clé2:valeur2,clé3:valeur3") -** _keys_values_sorted_ : chaîne avec la liste des clés et valeurs (triée sur - les clés) (format : "clé1:valeur1,clé2:valeur2,clé3:valeur3") +** _keys_values_ : chaîne avec la liste des clés et valeurs + (format : "clé1:valeur1,clé2:valeur2,clé3:valeur3") +** _keys_values_sorted_ : chaîne avec la liste des clés et valeurs (triée sur + les clés) (format : "clé1:valeur1,clé2:valeur2,clé3:valeur3") -Valeur de retour : +Valeur de retour : * valeur de la propriété sous forme de chaîne -Exemples en C : +Exemples en C : [source,C] ---- -weechat_printf (NULL, "les clés sont de type : %s", +weechat_printf (NULL, "les clés sont de type : %s", weechat_hashtable_get_string (hashtable, "type_keys")); -weechat_printf (NULL, "liste des clés : %s", +weechat_printf (NULL, "liste des clés : %s", weechat_hashtable_get_string (hashtable, "keys")); ---- @@ -4157,7 +4157,7 @@ _WeeChat ≥ 0.3.4._ Affecter un pointeur à une propriété d'une table de hachage. -Prototype : +Prototype : [source,C] ---- @@ -4165,17 +4165,17 @@ void weechat_hashtable_set_pointer (struct t_hashtable *hashtable, const char *property, void *pointer); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _property_ : nom de la propriété : -** _callback_free_key_ : définit la fonction "callback" pour supprimer les clés +* _hashtable_ : pointeur vers la table de hachage +* _property_ : nom de la propriété : +** _callback_free_key_ : définit la fonction "callback" pour supprimer les clés de la table de hachage _(WeeChat ≥ 0.4.2)_ -** _callback_free_value_ : définit la fonction "callback" pour supprimer les +** _callback_free_value_ : définit la fonction "callback" pour supprimer les valeurs de la table de hachage -* _pointer_ : nouvelle valeur de pointeur pour la propriété +* _pointer_ : nouvelle valeur de pointeur pour la propriété -Exemple en C : +Exemple en C : [source,C] ---- @@ -4204,7 +4204,7 @@ _WeeChat ≥ 0.3.3._ Ajouter les éléments d'une table de hachage dans un objet infolist. -Prototype : +Prototype : [source,C] ---- @@ -4213,26 +4213,26 @@ int weechat_hashtable_add_to_infolist (struct t_hashtable *hashtable, const char *prefix); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _infolist_item_ : pointeur vers l'objet de l'infolist -* _prefix_ : chaîne utilisée comme préfixe pour les noms dans l'infolist +* _hashtable_ : pointeur vers la table de hachage +* _infolist_item_ : pointeur vers l'objet de l'infolist +* _prefix_ : chaîne utilisée comme préfixe pour les noms dans l'infolist -Valeur de retour : +Valeur de retour : * 1 si ok, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- weechat_hashtable_add_to_infolist (hashtable, infolist_item, "testhash"); -/* si la table de hachage contient : +/* si la table de hachage contient : "cle1" => "valeur 1" "cle2" => "valeur 2" - alors les variables suivantes seront ajoutées dans l'objet de l'infolist : + alors les variables suivantes seront ajoutées dans l'objet de l'infolist : "testhash_name_00000" = "cle1" "testhash_value_00000" = "valeur 1" "testhash_name_00001" = "cle2" @@ -4249,19 +4249,19 @@ _WeeChat ≥ 0.3.3._ Supprimer un élément d'une table de hachage. -Prototype : +Prototype : [source,C] ---- void weechat_hashtable_remove (struct t_hashtable *hashtable, const void *key); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage -* _key_ : pointeur vers la clé +* _hashtable_ : pointeur vers la table de hachage +* _key_ : pointeur vers la clé -Exemple en C : +Exemple en C : [source,C] ---- @@ -4277,18 +4277,18 @@ _WeeChat ≥ 0.3.3._ Supprimer tous les éléments d'une table de hachage. -Prototype : +Prototype : [source,C] ---- void weechat_hashtable_remove_all (struct t_hashtable *hashtable); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage +* _hashtable_ : pointeur vers la table de hachage -Exemple en C : +Exemple en C : [source,C] ---- @@ -4304,18 +4304,18 @@ _WeeChat ≥ 0.3.3._ Supprimer une table de hachage. -Prototype : +Prototype : [source,C] ---- void weechat_hashtable_free (struct t_hashtable *hashtable); ---- -Paramètres : +Paramètres : -* _hashtable_ : pointeur vers la table de hachage +* _hashtable_ : pointeur vers la table de hachage -Exemple en C : +Exemple en C : [source,C] ---- @@ -4336,7 +4336,7 @@ _Mis à jour dans la 1.5._ Créer un nouveau fichier de configuration. -Prototype : +Prototype : [source,C] ---- @@ -4348,28 +4348,28 @@ struct t_config_file *weechat_config_new (const char *name, void *callback_reload_data); ---- -Paramètres : +Paramètres : -* _name_ : nom du nouveau fichier de configuration (sans chemin ou extension) -* _callback_reload_ : fonction appelée quand le fichier de configuration est +* _name_ : nom du nouveau fichier de configuration (sans chemin ou extension) +* _callback_reload_ : fonction appelée quand le fichier de configuration est rechargé avec `/reload` (optionnel, peut être NULL), paramètres et valeur de - retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_file *config_file_ : pointeur vers le fichier de + retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_file *config_file_ : pointeur vers le fichier de configuration -** valeur de retour : +** valeur de retour : *** _WEECHAT_CONFIG_READ_OK_ *** _WEECHAT_CONFIG_READ_MEMORY_ERROR_ *** _WEECHAT_CONFIG_READ_FILE_NOT_FOUND_ -* _callback_reload_pointer_ : pointeur donné au "callback" de rechargement +* _callback_reload_pointer_ : pointeur donné au "callback" de rechargement lorsqu'il est appelé par WeeChat -* _callback_reload_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_reload_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le fichier de configuration est libéré -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau fichier de configuration, NULL en cas d'erreur @@ -4380,7 +4380,7 @@ Vous ne devriez appeler cette fonction qu'après avoir créé les sections (avec <<_config_new_section,config_new_section>>) et les options (avec <<_config_new_option,config_new_option>>). -Exemple en C : +Exemple en C : [source,C] ---- @@ -4398,7 +4398,7 @@ struct t_config_file *config_file = weechat_config_new ("test", NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -4419,7 +4419,7 @@ _Mis à jour dans la 1.5._ Créer une nouvelle section dans un fichier de configuration. -Prototype : +Prototype : [source,C] ---- @@ -4465,114 +4465,114 @@ struct t_config_section *weechat_config_new_section ( void *callback_delete_option_data); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration -* _name_ : nom de la section -* _user_can_add_options_ : 1 si l'utilisateur peut créer de nouvelles options +* _config_file_ : pointeur vers le fichier de configuration +* _name_ : nom de la section +* _user_can_add_options_ : 1 si l'utilisateur peut créer de nouvelles options dans la section, ou 0 si c'est interdit -* _user_can_delete_options_ : 1 si l'utilisateur peut supprimer des options +* _user_can_delete_options_ : 1 si l'utilisateur peut supprimer des options dans la section, ou 0 si c'est interdit -* _callback_read_ : fonction appelée quand une option de la section est lue +* _callback_read_ : fonction appelée quand une option de la section est lue depuis le disque (devrait être NULL dans la plupart des cas, sauf si des options de la section nécessitent une fonction personnalisée), paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_file *config_file_ : pointeur vers le fichier de + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_file *config_file_ : pointeur vers le fichier de configuration -** _struct t_config_section *section_ : pointeur vers la section -** _const char *option_name_ : nom de l'option -** _const char *value_ : valeur -** valeur de retour : +** _struct t_config_section *section_ : pointeur vers la section +** _const char *option_name_ : nom de l'option +** _const char *value_ : valeur +** valeur de retour : *** _WEECHAT_CONFIG_READ_OK_ *** _WEECHAT_CONFIG_READ_MEMORY_ERROR_ *** _WEECHAT_CONFIG_READ_FILE_NOT_FOUND_ -* _callback_read_pointer_ : pointeur donné au "callback" quand il est appelé +* _callback_read_pointer_ : pointeur donné au "callback" quand il est appelé par WeeChat -* _callback_read_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_read_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque la section est libérée -* _callback_write_ : fonction appelée lorsque la section est écrite dans le +* _callback_write_ : fonction appelée lorsque la section est écrite dans le fichier (devrait être NULL dans la plupart des cas, sauf si la section nécessite d'être écrite par une fonction personnalisée), paramètres et valeur - de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_file *config_file_ : pointeur vers le fichier de + de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_file *config_file_ : pointeur vers le fichier de configuration -** _const char *section_name_ : nom de la section -** valeur de retour : +** _const char *section_name_ : nom de la section +** valeur de retour : *** _WEECHAT_CONFIG_WRITE_OK_ *** _WEECHAT_CONFIG_WRITE_ERROR_ *** _WEECHAT_CONFIG_WRITE_MEMORY_ERROR_ -* _callback_write_pointer_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_write_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_write_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_write_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque la section est libérée -* _callback_write_default_ : fonction appelée lorsque les valeurs par défaut - doivent être écrites dans le fichier, paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_file *config_file_ : pointeur vers le fichier de +* _callback_write_default_ : fonction appelée lorsque les valeurs par défaut + doivent être écrites dans le fichier, paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_file *config_file_ : pointeur vers le fichier de configuration -** _const char *section_name_ : nom de la section -** valeur de retour : +** _const char *section_name_ : nom de la section +** valeur de retour : *** _WEECHAT_CONFIG_WRITE_OK_ *** _WEECHAT_CONFIG_WRITE_ERROR_ *** _WEECHAT_CONFIG_WRITE_MEMORY_ERROR_ -* _callback_write_default_pointer_ : pointeur donné au "callback" lorsqu'il est +* _callback_write_default_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_write_default_data_ : pointeur donné au "callback" lorsqu'il est +* _callback_write_default_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque la section est libérée -* _callback_create_option_ : fonction appelée lorsqu'une nouvelle option est +* _callback_create_option_ : fonction appelée lorsqu'une nouvelle option est créée dans la section (NULL si la section n'autorise pas la création de - nouvelles options), paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_file *config_file_ : pointeur vers le fichier de + nouvelles options), paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_file *config_file_ : pointeur vers le fichier de configuration -** _struct t_config_section *section_ : pointeur vers la section -** _const char *option_name_ : nom de l'option -** _const char *value_ : valeur -* _callback_create_option_pointer_ : pointeur donné au "callback" lorsqu'il est +** _struct t_config_section *section_ : pointeur vers la section +** _const char *option_name_ : nom de l'option +** _const char *value_ : valeur +* _callback_create_option_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_create_option_data_ : pointeur donné au "callback" lorsqu'il est +* _callback_create_option_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque la section est libérée -* _callback_delete_option_ : fonction appelée lorsqu'une option est supprimée +* _callback_delete_option_ : fonction appelée lorsqu'une option est supprimée de la section (NULL si la section n'autorise pas la suppression d'options), - paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_file *config_file_ : pointeur vers le fichier de + paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_file *config_file_ : pointeur vers le fichier de configuration -** _struct t_config_section *section_ : pointeur vers la section -** _struct t_config_option *option_ : pointeur vers l'option -** valeur de retour : +** _struct t_config_section *section_ : pointeur vers la section +** _struct t_config_option *option_ : pointeur vers l'option +** valeur de retour : *** _WEECHAT_CONFIG_OPTION_SET_OK_CHANGED_ *** _WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE_ *** _WEECHAT_CONFIG_OPTION_SET_ERROR_ *** _WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND_ -* _callback_delete_option_pointer_ : pointeur donné au "callback" lorsqu'il est +* _callback_delete_option_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_delete_option_data_ : pointeur donné au "callback" lorsqu'il est +* _callback_delete_option_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque la section est libérée -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle section du fichier de configuration, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -4663,7 +4663,7 @@ struct t_config_section *new_section2 = &my_section_delete_option_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -4711,7 +4711,7 @@ section = weechat.config_new_section(config_file, "section1", 1, 1, Rechercher une section dans un fichier de configuration. -Prototype : +Prototype : [source,C] ---- @@ -4720,16 +4720,16 @@ struct t_config_section *weechat_config_search_section ( const char *section_name); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration -* _section_name_ : nom de la section à chercher +* _config_file_ : pointeur vers le fichier de configuration +* _section_name_ : nom de la section à chercher -Valeur de retour : +Valeur de retour : * pointeur vers la section trouvée, ou NULL si la section n'a pas été trouvée -Exemple en C : +Exemple en C : [source,C] ---- @@ -4737,7 +4737,7 @@ struct t_config_section *section = weechat_config_search_section (config_file, "section"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -4754,7 +4754,7 @@ _Mis à jour dans la 1.5._ Créer une nouvelle option dans une section d'un fichier de configuration. -Prototype : +Prototype : [source,C] ---- @@ -4788,72 +4788,72 @@ struct t_config_option *weechat_config_new_option ( void *callback_delete_data); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration -* _section_ : pointeur vers la section -* _name_ : nom de l'option ; avec WeeChat ≥ 1.4, le nom peut inclure le nom +* _config_file_ : pointeur vers le fichier de configuration +* _section_ : pointeur vers la section +* _name_ : nom de l'option ; avec WeeChat ≥ 1.4, le nom peut inclure le nom d'une option parente (la valeur de l'option parente sera affichée dans la - sortie de `/set` si cette option est "null"), la syntaxe est alors : + sortie de `/set` si cette option est "null"), la syntaxe est alors : "name << file.section.option" -* _type_ : type de l'option : -** _boolean_ : valeur booléenne (on/off) -** _integer_ : valeur entière (avec en option une chaîne pour chaque valeur) -** _string_ : une chaîne de caractères -** _color_ : une couleur -* _description_ : description de l'option -* _string_values_ : valeurs sous forme de chaîne (séparées par `+|+`), utilisées +* _type_ : type de l'option : +** _boolean_ : valeur booléenne (on/off) +** _integer_ : valeur entière (avec en option une chaîne pour chaque valeur) +** _string_ : une chaîne de caractères +** _color_ : une couleur +* _description_ : description de l'option +* _string_values_ : valeurs sous forme de chaîne (séparées par `+|+`), utilisées pour le type _integer_ (optionnel) -* _min_ : valeur minimum (pour le type _integer_) -* _max_ : valeur maximum (pour le type _integer_) -* _default_value_ : valeur par défaut de l'option (utilisée quand l'option est +* _min_ : valeur minimum (pour le type _integer_) +* _max_ : valeur maximum (pour le type _integer_) +* _default_value_ : valeur par défaut de l'option (utilisée quand l'option est réinitialisée) -* _value_ : valeur de l'option -* _null_value_allowed_ : 1 si _null_ (valeur non définie) est autorisé pour +* _value_ : valeur de l'option +* _null_value_allowed_ : 1 si _null_ (valeur non définie) est autorisé pour l'option, sinon 0 -* _callback_check_value_ : fonction appelée pour vérifier la nouvelle valeur - de l'option (optionnel), paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_option *option_ : pointeur vers l'option -** _const char *value_ : nouvelle valeur pour l'option -** valeur de retour : +* _callback_check_value_ : fonction appelée pour vérifier la nouvelle valeur + de l'option (optionnel), paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_option *option_ : pointeur vers l'option +** _const char *value_ : nouvelle valeur pour l'option +** valeur de retour : *** 1 si la valeur est ok *** 0 si la valeur est invalide -* _callback_check_value_pointer_ : pointeur donné au "callback" lorsqu'il est +* _callback_check_value_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_check_value_data_ : pointeur donné au "callback" lorsqu'il est +* _callback_check_value_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque l'option est libérée -* _callback_change_ : fonction appelée lorsque la valeur de l'option a changé - (optionnel), paramètres : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_option *option_ : pointeur vers l'option -* _callback_change_pointer_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_change_ : fonction appelée lorsque la valeur de l'option a changé + (optionnel), paramètres : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_option *option_ : pointeur vers l'option +* _callback_change_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_change_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_change_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque l'option est libérée -* _callback_delete_ : fonction appelée lorsque l'option est supprimée - (optionnel), paramètres : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_config_option *option_ : pointeur vers l'option -* _callback_delete_pointer_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_delete_ : fonction appelée lorsque l'option est supprimée + (optionnel), paramètres : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_config_option *option_ : pointeur vers l'option +* _callback_delete_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_delete_data_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_delete_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque l'option est libérée -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle option de la section, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -4924,7 +4924,7 @@ struct t_config_option *option5 = NULL, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -4994,7 +4994,7 @@ _(corrigé dans la version 0.4.1)_. Rechercher une option dans une section d'un fichier de configuration. -Prototype : +Prototype : [source,C] ---- @@ -5004,17 +5004,17 @@ struct t_config_option *weechat_config_search_option ( const char *option_name); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration -* _section_ : pointeur vers la section -* _name_ : nom de l'option à rechercher +* _config_file_ : pointeur vers le fichier de configuration +* _section_ : pointeur vers la section +* _name_ : nom de l'option à rechercher -Valeur de retour : +Valeur de retour : * pointeur vers l'option trouvée, NULL si l'option n'a pas été trouvée -Exemple en C : +Exemple en C : [source,C] ---- @@ -5022,7 +5022,7 @@ struct t_config_option *option = weechat_config_search_option (config_file, section, "option"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5038,7 +5038,7 @@ option = weechat.config_search_option(config_file, section, "option") Rechercher une section et une option dans un fichier de configuration ou une section. -Prototype : +Prototype : [source,C] ---- @@ -5049,17 +5049,17 @@ void weechat_config_search_section_option (struct t_config_file *config_file, struct t_config_option **option_found); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration -* _section_ : pointeur vers la section -* _option_name_ : nom de l'option -* _section_ : pointeur vers un pointeur sur une section, sera alimenté avec le +* _config_file_ : pointeur vers le fichier de configuration +* _section_ : pointeur vers la section +* _option_name_ : nom de l'option +* _section_ : pointeur vers un pointeur sur une section, sera alimenté avec le pointeur vers la section de l'option trouvée -* _option_ : pointeur vers un pointeur sur une option, sera alimenté avec le +* _option_ : pointeur vers un pointeur sur une option, sera alimenté avec le pointeur vers l'option trouvée -Exemple en C : +Exemple en C : [source,C] ---- @@ -5089,7 +5089,7 @@ Cette fonction n'est pas disponible dans l'API script. Retourner des infos sur fichier/section/option pour une option avec le nom complet. -Prototype : +Prototype : [source,C] ---- @@ -5100,20 +5100,20 @@ void weechat_config_search_with_string (const char *option_name, char **pos_option_name); ---- -Paramètres : +Paramètres : -* _option_name_ : nom complet de l'option (format : "fichier.section.option") -* _config_file_ : pointeur vers un pointeur sur un fichier de configuration, +* _option_name_ : nom complet de l'option (format : "fichier.section.option") +* _config_file_ : pointeur vers un pointeur sur un fichier de configuration, sera alimenté avec le pointeur vers le fichier de configuration de l'option trouvée -* _section_ : pointeur vers un pointeur sur une section, sera alimenté avec le +* _section_ : pointeur vers un pointeur sur une section, sera alimenté avec le pointeur vers la section de l'option trouvée -* _option_ : pointeur vers un pointeur sur une option, sera alimenté avec le +* _option_ : pointeur vers un pointeur sur une option, sera alimenté avec le pointeur vers l'option trouvée -* _pos_option_name_ : pointeur vers un pointeur sur une chaîne, sera alimenté +* _pos_option_name_ : pointeur vers un pointeur sur une chaîne, sera alimenté avec le pointeur vers le nom de l'option trouvée -Exemple en C : +Exemple en C : [source,C] ---- @@ -5144,23 +5144,23 @@ Cette fonction n'est pas disponible dans l'API script. Vérifier si un texte est "vrai" ou "faux", au sens booléen. -Prototype : +Prototype : [source,C] ---- int weechat_config_string_to_boolean (const char *text); ---- -Paramètres : +Paramètres : -* _text_ : texte à analyser +* _text_ : texte à analyser -Valeur de retour : +Valeur de retour : * 1 si le texte est "vrai" ("on", "yes", "y", "true", "t", "1") * 0 si le texte est "faux" ("off", "no", "n", "false", "f", "0") -Exemple en C : +Exemple en C : [source,C] ---- @@ -5174,7 +5174,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5190,7 +5190,7 @@ if weechat.config_string_to_boolean(text): Réinitialiser une option à sa valeur par défaut. -Prototype : +Prototype : [source,C] ---- @@ -5198,20 +5198,20 @@ int weechat_config_option_reset (struct t_config_option *option, int run_callback); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option -* _run_callback_ : 1 pour appeler le "callback" si la valeur de l'option est +* _option_ : pointeur vers l'option +* _run_callback_ : 1 pour appeler le "callback" si la valeur de l'option est changée, sinon 0 -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_OPTION_SET_OK_CHANGED_ si la valeur de l'option a été réinitialisée * _WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE_ si la valeur n'a pas changé * _WEECHAT_CONFIG_OPTION_SET_ERROR_ en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -5229,7 +5229,7 @@ switch (weechat_config_option_reset (option, 1)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5250,7 +5250,7 @@ elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_ERROR: Affecter une nouvelle valeur pour une option. -Prototype : +Prototype : [source,C] ---- @@ -5258,20 +5258,20 @@ int weechat_config_option_set (struct t_config_option *option, const char *value, int run_callback); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option -* _value_ : nouvelle valeur pour l'option -* _run_callback_ : 1 pour appeler le "callback" si la valeur de l'option est +* _option_ : pointeur vers l'option +* _value_ : nouvelle valeur pour l'option +* _run_callback_ : 1 pour appeler le "callback" si la valeur de l'option est changée, sinon 0 -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_OPTION_SET_OK_CHANGED_ si la valeur de l'option a été changée * _WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE_ si la valeur n'a pas changé * _WEECHAT_CONFIG_OPTION_SET_ERROR_ en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -5289,7 +5289,7 @@ switch (weechat_config_option_set (option, "nouvelle_valeur", 1)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5310,7 +5310,7 @@ elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_ERROR: Affecter "null" (valeur indéfinie) à une option. -Prototype : +Prototype : [source,C] ---- @@ -5318,23 +5318,23 @@ int weechat_config_option_set_null (struct t_config_option *option, int run_callback); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option -* _run_callback_ : 1 pour appeler le "callback" si la valeur de l'option est +* _option_ : pointeur vers l'option +* _run_callback_ : 1 pour appeler le "callback" si la valeur de l'option est changée (elle n'était pas "null"), sinon 0 [NOTE] Vous pouvez affecter "null" à une option seulement si c'est autorisé pour l'option (voir <<_config_new_option,config_new_option>>). -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_OPTION_SET_OK_CHANGED_ si la valeur de l'option a été changée * _WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE_ si la valeur n'a pas changé * _WEECHAT_CONFIG_OPTION_SET_ERROR_ en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -5352,7 +5352,7 @@ switch (weechat_config_option_set_null (option, 1)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5373,18 +5373,18 @@ elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_ERROR: Réinitialiser ou supprimer une option. -Prototype : +Prototype : [source,C] ---- int weechat_config_option_unset (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET_ si la valeur de l'option n'a pas été réinitialisée @@ -5393,7 +5393,7 @@ Valeur de retour : * _WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED_ si l'option a été supprimée * _WEECHAT_CONFIG_OPTION_UNSET_ERROR_ en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -5414,7 +5414,7 @@ switch (weechat_config_option_unset (option)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5437,7 +5437,7 @@ elif rc == weechat.WEECHAT_CONFIG_OPTION_UNSET_ERROR: Renommer une option. -Prototype : +Prototype : [source,C] ---- @@ -5445,19 +5445,19 @@ void weechat_config_option_rename (struct t_config_option *option, const char *new_name); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option -* _new_name_ : nouveau nom pour l'option +* _option_ : pointeur vers l'option +* _new_name_ : nouveau nom pour l'option -Exemple en C : +Exemple en C : [source,C] ---- weechat_config_option_rename (option, "nouveau_nom"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5472,7 +5472,7 @@ weechat.config_option_rename(option, "nouveau_nom") Retourner un pointeur vers une propriété de l'option. -Prototype : +Prototype : [source,C] ---- @@ -5480,32 +5480,32 @@ void *weechat_config_option_get_pointer (struct t_config_option *option, const char *property); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option -* _property_ : nom de la propriété : -** _config_file_ : pointeur vers le fichier de configuration +* _option_ : pointeur vers l'option +* _property_ : nom de la propriété : +** _config_file_ : pointeur vers le fichier de configuration (_struct t_config_file *_) -** _section_ : pointeur vers la section (_struct t_config_section *_) -** _name_ : nom de l'option (_char *_) -** _parent_name_ : nom de l'option parente (_char *_) _(WeeChat ≥ 1.4)_ -** _type_ : type de l'option (_int *_) -** _description_ : description de l'option (_char *_) -** _string_values_ : valeurs sous forme de chaîne (_char *_) -** _min_ : valeur minimum (_int *_) -** _max_ : valeur maximum (_int *_) -** _default_value_ : valeur par défaut (dépend du type) -** _value_ : valeur courante (dépend du type) -** _prev_option_ : pointeur vers l'option précédente +** _section_ : pointeur vers la section (_struct t_config_section *_) +** _name_ : nom de l'option (_char *_) +** _parent_name_ : nom de l'option parente (_char *_) _(WeeChat ≥ 1.4)_ +** _type_ : type de l'option (_int *_) +** _description_ : description de l'option (_char *_) +** _string_values_ : valeurs sous forme de chaîne (_char *_) +** _min_ : valeur minimum (_int *_) +** _max_ : valeur maximum (_int *_) +** _default_value_ : valeur par défaut (dépend du type) +** _value_ : valeur courante (dépend du type) +** _prev_option_ : pointeur vers l'option précédente (_struct t_config_option *_) -** _next_option_ : pointeur vers l'option suivante +** _next_option_ : pointeur vers l'option suivante (_struct t_config_option *_) -Valeur de retour : +Valeur de retour : * pointeur vers la propriété demandée -Exemple en C : +Exemple en C : [source,C] ---- @@ -5519,23 +5519,23 @@ Cette fonction n'est pas disponible dans l'API script. Vérifier si une option est "null" (valeur non définie). -Prototype : +Prototype : [source,C] ---- int weechat_config_option_is_null (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour : +Valeur de retour : * 1 si la valeur de l'option est "null" * 0 si la valeur de l'option n'est pas "null" -Exemple en C : +Exemple en C : [source,C] ---- @@ -5549,7 +5549,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5565,23 +5565,23 @@ if weechat.config_option_is_null(option): Vérifier si la valeur par défaut d'une option est "null" (valeur non définie). -Prototype : +Prototype : [source,C] ---- int weechat_config_option_default_is_null (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour : +Valeur de retour : * 1 si la valeur par défaut de l'option est "null" * 0 si la valeur par défaut de l'option n'est pas "null" -Exemple en C : +Exemple en C : [source,C] ---- @@ -5595,7 +5595,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5611,25 +5611,25 @@ if weechat.config_option_default_is_null(option): Retourner la valeur booléenne de l'option. -Prototype : +Prototype : [source,C] ---- int weechat_config_boolean (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de l'option : +Valeur de retour, selon le type de l'option : -* _boolean_ : valeur booléenne de l'option (0 ou 1) -* _integer_ : 0 -* _string_ : 0 -* _color_ : 0 +* _boolean_ : valeur booléenne de l'option (0 ou 1) +* _integer_ : 0 +* _string_ : 0 +* _color_ : 0 -Exemple en C : +Exemple en C : [source,C] ---- @@ -5644,7 +5644,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5661,25 +5661,25 @@ if weechat.config_boolean(option): Retourner la valeur booléenne par défaut de l'option. -Prototype : +Prototype : [source,C] ---- int weechat_config_boolean_default (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de l'option : +Valeur de retour, selon le type de l'option : -* _boolean_ : valeur booléenne par défaut de l'option (0 ou 1) -* _integer_ : 0 -* _string_ : 0 -* _color_ : 0 +* _boolean_ : valeur booléenne par défaut de l'option (0 ou 1) +* _integer_ : 0 +* _string_ : 0 +* _color_ : 0 -Exemple en C : +Exemple en C : [source,C] ---- @@ -5694,7 +5694,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5711,25 +5711,25 @@ if weechat.config_boolean_default(option): Retourner la valeur entière de l'option. -Prototype : +Prototype : [source,C] ---- int weechat_config_integer (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de l'option : +Valeur de retour, selon le type de l'option : -* _boolean_ : valeur booléenne de l'option (0 ou 1) -* _integer_ : valeur entière de l'option -* _string_ : 0 -* _color_ : index de la couleur +* _boolean_ : valeur booléenne de l'option (0 ou 1) +* _integer_ : valeur entière de l'option +* _string_ : 0 +* _color_ : index de la couleur -Exemple en C : +Exemple en C : [source,C] ---- @@ -5737,7 +5737,7 @@ struct t_config_option *option = weechat_config_get ("plugin.section.option"); int value = weechat_config_integer (option); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5753,25 +5753,25 @@ value = weechat.config_integer(option) Retourner la valeur entière par défaut de l'option. -Prototype : +Prototype : [source,C] ---- int weechat_config_integer_default (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de l'option : +Valeur de retour, selon le type de l'option : -* _boolean_ : valeur booléenne par défaut de l'option (0 ou 1) -* _integer_ : valeur entière par défaut de l'option -* _string_ : 0 -* _color_ : index de la couleur par défaut +* _boolean_ : valeur booléenne par défaut de l'option (0 ou 1) +* _integer_ : valeur entière par défaut de l'option +* _string_ : 0 +* _color_ : index de la couleur par défaut -Exemple en C : +Exemple en C : [source,C] ---- @@ -5779,7 +5779,7 @@ struct t_config_option *option = weechat_config_get ("plugin.section.option"); int value = weechat_config_integer_default (option); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5795,26 +5795,26 @@ value = weechat.config_integer_default(option) Retourner la valeur de l'option, sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- const char *weechat_config_string (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de l'option : +Valeur de retour, selon le type de l'option : -* _boolean_ : "on" si la valeur est vraie, sinon "off" -* _integer_ : valeur de l'option sous forme de chaîne si l'option est un entier +* _boolean_ : "on" si la valeur est vraie, sinon "off" +* _integer_ : valeur de l'option sous forme de chaîne si l'option est un entier avec des valeurs sous forme de chaînes, sinon NULL -* _string_ : valeur de l'option sous forme de chaîne -* _color_ : nom de la couleur +* _string_ : valeur de l'option sous forme de chaîne +* _color_ : nom de la couleur -Exemple en C : +Exemple en C : [source,C] ---- @@ -5822,7 +5822,7 @@ struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *value = weechat_config_string (option); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5838,26 +5838,26 @@ value = weechat.config_string(option) Retourner la valeur par défaut de l'option, sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- const char *weechat_config_string_default (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de l'option : +Valeur de retour, selon le type de l'option : -* _boolean_ : "on" si la valeur par défaut est vraie, sinon "off" -* _integer_ : valeur par défaut de l'option sous forme de chaîne si l'option +* _boolean_ : "on" si la valeur par défaut est vraie, sinon "off" +* _integer_ : valeur par défaut de l'option sous forme de chaîne si l'option est un entier avec des valeurs sous forme de chaînes, sinon NULL -* _string_ : valeur par défaut de l'option sous forme de chaîne -* _color_ : nom de la couleur par défaut +* _string_ : valeur par défaut de l'option sous forme de chaîne +* _color_ : nom de la couleur par défaut -Exemple en C : +Exemple en C : [source,C] ---- @@ -5865,7 +5865,7 @@ struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *value = weechat_config_string_default (option); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5881,25 +5881,25 @@ value = weechat.config_string_default(option) Retourner la valeur de l'option, sous forme de couleur. -Prototype : +Prototype : [source,C] ---- const char *weechat_config_color (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de l'option : +Valeur de retour, selon le type de l'option : -* _boolean_ : NULL -* _integer_ : NULL -* _string_ : NULL -* _color_ : nom de la couleur +* _boolean_ : NULL +* _integer_ : NULL +* _string_ : NULL +* _color_ : nom de la couleur -Exemple en C : +Exemple en C : [source,C] ---- @@ -5907,7 +5907,7 @@ struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *color = weechat_config_color (option); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5923,25 +5923,25 @@ value = weechat.config_color(option) Retourner la valeur par défaut de l'option, sous forme de couleur. -Prototype : +Prototype : [source,C] ---- const char *weechat_config_color_default (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Valeur de retour, selon le type de l'option : +Valeur de retour, selon le type de l'option : -* _boolean_ : NULL -* _integer_ : NULL -* _string_ : NULL -* _color_ : nom de la couleur par défaut +* _boolean_ : NULL +* _integer_ : NULL +* _string_ : NULL +* _color_ : nom de la couleur par défaut -Exemple en C : +Exemple en C : [source,C] ---- @@ -5949,7 +5949,7 @@ struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *color = weechat_config_color_default (option); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -5967,7 +5967,7 @@ value = weechat.config_color_default(option) (cette fonction doit être appelée uniquement dans un "callback" "write" ou "write_default" pour une section). -Prototype : +Prototype : [source,C] ---- @@ -5975,12 +5975,12 @@ void weechat_config_write_option (struct t_config_file *config_file, struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration -* _option_ : pointeur vers l'option +* _config_file_ : pointeur vers le fichier de configuration +* _option_ : pointeur vers l'option -Exemple en C : +Exemple en C : [source,C] ---- @@ -5997,7 +5997,7 @@ my_section_write_cb (const void *pointer, void *data, } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6017,7 +6017,7 @@ def my_section_write_cb(data, config_file, section_name): appelée uniquement dans un "callback" "write" ou "write_default" pour une section). -Prototype : +Prototype : [source,C] ---- @@ -6026,14 +6026,14 @@ void weechat_config_write_line (struct t_config_file *config_file, const char *value, ...); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration -* _option_name_ : nom de l'option -* _value_ : valeur (si NULL, alors la ligne est écrite avec le nom de la - section, par exemple : "[section]") +* _config_file_ : pointeur vers le fichier de configuration +* _option_name_ : nom de l'option +* _value_ : valeur (si NULL, alors la ligne est écrite avec le nom de la + section, par exemple : "[section]") -Exemple en C : +Exemple en C : [source,C] ---- @@ -6051,7 +6051,7 @@ my_section_write_cb (const void *pointer, void *data, } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6069,24 +6069,24 @@ def my_section_write_cb(data, config_file, section_name): Écrire un fichier de configuration sur le disque. -Prototype : +Prototype : [source,C] ---- int weechat_config_write (struct t_config_file *config_file); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration. +* _config_file_ : pointeur vers le fichier de configuration. -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_WRITE_OK_ si la configuration a été écrite * _WEECHAT_CONFIG_WRITE_MEMORY_ERROR_ s'il n'y a pas eu suffisamment de mémoire * _WEECHAT_CONFIG_WRITE_ERROR_ si une autre erreur s'est produite -Exemple en C : +Exemple en C : [source,C] ---- @@ -6104,7 +6104,7 @@ switch (weechat_config_write (config_file)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6125,24 +6125,24 @@ elif rc == weechat.WEECHAT_CONFIG_WRITE_ERROR: Lire un fichier de configuration depuis le disque. -Prototype : +Prototype : [source,C] ---- int weechat_config_read (struct t_config_file *config_file); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration +* _config_file_ : pointeur vers le fichier de configuration -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_READ_OK_ si la configuration a été chargée * _WEECHAT_CONFIG_READ_MEMORY_ERROR_ s'il n'y a pas eu suffisamment de mémoire * _WEECHAT_CONFIG_READ_FILE_NOT_FOUND_ si le fichier n'a pas été trouvé -Exemple en C : +Exemple en C : [source,C] ---- @@ -6160,7 +6160,7 @@ switch (weechat_config_read (config_file)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6181,24 +6181,24 @@ elif rc == weechat.WEECHAT_CONFIG_READ_FILE_NOT_FOUND: Relire un fichier de configuration depuis le disque. -Prototype : +Prototype : [source,C] ---- int weechat_config_reload (struct t_config_file *config_file); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration +* _config_file_ : pointeur vers le fichier de configuration -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_READ_OK_ si la configuration a été rechargée * _WEECHAT_CONFIG_READ_MEMORY_ERROR_ s'il n'y a pas eu suffisamment de mémoire * _WEECHAT_CONFIG_READ_FILE_NOT_FOUND_ si le fichier n'a pas été trouvé -Exemple en C : +Exemple en C : [source,C] ---- @@ -6216,7 +6216,7 @@ switch (weechat_config_reload (config_file)) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6237,25 +6237,25 @@ elif rc == weechat.WEECHAT_CONFIG_READ_FILE_NOT_FOUND: Supprimer une option. -Prototype : +Prototype : [source,C] ---- void weechat_config_option_free (struct t_config_option *option); ---- -Paramètres : +Paramètres : -* _option_ : pointeur vers l'option +* _option_ : pointeur vers l'option -Exemple en C : +Exemple en C : [source,C] ---- weechat_config_option_free (option); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6270,25 +6270,25 @@ weechat.config_option_free(option) Supprimer toutes les options dans une section. -Prototype : +Prototype : [source,C] ---- void weechat_config_section_free_options (struct t_config_section *section); ---- -Paramètres : +Paramètres : -* _section_ : pointeur vers la section +* _section_ : pointeur vers la section -Exemple en C : +Exemple en C : [source,C] ---- weechat_config_section_free_options (section); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6303,25 +6303,25 @@ weechat.config_section_free_options(section) Supprimer une section. -Prototype : +Prototype : [source,C] ---- void weechat_config_section_free (struct t_config_section *section); ---- -Paramètres : +Paramètres : -* _section_ : pointeur vers la section +* _section_ : pointeur vers la section -Exemple en C : +Exemple en C : [source,C] ---- weechat_config_section_free (section); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6336,25 +6336,25 @@ weechat.config_section_free(section) Supprimer un fichier de configuration. -Prototype : +Prototype : [source,C] ---- void weechat_config_free (struct t_config_file *config_file); ---- -Paramètres : +Paramètres : -* _config_file_ : pointeur vers le fichier de configuration +* _config_file_ : pointeur vers le fichier de configuration -Exemple en C : +Exemple en C : [source,C] ---- weechat_config_free (config_file); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6369,29 +6369,29 @@ weechat.config_free(config_file) Rechercher une option avec le nom complet. -Prototype : +Prototype : [source,C] ---- struct t_config_option *weechat_config_get (const char *option_name); ---- -Paramètres : +Paramètres : -* _option_name_ : nom complet de l'option (format : "fichier.section.option") +* _option_name_ : nom complet de l'option (format : "fichier.section.option") -Valeur de retour : +Valeur de retour : * pointeur vers l'option trouvée, NULL si l'option n'a pas été trouvée -Exemple en C : +Exemple en C : [source,C] ---- struct t_config_option *option = weechat_config_get ("weechat.look.item_time_format"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6407,23 +6407,23 @@ option = weechat.config_get("weechat.look.item_time_format") Rechercher une option dans le fichier de configuration des extensions (plugins.conf). -Prototype : +Prototype : [source,C] ---- const char *weechat_config_get_plugin (const char *option_name); ---- -Paramètres : +Paramètres : -* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe +* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe "plugins.var.xxx." (où "xxx" est le nom de l'extension courante) -Valeur de retour : +Valeur de retour : * valeur de l'option trouvée, NULL si l'option n'a pas été trouvée -Exemple en C : +Exemple en C : [source,C] ---- @@ -6432,7 +6432,7 @@ Exemple en C : char *value = weechat_config_get_plugin ("option"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6448,23 +6448,23 @@ value = weechat.config_get_plugin("option") Vérifier si une option existe dans le fichier de configuration des extensions (plugins.conf). -Prototype : +Prototype : [source,C] ---- int weechat_config_is_set_plugin (const char *option_name); ---- -Paramètres : +Paramètres : -* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe +* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe "plugins.var.xxx." (où "xxx" est le nom de l'extension courante) -Valeur de retour : +Valeur de retour : * 1 si l'option est définie, 0 si l'option n'existe pas -Exemple en C : +Exemple en C : [source,C] ---- @@ -6478,7 +6478,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6499,27 +6499,27 @@ else: Affecter une nouvelle valeur pour une option dans le fichier de configuration des extensions (plugins.conf). -Prototype : +Prototype : [source,C] ---- int weechat_config_set_plugin (const char *option_name, const char *value); ---- -Paramètres : +Paramètres : -* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe +* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe "plugins.var.xxx." (où "xxx" est le nom de l'extension courante) -* _value_ : nouvelle valeur pour l'option +* _value_ : nouvelle valeur pour l'option -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_OPTION_SET_OK_CHANGED_ si la valeur de l'option a été changée * _WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE_ si la valeur n'a pas changé * _WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND_ si l'option n'a pas été trouvée * _WEECHAT_CONFIG_OPTION_SET_ERROR_ en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -6540,7 +6540,7 @@ switch (weechat_config_set_plugin ("option", "valeur_test")) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6566,7 +6566,7 @@ _WeeChat ≥ 0.3.5._ Affecter une description pour une option dans le fichier de configuration des extensions (plugins.conf). -Prototype : +Prototype : [source,C] ---- @@ -6574,24 +6574,24 @@ void weechat_config_set_desc_plugin (const char *option_name, const char *description); ---- -Paramètres : +Paramètres : -* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe +* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe "plugins.desc.xxx." (où "xxx" est le nom de l'extension courante) -* _description_ : description pour l'option +* _description_ : description pour l'option [NOTE] Ce n'est pas un problème si l'option (plugins.var.xxx.option_name) n'existe pas. Une création future de cette option utilisera cette description. -Exemple en C : +Exemple en C : [source,C] ---- weechat_config_set_desc_plugin ("option", "description de l'option"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6608,19 +6608,19 @@ if int(version) >= 0x00030500: Supprimer une option du fichier de configuration des extensions (plugins.conf). -Prototype : +Prototype : [source,C] ---- int weechat_config_unset_plugin (const char *option_name); ---- -Paramètres : +Paramètres : -* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe +* _option_name_ : nom de l'option, WeeChat ajoutera le préfixe "plugins.var.xxx." (où "xxx" est le nom de l'extension courante) -Valeur de retour : +Valeur de retour : * _WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET_ si la valeur de l'option n'a pas été réinitialisée @@ -6629,7 +6629,7 @@ Valeur de retour : * _WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED_ si l'option a été supprimée * _WEECHAT_CONFIG_OPTION_UNSET_ERROR_ en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -6650,7 +6650,7 @@ switch (weechat_config_unset_plugin ("option")) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6685,28 +6685,28 @@ Contrairement à la commande `/key bind`, cette fonction ne changera jamais une association de touche existante, seulement des nouvelles touches seront créées. Pour supprimer une association de touche, utilisez <<_key_unbind,key_unbind>>. -Prototype : +Prototype : [source,C] ---- int weechat_key_bind (const char *context, struct t_hashtable *keys); ---- -Paramètres : +Paramètres : -* _context_ : contexte pour les touches : -** _default_ : contexte par défaut (actions courantes) -** _search_ : contexte de recherche (lors de la recherche de texte dans le +* _context_ : contexte pour les touches : +** _default_ : contexte par défaut (actions courantes) +** _search_ : contexte de recherche (lors de la recherche de texte dans le tampon) -** _cursor_ : mouvement libre du curseur à l'écran -** _mouse_ : touches pour les évènements de souris -* _keys_ : table de hachage avec les associations de touches +** _cursor_ : mouvement libre du curseur à l'écran +** _mouse_ : touches pour les évènements de souris +* _keys_ : table de hachage avec les associations de touches -Valeur de retour : +Valeur de retour : * nombre d'associations de touches ajoutées -Exemple en C : +Exemple en C : [source,C] ---- @@ -6725,7 +6725,7 @@ if (keys) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6749,24 +6749,24 @@ Supprimer une/des association(s) de touche(s). Lors de l'appel à cette fonction, assurez-vous que vous n'allez pas supprimer une touche définie par l'utilisateur. -Prototype : +Prototype : [source,C] ---- int weechat_key_unbind (const char *context, const char *key); ---- -Paramètres : +Paramètres : -* _context_ : contexte pour les touches (voir <<_key_bind,key_bind>>) -* _key_ : touche à supprimer ou la valeur spéciale "area:XXX" pour supprimer +* _context_ : contexte pour les touches (voir <<_key_bind,key_bind>>) +* _key_ : touche à supprimer ou la valeur spéciale "area:XXX" pour supprimer toutes les touches ayant _XXX_ comme première ou deuxième zone -Valeur de retour : +Valeur de retour : * nombre d'associations de touches supprimées -Exemples en C : +Exemples en C : [source,C] ---- @@ -6777,7 +6777,7 @@ weechat_key_unbind ("mouse", "@chat(plugin.buffer):button1"); weechat_key_unbind ("mouse", "area:chat(plugin.buffer)"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6802,23 +6802,23 @@ Fonctions pour afficher du texte dans les tampons. Retourner un préfixe. -Prototype : +Prototype : [source,C] ---- const char *weechat_prefix (const char *prefix); ---- -Paramètres : +Paramètres : -* _prefix_ : nom du préfixe (voir le tableau ci-dessous) +* _prefix_ : nom du préfixe (voir le tableau ci-dessous) -Valeur de retour : +Valeur de retour : * valeur du préfixe (chaîne avec le préfixe et des codes couleur), chaîne vide si le préfixe n'a pas été trouvé -Liste des préfixes : +Liste des préfixes : [width="70%",cols="^2m,^1,^3,5",options="header"] |=== @@ -6833,14 +6833,14 @@ Liste des préfixes : [NOTE] Les valeurs et couleurs peuvent être configurées avec la commande `/set`. -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (NULL, "%sCeci est une erreur...", weechat_prefix ("error")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6855,78 +6855,78 @@ weechat.prnt("", "%sCeci est une erreur..." % weechat.prefix("error")) Retourner une chaîne avec un code couleur pour affichage. -Prototype : +Prototype : [source,C] ---- const char *weechat_color (const char *color_name); ---- -Paramètres : +Paramètres : -* _color_name_ : nom de la couleur, parmi : +* _color_name_ : nom de la couleur, parmi : ** le nom d'une option de couleur WeeChat (de weechat.color.xxx), par exemple _chat_delimiters_ -** le nom d'une option (format : fichier.section.option), par exemple +** le nom d'une option (format : fichier.section.option), par exemple _irc.color.message_quit_ (_WeeChat ≥ 1.2_) ** une couleur avec des attributs/fond optionnels (voir ci-dessous) -** un attribut : -*** _bold_ : activer le gras -*** _-bold_ : désactiver le gras -*** _reverse_ : activer la vidéo inverse -*** _-reverse_ : désactiver la vidéo inverse -*** _italic_ : activer l'italique -*** _-italic_ : désactiver l'italique -*** _underline_ : activer le souligné -*** _-underline_ : désactiver le souligné -*** _emphasis_ : activer/désactiver la mise en valeur du texte (note : cela ne +** un attribut : +*** _bold_ : activer le gras +*** _-bold_ : désactiver le gras +*** _reverse_ : activer la vidéo inverse +*** _-reverse_ : désactiver la vidéo inverse +*** _italic_ : activer l'italique +*** _-italic_ : désactiver l'italique +*** _underline_ : activer le souligné +*** _-underline_ : désactiver le souligné +*** _emphasis_ : activer/désactiver la mise en valeur du texte (note : cela ne devrait être utilisé que dans les barres, car WeeChat utilise la mise en valeur du texte lors de la recherche de texte dans le tampon) _(WeeChat ≥ 0.4.2)_ -** nom d'une couleur de barre : -*** _bar_fg_ : couleur de texte pour la barre -*** _bar_delim_ : couleur des délimiteurs pour la barre -*** _bar_bg_ : couleur de fond pour la barre -** réinitialisation : -*** _reset_ : réinitialiser la couleur et les attributs -*** _resetcolor_ : réinitialiser la couleur (garder les attributs) +** nom d'une couleur de barre : +*** _bar_fg_ : couleur de texte pour la barre +*** _bar_delim_ : couleur des délimiteurs pour la barre +*** _bar_bg_ : couleur de fond pour la barre +** réinitialisation : +*** _reset_ : réinitialiser la couleur et les attributs +*** _resetcolor_ : réinitialiser la couleur (garder les attributs) _(WeeChat ≥ 0.3.6)_ -Le format de la couleur est : attributs (optionnel) + nom de couleur + ",fond" -(optionnel). Les attributs possibles sont : +Le format de la couleur est : attributs (optionnel) + nom de couleur + ",fond" +(optionnel). Les attributs possibles sont : -* `+*+` : texte gras -* `+!+` : mode vidéo inverse -* `+/+` : italique -* `+_+` : texte souligné -* `+|+` : garder les attributs : ne pas réinitialiser +* `+*+` : texte gras +* `+!+` : mode vidéo inverse +* `+/+` : italique +* `+_+` : texte souligné +* `+|+` : garder les attributs : ne pas réinitialiser gras/inverse/italique/souligné lors du changement de couleur _(WeeChat ≥ 0.3.6)_ -Exemples : +Exemples : -* `+yellow+` : jaune -* `+_green+` : vert souligné -* `+*214+` : orange gras -* `+yellow,red+` : jaune sur rouge -* `+|cyan+` : cyan (et garder tout attribut définit précédemment) +* `+yellow+` : jaune +* `+_green+` : vert souligné +* `+*214+` : orange gras +* `+yellow,red+` : jaune sur rouge +* `+|cyan+` : cyan (et garder tout attribut définit précédemment) -Valeur de retour : +Valeur de retour : * chaîne avec le code couleur, ou une chaîne vide si la couleur n'a pas été trouvée -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "Couleur : %sbleu %scouleur par défaut %sjaune sur rouge", +weechat_printf (NULL, "Couleur : %sbleu %scouleur par défaut %sjaune sur rouge", weechat_color ("blue"), weechat_color ("chat"), weechat_color ("yellow,red")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -6934,7 +6934,7 @@ Script (Python) : value = weechat.color(color_name) # exemple -weechat.prnt("", "Couleur : %sbleu %scouleur par défaut %sjaune sur rouge" +weechat.prnt("", "Couleur : %sbleu %scouleur par défaut %sjaune sur rouge" % (weechat.color("blue"), weechat.color("chat"), weechat.color("yellow,red"))) ---- @@ -6942,7 +6942,7 @@ weechat.prnt("", "Couleur : %sbleu %scouleur par défaut %sjaune sur rouge" Afficher un message sur un tampon. -Prototype : +Prototype : [source,C] ---- @@ -6950,7 +6950,7 @@ void weechat_printf (struct t_gui_buffer *buffer, const char *message, ...); ---- Cette fonction est un raccourci vers la fonction printf_date_tags. Ces deux appels -donnent exactement le même résultat : +donnent exactement le même résultat : [source,C] ---- @@ -6958,17 +6958,17 @@ weechat_printf (buffer, "message"); weechat_printf_date_tags (buffer, 0, NULL, "message"); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon, si NULL, le message est affiché sur le +* _buffer_ : pointeur vers le tampon, si NULL, le message est affiché sur le tampon WeeChat -* _message_ : message à afficher +* _message_ : message à afficher [NOTE] La première tabulation dans le message ("\t") est utilisée pour séparer le préfixe du message. + Si votre message contient des tabulations et si vous ne voulez pas de préfixe, -utilisez un espace, une tabulation, puis le message : cela désactivera le +utilisez un espace, une tabulation, puis le message : cela désactivera le préfixe (l'espace avant la tabulation ne sera pas affiché). [NOTE] @@ -6976,7 +6976,7 @@ Avec deux tabulations ("\t") au début du message, l'heure ne sera pas affichée et le message n'aura pas d'alignement. De plus, la date dans le message sera positionnée à 0. -Exemple en C : +Exemple en C : [source,C] ---- @@ -6988,7 +6988,7 @@ weechat_printf (buffer, "\t\tMessage sans heure/alignement"); weechat_printf (buffer, "\t\t"); /* ligne vide (sans heure) */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7012,7 +7012,7 @@ La fonction s'appelle "print" dans les scripts ("prnt" en Python). Afficher un message sur un tampon, en utilisant une date et des étiquettes personnalisées. -Prototype : +Prototype : [source,C] ---- @@ -7020,19 +7020,19 @@ void weechat_printf_date_tags (struct t_gui_buffer *buffer, time_t date, const char *tags, const char *message, ...); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon, si NULL, le message est affiché sur le +* _buffer_ : pointeur vers le tampon, si NULL, le message est affiché sur le tampon Weechat -* _date_ : date pour le message (0 signifie la date/heure courante) -* _tags_ : liste d'étiquettes séparées par des virgules (NULL signifie aucune +* _date_ : date pour le message (0 signifie la date/heure courante) +* _tags_ : liste d'étiquettes séparées par des virgules (NULL signifie aucune étiquette) -* _message_ : message à afficher +* _message_ : message à afficher Voir le chapitre sur les étiquettes des lignes dans le _Guide utilisateur WeeChat_ pour une liste des étiquettes couramment utilisées dans WeeChat. -Exemple en C : +Exemple en C : [source,C] ---- @@ -7040,7 +7040,7 @@ weechat_printf_date_tags (NULL, time (NULL) - 120, "notify_message", "Message il y a 2 minutes avec une étiquette 'notify_message'"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7061,7 +7061,7 @@ Python). Afficher un message sur une ligne d'un tampon avec contenu libre. -Prototype : +Prototype : [source,C] ---- @@ -7069,24 +7069,24 @@ void weechat_printf_y (struct t_gui_buffer *buffer, int y, const char *message, ...); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _y_ : numéro de ligne (la première ligne est 0); une valeur négative affiche - une ligne après la dernière ligne affichée : la valeur absolue de _y_ est le +* _buffer_ : pointeur vers le tampon +* _y_ : numéro de ligne (la première ligne est 0); une valeur négative affiche + une ligne après la dernière ligne affichée : la valeur absolue de _y_ est le nombre de lignes après la dernière ligne (par exemple -1 est immédiatement après la dernière ligne, -2 est 2 lignes après la dernière ligne) _(WeeChat ≥ 1.0)_ -* _message_ : message à afficher +* _message_ : message à afficher -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf_y (buffer, 2, "Mon message sur la 3ème ligne"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7104,25 +7104,25 @@ La fonction s'appelle "print_y" dans les scripts ("prnt_y" en Python). Écrire un message dans le fichier de log WeeChat (weechat.log). -Prototype : +Prototype : [source,C] ---- void weechat_log_printf (const char *message, ...); ---- -Paramètres : +Paramètres : -* _message_ : message à écrire +* _message_ : message à écrire -Exemple en C : +Exemple en C : [source,C] ---- weechat_log_printf ("Mon message dans le fichier log"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7151,13 +7151,13 @@ trouvé et exécuté avant les autres "hooks". Cela est pratique pour les modificateurs, car l'ordre d'exécution est important. Pour définir une priorité, vous devez utiliser cette syntaxe, pour un paramètre -où la priorité est autorisée : "nnn|nom" où "nnn" est un entier positif ou nul +où la priorité est autorisée : "nnn|nom" où "nnn" est un entier positif ou nul avec la priorité et "nom" le nom pour le paramètre (la priorité n'apparaît pas dans le nom, elle est automatiquement retirée de la chaîne). La priorité par défaut est 1000. -Exemple en C : +Exemple en C : [source,C] ---- @@ -7165,7 +7165,7 @@ Exemple en C : weechat_hook_modifier ("2000|input_text_display", &modifier_cb, NULL, NULL); ---- -Les types de "hooks" suivants autorisent une priorité : command, command_run, +Les types de "hooks" suivants autorisent une priorité : command, command_run, signal, hsignal, config, completion, modifier, info, info_hashtable, infolist, hdata, focus. @@ -7175,7 +7175,7 @@ _Mis à jour dans la 1.5, 1.7._ Accrocher une commande. -Prototype : +Prototype : [source,C] ---- @@ -7194,30 +7194,30 @@ struct t_hook *weechat_hook_command (const char *command, void *callback_data); ---- -Paramètres : +Paramètres : -* _command_ : nom de la commande +* _command_ : nom de la commande (priorité autorisée, voir la note sur la <>) -* _description_ : description de la commande (affiché avec `/help command`) -* _args_ : paramètres pour la commande (affichés avec `/help command`) -* _args_description_ : description des paramètres (affichée avec +* _description_ : description de la commande (affiché avec `/help command`) +* _args_ : paramètres pour la commande (affichés avec `/help command`) +* _args_description_ : description des paramètres (affichée avec `/help command`) -* _completion_ : modèle pour la complétion de la commande (voir le format ci-dessous) -* _callback_ : fonction appelée lorsque la commande est utilisée, paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_gui_buffer *buffer_ : tampon où la commande est exécutée -** _int argc_ : nombre de paramètres passés à la commande -** _char **argv_ : paramètres pour la commande -** _char **argv_eol_ : paramètres pour la commande (jusqu'à fin de ligne pour +* _completion_ : modèle pour la complétion de la commande (voir le format ci-dessous) +* _callback_ : fonction appelée lorsque la commande est utilisée, paramètres et + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_gui_buffer *buffer_ : tampon où la commande est exécutée +** _int argc_ : nombre de paramètres passés à la commande +** _char **argv_ : paramètres pour la commande +** _char **argv_eol_ : paramètres pour la commande (jusqu'à fin de ligne pour chaque paramètre) -** valeur de retour : +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé @@ -7227,37 +7227,37 @@ séparés par des espaces. Plusieurs complétions sont possibles pour un paramè séparées par `+|+`. Plusieurs modèles de complétions sont possibles pour une même commande, séparés par `+||+`. -Le format de la complétion peut être : +Le format de la complétion peut être : -* _%(nom)_ : la complétion _nom_ -* _%(nom:paramètres)_ : la complétion _nom_ avec des _paramètres_ envoyés au +* _%(nom)_ : la complétion _nom_ +* _%(nom:paramètres)_ : la complétion _nom_ avec des _paramètres_ envoyés au « callback » _(WeeChat ≥ 1.7)_ -* toute chaîne : elle est utilisée telle quelle dans la complétion +* toute chaîne : elle est utilisée telle quelle dans la complétion Par exemple le modèle `list || add %(filters_names) || del %(filters_names)|-all` -complètera avec les valeurs suivantes dans les paramètres de commande : +complètera avec les valeurs suivantes dans les paramètres de commande : -* premier paramètre : `list`, `add` et `del` -* second paramètre, cela dépend du premier paramètre : -** `list` : rien -** `add` : noms des filtres -** `del` : noms des filtres et `-all` +* premier paramètre : `list`, `add` et `del` +* second paramètre, cela dépend du premier paramètre : +** `list` : rien +** `add` : noms des filtres +** `del` : noms des filtres et `-all` -Les codes complétions par défaut sont : +Les codes complétions par défaut sont : include::autogen/plugin_api/completions.adoc[] -Codes spéciaux : +Codes spéciaux : -* `+%%command+` : réutiliser le modèle de complétion de la commande _command_ -* `+%-+` : arrêter la complétion -* `+%*+` : répéter la dernière complétion +* `+%%command+` : réutiliser le modèle de complétion de la commande _command_ +* `+%-+` : arrêter la complétion +* `+%*+` : répéter la dernière complétion -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -7287,14 +7287,14 @@ struct t_hook *my_command_hook = ---- Par exemple, si la commande appelée est `/command abc def ghi`, alors _argv_ et -_argv_eol_ ont les valeurs suivantes : +_argv_eol_ ont les valeurs suivantes : -* _argv_ : +* _argv_ : ** _argv[0]_ == "/command" ** _argv[1]_ == "abc" ** _argv[2]_ == "def" ** _argv[3]_ == "ghi" -* _argv_eol_ : +* _argv_eol_ : ** _argv_eol[0]_ == "/command abc def ghi" ** _argv_eol[1]_ == "abc def ghi" ** _argv_eol[2]_ == "def ghi" @@ -7302,7 +7302,7 @@ _argv_eol_ ont les valeurs suivantes : Pour les scripts, _args_ a la valeur "abc def ghi". -Script (Python) : +Script (Python) : [source,python] ---- @@ -7333,7 +7333,7 @@ _Mis à jour dans la 1.5, 1.7._ Accrocher une complétion. -Prototype : +Prototype : [source,C] ---- @@ -7348,30 +7348,30 @@ struct t_hook *weechat_hook_completion (const char *completion_item, void *callback_data); ---- -Paramètres : +Paramètres : -* _completion_item_ : nom de l'objet de complétion, après vous pouvez utiliser +* _completion_item_ : nom de l'objet de complétion, après vous pouvez utiliser _%(nom)_ (ou _%(nom:paramètres)_ avec WeeChat ≥ 1.7) dans une commande (paramètre _completion_) (priorité autorisée, voir la note sur la <>) -* _description_ : description de la complétion -* _callback_ : fonction appelée lorsque la complétion est utilisée +* _description_ : description de la complétion +* _callback_ : fonction appelée lorsque la complétion est utilisée (l'utilisateur est en train de compléter quelque chose qui fait appel à cette - complétion), paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *completion_item_ : nom de la complétion (avec WeeChat ≥ 1.7 il - peut inclure des paramètres, avec le format : _nom:paramètres_) -** _struct t_gui_buffer *buffer_ : tampon où la complétion est effectuée -** _struct t_gui_completion *completion_ : structure utilisée pour ajouter + complétion), paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *completion_item_ : nom de la complétion (avec WeeChat ≥ 1.7 il + peut inclure des paramètres, avec le format : _nom:paramètres_) +** _struct t_gui_buffer *buffer_ : tampon où la complétion est effectuée +** _struct t_gui_completion *completion_ : structure utilisée pour ajouter les mots pour la complétion (voir <<_hook_completion_list_add,hook_completion_list_add>>) -** valeur de retour : +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé @@ -7387,15 +7387,15 @@ Le "callback" doit seulement appeler la fonction et ne doit *PAS* mettre à jour la ligne de commande. + Pour mettre à jour la ligne de commande quand kbd:[Tab] est pressé, vous pouvez utiliser la fonction <<_hook_command_run,hook_command_run>> -avec la commande : `/input complete_next` (et vous devez retourner +avec la commande : `/input complete_next` (et vous devez retourner _WEECHAT_RC_OK_EAT_ si votre "callback" a mis à jour la ligne de commande, de sorte que WeeChat n'exécute pas la complétion). -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -7416,7 +7416,7 @@ struct t_hook *my_completion_hook = weechat_hook_completion ("extension_item", &my_completion_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7439,7 +7439,7 @@ _WeeChat ≥ 0.3.4._ Retourner la valeur d'une propriété de la complétion sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- @@ -7447,15 +7447,15 @@ const char *weechat_hook_completion_get_string (struct t_gui_completion *complet const char *property); ---- -Paramètres : +Paramètres : -* _completion_ : pointeur vers la complétion -* _property_ : nom de la propriété : -** _base_command_ : commande utilisée pour la complétion -** _base_word_ : le mot qui va être complété -** _args_ : paramètres de la commande (incluant le mot de base "base_word") +* _completion_ : pointeur vers la complétion +* _property_ : nom de la propriété : +** _base_command_ : commande utilisée pour la complétion +** _base_word_ : le mot qui va être complété +** _args_ : paramètres de la commande (incluant le mot de base "base_word") -Exemple en C : +Exemple en C : [source,C] ---- @@ -7474,7 +7474,7 @@ my_completion_cb (const void *pointer, void *data, const char *completion_item, } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7494,7 +7494,7 @@ def my_completion_cb(data, completion_item, buffer, completion): Ajouter un mot pour une complétion. -Prototype : +Prototype : [source,C] ---- @@ -7504,26 +7504,26 @@ void weechat_hook_completion_list_add (struct t_gui_completion *completion, const char *where); ---- -Paramètres : +Paramètres : -* _completion_ : pointeur vers la complétion -* _word_ : mot à ajouter -* _nick_completion_ : 1 si le mot est un pseudo, sinon 0 -* _where_ : position où sera inséré le mot dans la liste : -** _WEECHAT_LIST_POS_SORT_ : n'importe où, pour maintenir la liste triée -** _WEECHAT_LIST_POS_BEGINNING_ : au début de la liste -** _WEECHAT_LIST_POS_END_ : à la fin de la liste +* _completion_ : pointeur vers la complétion +* _word_ : mot à ajouter +* _nick_completion_ : 1 si le mot est un pseudo, sinon 0 +* _where_ : position où sera inséré le mot dans la liste : +** _WEECHAT_LIST_POS_SORT_ : n'importe où, pour maintenir la liste triée +** _WEECHAT_LIST_POS_BEGINNING_ : au début de la liste +** _WEECHAT_LIST_POS_END_ : à la fin de la liste -Exemple en C : voir <<_hook_completion,hook_completion>>. +Exemple en C : voir <<_hook_completion,hook_completion>>. -Script (Python) : +Script (Python) : [source,python] ---- # prototype weechat.hook_completion_list_add(completion, word, nick_completion, where) -# exemple : voir la fonction hook_completion ci-dessus +# exemple : voir la fonction hook_completion ci-dessus ---- ==== hook_command_run @@ -7532,7 +7532,7 @@ _Mis à jour dans la 1.5._ Intercepter une commande lorsqu'elle est exécutée par WeeChat. -Prototype : +Prototype : [source,C] ---- @@ -7545,23 +7545,23 @@ struct t_hook *weechat_hook_command_run (const char *command, void *callback_data); ---- -Paramètres : +Paramètres : -* _command_ : commande à intercepter (le caractère joker `+*+` est autorisé) +* _command_ : commande à intercepter (le caractère joker `+*+` est autorisé) (priorité autorisée, voir la note sur la <>) -* _callback_ : fonction appelée lorsque la commande est exécutée, paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_gui_buffer *buffer_ : tampon où la commande est exécutée -** _const char *command_ : la commande exécutée, avec ses paramètres -** valeur de retour : +* _callback_ : fonction appelée lorsque la commande est exécutée, paramètres et + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_gui_buffer *buffer_ : tampon où la commande est exécutée +** _const char *command_ : la commande exécutée, avec ses paramètres +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_OK_EAT_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé @@ -7570,11 +7570,11 @@ Paramètres : Le "callback" peut retourner _WEECHAT_RC_OK_ ou _WEECHAT_RC_OK_EAT_ (la commande ne sera pas exécutée par WeeChat après le "callback"). -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -7591,7 +7591,7 @@ struct t_hook *my_command_run_hook = &my_command_run_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7612,7 +7612,7 @@ _Mis à jour dans la 1.5._ Accrocher un minuteur (fonction appelée à intervalles réguliers). -Prototype : +Prototype : [source,C] ---- @@ -7626,36 +7626,36 @@ struct t_hook *weechat_hook_timer (long interval, void *callback_data); ---- -Paramètres : +Paramètres : -* _interval_ : intervalle entre deux appels (en millisecondes, donc 1000 = 1 +* _interval_ : intervalle entre deux appels (en millisecondes, donc 1000 = 1 seconde) -* _align_second_ : alignement sur la seconde. Par exemple, si la date courante +* _align_second_ : alignement sur la seconde. Par exemple, si la date courante est 09:00, si l'intervalle est 60000 (60 secondes), et que align_second = 60, alors le minuteur sera appelé chaque minute quand la seconde sera 0 -* _max_calls_ : nombre maximum d'appels au minuteur (si 0, le minuteur n'a pas +* _max_calls_ : nombre maximum d'appels au minuteur (si 0, le minuteur n'a pas de fin) -* _callback_ : fonction appelée quand le délai est atteint, paramètres et valeur - de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _int remaining_calls_ : nombre d'appels restants (-1 si le minuteur n'a pas +* _callback_ : fonction appelée quand le délai est atteint, paramètres et valeur + de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _int remaining_calls_ : nombre d'appels restants (-1 si le minuteur n'a pas de fin) -** valeur de retour : +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -7671,7 +7671,7 @@ struct t_hook *my_timer_hook = weechat_hook_timer (20 * 1000, 0, 0, &my_timer_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7693,7 +7693,7 @@ _Mis à jour dans la 1.3, 1.5._ Accrocher un descripteur de fichier (fichier ou socket). -Prototype : +Prototype : [source,C] ---- @@ -7708,33 +7708,33 @@ struct t_hook *weechat_hook_fd (int fd, void *callback_data); ---- -Paramètres : +Paramètres : -* _fd_ : descripteur de fichier -* _flag_read_ : 1 = intercepter un évènement de lecture, 0 = ignorer -* _flag_write_ : 1 = intercepter un évènement d'écriture, 0 = ignorer -* _flag_exception_ : 1 = intercepter un évènement d'exception, 0 = ignorer - (_WeeChat ≥ 1.3_ : ce paramètre est ignoré et n'est plus utilisé) -* _callback_ : fonction appelée lorsqu'un des évènements sélectionnés se - produit pour le fichier (ou le socket), paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _int fd_ : descripteur de fichier -** valeur de retour : +* _fd_ : descripteur de fichier +* _flag_read_ : 1 = intercepter un évènement de lecture, 0 = ignorer +* _flag_write_ : 1 = intercepter un évènement d'écriture, 0 = ignorer +* _flag_exception_ : 1 = intercepter un évènement d'exception, 0 = ignorer + (_WeeChat ≥ 1.3_ : ce paramètre est ignoré et n'est plus utilisé) +* _callback_ : fonction appelée lorsqu'un des évènements sélectionnés se + produit pour le fichier (ou le socket), paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _int fd_ : descripteur de fichier +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -7751,7 +7751,7 @@ int sock = socket (AF_INET, SOCK_STREAM, 0); struct t_hook *my_fd_hook = weechat_hook_fd (sock, 1, 0, 0, &my_fd_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7782,7 +7782,7 @@ commande), ou si vous souhaitez utiliser le shell, vous pouvez utiliser la fonction <<_hook_process_hashtable,hook_process_hashtable>> avec les paramètres dans la table de hachage _options_ _(WeeChat ≥ 0.4.0)_. -Prototype : +Prototype : [source,C] ---- @@ -7799,46 +7799,46 @@ struct t_hook *weechat_hook_process (const char *command, ---- -Paramètres : +Paramètres : -* _command_ : commande à lancer dans le processus fils, URL _(WeeChat ≥ 0.3.7)_ +* _command_ : commande à lancer dans le processus fils, URL _(WeeChat ≥ 0.3.7)_ ou fonction _(WeeChat ≥ 1.5)_ (voir ci-dessous) -* _timeout_ : timeout pour la commande (en millisecondes) : après ce délai, le +* _timeout_ : timeout pour la commande (en millisecondes) : après ce délai, le processus fils est tué (0 signifie pas de limite) -* _callback_ : fonction appelée quand des données du fils sont disponibles, or - ou quand le fils s'est terminé, paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *command_ : commande exécutée par le fils -** _int return_code_ : code retour : -*** _>= 0_ : code retour du fils pour une commande, et pour l'URL, les valeurs - possibles sont : -**** _0_ : transfert ok -**** _1_ : URL invalide -**** _2_ : erreur de transfert -**** _3_ : pas assez de mémoire -**** _4_ : erreur avec un fichier -*** _< 0_ : -**** _WEECHAT_HOOK_PROCESS_RUNNING_ : données disponibles, mais le fils tourne +* _callback_ : fonction appelée quand des données du fils sont disponibles, or + ou quand le fils s'est terminé, paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *command_ : commande exécutée par le fils +** _int return_code_ : code retour : +*** _>= 0_ : code retour du fils pour une commande, et pour l'URL, les valeurs + possibles sont : +**** _0_ : transfert ok +**** _1_ : URL invalide +**** _2_ : erreur de transfert +**** _3_ : pas assez de mémoire +**** _4_ : erreur avec un fichier +*** _< 0_ : +**** _WEECHAT_HOOK_PROCESS_RUNNING_ : données disponibles, mais le fils tourne toujours -**** _WEECHAT_HOOK_PROCESS_ERROR_ : erreur en lançant la commande +**** _WEECHAT_HOOK_PROCESS_ERROR_ : erreur en lançant la commande **** _WEECHAT_HOOK_PROCESS_CHILD_: le "callback" est appelé dans le processus fils -** _out_ : sortie standard de la commande (stdout) -** _err_ : erreurs de la commande (stderr) -** valeur de retour : +** _out_ : sortie standard de la commande (stdout) +** _err_ : erreurs de la commande (stderr) +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ *** code retour du processus fils (dans le cas d'une fonction avec "func:" dans la commande) -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur @@ -7846,12 +7846,12 @@ Lorsque la commande est terminée, ou si le timeout est atteint, WeeChat supprimera automatiquement le "hook" (et tuera le processus s'il tourne toujours). -La commande peut être une URL avec le format : "url:http://www.example.com", +La commande peut être une URL avec le format : "url:http://www.example.com", pour télécharger le contenu de l'URL _(WeeChat ≥ 0.3.7)_. Des options pour l'URL sont possibles avec la fonction <<_hook_process_hashtable,hook_process_hashtable>>. -La commande peut aussi être le nom d'une fonction avec le format : "func:nom", +La commande peut aussi être le nom d'une fonction avec le format : "func:nom", pour exécuter la fonction "nom" _(WeeChat ≥ 1.5)_. Cette fonction reçoit un paramètre (_data_) et doit retourner une chaîne de caractères, qui sera envoyée au "callback". + @@ -7869,17 +7869,17 @@ sur la page https://weechat.org/dev/info [NOTE] La taille du tampon pour l'envoi des données au "callback" est de 64 Ko (il y a -2 tampons : un pour stdout et un pour stderr). +2 tampons : un pour stdout et un pour stderr). Si la sortie du processus fils (stdout ou stderr) est plus longue que 64 Ko, le "callback" sera appelé plusieurs fois. [IMPORTANT] Même si la plupart du temps le "callback" n'est appelé qu'une seule fois, vous -devez vous assurer que plusieurs appels au "callback" sont ok dans votre code : +devez vous assurer que plusieurs appels au "callback" sont ok dans votre code : vous devez concaténer les données issues de plusieurs appels et n'utiliser les données que lorsque le code retour est positif ou nul. -Exemple en C : +Exemple en C : [source,C] ---- @@ -7901,12 +7901,12 @@ my_process_cb (const void *pointer, void *data, const char *command, if (out) { - weechat_printf (NULL, "stdout : %s", out); + weechat_printf (NULL, "stdout : %s", out); } if (err) { - weechat_printf (NULL, "stderr : %s", err); + weechat_printf (NULL, "stderr : %s", err); } return WEECHAT_RC_OK; @@ -7946,12 +7946,12 @@ my_process_cb (const void *pointer, void *data, const char *command, if (out) { - weechat_printf (NULL, "stdout : %s", out); + weechat_printf (NULL, "stdout : %s", out); } if (err) { - weechat_printf (NULL, "stderr : %s", err); + weechat_printf (NULL, "stderr : %s", err); } return WEECHAT_RC_OK; @@ -7962,7 +7962,7 @@ struct t_hook *my_process_hook = weechat_hook_process ("func:get_status", 5000, &my_process_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -7977,9 +7977,9 @@ def my_process_cb(data, command, return_code, out, err): if return_code >= 0: weechat.prnt("", "return_code = %d" % return_code) if out != "": - weechat.prnt("", "stdout : %s" % out) + weechat.prnt("", "stdout : %s" % out) if err != "": - weechat.prnt("", "stderr : %s" % err) + weechat.prnt("", "stderr : %s" % err) return weechat.WEECHAT_RC_OK hook = weechat.hook_process("ls", 5000, "my_process_cb", "") @@ -7997,9 +7997,9 @@ def my_process_cb(data, command, return_code, out, err): if return_code >= 0: weechat.prnt("", "return_code = %d" % return_code) if out != "": - weechat.prnt("", "stdout : %s" % out) + weechat.prnt("", "stdout : %s" % out) if err != "": - weechat.prnt("", "stderr : %s" % err) + weechat.prnt("", "stderr : %s" % err) return weechat.WEECHAT_RC_OK hook = weechat.hook_process("func:get_status", 5000, "my_process_cb", "") @@ -8012,7 +8012,7 @@ _WeeChat ≥ 0.3.7, mis à jour dans la 1.5._ Accrocher un processus (lancé par un fork) en utilisant des options dans une table de hachage, et intercepter sa sortie. -Prototype : +Prototype : [source,C] ---- @@ -8030,14 +8030,14 @@ struct t_hook *weechat_hook_process_hashtable (const char *command, ---- Les paramètres sont les mêmes que ceux de la fonction -<<_hook_process,hook_process>>, avec un paramètre supplémentaire : +<<_hook_process,hook_process>>, avec un paramètre supplémentaire : -* _options_ : options pour la commande exécutée; la table de hachage est +* _options_ : options pour la commande exécutée; la table de hachage est dupliquée dans la fonction, donc il est possible de la supprimer après cet appel Pour une commande standard (ne commençant pas par "url:"), les options suivantes -sont disponibles : +sont disponibles : [width="100%",cols="^1,1,3",options="header"] |=== @@ -8046,7 +8046,7 @@ sont disponibles : | argN (N ≥ 1) + _(WeeChat ≥ 0.4.0)_ | toute chaîne | - Paramètres pour la commande ; si aucun paramètre n'est donné avec ces options, + Paramètres pour la commande ; si aucun paramètre n'est donné avec ces options, la commande sera automatiquement découpée comme le fait le shell (et donc les paramètres de la commande sont lus dans le paramètre _command_). @@ -8066,32 +8066,32 @@ sont disponibles : | detached + _(WeeChat ≥ 1.0)_ | (non utilisée) | - Lancer le process dans un mode détaché : stdout et stderr sont redirigés vers + Lancer le process dans un mode détaché : stdout et stderr sont redirigés vers _/dev/null_. |=== Pour la commande "url:...", les options suivantes sont disponibles (voir -`man curl_easy_setopt` pour une description de chaque option) : +`man curl_easy_setopt` pour une description de chaque option) : include::autogen/plugin_api/url_options.adoc[] [NOTE] ^(1)^ Lorsque des constantes sont disponibles, elles doivent être utilisées comme valeur pour l'option. Pour les options avec le type "mask", le format -est : "valeur1+valeur2+valeur3". +est : "valeur1+valeur2+valeur3". Pour l'URL, deux options supplémentaires (chaînes) sont autorisées, pour le -fichier en entrée/sortie : +fichier en entrée/sortie : -* _file_in_ : fichier à lire pour envoyer avec l'URL (envoi de fichier "post") -* _file_out_ : écrire l'URL/fichier dans ce fichier (au lieu de la sortie +* _file_in_ : fichier à lire pour envoyer avec l'URL (envoi de fichier "post") +* _file_out_ : écrire l'URL/fichier dans ce fichier (au lieu de la sortie standard) -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -8112,18 +8112,18 @@ my_process_cb (const void *pointer, void *data, const char *command, if (out) { - weechat_printf (NULL, "stdout : %s", out); + weechat_printf (NULL, "stdout : %s", out); } if (err) { - weechat_printf (NULL, "stderr : %s", err); + weechat_printf (NULL, "stderr : %s", err); } return WEECHAT_RC_OK; } -/* exemple 1 : téléchargement d'une URL */ +/* exemple 1 : téléchargement d'une URL */ struct t_hashtable *options = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, WEECHAT_HASHTABLE_STRING, @@ -8139,7 +8139,7 @@ if (options) weechat_hashtable_free (options); } -/* exemple 2 : exécution d'un programme de notification avec le message de quelqu'un */ +/* exemple 2 : exécution d'un programme de notification avec le message de quelqu'un */ struct t_hashtable *options_cmd1 = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, WEECHAT_HASHTABLE_STRING, @@ -8158,7 +8158,7 @@ if (options_cmd1) weechat_hashtable_free (options_cmd1); } -/* exemple 3 : appeler le shell pour exécuter la commande (la commande doit être SURE) */ +/* exemple 3 : appeler le shell pour exécuter la commande (la commande doit être SURE) */ struct t_hashtable *options_cmd2 = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, WEECHAT_HASHTABLE_STRING, @@ -8176,7 +8176,7 @@ if (options_cmd2) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -8191,17 +8191,17 @@ def my_process_cb(data, command, return_code, out, err): if return_code >= 0: weechat.prnt("", "return_code = %d" % return_code) if out != "": - weechat.prnt("", "stdout : %s" % out) + weechat.prnt("", "stdout : %s" % out) if err != "": - weechat.prnt("", "stderr : %s" % err) + weechat.prnt("", "stderr : %s" % err) return weechat.WEECHAT_RC_OK -# exemple 1 : téléchargement d'une URL +# exemple 1 : téléchargement d'une URL hook1 = weechat.hook_process_hashtable("url:https://weechat.org/", {"file_out": "/tmp/weechat.org.html"}, 20000, "my_process_cb", "") -# exemple 2 : exécution d'un programme de notification avec le message de quelqu'un +# exemple 2 : exécution d'un programme de notification avec le message de quelqu'un hook2 = weechat.hook_process_hashtable("my-notify-command", {"arg1": "-from", "arg2": nick, @@ -8209,7 +8209,7 @@ hook2 = weechat.hook_process_hashtable("my-notify-command", "arg4": message}, # paramètre non sûr 20000, "my_process_cb", "") -# exemple 3 : appeler le shell pour exécuter la commande (la commande doit être SURE) +# exemple 3 : appeler le shell pour exécuter la commande (la commande doit être SURE) hook3 = weechat.hook_process_hashtable("sh", {"arg1": "-c", "arg2": "ls -l /tmp | grep something"}, @@ -8222,7 +8222,7 @@ _Mis à jour dans la 1.5._ Accrocher une connexion (connexion à une machine distante en tâche de fond). -Prototype : +Prototype : [source,C] ---- @@ -8247,67 +8247,67 @@ struct t_hook *weechat_hook_connect (const char *proxy, void *callback_data); ---- -Paramètres : +Paramètres : -* _proxy_ : nom du proxy à utiliser pour la connexion (optionnel, NULL signifie +* _proxy_ : nom du proxy à utiliser pour la connexion (optionnel, NULL signifie une connexion sans proxy) -* _address_ : nom ou adresse IP de la machine à laquelle se connecter -* _port_ : numéro de port -* _ipv6_ : 1 pour utiliser IPv6 (avec repli sur IPv4), 0 pour utiliser seulement +* _address_ : nom ou adresse IP de la machine à laquelle se connecter +* _port_ : numéro de port +* _ipv6_ : 1 pour utiliser IPv6 (avec repli sur IPv4), 0 pour utiliser seulement IPv4 -* _retry_ : numéro de nouvelle tentative, utilisé pour se rabattre sur les +* _retry_ : numéro de nouvelle tentative, utilisé pour se rabattre sur les adresses IPv4 si la connexion IPv6 échoue -* _gnutls_sess_ : session GnuTLS (optionnel) -* _gnutls_cb_ : callback pour GnuTLS (optionnel) -* _gnutls_dhkey_size_ : taille de clé utilisée pour l'échange de clé +* _gnutls_sess_ : session GnuTLS (optionnel) +* _gnutls_cb_ : callback pour GnuTLS (optionnel) +* _gnutls_dhkey_size_ : taille de clé utilisée pour l'échange de clé Diffie-Hellman (GnuTLS) -* _gnutls_priorities_ : priorités pour gnutls (pour la syntaxe, voir la +* _gnutls_priorities_ : priorités pour gnutls (pour la syntaxe, voir la documentation de la fonction _gnutls_priority_init_ dans le manuel gnutls), - les valeurs de base sont : + les valeurs de base sont : ** _PERFORMANCE_ ** _NORMAL_ (défaut) ** _SECURE128_ ** _SECURE256_ ** _EXPORT_ ** _NONE_ -* _local_hostname_ : nom de machine local à utiliser pour la connexion +* _local_hostname_ : nom de machine local à utiliser pour la connexion (optionnel) -* _callback_ : fonction appelée lorsque la connexion est ok ou a échoué, - paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _int status_ : statut de connexion : -*** _WEECHAT_HOOK_CONNECT_OK_ : connexion ok -*** _WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND_ : adresse non trouvée -*** _WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND_ : adresse IP non trouvée -*** _WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED_ : connexion refusée -*** _WEECHAT_HOOK_CONNECT_PROXY_ERROR_ : erreur avec le proxy -*** _WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR_ : erreur avec le nom local -*** _WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR_ : erreur d'initialisation GnuTLS -*** _WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR_ : erreur avec la +* _callback_ : fonction appelée lorsque la connexion est ok ou a échoué, + paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _int status_ : statut de connexion : +*** _WEECHAT_HOOK_CONNECT_OK_ : connexion ok +*** _WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND_ : adresse non trouvée +*** _WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND_ : adresse IP non trouvée +*** _WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED_ : connexion refusée +*** _WEECHAT_HOOK_CONNECT_PROXY_ERROR_ : erreur avec le proxy +*** _WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR_ : erreur avec le nom local +*** _WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR_ : erreur d'initialisation GnuTLS +*** _WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR_ : erreur avec la "poignée de main" GnuTLS -*** _WEECHAT_HOOK_CONNECT_MEMORY_ERROR_ : mémoire insuffisante -*** _WEECHAT_HOOK_CONNECT_TIMEOUT_ : temps maximum dépassé -*** _WEECHAT_HOOK_CONNECT_SOCKET_ERROR_ : erreur de création socket -** _gnutls_rc_ : valeur retour de _gnutls_handshake()_ -** _sock_ : socket utilisé pour la connexion -** _const char *error_ : valeur retour de _gnutls_strerror(gnutls_rc)_ -** _const char *ip_address_ : adresse IP trouvée -** valeur de retour : +*** _WEECHAT_HOOK_CONNECT_MEMORY_ERROR_ : mémoire insuffisante +*** _WEECHAT_HOOK_CONNECT_TIMEOUT_ : temps maximum dépassé +*** _WEECHAT_HOOK_CONNECT_SOCKET_ERROR_ : erreur de création socket +** _gnutls_rc_ : valeur retour de _gnutls_handshake()_ +** _sock_ : socket utilisé pour la connexion +** _const char *error_ : valeur retour de _gnutls_strerror(gnutls_rc)_ +** _const char *ip_address_ : adresse IP trouvée +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -8362,7 +8362,7 @@ struct t_hook *my_connect_hook = weechat_hook_connect (NULL, &my_connect_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -8406,7 +8406,7 @@ _Mis à jour dans la 0.4.3, 1.0, 1.5._ Intercepter un message affiché. -Prototype : +Prototype : [source,C] ---- @@ -8428,44 +8428,44 @@ struct t_hook *weechat_hook_print (struct t_gui_buffer *buffer, void *callback_data); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon, si NULL, les messages de tous les tampons +* _buffer_ : pointeur vers le tampon, si NULL, les messages de tous les tampons sont interceptés -* _tags_ : intercepter seulement les messages avec ces étiquettes (optionnel) : -** avec WeeChat ≥ 0.4.3 : liste d'étiquettes (séparées par des virgules) qui +* _tags_ : intercepter seulement les messages avec ces étiquettes (optionnel) : +** avec WeeChat ≥ 0.4.3 : liste d'étiquettes (séparées par des virgules) qui doivent être dans le message ("ou" logique); il est possible de combiner plusieurs étiquettes sous forme d'un "et" logique avec le séparateur `+++`; le caractère joker `+*+` est autorisé dans les étiquettes -** avec WeeChat ≤ 0.4.2 : liste d'étiquettes (séparées par des virgules) qui +** avec WeeChat ≤ 0.4.2 : liste d'étiquettes (séparées par des virgules) qui doivent toutes être dans le message ("et" logique) -* _message_ : seulement les messages contenant cette chaîne seront interceptés +* _message_ : seulement les messages contenant cette chaîne seront interceptés (optionnel, insensible à la casse) -* _strip_colors_ : si 1, les couleurs seront supprimées du message affiché, +* _strip_colors_ : si 1, les couleurs seront supprimées du message affiché, avant d'appeler le "callback" -* _callback_ : fonction appelée lorsqu'un message est affiché, paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_gui_buffer *buffer_ : pointeur vers le tampon -** _time_t date_ : date -** _int tags_count_ : nombre d'étiquettes de la ligne -** _const char **tags_ : tableau avec les étiquettes de la ligne -** _int displayed_ : 1 si la ligne est affichée, 0 si elle est filtrée (cachée) -** _int highlight_ : 1 si la ligne contient un highlight, sinon 0 -** _const char *prefix_ : préfixe -** _const char *message_ : message -** valeur de retour : +* _callback_ : fonction appelée lorsqu'un message est affiché, paramètres et + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_gui_buffer *buffer_ : pointeur vers le tampon +** _time_t date_ : date +** _int tags_count_ : nombre d'étiquettes de la ligne +** _const char **tags_ : tableau avec les étiquettes de la ligne +** _int displayed_ : 1 si la ligne est affichée, 0 si elle est filtrée (cachée) +** _int highlight_ : 1 si la ligne contient un highlight, sinon 0 +** _const char *prefix_ : préfixe +** _const char *message_ : message +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur @@ -8473,10 +8473,10 @@ Valeur de retour : Dans les scripts, avec WeeChat ≥ 1.0, les paramètres du callback _displayed_ et _highlight_ sont des entiers (avec WeeChat ≤ 0.4.3, ils étaient des chaînes). + Pour être compatible avec toutes les versions, il est recommandé de convertir -le paramètre en entier avant de le tester, par exemple en Python : +le paramètre en entier avant de le tester, par exemple en Python : `if int(highlight):`. -Exemple en C : +Exemple en C : [source,C] ---- @@ -8495,7 +8495,7 @@ struct t_hook *my_print_hook = weechat_hook_print (NULL, NULL, NULL, 1, &my_print_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -8518,7 +8518,7 @@ _Mis à jour dans la 1.5._ S'accrocher à un signal. -Prototype : +Prototype : [source,C] ---- @@ -8532,38 +8532,38 @@ struct t_hook *weechat_hook_signal (const char *signal, void *callback_data); ---- -Paramètres : +Paramètres : -* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé +* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé (priorité autorisée, voir la note sur la <>) (voir le tableau ci-dessous) -* _callback_ : fonction appelée quand le signal est reçu, paramètres et valeur - de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *signal_ : signal reçu -** _const char *type_data_ : type de donnée reçu avec le signal : -*** _WEECHAT_HOOK_SIGNAL_STRING_ : chaîne de caractères -*** _WEECHAT_HOOK_SIGNAL_INT_ : nombre entier -*** _WEECHAT_HOOK_SIGNAL_POINTER_ : pointeur -** _void *signal_data_ : données envoyées avec le signal -** valeur de retour : +* _callback_ : fonction appelée quand le signal est reçu, paramètres et valeur + de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *signal_ : signal reçu +** _const char *type_data_ : type de donnée reçu avec le signal : +*** _WEECHAT_HOOK_SIGNAL_STRING_ : chaîne de caractères +*** _WEECHAT_HOOK_SIGNAL_INT_ : nombre entier +*** _WEECHAT_HOOK_SIGNAL_POINTER_ : pointeur +** _void *signal_data_ : données envoyées avec le signal +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_OK_EAT_ (arrêter l'envoi du signal immédiatement) _(WeeChat ≥ 0.4.0)_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Liste des signaux envoyés par WeeChat et les extensions : +Liste des signaux envoyés par WeeChat et les extensions : [width="100%",cols="^1,^3,^4,5",options="header"] |=== @@ -8571,106 +8571,106 @@ Liste des signaux envoyés par WeeChat et les extensions : | aspell | aspell_suggest + _(WeeChat ≥ 0.4.0)_ | - Pointeur : tampon. | + Pointeur : tampon. | Nouvelles suggestions pour un mot mal orthographié. | guile | guile_script_loaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script scheme chargé. | guile | guile_script_unloaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script scheme déchargé. | guile | guile_script_installed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | + Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | Script(s) scheme installé(s). | guile | guile_script_removed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de scripts supprimés (séparés par des virgules). | + Chaîne : liste de scripts supprimés (séparés par des virgules). | Script(s) scheme supprimé(s). | irc | xxx,irc_in_yyy ^(1)^ | - Chaîne : message. | + Chaîne : message. | Message IRC du serveur (avant utilisation par l'extension irc, signal envoyé uniquement si le message n'est *pas* ignoré). | irc | xxx,irc_in2_yyy ^(1)^ | - Chaîne : message. | + Chaîne : message. | Message IRC du serveur (après utilisation par l'extension irc, signal envoyé uniquement si le message n'est *pas* ignoré). | irc | xxx,irc_raw_in_yyy ^(1)^ + _(WeeChat ≥ 0.3.2)_ | - Chaîne : message. | + Chaîne : message. | Message IRC du serveur (avant utilisation par l'extension irc, signal envoyé même si le message est ignoré). | irc | xxx,irc_raw_in2_yyy ^(1)^ + _(WeeChat ≥ 0.3.2)_ | - Chaîne : message. | + Chaîne : message. | Message IRC du serveur (après utilisation par l'extension irc, signal envoyé même si le message est ignoré). | irc | xxx,irc_out1_yyy ^(1)^ + _(WeeChat ≥ 0.3.7)_ | - Chaîne : message. | + Chaîne : message. | Message IRC envoyé au serveur (avant découpage automatique pour tenir dans les 512 octets). | irc | xxx,irc_out_yyy ^(1)^ | - Chaîne : message. | + Chaîne : message. | Message IRC envoyé au serveur (après découpage automatique pour tenir dans les 512 octets). | irc | xxx,irc_outtags_yyy ^(1)^ + _(WeeChat ≥ 0.3.4)_ | - Chaîne : étiquettes + ";" + message. | + Chaîne : étiquettes + ";" + message. | Étiquettes + message IRC envoyé au serveur. | irc | irc_ctcp | - Chaîne : message. | + Chaîne : message. | CTCP reçu. | irc | irc_dcc | - Chaîne : message. | + Chaîne : message. | Nouveau DCC. | irc | irc_pv | - Chaîne : message. | + Chaîne : message. | Message privé reçu. | irc | irc_channel_opened | - Pointeur : tampon. | + Pointeur : tampon. | Canal ouvert. | irc | irc_pv_opened | - Pointeur : tampon. | + Pointeur : tampon. | Discussion privée ouverte. | irc | irc_server_opened + _(WeeChat ≥ 0.3.7)_ | - Pointeur : tampon. | + Pointeur : tampon. | Tampon du serveur ouvert. | irc | irc_server_connecting | - Chaîne : nom du serveur. | + Chaîne : nom du serveur. | Connexion en cours au serveur. | irc | irc_server_connected | - Chaîne : nom du serveur. | + Chaîne : nom du serveur. | Connecté au serveur. | irc | irc_server_disconnected | - Chaîne : nom du serveur. | + Chaîne : nom du serveur. | Déconnecté du serveur. | irc | irc_ignore_removing | - Pointeur : ignore. | + Pointeur : ignore. | Suppression d'un ignore en cours. | irc | irc_ignore_removed | @@ -8679,283 +8679,283 @@ Liste des signaux envoyés par WeeChat et les extensions : | irc | irc_notify_join + _(WeeChat ≥ 0.3.8)_ | - Chaîne : nom du serveur + "," + pseudo. | + Chaîne : nom du serveur + "," + pseudo. | Un pseudo dans la liste de notifications a rejoint le serveur. | irc | irc_notify_quit + _(WeeChat ≥ 0.3.8)_ | - Chaîne : nom du serveur + "," + pseudo. | + Chaîne : nom du serveur + "," + pseudo. | Un pseudo dans la liste de notifications a quitté le serveur. | irc | irc_notify_away + _(WeeChat ≥ 0.3.8)_ | - Chaîne : nom du serveur + "," + pseudo + "," + message d'absence. | + Chaîne : nom du serveur + "," + pseudo + "," + message d'absence. | Un pseudo dans la liste de notifications est maintenant absent sur le serveur. | irc | irc_notify_still_away + _(WeeChat ≥ 0.3.8)_ | - Chaîne : nom du serveur + "," + pseudo + "," + message d'absence. | + Chaîne : nom du serveur + "," + pseudo + "," + message d'absence. | Un pseudo dans la liste de notifications est toujours absent sur le serveur (le message d'absence a changé). | irc | irc_notify_back + _(WeeChat ≥ 0.3.8)_ | - Chaîne : nom du serveur + "," + pseudo. | + Chaîne : nom du serveur + "," + pseudo. | Un pseudo dans la liste de notifications est de retour (statut d'absence supprimé). | javascript | javascript_script_loaded + _(WeeChat ≥ 1.2)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script javascript chargé. | javascript | javascript_script_unloaded + _(WeeChat ≥ 1.2)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script javascript déchargé. | javascript | javascript_script_installed + _(WeeChat ≥ 1.2)_ | - Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | + Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | Script(s) javascript installé(s). | javascript | javascript_script_removed + _(WeeChat ≥ 1.2)_ | - Chaîne : liste de scripts supprimés (séparés par des virgules). | + Chaîne : liste de scripts supprimés (séparés par des virgules). | Script(s) javascript supprimé(s). | logger | logger_start | - Pointeur : tampon. | + Pointeur : tampon. | Démarrage de l'enregistrement sur disque pour le tampon. | logger | logger_stop | - Pointeur : tampon. | + Pointeur : tampon. | Fin de l'enregistrement sur disque pour le tampon. | logger | logger_backlog | - Pointeur : tampon. | + Pointeur : tampon. | Affichage du backlog pour le tampon. | lua | lua_script_loaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script lua chargé. | lua | lua_script_unloaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script lua déchargé. | lua | lua_script_installed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | + Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | Script(s) lua installé(s). | lua | lua_script_removed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de scripts supprimés (séparés par des virgules). | + Chaîne : liste de scripts supprimés (séparés par des virgules). | Script(s) lua supprimé(s). | perl | perl_script_loaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script perl chargé. | perl | perl_script_unloaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script perl déchargé. | perl | perl_script_installed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | + Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | Script(s) perl installé(s). | perl | perl_script_removed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de scripts supprimés (séparés par des virgules). | + Chaîne : liste de scripts supprimés (séparés par des virgules). | Script(s) perl supprimé(s). | python | python_script_loaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script python chargé. | python | python_script_unloaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script python déchargé. | python | python_script_installed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | + Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | Script(s) python installé(s). | python | python_script_removed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de scripts supprimés (séparés par des virgules). | + Chaîne : liste de scripts supprimés (séparés par des virgules). | Script(s) python supprimé(s). | relay | relay_client_connecting + _(WeeChat ≥ 1.0)_ | - Pointeur : client relay. | + Pointeur : client relay. | Un client relay est en train de se connecter. | relay | relay_client_waiting_auth + _(WeeChat ≥ 1.0)_ | - Pointeur : client relay. | + Pointeur : client relay. | Attente de l'authentification d'un client relay. | relay | relay_client_auth_ok + _(WeeChat ≥ 1.0)_ | - Pointeur : client relay. | + Pointeur : client relay. | Authentification réussie d'un client relay. | relay | relay_client_connected + _(WeeChat ≥ 1.0)_ | - Pointeur : client relay. | + Pointeur : client relay. | Un client relay est connecté. | relay | relay_client_auth_failed + _(WeeChat ≥ 1.0)_ | - Pointeur : client relay. | + Pointeur : client relay. | L'authentification d'un client relay a échoué. | relay | relay_client_disconnected + _(WeeChat ≥ 1.0)_ | - Pointeur : client relay. | + Pointeur : client relay. | Un client relay est déconnecté. | ruby | ruby_script_loaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script ruby chargé. | ruby | ruby_script_unloaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script ruby déchargé. | ruby | ruby_script_installed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | + Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | Script(s) ruby installé(s). | ruby | ruby_script_removed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de scripts supprimés (séparés par des virgules). | + Chaîne : liste de scripts supprimés (séparés par des virgules). | Script(s) ruby supprimé(s). | tcl | tcl_script_loaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script tcl chargé. | tcl | tcl_script_unloaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers le script. | + Chaîne : chemin vers le script. | Script tcl déchargé. | tcl | tcl_script_installed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | + Chaîne : liste de chemins vers scripts installés (séparés par des virgules). | Script(s) tcl installé(s). | tcl | tcl_script_removed + _(WeeChat ≥ 0.3.9)_ | - Chaîne : liste de scripts supprimés (séparés par des virgules). | + Chaîne : liste de scripts supprimés (séparés par des virgules). | Script(s) tcl supprimé(s). | weechat | buffer_opened | - Pointeur : tampon. | + Pointeur : tampon. | Tampon ouvert. | weechat | buffer_closing | - Pointeur : tampon. | + Pointeur : tampon. | Fermeture du tampon en cours. | weechat | buffer_closed | - Pointeur : tampon. | + Pointeur : tampon. | Tampon fermé. | weechat | buffer_cleared | - Pointeur : tampon. | + Pointeur : tampon. | Tampon vidé. | weechat | buffer_hidden | - Pointeur : tampon. | + Pointeur : tampon. | Tampon masqué. | weechat | buffer_unhidden | - Pointeur : tampon. | + Pointeur : tampon. | Tampon démasqué. | weechat | buffer_line_added + _(WeeChat ≥ 0.3.7)_ | - Pointeur : ligne. | + Pointeur : ligne. | Ligne ajoutée dans un tampon. | weechat | buffer_lines_hidden | - Pointeur : tampon. | + Pointeur : tampon. | Lignes cachées dans le tampon. | weechat | buffer_localvar_added | - Pointeur : tampon. | + Pointeur : tampon. | Variable locale ajoutée. | weechat | buffer_localvar_changed | - Pointeur : tampon. | + Pointeur : tampon. | Variable locale modifiée. | weechat | buffer_localvar_removed | - Pointeur : tampon. | + Pointeur : tampon. | Variable locale supprimée. | weechat | buffer_merged | - Pointeur : tampon. | + Pointeur : tampon. | Tampon mélangé. | weechat | buffer_unmerged | - Pointeur : tampon. | + Pointeur : tampon. | Le tampon n'est plus mélangé. | weechat | buffer_moved | - Pointeur : tampon. | + Pointeur : tampon. | Tampon déplacé. | weechat | buffer_renamed | - Pointeur : tampon. | + Pointeur : tampon. | Tampon renommé. | weechat | buffer_switch | - Pointeur : tampon. | + Pointeur : tampon. | Basculement vers un autre tampon. | weechat | buffer_title_changed | - Pointeur : tampon. | + Pointeur : tampon. | Titre du tampon changé. | weechat | buffer_type_changed | - Pointeur : tampon. | + Pointeur : tampon. | Type de tampon changé. | weechat | buffer_zoomed + _(WeeChat ≥ 0.4.3)_ | - Pointeur : tampon. | + Pointeur : tampon. | Zoom sur un tampon mélangé. | weechat | buffer_unzoomed + _(WeeChat ≥ 0.4.3)_ | - Pointeur : tampon. | + Pointeur : tampon. | Fin du zoom sur un tampon mélangé. | weechat | day_changed + _(WeeChat ≥ 0.3.2)_ | - Chaîne : nouvelle date, format : "2010-01-31". | + Chaîne : nouvelle date, format : "2010-01-31". | Le jour de la date système a changé. | weechat | debug_dump | - Chaîne : nom d'extension. | + Chaîne : nom d'extension. | Requête de "dump". | weechat | debug_libs | @@ -8963,11 +8963,11 @@ Liste des signaux envoyés par WeeChat et les extensions : Affichage des bibliothèques externes utilisées. | weechat | filter_added | - Pointeur : filtre. | + Pointeur : filtre. | Filtre ajouté. | weechat | filter_removing | - Pointeur : filtre. | + Pointeur : filtre. | Suppression de filtre en cours. | weechat | filter_removed | @@ -8991,42 +8991,42 @@ Liste des signaux envoyés par WeeChat et les extensions : Coller de lignes en cours. | weechat | input_search | - Pointeur : tampon. | + Pointeur : tampon. | Recherche de texte dans le tampon. | weechat | input_text_changed | - Pointeur : tampon. | + Pointeur : tampon. | Texte modifié dans la barre "input". | weechat | input_text_cursor_moved | - Pointeur : tampon. | + Pointeur : tampon. | Curseur déplacé dans la barre "input". | weechat | key_bind | - Chaîne : touche. | + Chaîne : touche. | Touche ajoutée. | weechat | key_unbind | - Chaîne : touche. | + Chaîne : touche. | Touche supprimée. | weechat | key_pressed | - Chaîne : touche appuyée. | + Chaîne : touche appuyée. | Touche appuyée. | weechat | key_combo_default + _(WeeChat ≥ 1.0)_ | - Chaîne : combinaison de touches. | + Chaîne : combinaison de touches. | Combinaison de touches dans le contexte _default_. | weechat | key_combo_search + _(WeeChat ≥ 1.0)_ | - Chaîne : combinaison de touches. | + Chaîne : combinaison de touches. | Combinaison de touches dans le contexte _search_. | weechat | key_combo_cursor + _(WeeChat ≥ 1.0)_ | - Chaîne : combinaison de touches. | + Chaîne : combinaison de touches. | Combinaison de touches dans le contexte _cursor_. | weechat | mouse_enabled + @@ -9041,42 +9041,42 @@ Liste des signaux envoyés par WeeChat et les extensions : | weechat | nicklist_group_added + _(WeeChat ≥ 0.3.2)_ | - Chaîne : pointeur tampon + "," + nom du groupe. | + Chaîne : pointeur tampon + "," + nom du groupe. | Groupe ajouté dans la liste des pseudos. | weechat | nicklist_group_changed + _(WeeChat ≥ 0.3.4)_ | - Chaîne : pointeur tampon + "," + nom du groupe. | + Chaîne : pointeur tampon + "," + nom du groupe. | Groupe modifié dans la liste des pseudos. | weechat | nicklist_group_removing + _(WeeChat ≥ 0.4.1)_ | - Chaîne : pointeur tampon + "," + nom du groupe. | + Chaîne : pointeur tampon + "," + nom du groupe. | Suppression du groupe de la liste des pseudos. | weechat | nicklist_group_removed + _(WeeChat ≥ 0.3.2)_ | - Chaîne : pointeur tampon + "," + nom du groupe. | + Chaîne : pointeur tampon + "," + nom du groupe. | Groupe supprimé de la liste des pseudos. | weechat | nicklist_nick_added + _(WeeChat ≥ 0.3.2)_ | - Chaîne : pointeur tampon + "," + pseudo. | + Chaîne : pointeur tampon + "," + pseudo. | Pseudo ajouté dans la liste des pseudos. | weechat | nicklist_nick_changed + _(WeeChat ≥ 0.3.4)_ | - Chaîne : pointeur tampon + "," + pseudo. | + Chaîne : pointeur tampon + "," + pseudo. | Pseudo modifié dans la liste des pseudos. | weechat | nicklist_nick_removing + _(WeeChat ≥ 0.4.1)_ | - Chaîne : pointeur tampon + "," + pseudo. | + Chaîne : pointeur tampon + "," + pseudo. | Suppression du pseudo de la liste des pseudos. | weechat | nicklist_nick_removed + _(WeeChat ≥ 0.3.2)_ | - Chaîne : pointeur tampon + "," + pseudo. | + Chaîne : pointeur tampon + "," + pseudo. | Pseudo supprimé de la liste des pseudos. | weechat | partial_completion | @@ -9085,16 +9085,16 @@ Liste des signaux envoyés par WeeChat et les extensions : | weechat | plugin_loaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : chemin vers l'extension chargée. | + Chaîne : chemin vers l'extension chargée. | Extension chargée. | weechat | plugin_unloaded + _(WeeChat ≥ 0.3.9)_ | - Chaîne : nom de l'extension déchargée (exemple : "irc"). | + Chaîne : nom de l'extension déchargée (exemple : "irc"). | Extension déchargée. | weechat | quit | - Chaîne : paramètres pour le /quit. | + Chaîne : paramètres pour le /quit. | La commande `/quit` a été exécutée par l'utilisateur. | weechat | signal_sighup + @@ -9118,7 +9118,7 @@ Liste des signaux envoyés par WeeChat et les extensions : Signal SIGWINCH reçu (le terminal a été redimensionné). | weechat | upgrade | - Chaîne : "quit" si le paramètre "-quit" a été donné pour /upgrade, sinon NULL. | + Chaîne : "quit" si le paramètre "-quit" a été donné pour /upgrade, sinon NULL. | La commande `/upgrade` a été exécutée par l'utilisateur. | weechat | upgrade_ended + @@ -9127,87 +9127,87 @@ Liste des signaux envoyés par WeeChat et les extensions : Fin du processus de mise à jour (commande `/upgrade`). | weechat | weechat_highlight | - Chaîne : message avec le préfixe. | + Chaîne : message avec le préfixe. | Un highlight est survenu. | weechat | weechat_pv | - Chaîne : message avec le préfixe. | + Chaîne : message avec le préfixe. | Un message privé a été affiché. | weechat | window_closing + _(WeeChat ≥ 0.3.6)_ | - Pointeur : fenêtre. | + Pointeur : fenêtre. | Fermeture de la fenêtre en cours. | weechat | window_closed + _(WeeChat ≥ 0.3.6)_ | - Pointeur : fenêtre. | + Pointeur : fenêtre. | Fenêtre fermée. | weechat | window_opened + _(WeeChat ≥ 0.4.1)_ | - Pointeur : fenêtre. | + Pointeur : fenêtre. | Fenêtre ouverte. | weechat | window_scrolled | - Pointeur : fenêtre. | + Pointeur : fenêtre. | Défilement dans la fenêtre. | weechat | window_switch + _(WeeChat ≥ 0.3.7)_ | - Pointeur : fenêtre. | + Pointeur : fenêtre. | Basculement vers une autre fenêtre. | weechat | window_zoom | - Pointeur : fenêtre courante. | + Pointeur : fenêtre courante. | Zoom en cours sur la fenêtre. | weechat | window_zoomed | - Pointeur : fenêtre courante. | + Pointeur : fenêtre courante. | Zoom effectué sur la fenêtre. | weechat | window_unzoom | - Pointeur : fenêtre courante. | + Pointeur : fenêtre courante. | Fin du zoom en cours sur la fenêtre. | weechat | window_unzoomed | - Pointeur : fenêtre courante. | + Pointeur : fenêtre courante. | Fin du zoom effectué sur la fenêtre. | xfer | xfer_add | - Pointeur : infolist avec l'info xfer. | + Pointeur : infolist avec l'info xfer. | Nouveau xfer. | xfer | xfer_send_ready | - Pointeur : infolist avec l'info xfer. | + Pointeur : infolist avec l'info xfer. | Xfer prêt. | xfer | xfer_accept_resume | - Pointeur : infolist avec l'info xfer. | + Pointeur : infolist avec l'info xfer. | Accepter la reprise xfer. | xfer | xfer_send_accept_resume | - Pointeur : infolist avec l'info xfer. | + Pointeur : infolist avec l'info xfer. | Reprise xfer acceptée. | xfer | xfer_start_resume | - Pointeur : infolist avec l'info xfer. | + Pointeur : infolist avec l'info xfer. | Redémarrage. | xfer | xfer_resume_ready | - Pointer : infolist avec l'info xfer. | + Pointer : infolist avec l'info xfer. | Redémarrage prêt. | xfer | xfer_ended + _(WeeChat ≥ 0.3.2)_ | - Pointer : infolist avec l'info xfer. | + Pointer : infolist avec l'info xfer. | Le xfer s'est terminé. |=== [NOTE] ^(1)^ _xxx_ est le nom du serveur IRC, _yyy_ est le nom d'une commande IRC. -Exemple en C : +Exemple en C : [source,C] ---- @@ -9224,7 +9224,7 @@ struct t_hook *my_signal_hook = weechat_hook_signal ("quit", &my_signal_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9246,7 +9246,7 @@ _Mis à jour dans la 1.0._ Envoyer un signal. -Prototype : +Prototype : [source,C] ---- @@ -9254,29 +9254,29 @@ int weechat_hook_signal_send (const char *signal, const char *type_data, void *signal_data); ---- -Paramètres : +Paramètres : -* _signal_ : signal à envoyer -* _type_data_ : type de données à envoyer avec le signal (voir +* _signal_ : signal à envoyer +* _type_data_ : type de données à envoyer avec le signal (voir <<_hook_signal,hook_signal>>) -* _signal_data_ : données envoyées avec le signal +* _signal_data_ : données envoyées avec le signal -Valeur de retour _(WeeChat ≥ 1.0)_ : +Valeur de retour _(WeeChat ≥ 1.0)_ : * code retour du dernier "callback" exécuté (_WEECHAT_RC_OK_ si aucun "callback" - n'a été exécuté) : + n'a été exécuté) : ** _WEECHAT_RC_OK_ ** _WEECHAT_RC_OK_EAT_ ** _WEECHAT_RC_ERROR_ -Exemple en C : +Exemple en C : [source,C] ---- int rc = weechat_hook_signal_send ("mon_signal", WEECHAT_HOOK_SIGNAL_STRING, ma_chaine); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9296,14 +9296,14 @@ votre extension/script). Le paramètre est un pointeur vers le tampon. -Exemple en C : +Exemple en C : [source,C] ---- weechat_hook_signal_send ("logger_backlog", WEECHAT_HOOK_SIGNAL_POINTER, buffer); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9313,7 +9313,7 @@ weechat.hook_signal_send("logger_backlog", weechat.WEECHAT_HOOK_SIGNAL_POINTER, [[signals_xxx_script_install]] ===== Signaux xxx_script_install -Cinq signaux peuvent être envoyés pour installer un script, selon le langage : +Cinq signaux peuvent être envoyés pour installer un script, selon le langage : * _perl_script_install_ * _python_script_install_ @@ -9323,7 +9323,7 @@ Cinq signaux peuvent être envoyés pour installer un script, selon le langage : * _guile_script_install_ * _javascript_script_install_ -Le "callback" effectuera les actions suivantes lorsqu'il recevra le signal : +Le "callback" effectuera les actions suivantes lorsqu'il recevra le signal : . déchargement et suppression du script installé . déplacement du nouveau script vers le répertoire _~/.weechat/xxx/_ (où _xxx_ @@ -9336,7 +9336,7 @@ Ces signaux sont utilisés par l'extension _script_ pour installer des scripts. Le paramètre est une chaîne avec le chemin vers le script à installer. -Exemple en C : +Exemple en C : [source,C] ---- @@ -9344,7 +9344,7 @@ weechat_hook_signal_send ("python_script_install", WEECHAT_HOOK_SIGNAL_STRING, "/home/xxx/.weechat/test.py"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9356,7 +9356,7 @@ weechat.hook_signal_send("python_script_install", WEECHAT_HOOK_SIGNAL_STRING, ===== Signaux xxx_script_remove Cinq signaux peuvent être envoyés pour supprimer une liste de scripts, selon le -langage : +langage : * _perl_script_remove_ * _python_script_remove_ @@ -9374,7 +9374,7 @@ Ces signaux sont utilisés par l'extension _script_ pour supprimer des scripts. Le paramètre est une chaîne avec une liste de scripts à supprimer (séparés par des virgules, nom du script sans le chemin, par exemple _script.py_). -Exemple en C : +Exemple en C : [source,C] ---- @@ -9383,7 +9383,7 @@ weechat_hook_signal_send ("python_script_remove", WEECHAT_HOOK_SIGNAL_STRING, "test.py,script.py"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9400,25 +9400,25 @@ _WeeChat ≥ 0.3.4, mis à jour dans la 1.5._ Le signal "irc_input_send" peut être envoyé pour simuler une entrée de texte dans un tampon irc (serveur, canal ou privé). -Le paramètre est une chaîne avec le format suivant : +Le paramètre est une chaîne avec le format suivant : * nom interne du serveur (requis) * point-virgule * nom de canal (optionnel) * point-virgule -* liste d'options séparées par des virgules (optionnel) : -** _priority_high_ : file d'attente avec haute priorité (comme les messages - utilisateur) ; c'est la priorité par défaut -** _priority_low_ : file d'attente avec basse priorité (comme les messages +* liste d'options séparées par des virgules (optionnel) : +** _priority_high_ : file d'attente avec haute priorité (comme les messages + utilisateur) ; c'est la priorité par défaut +** _priority_low_ : file d'attente avec basse priorité (comme les messages envoyés automatiquement par WeeChat) -** _user_message_ : forcer un message utilisateur (ne pas exécuter de commande) +** _user_message_ : forcer un message utilisateur (ne pas exécuter de commande) * point-virgule * liste d'étiquettes (séparées par des virgules) utilisées lors de l'envoi du message (optionnel) * point-virgule * texte ou commande (requis) -Exemples en C : +Exemples en C : [source,C] ---- @@ -9431,7 +9431,7 @@ weechat_hook_signal_send ("irc_input_send", WEECHAT_HOOK_SIGNAL_STRING, "freenode;;priority_low;;/whois FlashCode"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9450,7 +9450,7 @@ _WeeChat ≥ 0.3.4, mis à jour dans la 1.5._ S'accrocher à un hsignal (signal avec une table de hachage). -Prototype : +Prototype : [source,C] ---- @@ -9463,34 +9463,34 @@ struct t_hook *weechat_hook_hsignal (const char *signal, void *callback_data); ---- -Paramètres : +Paramètres : -* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé +* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé (priorité autorisée, voir la note sur la <>) (voir le tableau ci-dessous) -* _callback_ : fonction appelée quand le signal est reçu, paramètres et valeur - de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *signal_ : signal reçu -** _struct t_hashtable *hashtable_ : table de hachage -** valeur de retour : +* _callback_ : fonction appelée quand le signal est reçu, paramètres et valeur + de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *signal_ : signal reçu +** _struct t_hashtable *hashtable_ : table de hachage +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_OK_EAT_ (arrêter l'envoi du signal immédiatement) _(WeeChat ≥ 0.4.0)_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Liste des hsignaux envoyés par WeeChat et les extensions : +Liste des hsignaux envoyés par WeeChat et les extensions : [width="100%",cols="^1,^3,5,5",options="header"] |=== @@ -9503,44 +9503,44 @@ Liste des hsignaux envoyés par WeeChat et les extensions : | weechat | nicklist_group_added + _(WeeChat ≥ 0.4.1)_ | - _buffer_ (_struct t_gui_buffer *_) : tampon + - _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + - _group_ (_struct t_gui_nick_group *_) : groupe | + _buffer_ (_struct t_gui_buffer *_) : tampon + + _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + + _group_ (_struct t_gui_nick_group *_) : groupe | Groupe ajouté dans la liste de pseudos. | weechat | nicklist_nick_added + _(WeeChat ≥ 0.4.1)_ | - _buffer_ (_struct t_gui_buffer *_) : tampon + - _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + - _nick_ (_struct t_gui_nick *_) : pseudo | + _buffer_ (_struct t_gui_buffer *_) : tampon + + _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + + _nick_ (_struct t_gui_nick *_) : pseudo | Pseudo ajouté dans la liste de pseudos. | weechat | nicklist_group_removing + _(WeeChat ≥ 0.4.1)_ | - _buffer_ (_struct t_gui_buffer *_) : tampon + - _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + - _group_ (_struct t_gui_nick_group *_) : groupe | + _buffer_ (_struct t_gui_buffer *_) : tampon + + _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + + _group_ (_struct t_gui_nick_group *_) : groupe | Suppression d'un groupe de la liste de pseudos. | weechat | nicklist_nick_removing + _(WeeChat ≥ 0.4.1)_ | - _buffer_ (_struct t_gui_buffer *_) : tampon + - _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + - _nick_ (_struct t_gui_nick *_) : pseudo | + _buffer_ (_struct t_gui_buffer *_) : tampon + + _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + + _nick_ (_struct t_gui_nick *_) : pseudo | Suppression d'un pseudo de la liste de pseudos. | weechat | nicklist_group_changed + _(WeeChat ≥ 0.4.1)_ | - _buffer_ (_struct t_gui_buffer *_) : tampon + - _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + - _group_ (_struct t_gui_nick_group *_) : groupe | + _buffer_ (_struct t_gui_buffer *_) : tampon + + _parent_group_ (_struct t_gui_nick_group *_) : groupe parent + + _group_ (_struct t_gui_nick_group *_) : groupe | Groupe changé dans la liste de pseudos. | weechat | nicklist_nick_changed + _(WeeChat ≥ 0.4.1)_ | - _buffer_ (_struct t_gui_buffer *_) : tampon + - _parent_group_ (_struct t_gui_nick_group *_) : parent + - _nick_ (_struct t_gui_nick *_) : pseudo | + _buffer_ (_struct t_gui_buffer *_) : tampon + + _parent_group_ (_struct t_gui_nick_group *_) : parent + + _nick_ (_struct t_gui_nick *_) : pseudo | Pseudo changé dans la liste de pseudos. |=== @@ -9548,7 +9548,7 @@ Liste des hsignaux envoyés par WeeChat et les extensions : ^(1)^ _xxx_ est l'argument "signal" utilisé dans la redirection, _yyy_ est le modèle de redirection ("pattern"). -Exemple en C : +Exemple en C : [source,C] ---- @@ -9564,7 +9564,7 @@ struct t_hook *my_hsignal_hook = weechat_hook_hsignal ("test", &my_hsignal_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9585,27 +9585,27 @@ _WeeChat ≥ 0.3.4, mis à jour dans la 1.0._ Envoyer un hsignal (signal avec table de hachage). -Prototype : +Prototype : [source,C] ---- int weechat_hook_hsignal_send (const char *signal, struct t_hashtable *hashtable); ---- -Paramètres : +Paramètres : -* _signal_ : signal à envoyer -* _hashtable_ : table de hachage +* _signal_ : signal à envoyer +* _hashtable_ : table de hachage -Valeur de retour _(WeeChat ≥ 1.0)_ : +Valeur de retour _(WeeChat ≥ 1.0)_ : * code retour du dernier "callback" exécuté (_WEECHAT_RC_OK_ si aucun "callback" - n'a été exécuté) : + n'a été exécuté) : ** _WEECHAT_RC_OK_ ** _WEECHAT_RC_OK_EAT_ ** _WEECHAT_RC_ERROR_ -Exemple en C : +Exemple en C : [source,C] ---- @@ -9623,7 +9623,7 @@ if (hashtable) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9643,12 +9643,12 @@ Le hsignal "irc_redirect_command" peut être envoyé pour rediriger la sortie d'une commande irc vers un "callback". Le paramètre est une table de hachage avec les entrées suivantes (les clés et -valeurs sont des chaînes) : +valeurs sont des chaînes) : -* _server_ : nom interne du serveur (requis) -* _pattern_ : modèle de redirection à utiliser (requis), soit un par défaut +* _server_ : nom interne du serveur (requis) +* _pattern_ : modèle de redirection à utiliser (requis), soit un par défaut (défini par l'extension irc), ou un modèle utilisateur (voir - <>), les modèles par défaut sont : + <>), les modèles par défaut sont : ** _ison_ ** _list_ ** _mode_channel_ @@ -9665,14 +9665,14 @@ valeurs sont des chaînes) : ** _who_ ** _whois_ ** _whowas_ -* _signal_ : nom du signal (requis) -* _count_ : nombre de fois que la redirection sera exécutée (optionnel, 1 par +* _signal_ : nom du signal (requis) +* _count_ : nombre de fois que la redirection sera exécutée (optionnel, 1 par défaut) -* _string_ : chaîne qui doit être dans les messages irc reçus (optionnel, mais +* _string_ : chaîne qui doit être dans les messages irc reçus (optionnel, mais recommandé, si une chaîne peut être utilisée pour identifier les messages) -* _timeout_ : temps d'attente maximum pour la redirection, en secondes +* _timeout_ : temps d'attente maximum pour la redirection, en secondes (optionnel, 60 par défaut) -* _cmd_filter_ : liste de commandes irc (séparées par des virgules) à filtrer +* _cmd_filter_ : liste de commandes irc (séparées par des virgules) à filtrer (seules ces commandes seront transmises au "callback", les autres seront ignorées) (optionnel) @@ -9684,18 +9684,18 @@ Ce hsignal a le nom _irc_redirection_xxx_yyy_ où _xxx_ est le _signal_ et _yyy_ le _pattern_ utilisé. La table de hachage envoyée dans le hsignal a le contenu suivant (les clés et -valeurs sont des chaînes) : +valeurs sont des chaînes) : -* _output_ : sortie de la commande (les messages sont séparés par "\n") -* _output_size_ : nombre d'octets dans _output_ (sous forme de chaîne) -* _error_ : chaîne d'erreur (si une erreur s'est produite) : -** _timeout_ : redirection stoppée après le délai maximum dépassé -* _server_ : nom interne du serveur -* _pattern_ : modèle de redirection -* _signal_ : nom du signal -* _command_ : commande redirigée +* _output_ : sortie de la commande (les messages sont séparés par "\n") +* _output_size_ : nombre d'octets dans _output_ (sous forme de chaîne) +* _error_ : chaîne d'erreur (si une erreur s'est produite) : +** _timeout_ : redirection stoppée après le délai maximum dépassé +* _server_ : nom interne du serveur +* _pattern_ : modèle de redirection +* _signal_ : nom du signal +* _command_ : commande redirigée -Exemple en C : +Exemple en C : [source,C] ---- @@ -9727,7 +9727,7 @@ if (hashtable) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9753,21 +9753,21 @@ Le hsignal "irc_redirect_pattern" peut être envoyé pour créer un modèle de redirection irc (voir <>). Le paramètre est une table de hachage avec les entrées suivantes (les clés et -valeurs sont des chaînes) : +valeurs sont des chaînes) : -* _pattern_ : nom du modèle (requis) -* _timeout_ : temps d'attente maximum pour le modèle, en secondes (optionnel, 60 +* _pattern_ : nom du modèle (requis) +* _timeout_ : temps d'attente maximum pour le modèle, en secondes (optionnel, 60 par défaut) -* _cmd_start_ : liste de commandes (séparées par des virgules) démarrant la +* _cmd_start_ : liste de commandes (séparées par des virgules) démarrant la redirection (optionnel) -* _cmd_stop_ : liste de commandes (séparées par des virgules) stoppant la +* _cmd_stop_ : liste de commandes (séparées par des virgules) stoppant la redirection (requis) -* _cmd_extra_ : liste de commandes (séparées par des virgules) pouvant être +* _cmd_extra_ : liste de commandes (séparées par des virgules) pouvant être reçues après les commandes de stop (optionnel) Pour chaque commande dans _cmd_start_, _cmd_stop_ et _cmd_extra_, il est possible de donner un entier avec la position de la chaîne "string" qui doit -être trouvée dans le message reçu, par exemple : +être trouvée dans le message reçu, par exemple : ---- 352:1,354,401:1 @@ -9781,7 +9781,7 @@ Le modèle est détruit dès qu'il est utilisé dans une redirection. Si vous av besoin du modèle pour plusieurs redirections, vous devez créer un modèle pour chaque redirection. -Exemple en C : +Exemple en C : [source,C] ---- @@ -9807,7 +9807,7 @@ if (hashtable) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9827,7 +9827,7 @@ _Mis à jour dans la 1.5._ S'accrocher à une option de configuration. -Prototype : +Prototype : [source,C] ---- @@ -9840,33 +9840,33 @@ struct t_hook *weechat_hook_config (const char *option, void *callback_data); ---- -Paramètres : +Paramètres : -* _option_ : option, le format est le nom complet, celui utilisé avec la - commande `/set` (par exemple : `weechat.look.item_time_format`), le caractère +* _option_ : option, le format est le nom complet, celui utilisé avec la + commande `/set` (par exemple : `weechat.look.item_time_format`), le caractère joker `+*+` est autorisé (priorité autorisée, voir la note sur la <>) -* _callback_ : fonction appelée lorsque l'option de configuration est modifiée, - paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *option_ : nom de l'option -** _const char *value_ : nouvelle valeur pour l'option -** valeur de retour : +* _callback_ : fonction appelée lorsque l'option de configuration est modifiée, + paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *option_ : nom de l'option +** _const char *value_ : nouvelle valeur pour l'option +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -9883,7 +9883,7 @@ struct t_hook *my_config_hook = weechat_hook_config ("weechat.look.item_time_for &my_config_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -9905,7 +9905,7 @@ _Mis à jour dans la 1.5._ Accrocher un modificateur. -Prototype : +Prototype : [source,C] ---- @@ -9919,32 +9919,32 @@ struct t_hook *weechat_hook_modifier (const char *modifier, void *callback_data); ---- -Paramètres : +Paramètres : -* _modifier_ : nom du modificateur, liste des modificateurs utilisés par WeeChat +* _modifier_ : nom du modificateur, liste des modificateurs utilisés par WeeChat ou des extensions (priorité autorisée, voir la note sur la <>) (voir le tableau ci-dessous) -* _callback_ : fonction appelée lorsque le modificateur est utilisé, paramètres - et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *modifier_ : nom du modificateur -** _const char *modifier_data_ : données pour le modificateur -** _const char *string_ : chaîne à modifier -** valeur de retour : nouvelle chaîne -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_ : fonction appelée lorsque le modificateur est utilisé, paramètres + et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *modifier_ : nom du modificateur +** _const char *modifier_data_ : données pour le modificateur +** _const char *string_ : chaîne à modifier +** valeur de retour : nouvelle chaîne +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Liste des modificateurs utilisés par WeeChat et les extensions : +Liste des modificateurs utilisés par WeeChat et les extensions : [width="100%",cols="^2,3,4,4",options="header"] |=== @@ -9983,8 +9983,8 @@ Liste des modificateurs utilisés par WeeChat et les extensions : | irc_command_auth + _(WeeChat ≥ 0.4.1)_ | Nom du serveur | - Commande d'authentification (par exemple : `+/msg nickserv identify password+`). | - Commande avec le mot de passe caché (par exemple : `+/msg nickserv identify ********+`). + Commande d'authentification (par exemple : `+/msg nickserv identify password+`). | + Commande avec le mot de passe caché (par exemple : `+/msg nickserv identify ********+`). | irc_message_auth + _(WeeChat ≥ 0.4.1)_ | @@ -10068,7 +10068,7 @@ Liste des modificateurs utilisés par WeeChat et les extensions : ^(1)^ _xxx_ est un nom de commande IRC. + ^(2)^ _yyy_ est le nom de la barre. -Exemple en C : +Exemple en C : [source,C] ---- @@ -10098,7 +10098,7 @@ struct t_hook *my_modifier_hook = weechat_hook_modifier ("weechat_print", &my_modifier_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10116,7 +10116,7 @@ hook = weechat.hook_modifier("weechat_print", "my_modifier_cb", "") Exécuter un ou plusieurs modificateurs. -Prototype : +Prototype : [source,C] ---- @@ -10125,17 +10125,17 @@ char *weechat_hook_modifier_exec (const char *modifier, const char *string); ---- -Paramètres : +Paramètres : -* _modifier_ : nom du modificateur -* _modifier_data_ : données du modificateur -* _string_ : chaîne à modifier +* _modifier_ : nom du modificateur +* _modifier_data_ : données du modificateur +* _string_ : chaîne à modifier -Valeur de retour : +Valeur de retour : * chaîne modifiée, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -10143,7 +10143,7 @@ char *new_string = weechat_hook_modifier_exec ("mon_modifier", mes_donnees, ma_chaine); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10160,7 +10160,7 @@ _Mis à jour dans la 1.5._ Accrocher une information (le "callback" prend et retourne une chaîne). -Prototype : +Prototype : [source,C] ---- @@ -10175,32 +10175,32 @@ struct t_hook *weechat_hook_info (const char *info_name, void *callback_data); ---- -Paramètres : +Paramètres : -* _info_name_ : nom de l'information +* _info_name_ : nom de l'information (priorité autorisée, voir la note sur la <>) -* _description_ : description -* _args_description_ : description des paramètres (optionnel, peut être NULL) -* _callback_ : fonction appelée quand l'information est demandée, paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *info_name_ : nom de l'information -** _const char *arguments_ : paramètres additionnels, dépendant de +* _description_ : description +* _args_description_ : description des paramètres (optionnel, peut être NULL) +* _callback_ : fonction appelée quand l'information est demandée, paramètres et + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *info_name_ : nom de l'information +** _const char *arguments_ : paramètres additionnels, dépendant de l'information -** valeur de retour : valeur de l'information demandée -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +** valeur de retour : valeur de l'information demandée +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -10219,7 +10219,7 @@ struct t_hook *my_info_hook = weechat_hook_info ("mon_info", &my_info_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10242,7 +10242,7 @@ _WeeChat ≥ 0.3.4, mis à jour dans la 1.5._ Accrocher une information (le "callback" prend et retourne une table de hachage). -Prototype : +Prototype : [source,C] ---- @@ -10258,35 +10258,35 @@ struct t_hook *weechat_hook_info_hashtable (const char *info_name, void *callback_data); ---- -Paramètres : +Paramètres : -* _info_name_ : nom de l'information +* _info_name_ : nom de l'information (priorité autorisée, voir la note sur la <>) -* _description_ : description -* _args_description_ : description de la table de hachage attendue +* _description_ : description +* _args_description_ : description de la table de hachage attendue (optionnel, peut être NULL) -* _output_description_ : description de la table de hachage retournée par le +* _output_description_ : description de la table de hachage retournée par le "callback" (optionnel, peut être NULL) -* _callback_ : fonction appelée quand l'information est demandée, paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *info_name_ : nom de l'information -** _struct t_hashtable *hashtable_ : table de hachage, dépendant de +* _callback_ : fonction appelée quand l'information est demandée, paramètres et + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *info_name_ : nom de l'information +** _struct t_hashtable *hashtable_ : table de hachage, dépendant de l'information -** valeur de retour : table de hachage demandée -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +** valeur de retour : table de hachage demandée +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -10306,7 +10306,7 @@ struct t_hook *my_info_hook = weechat_hook_info_hashtable ("mon_info_hashtable", &my_info_hashtable_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10328,10 +10328,10 @@ hook = weechat.hook_info_hashtable("mon_info_hashtable", "Une information", _Mis à jour dans la 1.5._ -Accrocher une infolist : le "callback" retournera un pointeur vers l'infolist +Accrocher une infolist : le "callback" retournera un pointeur vers l'infolist demandée. -Prototype : +Prototype : [source,C] ---- @@ -10348,34 +10348,34 @@ struct t_hook *weechat_hook_infolist (const char *infolist_name, void *callback_data); ---- -Paramètres : +Paramètres : -* _infolist_name_ : nom de l'infolist +* _infolist_name_ : nom de l'infolist (priorité autorisée, voir la note sur la <>) -* _description_ : description -* _pointer_description_ : description du pointeur (optionnel, peut être NULL) -* _args_description_ : description des paramètres (optionnel, peut être NULL) -* _callback_ : fonction appelée quand l'infolist est demandée, paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *infolist_name_ : nom de l'infolist -** _void *pointer_ : pointeur vers un objet que l'infolist doit retourner (pour +* _description_ : description +* _pointer_description_ : description du pointeur (optionnel, peut être NULL) +* _args_description_ : description des paramètres (optionnel, peut être NULL) +* _callback_ : fonction appelée quand l'infolist est demandée, paramètres et + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *infolist_name_ : nom de l'infolist +** _void *pointer_ : pointeur vers un objet que l'infolist doit retourner (pour obtenir uniquement cet objet dans l'infolist) -** _const char *arguments_ : paramètres additionnels, dépendant de l'infolist -** valeur de retour : infolist demandée -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +** _const char *arguments_ : paramètres additionnels, dépendant de l'infolist +** valeur de retour : infolist demandée +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -10399,7 +10399,7 @@ struct t_hook *my_infolist = weechat_hook_infolist ("mon_infolist", &my_infolist_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10422,9 +10422,9 @@ hook = weechat.hook_infolist("mon_infolist", "Mon infolist", _Mis à jour dans la 1.5._ -Accrocher un hdata : le "callback" retournera un pointeur vers le hdata demandé. +Accrocher un hdata : le "callback" retournera un pointeur vers le hdata demandé. -Prototype : +Prototype : [source,C] ---- @@ -10437,29 +10437,29 @@ struct t_hook *weechat_hook_hdata (const char *hdata_name, void *callback_data); ---- -Paramètres : +Paramètres : -* _hdata_name_ : nom du hdata +* _hdata_name_ : nom du hdata (priorité autorisée, voir la note sur la <>) -* _description_ : description -* _callback_ : fonction appelée quand le hdata est demandé, paramètres et valeur - de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _const char *hdata_name_ : nom du hdata -** valeur de retour : hdata demandé -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _description_ : description +* _callback_ : fonction appelée quand le hdata est demandé, paramètres et valeur + de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _const char *hdata_name_ : nom du hdata +** valeur de retour : hdata demandé +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -10487,10 +10487,10 @@ Cette fonction n'est pas disponible dans l'API script. _Mis à jour dans la 1.5._ -Accrocher un focus : évènement souris ou touche du clavier pressée dans le mode +Accrocher un focus : évènement souris ou touche du clavier pressée dans le mode "curseur" (mouvement libre du curseur). -Prototype : +Prototype : [source,C] ---- @@ -10502,38 +10502,38 @@ struct t_hook *weechat_hook_focus (const char *area, void *callback_data); ---- -Paramètres : +Paramètres : -* _area_ : "chat" pour la zone de discussion, ou un nom d'objet de barre +* _area_ : "chat" pour la zone de discussion, ou un nom d'objet de barre (priorité autorisée, voir la note sur la <>) -* _callback_ : fonction appelée quand le focus est fait, paramètres et valeur de - retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_hashtable *info_ : table de hachage avec les informations sur le +* _callback_ : fonction appelée quand le focus est fait, paramètres et valeur de + retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_hashtable *info_ : table de hachage avec les informations sur le focus et les chaînes retournées par les autres appels aux "callbacks" de focus (avec plus haute priorité) (voir le tableau ci-dessous) -** valeur de retour : soit le pointeur vers la table de hachage "info" (avec la +** valeur de retour : soit le pointeur vers la table de hachage "info" (avec la table de hachage complétée), ou un pointeur vers une nouvelle table de hachage (créée par le "callback", avec clés et valeurs de type "string"), le contenu de cette nouvelle table de hachage sera ajouté à _info_ pour les autres appels aux "callbacks" focus -* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le "hook" est supprimé [IMPORTANT] -Pour un geste de souris, votre "callback" sera appelé deux fois : la première +Pour un geste de souris, votre "callback" sera appelé deux fois : la première lorsque le bouton est pressé (ici la zone correspond à vôtre zone), la seconde fois lorsque le bouton est relâché, et la zone peut ne pas correspondre à la -vôtre : donc vous devez *toujours* tester dans le "callback" si la zone +vôtre : donc vous devez *toujours* tester dans le "callback" si la zone correspond avant d'utiliser les informations de la table de hachage. Contenu de la table de hachage envoyée au "callback" (les clés et valeurs sont -de type "string") : +de type "string") : [width="100%",cols="5,5,8,3",options="header"] |=== @@ -10632,7 +10632,7 @@ de type "string") : |=== [NOTE] -^(1)^ Il y a les mêmes clés suffixées par "2" (c'est-à-dire : "_x2", "_y2", +^(1)^ Il y a les mêmes clés suffixées par "2" (c'est-à-dire : "_x2", "_y2", "_window2", ...) avec l'information sur le second point (pratique seulement pour les gestes de souris, pour savoir où le bouton de la souris a été relâché). + @@ -10641,7 +10641,7 @@ relâché). + ^(4)^ Il s'agit de la date lorsque WeeChat ajoute la ligne dans le tampon (supérieure ou égale à "_chat_line_date"). -Informations additionnelles pour l'objet de barre "buffer_nicklist" : +Informations additionnelles pour l'objet de barre "buffer_nicklist" : [width="60%",cols="1,1,5",options="header"] |=== @@ -10657,11 +10657,11 @@ Informations additionnelles pour l'objet de barre "buffer_nicklist" : pour cet objet de barre (donc par exemple si l'extension est "irc", ces infos ne seront disponibles que sur les tampons irc). -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hook", NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -10679,7 +10679,7 @@ struct t_hook *my_focus = weechat_hook_focus ("buffer_nicklist", &my_focus_nicklist_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10697,11 +10697,11 @@ hook = weechat.hook_focus("buffer_nicklist", "my_focus_nicklist_cb", "") ==== hook_set -_WeeChat ≥ 0.3.9 (script : WeeChat ≥ 0.4.3)._ +_WeeChat ≥ 0.3.9 (script : WeeChat ≥ 0.4.3)._ Affecter une valeur à une propriété d'un hook. -Prototype : +Prototype : [source,C] ---- @@ -10709,13 +10709,13 @@ void weechat_hook_set (struct t_hook *hook, const char *property, const char *value); ---- -Paramètres : +Paramètres : -* _hook_ : quelque chose d'accroché avec "weechat_hook_xxx()" -* _property_ : nom de la propriété (voir le tableau ci-dessous) -* _value_ : nouvelle valeur pour la propriété +* _hook_ : quelque chose d'accroché avec "weechat_hook_xxx()" +* _property_ : nom de la propriété (voir le tableau ci-dessous) +* _value_ : nouvelle valeur pour la propriété -Propriétés : +Propriétés : [width="100%",cols="^2,2,2,5",options="header"] |=== @@ -10739,12 +10739,12 @@ Propriétés : | signal + _(WeeChat ≥ 1.0)_ | _process_, _process_hashtable_ | - numéro de signal ou un de ces noms : `hup`, `int`, `quit`, `kill`, `term`, + numéro de signal ou un de ces noms : `hup`, `int`, `quit`, `kill`, `term`, `usr1`, `usr2` | Envoyer un signal au proces.sus fils |=== -Exemple en C : +Exemple en C : [source,C] ---- @@ -10755,7 +10755,7 @@ struct t_hook *my_command_hook = weechat_hook_set (my_command_hook, "subplugin", "test"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10777,18 +10777,18 @@ weechat.hook_set(hook, "stdin_close", "") # facultatif Décrocher quelque chose qui est a été accroché. -Prototype : +Prototype : [source,C] ---- void weechat_unhook (struct t_hook *hook); ---- -Paramètres : +Paramètres : -* _hook_ : quelque chose accroché avec "weechat_hook_xxx()" +* _hook_ : quelque chose accroché avec "weechat_hook_xxx()" -Exemple en C : +Exemple en C : [source,C] ---- @@ -10797,7 +10797,7 @@ struct t_hook *my_hook = weechat_hook_command ( /* ... */ ); weechat_unhook (my_hook); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10814,26 +10814,26 @@ _Mis à jour dans la 1.5._ Décrocher tout ce qui a été accroché par l'extension courante. -Prototype : +Prototype : [source,C] ---- void weechat_unhook_all (const char *subplugin); ---- -Paramètres : +Paramètres : -* _subplugin_ : si non NULL, décrocher uniquement les "hooks" qui ont ce +* _subplugin_ : si non NULL, décrocher uniquement les "hooks" qui ont ce "subplugin" défini (ce paramètre n'est pas disponible dans l'API script) -Exemple en C : +Exemple en C : [source,C] ---- weechat_unhook_all (NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10855,7 +10855,7 @@ _Mis à jour dans la 1.5._ Ouvrir un nouveau tampon. -Prototype : +Prototype : [source,C] ---- @@ -10873,44 +10873,44 @@ struct t_gui_buffer *weechat_buffer_new (const char *name, void *close_callback_data); ---- -Paramètres : +Paramètres : -* _name_ : nom du tampon (doit être unique pour l'extension) -* _input_callback_ : fonction appelée lorsque du texte saisi est envoyé au - tampon, paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_gui_buffer *buffer_ : pointeur vers le tampon -** _const char *input_data_ : données en entrée -** valeur de retour : +* _name_ : nom du tampon (doit être unique pour l'extension) +* _input_callback_ : fonction appelée lorsque du texte saisi est envoyé au + tampon, paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_gui_buffer *buffer_ : pointeur vers le tampon +** _const char *input_data_ : données en entrée +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _input_callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé +* _input_callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _input_callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _input_callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le tampon est fermé -* _close_callback_ : fonction appelée lorsque le tampon est fermé, paramètres et - valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_gui_buffer *buffer_ : pointeur vers le tampon -** valeur de retour : +* _close_callback_ : fonction appelée lorsque le tampon est fermé, paramètres et + valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_gui_buffer *buffer_ : pointeur vers le tampon +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _close_callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé +* _close_callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _close_callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _close_callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le tampon est fermé -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau tampon, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -10918,7 +10918,7 @@ int my_input_cb (const void *pointer, void *data, struct t_gui_buffer *buffer, const char *input_data) { - weechat_printf (buffer, "Texte : %s", input_data); + weechat_printf (buffer, "Texte : %s", input_data); return WEECHAT_RC_OK; } @@ -10935,7 +10935,7 @@ struct t_gui_buffer *my_buffer = weechat_buffer_new ("mon_buffer", &my_close_cb, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10945,7 +10945,7 @@ buffer = weechat.buffer_new(name, input_callback, input_callback_data, # exemple def my_input_cb(data, buffer, input_data): - weechat.prnt(buffer, "Texte : %s" % input_data) + weechat.prnt(buffer, "Texte : %s" % input_data) return weechat.WEECHAT_RC_OK def my_close_cb(data, buffer): @@ -10960,25 +10960,25 @@ buffer = weechat.buffer_new("mon_buffer", "my_input_cb", "", "my_close_cb", "") Retourner un pointeur vers le tampon courant (le tampon affiché par la fenêtre courante). -Prototype : +Prototype : [source,C] ---- struct t_gui_buffer *weechat_current_buffer (); ---- -Valeur de retour : +Valeur de retour : * pointeur vers le tampon courant -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (weechat_current_buffer (), "Texte sur le tampon courant"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -10995,7 +10995,7 @@ _Mis à jour dans la 1.0._ Rechercher un tampon par l'extension et/ou le nom. -Prototype : +Prototype : [source,C] ---- @@ -11003,21 +11003,21 @@ struct t_gui_buffer *weechat_buffer_search (const char *plugin, const char *name); ---- -Paramètres : +Paramètres : -* _plugin_ : nom de l'extension, la valeur spéciale suivante est autorisée : -** `+==+` : le nom utilisé est le nom complet du tampon (par exemple : +* _plugin_ : nom de l'extension, la valeur spéciale suivante est autorisée : +** `+==+` : le nom utilisé est le nom complet du tampon (par exemple : `irc.freenode.#weechat` au lieu de `freenode.#weechat`) _(WeeChat ≥ 1.0)_ -* _name_ : nom du tampon, si c'est NULL ou une chaîne vide, le tampon courant +* _name_ : nom du tampon, si c'est NULL ou une chaîne vide, le tampon courant est retourné (tampon affiché par la fenêtre courante); si le nom commence par `(?i)`, la recherche est insensible à la casse _(WeeChat ≥ 1.0)_ -Valeur de retour : +Valeur de retour : * pointeur vers le tampon trouvé, NULL s'il n'a pas été trouvé -Exemples en C : +Exemples en C : [source,C] ---- @@ -11025,7 +11025,7 @@ struct t_gui_buffer *buffer1 = weechat_buffer_search ("irc", "freenode.#weechat" struct t_gui_buffer *buffer2 = weechat_buffer_search ("==", "irc.freenode.#test"); /* WeeChat ≥ 1.0 */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11041,25 +11041,25 @@ buffer = weechat.buffer_search("mon_extension", "mon_tampon") Rechercher le tampon principal de WeeChat (tampon _core_, premier tampon affiché lorsque WeeChat démarre). -Prototype : +Prototype : [source,C] ---- struct t_gui_buffer *weechat_buffer_search_main (); ---- -Valeur de retour : +Valeur de retour : * pointeur vers le tampon principal WeeChat (tampon _core_) -Exemple en C : +Exemple en C : [source,C] ---- struct t_gui_buffer *weechat_buffer = weechat_buffer_search_main (); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11074,18 +11074,18 @@ buffer = weechat.buffer_search_main() Effacer le contenu d'un tampon. -Prototype : +Prototype : [source,C] ---- void weechat_buffer_clear (struct t_gui_buffer *buffer); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon +* _buffer_ : pointeur vers le tampon -Exemple en C : +Exemple en C : [source,C] ---- @@ -11097,7 +11097,7 @@ if (my_buffer) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11114,18 +11114,18 @@ if buffer != "": Fermer un tampon. -Prototype : +Prototype : [source,C] ---- void weechat_buffer_close (struct t_gui_buffer *buffer); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon +* _buffer_ : pointeur vers le tampon -Exemple en C : +Exemple en C : [source,C] ---- @@ -11136,7 +11136,7 @@ struct t_gui_buffer *my_buffer = weechat_buffer_new ("mon_tampon", weechat_buffer_close (my_buffer); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11151,11 +11151,11 @@ weechat.buffer_close(buffer) ==== buffer_merge -Mélanger le tampon avec un autre tampon : les deux tampons continueront +Mélanger le tampon avec un autre tampon : les deux tampons continueront d'exister chacun de leur côté, mais avec le même numéro, et WeeChat affichera les lignes des deux tampons (lignes mélangées). -Prototype : +Prototype : [source,C] ---- @@ -11163,12 +11163,12 @@ void weechat_buffer_merge (struct t_gui_buffer *buffer, struct t_gui_buffer *target_buffer); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _target_buffer_ : tampon cible avec lequel on doit mélanger +* _buffer_ : pointeur vers le tampon +* _target_buffer_ : tampon cible avec lequel on doit mélanger -Exemple en C : +Exemple en C : [source,C] ---- @@ -11177,7 +11177,7 @@ weechat_buffer_merge (weechat_current_buffer (), weechat_buffer_search_main ()); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11193,7 +11193,7 @@ weechat.buffer_merge(weechat.current_buffer(), weechat.buffer_search_main()) Supprimer le mélange d'un tampon. -Prototype : +Prototype : [source,C] ---- @@ -11201,20 +11201,20 @@ void weechat_buffer_unmerge (struct t_gui_buffer *buffer, int number); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _number_ : numéro cible pour le tampon détaché, s'il est < 1, alors le tampon +* _buffer_ : pointeur vers le tampon +* _number_ : numéro cible pour le tampon détaché, s'il est < 1, alors le tampon sera déplacé vers le numéro du tampon + 1 -Exemple en C : +Exemple en C : [source,C] ---- weechat_buffer_unmerge (weechat_current_buffer (), 1); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11229,7 +11229,7 @@ weechat.buffer_unmerge(weechat.current_buffer(), 1) Retourner une valeur entière pour une propriété du tampon. -Prototype : +Prototype : [source,C] ---- @@ -11237,72 +11237,72 @@ int weechat_buffer_get_integer (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _property_ : nom de la propriété : -** _number_ : numéro du tampon (commence à 1) -** _layout_number_ : numéro du tampon sauvegardé dans le "layout" -** _layout_number_merge_order_ : ordre du tampon mélangé pour le "layout" -** _short_name_is_set_ : 1 si le nom court est défini, 0 si non défini -** _type_ : type de tampon (0 : formaté, 1 : contenu libre) -** _notify_ : niveau de notification du tampon -** _num_displayed_ : nombre de fenêtres affichant ce tampon -** _active_ : 2 si le tampon est le seul actif (mélangé), 1 si le tampon est +* _buffer_ : pointeur vers le tampon +* _property_ : nom de la propriété : +** _number_ : numéro du tampon (commence à 1) +** _layout_number_ : numéro du tampon sauvegardé dans le "layout" +** _layout_number_merge_order_ : ordre du tampon mélangé pour le "layout" +** _short_name_is_set_ : 1 si le nom court est défini, 0 si non défini +** _type_ : type de tampon (0 : formaté, 1 : contenu libre) +** _notify_ : niveau de notification du tampon +** _num_displayed_ : nombre de fenêtres affichant ce tampon +** _active_ : 2 si le tampon est le seul actif (mélangé), 1 si le tampon est actif, 0 si le tampon est mélangé et n'est pas sélectionné -** _hidden_ : 1 si le tampon est caché, sinon 0 +** _hidden_ : 1 si le tampon est caché, sinon 0 _(WeeChat ≥ 1.0)_ -** _zoomed_ : 1 si le tampon est mélangé et zoomé, sinon 0 +** _zoomed_ : 1 si le tampon est mélangé et zoomé, sinon 0 _(WeeChat ≥ 1.0)_ -** _print_hooks_enabled_ : 1 si les hooks "print" sont activés, sinon 0 -** _day_change_ : 1 si les messages de changement de jour sont affichés, sinon 0 +** _print_hooks_enabled_ : 1 si les hooks "print" sont activés, sinon 0 +** _day_change_ : 1 si les messages de changement de jour sont affichés, sinon 0 _(WeeChat ≥ 0.4.3)_ -** _clear_ : 1 si le tampon peut être effacé avec la commande `/buffer clear`, +** _clear_ : 1 si le tampon peut être effacé avec la commande `/buffer clear`, sinon 0 _(WeeChat ≥ 1.0)_ -** _filter_ : 1 si les filtres sont activés sur le tampon, sinon 0 +** _filter_ : 1 si les filtres sont activés sur le tampon, sinon 0 _(WeeChat ≥ 1.0)_ -** _lines_hidden_ : 1 si au moins une ligne est cachée dans le tampon +** _lines_hidden_ : 1 si au moins une ligne est cachée dans le tampon (filtrée), ou 0 si toutes les lignes sont affichées -** _prefix_max_length_ : longueur maximale du préfixe dans ce tampon -** _time_for_each_line_ : 1 si l'heure est affichée pour chaque ligne du tampon +** _prefix_max_length_ : longueur maximale du préfixe dans ce tampon +** _time_for_each_line_ : 1 si l'heure est affichée pour chaque ligne du tampon (par défaut), sinon 0 -** _nicklist_ : 1 si la liste de pseudos est activée, sinon 0 -** _nicklist_case_sensitive_ : 1 si les pseudos sont sensibles à la casse, +** _nicklist_ : 1 si la liste de pseudos est activée, sinon 0 +** _nicklist_case_sensitive_ : 1 si les pseudos sont sensibles à la casse, sinon 0 -** _nicklist_max_length_ : longueur maximale d'un pseudo -** _nicklist_display_groups_ : 1 si les groupes sont affichés, sinon 0 -** _nicklist_count_ : nombre de pseudos et groupes dans la liste de pseudos -** _nicklist_groups_count_ : nombre de groupes dans la liste de pseudos -** _nicklist_nicks_count_ : nombre de pseudos dans la liste de pseudos -** _nicklist_visible_count_ : nombre de pseudos/groupes affichés -** _input_ : 1 si la zone de saisie est activée, sinon 0 -** _input_get_unknown_commands_ : 1 si les commandes inconnues sont envoyées +** _nicklist_max_length_ : longueur maximale d'un pseudo +** _nicklist_display_groups_ : 1 si les groupes sont affichés, sinon 0 +** _nicklist_count_ : nombre de pseudos et groupes dans la liste de pseudos +** _nicklist_groups_count_ : nombre de groupes dans la liste de pseudos +** _nicklist_nicks_count_ : nombre de pseudos dans la liste de pseudos +** _nicklist_visible_count_ : nombre de pseudos/groupes affichés +** _input_ : 1 si la zone de saisie est activée, sinon 0 +** _input_get_unknown_commands_ : 1 si les commandes inconnues sont envoyées au "callback input", sinon 0 -** _input_size_ : taille de la zone de saisie (en octets) -** _input_length_ : longueur de la zone de saisie (nombre de caractères) -** _input_pos_ : position du curseur dans la zone de saisie -** _input_1st_display_ : premier caractère affiché à l'écran -** _num_history_ : nombre de commandes dans l'historique -** _text_search_ : type de recherche de texte : -*** 0 : pas de recherche en cours -*** 1 : recherche arrière (vers les messages les plus anciens) -*** 2 : recherche avant (vers les messages les plus récents) -** _text_search_exact_ : 1 si la recherche de texte est sensible à la casse -** _text_search_found_ : 1 si du texte a été trouvé, sinon 0 +** _input_size_ : taille de la zone de saisie (en octets) +** _input_length_ : longueur de la zone de saisie (nombre de caractères) +** _input_pos_ : position du curseur dans la zone de saisie +** _input_1st_display_ : premier caractère affiché à l'écran +** _num_history_ : nombre de commandes dans l'historique +** _text_search_ : type de recherche de texte : +*** 0 : pas de recherche en cours +*** 1 : recherche arrière (vers les messages les plus anciens) +*** 2 : recherche avant (vers les messages les plus récents) +** _text_search_exact_ : 1 si la recherche de texte est sensible à la casse +** _text_search_found_ : 1 si du texte a été trouvé, sinon 0 -Valeur de retour : +Valeur de retour : * valeur entière de la propriété -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "mon numéro de tampon est : %d", +weechat_printf (NULL, "mon numéro de tampon est : %d", weechat_buffer_get_integer (mon_tampon, "number")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11310,14 +11310,14 @@ Script (Python) : value = weechat.buffer_get_integer(buffer, property) # exemple -weechat.prnt("", "mon numéro de tampon est : %d" % weechat.buffer_get_integer(my_buffer, "number")) +weechat.prnt("", "mon numéro de tampon est : %d" % weechat.buffer_get_integer(my_buffer, "number")) ---- ==== buffer_get_string Retourner la valeur d'une propriété du tampon sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- @@ -11325,45 +11325,45 @@ const char *weechat_buffer_get_string (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _property_ : nom de la propriété : -** _plugin_ : nom de l'extension qui a créé ce tampon ("core" pour le tampon +* _buffer_ : pointeur vers le tampon +* _property_ : nom de la propriété : +** _plugin_ : nom de l'extension qui a créé ce tampon ("core" pour le tampon principal WeeChat) -** _name_ : nom du tampon -** _full_name_ : nom complet du tampon ("extension.nom") _(WeeChat ≥ 0.3.7)_ -** _short_name_ : nom court du tampon (note : utilisé pour l'affichage +** _name_ : nom du tampon +** _full_name_ : nom complet du tampon ("extension.nom") _(WeeChat ≥ 0.3.7)_ +** _short_name_ : nom court du tampon (note : utilisé pour l'affichage seulement et peut être changé par l'utilisateur, il ne doit pas être utilisé pour trouver le nom du tampon, utilisez à la place _name_, _full_name_ ou bien la variable locale _channel_) -** _title_ : titre du tampon -** _input_ : texte saisi -** _text_search_input_ : texte saisi sauvegardé avant la recherche de texte -** _highlight_words_ : liste des mots pour le highlight -** _highlight_regex_ : expression régulière POSIX étendue pour le highlight -** _highlight_tags_restrict_ : restreindre les highlights aux messages +** _title_ : titre du tampon +** _input_ : texte saisi +** _text_search_input_ : texte saisi sauvegardé avant la recherche de texte +** _highlight_words_ : liste des mots pour le highlight +** _highlight_regex_ : expression régulière POSIX étendue pour le highlight +** _highlight_tags_restrict_ : restreindre les highlights aux messages comportant ces étiquettes -** _highlight_tags_ : forcer le highlight pour les messages avec ces étiquettes -** _hotlist_max_level_nicks_ : niveau maximum pour la hotlist pour certains +** _highlight_tags_ : forcer le highlight pour les messages avec ces étiquettes +** _hotlist_max_level_nicks_ : niveau maximum pour la hotlist pour certains pseudos -** _localvar_xxx_ : contenu de la variable locale "xxx" (remplacer "xxx" par le +** _localvar_xxx_ : contenu de la variable locale "xxx" (remplacer "xxx" par le nom de la variable locale à lire) -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de chaîne -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "nom / nom court du tampon sont : %s / %s", +weechat_printf (NULL, "nom / nom court du tampon sont : %s / %s", weechat_buffer_get_string (my_buffer, "name"), weechat_buffer_get_string (my_buffer, "short_name")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11371,7 +11371,7 @@ Script (Python) : value = weechat.buffer_get_string(buffer, property) # exemple -weechat.prnt("", "nom / nom court du tampon sont : %s / %s" +weechat.prnt("", "nom / nom court du tampon sont : %s / %s" % (weechat.buffer_get_string(my_buffer, "name"), weechat.buffer_get_string(my_buffer, "short_name"))) ---- @@ -11380,7 +11380,7 @@ weechat.prnt("", "nom / nom court du tampon sont : %s / %s" Retourner la valeur d'une propriété sous forme d'un pointeur. -Prototype : +Prototype : [source,C] ---- @@ -11388,27 +11388,27 @@ void *weechat_buffer_pointer (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _property_ : nom de la propriété : -** _plugin_ : pointeur vers l'extension qui a créé le tampon (NULL pour le +* _buffer_ : pointeur vers le tampon +* _property_ : nom de la propriété : +** _plugin_ : pointeur vers l'extension qui a créé le tampon (NULL pour le tampon principal WeeChat) -** _highlight_regex_compiled_ : expression régulière _highlight_regex_ compilée +** _highlight_regex_compiled_ : expression régulière _highlight_regex_ compilée -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de pointeur -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "pointeur vers l'extension de mon tampon : %lx", +weechat_printf (NULL, "pointeur vers l'extension de mon tampon : %lx", weechat_buffer_get_pointer (mon_tampon, "plugin")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11416,14 +11416,14 @@ Script (Python) : value = weechat.buffer_get_pointer(buffer, property) # exemple -weechat.prnt("", "pointeur vers l'extension de mon tampon : %s" % weechat.buffer_get_pointer(my_buffer, "plugin")) +weechat.prnt("", "pointeur vers l'extension de mon tampon : %s" % weechat.buffer_get_pointer(my_buffer, "plugin")) ---- ==== buffer_set Affecter une valeur à une propriété d'un tampon. -Prototype : +Prototype : [source,C] ---- @@ -11431,13 +11431,13 @@ void weechat_buffer_set (struct t_gui_buffer *buffer, const char *property, const char *value); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _property_ : nom de la propriété (voir le tableau ci-dessous) -* _value_ : nouvelle valeur pour la propriété +* _buffer_ : pointeur vers le tampon +* _property_ : nom de la propriété (voir le tableau ci-dessous) +* _value_ : nouvelle valeur pour la propriété -Propriétés : +Propriétés : [width="100%",cols="^2,4,8",options="header"] |=== @@ -11445,31 +11445,31 @@ Propriétés : | hotlist | "+", "-", WEECHAT_HOTLIST_LOW, WEECHAT_HOTLIST_MESSAGE, WEECHAT_HOTLIST_PRIVATE, WEECHAT_HOTLIST_HIGHLIGHT, "-1" | - "+" : active la hotlist (option globale, le pointeur vers le tampon n'est pas + "+" : active la hotlist (option globale, le pointeur vers le tampon n'est pas utilisé) + - "-" : désactive la hotlist (option globale, le pointeur vers le tampon n'est + "-" : désactive la hotlist (option globale, le pointeur vers le tampon n'est pas utilisé) + - priorité : ajouter ce tampon dans la hotlist avec cette priorité + - "-1" : supprimer ce tampon de la hotlist _(WeeChat ≥ 1.0)_. + priorité : ajouter ce tampon dans la hotlist avec cette priorité + + "-1" : supprimer ce tampon de la hotlist _(WeeChat ≥ 1.0)_. | completion_freeze | "0" ou "1" | - "0" : pas de gel de la complétion (valeur par défaut) + "0" : pas de gel de la complétion (valeur par défaut) (option globale, le pointeur vers le tampon n'est pas utilisé) + - "1" : ne pas arrêter la complétion lorsque la ligne de commande est mise à + "1" : ne pas arrêter la complétion lorsque la ligne de commande est mise à jour (option globale, le pointeur vers le tampon n'est pas utilisé). | unread | - | Définit le marqueur de données non lues après la dernière ligne du tampon. | display | "1" ou "auto" | - "1" : basculer vers ce tampon dans la fenêtre active + - "auto" : basculer vers ce tampon dans la fenêtre active, le marqueur de + "1" : basculer vers ce tampon dans la fenêtre active + + "auto" : basculer vers ce tampon dans la fenêtre active, le marqueur de données non lues n'est pas réinitialisé. | hidden + _(WeeChat ≥ 1.0)_ | "0" ou "1" | - "0" : démasquer le tampon + - "1" : masquer le tampon. + "0" : démasquer le tampon + + "1" : masquer le tampon. | number | numéro | Déplace le tampon vers ce numéro. @@ -11481,12 +11481,12 @@ Propriétés : Change le nom court du tampon. | type | "formatted" ou "free" | - Définit le type de tampon : "formatted" (pour afficher les messages d'une + Définit le type de tampon : "formatted" (pour afficher les messages d'une discussion), ou "free" (pour du contenu libre); lorsque la valeur est "free", la propriété _clear_ est forcée à "0" _(WeeChat ≥ 1.0)_. | notify | "0", "1", "2", "3" | - Définit le niveau de notification du tampon : "0" = ne jamais ajouter à la + Définit le niveau de notification du tampon : "0" = ne jamais ajouter à la hotlist, "1" = ajouter pour les highlights seulement, "2" = ajouter pour les highlights et les messages, "3" = ajouter pour tous les messages. @@ -11503,13 +11503,13 @@ Propriétés : _(WeeChat ≥ 1.0)_ | "0" ou "1" | "0" pour empêcher l'utilisateur d'effacer le tampon avec la commande `/buffer clear`, "1" pour autoriser l'utilisateur à effacer le tampon (par - défaut pour un nouveau tampon) (note : même lorsque la valeur est "0", le + défaut pour un nouveau tampon) (note : même lorsque la valeur est "0", le tampon peut toujours être effacé avec la fonction <<_buffer_clear,buffer_clear>>). | filter + _(WeeChat ≥ 1.0)_ | "0" or "1" | - "0" : désactiver les filtres sur le tampon + - "1" : activer les filtres sur le tampon. + "0" : désactiver les filtres sur le tampon + + "1" : activer les filtres sur le tampon. | title | toute chaîne | Change le titre du tampon. @@ -11532,7 +11532,7 @@ Propriétés : | highlight_words | "-" ou une liste de mots séparés par des virgules | "-" est une valeur spéciale pour désactiver tout highlight sur ce tampon, ou - une liste de mots à mettre en valeur dans ce tampon, par exemple : + une liste de mots à mettre en valeur dans ce tampon, par exemple : "abc,def,ghi". | highlight_words_add | liste de mots séparés par des virgules | @@ -11549,17 +11549,17 @@ Propriétés : | highlight_tags_restrict | liste d'étiquettes séparées par des virgules | Restreindre les highlights aux messages avec ces étiquettes dans ce tampon (il est possible de combiner plusieurs étiquettes sous forme d'un "et" logique - avec le séparateur "+", par exemple : "nick_toto+irc_action"). + avec le séparateur "+", par exemple : "nick_toto+irc_action"). | highlight_tags | liste d'étiquettes séparées par des virgules | Forcer le highlight pour les messages avec ces étiquettes dans ce tampon (il est possible de combiner plusieurs étiquettes sous forme d'un "et" logique - avec le séparateur "+", par exemple : "nick_toto+irc_action"). + avec le séparateur "+", par exemple : "nick_toto+irc_action"). | hotlist_max_level_nicks | liste de "pseudo:niveau" séparés par des virgules | Liste de pseudos avec niveau max pour la hotlist sur ce tampon (le niveau peut - être : -1 : jamais dans la hotlist, 0 : faible, 1 : message, 2 : privé, - 3 : highlight), par exemple : "joe:2,mike:-1,robert:-1" (joe ne produira + être : -1 : jamais dans la hotlist, 0 : faible, 1 : message, 2 : privé, + 3 : highlight), par exemple : "joe:2,mike:-1,robert:-1" (joe ne produira jamais de highlight sur le tampon, mike et robert ne changeront jamais la hotlist). @@ -11597,7 +11597,7 @@ Propriétés : Supprime la variable locale _xxx_. |=== -Exemple en C : +Exemple en C : [source,C] ---- @@ -11617,7 +11617,7 @@ weechat_buffer_set (mon_tampon, "localvar_set_toto", "abc"); weechat_buffer_set (mon_tampon, "localvar_del_toto", NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11646,7 +11646,7 @@ weechat.buffer_set(my_buffer, "localvar_del_toto", "") Affecter un pointeur à une propriété d'un tampon. -Prototype : +Prototype : [source,C] ---- @@ -11654,25 +11654,25 @@ void weechat_buffer_set_pointer (struct t_gui_buffer *buffer, const char *proper void *pointer); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _property_ : nom de la propriété : -** _close_callback_ : définit la fonction "callback" de fermeture du tampon -** _close_callback_data_ : définit les données pour le "callback" de fermeture +* _buffer_ : pointeur vers le tampon +* _property_ : nom de la propriété : +** _close_callback_ : définit la fonction "callback" de fermeture du tampon +** _close_callback_data_ : définit les données pour le "callback" de fermeture du tampon -** _input_callback_ : définit la fonction de "callback" pour les données en +** _input_callback_ : définit la fonction de "callback" pour les données en entrée -** _input_callback_data_ : définit les données pour le "callback" des données +** _input_callback_data_ : définit les données pour le "callback" des données en entrée -** _nickcmp_callback_ : définit la fonction "callback" de comparaison de pseudos +** _nickcmp_callback_ : définit la fonction "callback" de comparaison de pseudos (ce "callback" est appelé lors de la recherche d'un pseudo dans la liste des pseudos) _(WeeChat ≥ 0.3.9)_ -** _nickcmp_callback_data_ : définit les données pour le "callback" de +** _nickcmp_callback_data_ : définit les données pour le "callback" de comparaison de pseudos _(WeeChat ≥ 0.3.9)_ -* _pointer_ : nouvelle valeur de pointeur pour la propriété +* _pointer_ : nouvelle valeur de pointeur pour la propriété -Prototypes pour les "callbacks" : +Prototypes pour les "callbacks" : [source,C] ---- @@ -11687,7 +11687,7 @@ int nickcmp_callback (const void *pointer, void *data, const char *nick1, const char *nick2); ---- -Exemple en C : +Exemple en C : [source,C] ---- @@ -11709,7 +11709,7 @@ Cette fonction n'est pas disponible dans l'API script. Remplacer les variables locales dans une chaîne par leurs valeurs, en utilisant les variables locales du tampon. -Prototype : +Prototype : [source,C] ---- @@ -11717,16 +11717,16 @@ char *weechat_buffer_string_replace_local_var (struct t_gui_buffer *buffer, const char *string); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _string_ : chaîne avec du texte et des variables locales, au format "$var" +* _buffer_ : pointeur vers le tampon +* _string_ : chaîne avec du texte et des variables locales, au format "$var" -Valeur de retour : +Valeur de retour : * chaîne avec les valeurs des variables locales -Exemple en C : +Exemple en C : [source,C] ---- @@ -11737,7 +11737,7 @@ char *str = weechat_buffer_string_replace_local_var (mon_tampon, /* str contient "test avec abc" */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11756,26 +11756,26 @@ _WeeChat ≥ 0.3.5._ Vérifier si le tampon correspond à la liste de tampons. -Prototype : +Prototype : [source,C] ---- int weechat_buffer_match_list (struct t_gui_buffer *buffer, const char *string); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _string_ : liste de tampons, séparés par des virgules : +* _buffer_ : pointeur vers le tampon +* _string_ : liste de tampons, séparés par des virgules : ** `+*+` signifie tous les tampons ** un nom commençant par `+!+` est exclu ** le caractère joker `+*+` est autorisé dans le nom -Valeur de retour : +Valeur de retour : * 1 si le tampon correspond à la liste de tampons, 0 sinon -Exemple en C : +Exemple en C : [source,C] ---- @@ -11789,7 +11789,7 @@ if (buffer) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11814,25 +11814,25 @@ Fonctions pour interroger les fenêtres. Retourner le pointeur vers la fenêtre courante. -Prototype : +Prototype : [source,C] ---- struct t_gui_window *weechat_current_window (); ---- -Valeur de retour : +Valeur de retour : * pointeur vers la fenêtre courante -Exemple en C : +Exemple en C : [source,C] ---- struct t_gui_window *current_window = weechat_current_window (); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11849,32 +11849,32 @@ _WeeChat ≥ 0.3.5._ Retourner le pointeur vers la fenêtre affichant un tampon. -Prototype : +Prototype : [source,C] ---- struct t_gui_window *weechat_window_search_with_buffer (struct t_gui_buffer *buffer); ---- -Paramètre : +Paramètre : -* _buffer_ : pointeur vers le tampon +* _buffer_ : pointeur vers le tampon -Valeur de retour : +Valeur de retour : * pointeur vers la fenêtre affichant un tampon (NULL si aucune fenêtre n'affiche ce tampon) -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (NULL, - "fenêtre affichant le tampon core : %lx", + "fenêtre affichant le tampon core : %lx", weechat_window_search_with_buffer (weechat_buffer_search_main ())); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11882,7 +11882,7 @@ Script (Python) : window = weechat.window_search_with_buffer(buffer) # exemple -weechat.prnt("", "fenêtre affichant le tampon core : %s" +weechat.prnt("", "fenêtre affichant le tampon core : %s" % weechat.window_search_with_buffer(weechat.buffer_search_main())) ---- @@ -11890,7 +11890,7 @@ weechat.prnt("", "fenêtre affichant le tampon core : %s" Retourner la valeur entière d'une propriété de la fenêtre. -Prototype : +Prototype : [source,C] ---- @@ -11898,50 +11898,50 @@ int weechat_window_get_integer (struct t_gui_window *window, const char *property); ---- -Paramètres : +Paramètres : -* _window_ : pointeur vers la fenêtre -* _property_ : nom de la propriété : -** _number_ : numéro de la fenêtre (commence à 1) -** _win_x_ : position X de la fenêtre dans le terminal (la première colonne est +* _window_ : pointeur vers la fenêtre +* _property_ : nom de la propriété : +** _number_ : numéro de la fenêtre (commence à 1) +** _win_x_ : position X de la fenêtre dans le terminal (la première colonne est 0) -** _win_y_ : position Y de la fenêtre dans le terminal (la première ligne est +** _win_y_ : position Y de la fenêtre dans le terminal (la première ligne est 0) -** _win_width_ : largeur de la fenêtre, en caractères -** _win_height_ : hauteur de la fenêtre, en caractères -** _win_width_pct_ : taille en pourcentage, en comparaison avec la fenêtre +** _win_width_ : largeur de la fenêtre, en caractères +** _win_height_ : hauteur de la fenêtre, en caractères +** _win_width_pct_ : taille en pourcentage, en comparaison avec la fenêtre parente (par exemple 50 indique une largeur de moitié) -** _win_height_pct_ : taille en pourcentage, en comparaison avec la fenêtre +** _win_height_pct_ : taille en pourcentage, en comparaison avec la fenêtre parente (par exemple 50 indique une hauteur de moitié) -** _win_chat_x_ : position X de la fenêtre de discussion ("chat") dans le +** _win_chat_x_ : position X de la fenêtre de discussion ("chat") dans le terminal (la première colonne est 0) -** _win_chat_y_ : position Y de la fenêtre de discussion ("chat") dans le +** _win_chat_y_ : position Y de la fenêtre de discussion ("chat") dans le terminal (la première ligne est 0) -** _win_chat_width_ : largeur de la fenêtre de discussion ("chat"), en +** _win_chat_width_ : largeur de la fenêtre de discussion ("chat"), en caractères -** _win_chat_height_ : hauteur de la fenêtre de discussion ("chat"), en +** _win_chat_height_ : hauteur de la fenêtre de discussion ("chat"), en caractères -** _first_line_displayed_ : 1 si la première du tampon est affichée à l'écran, +** _first_line_displayed_ : 1 si la première du tampon est affichée à l'écran, sinon 0 -** _scrolling_ : 1 s'il y a un défilement en cours dans la fenêtre (la dernière +** _scrolling_ : 1 s'il y a un défilement en cours dans la fenêtre (la dernière ligne n'est pas affichée) -** _lines_after_ : nombre de lignes non affichées après la dernière ligne +** _lines_after_ : nombre de lignes non affichées après la dernière ligne affichée (lors d'un défilement) -Valeur de retour : +Valeur de retour : * valeur entière de la propriété -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "la fenêtre courante est en position (x,y) : (%d,%d)", +weechat_printf (NULL, "la fenêtre courante est en position (x,y) : (%d,%d)", weechat_window_get_integer (weechat_current_window (), "win_x"), weechat_window_get_integer (weechat_current_window (), "win_y")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -11949,7 +11949,7 @@ Script (Python) : value = weechat.window_get_integer(window, property) # exemple -weechat.prnt("", "la fenêtre courante est en position (x,y) : (%d,%d)" +weechat.prnt("", "la fenêtre courante est en position (x,y) : (%d,%d)" % (weechat.window_get_integer(weechat.current_window(), "win_x"), weechat.window_get_integer(weechat.current_window(), "win_y"))) ---- @@ -11962,7 +11962,7 @@ Retourner la valeur d'une propriété de la fenêtre sous forme d'une chaîne. Cette fonction n'est pas utilisée aujourd'hui, elle est réservée pour une version future. -Prototype : +Prototype : [source,C] ---- @@ -11970,12 +11970,12 @@ int weechat_window_get_string (struct t_gui_window *window, const char *property); ---- -Paramètres : +Paramètres : -* _window_ : pointeur vers la fenêtre -* _property_ : nom de la propriété +* _window_ : pointeur vers la fenêtre +* _property_ : nom de la propriété -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de chaîne @@ -11983,7 +11983,7 @@ Valeur de retour : Retourner la valeur d'une propriété, sous forme d'un pointeur. -Prototype : +Prototype : [source,C] ---- @@ -11991,27 +11991,27 @@ void *weechat_window_get_pointer (struct t_gui_window *window, const char *property); ---- -Paramètres : +Paramètres : -* _window_ : pointeur vers la fenêtre -* _property_ : nom de la propriété : -** _current_ : pointeur vers la fenêtre courante -** _buffer_ : pointeur vers le tampon affiché par la fenêtre +* _window_ : pointeur vers la fenêtre +* _property_ : nom de la propriété : +** _current_ : pointeur vers la fenêtre courante +** _buffer_ : pointeur vers le tampon affiché par la fenêtre -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de pointeur -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (NULL, - "tampon affiché dans la fenêtre courante : %lx", + "tampon affiché dans la fenêtre courante : %lx", weechat_window_get_pointer (weechat_current_window (), "buffer")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12019,7 +12019,7 @@ Script (Python) : value = weechat.window_get_pointer(window, property) # exemple -weechat.prnt("", "tampon affiché dans la fenêtre courante : %s" +weechat.prnt("", "tampon affiché dans la fenêtre courante : %s" % weechat.window_get_pointer(weechat.current_window(), "buffer")) ---- @@ -12027,27 +12027,27 @@ weechat.prnt("", "tampon affiché dans la fenêtre courante : %s" Définir le titre du terminal. -Prototype : +Prototype : [source,C] ---- void weechat_window_set_title (const char *title); ---- -Paramètres : +Paramètres : -* _title_ : nouveau titre pour le terminal (NULL pour réinitialiser le titre) ; +* _title_ : nouveau titre pour le terminal (NULL pour réinitialiser le titre) ; la chaîne est évaluée, donc les variables comme `${info:version}` peuvent être utilisées (voir <<_string_eval_expression,string_eval_expression>>) -Exemple en C : +Exemple en C : [source,C] ---- weechat_window_set_title ("nouveau titre ici"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12067,7 +12067,7 @@ Fonctions pour la liste des pseudos. Ajouter un groupe dans la liste des pseudos. -Prototype : +Prototype : [source,C] ---- @@ -12078,35 +12078,35 @@ struct t_gui_nick_group *weechat_nicklist_add_group (struct t_gui_buffer *buffer int visible); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _parent_group_ : pointeur vers le parent du groupe, NULL si le groupe n'a pas +* _buffer_ : pointeur vers le tampon +* _parent_group_ : pointeur vers le parent du groupe, NULL si le groupe n'a pas de parent (racine de la liste des pseudos) -* _name_ : nom du groupe -* _color_ : nom de l'option contenant la couleur : +* _name_ : nom du groupe +* _color_ : nom de l'option contenant la couleur : ** une option WeeChat, par exemple _weechat.color.nicklist_group_ ** une couleur avec un fond optionnel, par exemple _yellow_ ou _yellow,red_ -** nom d'une couleur de barre : -*** _bar_fg_ : couleur de texte pour la barre -*** _bar_delim_ : couleur des délimiteurs pour la barre -*** _bar_bg_ : couleur de fond pour la barre -* _visible_ : -** _1_ : le groupe et ses sous-groupes/pseudos sont visibles -** _0_ : le groupe et ses sous-groupes/pseudos sont cachés +** nom d'une couleur de barre : +*** _bar_fg_ : couleur de texte pour la barre +*** _bar_delim_ : couleur des délimiteurs pour la barre +*** _bar_bg_ : couleur de fond pour la barre +* _visible_ : +** _1_ : le groupe et ses sous-groupes/pseudos sont visibles +** _0_ : le groupe et ses sous-groupes/pseudos sont cachés [NOTE] Le nom du groupe peut commencer par un ou plusieurs chiffres, suivis d'un pipe ("|"), puis du nom du groupe. Quand une telle chaîne est trouvée au début, elle est utilisée pour trier les groupes dans la liste des pseudos. Par exemple les -groupes "1|test" et "2|abc" seront affichés dans cet ordre : "test" en premier, +groupes "1|test" et "2|abc" seront affichés dans cet ordre : "test" en premier, puis "abc" en second. -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau groupe, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -12118,7 +12118,7 @@ struct t_gui_nick_group *my_group = 1); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12134,7 +12134,7 @@ group = weechat.nicklist_add_group(my_buffer, my_parent_group, "groupe_test", Rechercher un groupe dans la liste des pseudos. -Prototype : +Prototype : [source,C] ---- @@ -12143,18 +12143,18 @@ struct t_gui_nick_group *weechat_nicklist_search_group (struct t_gui_buffer *buf const char *name); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _from_group_ : recherche depuis ce groupe seulement, si NULL, alors recherche +* _buffer_ : pointeur vers le tampon +* _from_group_ : recherche depuis ce groupe seulement, si NULL, alors recherche dans toute la liste des pseudos -* _name_ : nom du groupes à rechercher +* _name_ : nom du groupes à rechercher -Valeur de retour : +Valeur de retour : * pointeur vers le groupe trouvé, NULL s'il n'est pas trouvé -Exemple en C : +Exemple en C : [source,C] ---- @@ -12162,7 +12162,7 @@ struct t_gui_nick_group *ptr_group = weechat_nicklist_search_group (my_buffer, NULL, "groupe_test"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12177,7 +12177,7 @@ group = weechat.nicklist_search_group(my_buffer, "", "groupe_test") Ajouter un pseudo dans un groupe. -Prototype : +Prototype : [source,C] ---- @@ -12190,35 +12190,35 @@ struct t_gui_nick_group *weechat_nicklist_add_nick (struct t_gui_buffer *buffer, int visible); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _group_ : pointeur vers le groupe -* _name_ : nom du pseudo -* _color_ : nom de l'option contenant la couleur pour le pseudo : +* _buffer_ : pointeur vers le tampon +* _group_ : pointeur vers le groupe +* _name_ : nom du pseudo +* _color_ : nom de l'option contenant la couleur pour le pseudo : ** une option WeeChat, par exemple _weechat.color.nicklist_group_ ** une couleur avec un fond optionnel, par exemple _yellow_ ou _yellow,red_ -** nom d'une couleur de barre : -*** _bar_fg_ : couleur de texte pour la barre -*** _bar_delim_ : couleur des délimiteurs pour la barre -*** _bar_bg_ : couleur de fond pour la barre -* _prefix_ : préfixe affiché avant le pseudo -* _prefix_color_ : nom de l'option contenant la couleur pour le préfixe : +** nom d'une couleur de barre : +*** _bar_fg_ : couleur de texte pour la barre +*** _bar_delim_ : couleur des délimiteurs pour la barre +*** _bar_bg_ : couleur de fond pour la barre +* _prefix_ : préfixe affiché avant le pseudo +* _prefix_color_ : nom de l'option contenant la couleur pour le préfixe : ** une option WeeChat, par exemple _weechat.color.nicklist_group_ ** une couleur avec un fond optionnel, par exemple _yellow_ ou _yellow,red_ -** nom d'une couleur de barre : -*** _bar_fg_ : couleur de texte pour la barre -*** _bar_delim_ : couleur des délimiteurs pour la barre -*** _bar_bg_ : couleur de fond pour la barre -* _visible_ : -** _1_ : le pseudo est visible -** _0_ : le pseudo est caché +** nom d'une couleur de barre : +*** _bar_fg_ : couleur de texte pour la barre +*** _bar_delim_ : couleur des délimiteurs pour la barre +*** _bar_bg_ : couleur de fond pour la barre +* _visible_ : +** _1_ : le pseudo est visible +** _0_ : le pseudo est caché -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau pseudo, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -12230,7 +12230,7 @@ struct t_gui_nick *my_nick = 1); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12249,7 +12249,7 @@ nick = weechat.nicklist_add_nick(my_buffer, my_group, "test_nick", color, "@", " Rechercher un pseudo dans la liste des pseudos. -Prototype : +Prototype : [source,C] ---- @@ -12258,18 +12258,18 @@ struct t_gui_nick *weechat_nicklist_search_nick (struct t_gui_buffer *buffer, const char *name); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _from_group_ : recherche depuis ce groupe seulement, si NULL, alors recherche +* _buffer_ : pointeur vers le tampon +* _from_group_ : recherche depuis ce groupe seulement, si NULL, alors recherche dans toute la liste des pseudos -* _name_ : nom du pseudo à rechercher +* _name_ : nom du pseudo à rechercher -Valeur de retour : +Valeur de retour : * pointeur vers le pseudo trouvé, NULL s'il n'est pas trouvé -Exemple en C : +Exemple en C : [source,C] ---- @@ -12277,7 +12277,7 @@ struct t_gui_nick *ptr_nick = weechat_nicklist_search_nick (my_buffer, NULL, "test_nick"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12292,7 +12292,7 @@ nick = weechat.nicklist_search_nick(my_buffer, "", "test_nick") Supprimer un groupe de la liste des pseudos. -Prototype : +Prototype : [source,C] ---- @@ -12300,20 +12300,20 @@ void weechat_nicklist_remove_group (struct t_gui_buffer *buffer, struct t_gui_nick_group *group); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _group_ : pointeur vers le groupe à supprimer (tous les sous-groupes/pseudos +* _buffer_ : pointeur vers le tampon +* _group_ : pointeur vers le groupe à supprimer (tous les sous-groupes/pseudos seront supprimés également) -Exemple en C : +Exemple en C : [source,C] ---- weechat_nicklist_remove_group (my_buffer, my_group); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12328,7 +12328,7 @@ weechat.nicklist_remove_group(my_buffer, my_group) Supprimer un pseudo de la liste des pseudos. -Prototype : +Prototype : [source,C] ---- @@ -12336,19 +12336,19 @@ void weechat_nicklist_remove_nick (struct t_gui_buffer *buffer, struct t_gui_nick *nick); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _nick_ : pointeur vers le pseudo à supprimer +* _buffer_ : pointeur vers le tampon +* _nick_ : pointeur vers le pseudo à supprimer -Exemple en C : +Exemple en C : [source,C] ---- weechat_nicklist_remove_nick (my_buffer, my_nick); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12363,25 +12363,25 @@ weechat.nicklist_remove_nick(my_buffer, my_nick) Supprimer tous les groupes/pseudos de la liste des pseudos. -Prototype : +Prototype : [source,C] ---- void weechat_nicklist_remove_all (struct t_gui_buffer *buffer); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon +* _buffer_ : pointeur vers le tampon -Exemple en C : +Exemple en C : [source,C] ---- weechat_nicklist_remove_all (my_buffer); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12399,7 +12399,7 @@ _WeeChat ≥ 0.3.7._ Retourner le prochain groupe ou pseudo de la liste des pseudos (utilisé principalement pour afficher la liste des pseudos). -Prototype : +Prototype : [source,C] ---- @@ -12408,13 +12408,13 @@ void weechat_nicklist_get_next_item (struct t_gui_buffer *buffer, struct t_gui_nick **nick); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _group_ : pointeur vers un pointeur sur le groupe -* _nick_ : pointeur vers un pointeur sur le pseudo +* _buffer_ : pointeur vers le tampon +* _group_ : pointeur vers un pointeur sur le groupe +* _nick_ : pointeur vers un pointeur sur le pseudo -Exemple en C : +Exemple en C : [source,C] ---- @@ -12449,7 +12449,7 @@ _WeeChat ≥ 0.3.4._ Retourner une valeur entière pour une propriété du groupe. -Prototype : +Prototype : [source,C] ---- @@ -12458,26 +12458,26 @@ int weechat_nicklist_group_get_integer (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _group_ : pointeur vers le groupe -* _property_ : nom de la propriété : -** _visible_ : 1 si le groupe est visible, sinon 0 -** _level_ : niveau du groupe (la racine est 0) +* _buffer_ : pointeur vers le tampon +* _group_ : pointeur vers le groupe +* _property_ : nom de la propriété : +** _visible_ : 1 si le groupe est visible, sinon 0 +** _level_ : niveau du groupe (la racine est 0) -Valeur de retour : +Valeur de retour : * valeur entière de la propriété -Exemple en C : +Exemple en C : [source,C] ---- int visible = weechat_nicklist_group_get_integer (buffer, group, "visible"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12494,7 +12494,7 @@ _WeeChat ≥ 0.3.4._ Retourner la valeur d'une propriété du groupe sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- @@ -12503,26 +12503,26 @@ const char *weechat_nicklist_group_get_string (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _group_ : pointeur vers le groupe -* _property_ : nom de la propriété : -** _name_ : nom du groupe -** _color_ : couleur du groupe dans la liste des pseudos +* _buffer_ : pointeur vers le tampon +* _group_ : pointeur vers le groupe +* _property_ : nom de la propriété : +** _name_ : nom du groupe +** _color_ : couleur du groupe dans la liste des pseudos -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de chaîne -Exemple en C : +Exemple en C : [source,C] ---- const char *color = weechat_nicklist_group_get_string (buffer, group, "color"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12539,7 +12539,7 @@ _WeeChat ≥ 0.3.4._ Retourner la valeur d'une propriété du groupe sous forme d'un pointeur. -Prototype : +Prototype : [source,C] ---- @@ -12548,25 +12548,25 @@ void *weechat_nicklist_group_get_pointer (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _group_ : pointeur vers le groupe -* _property_ : nom de la propriété : -** _parent_ : pointeur vers le groupe parent +* _buffer_ : pointeur vers le tampon +* _group_ : pointeur vers le groupe +* _property_ : nom de la propriété : +** _parent_ : pointeur vers le groupe parent -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de pointeur -Exemple en C : +Exemple en C : [source,C] ---- struct t_gui_nick_group *parent = weechat_nicklist_group_get_pointer (buffer, group, "parent"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12583,7 +12583,7 @@ _WeeChat ≥ 0.3.4._ Affecter une valeur à une propriété d'un groupe. -Prototype : +Prototype : [source,C] ---- @@ -12593,14 +12593,14 @@ void weechat_nicklist_group_set (struct t_gui_buffer *buffer, const char *value); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _group_ : pointeur vers le groupe -* _property_ : nom de la propriété (voir le tableau ci-dessous) -* _value_ : nouvelle valeur pour la propriété +* _buffer_ : pointeur vers le tampon +* _group_ : pointeur vers le groupe +* _property_ : nom de la propriété (voir le tableau ci-dessous) +* _value_ : nouvelle valeur pour la propriété -Propriétés : +Propriétés : [width="100%",cols="^2,4,8",options="header"] |=== @@ -12614,7 +12614,7 @@ Propriétés : "0" = groupe caché, "1" = groupe visible. |=== -Exemples en C : +Exemples en C : [source,C] ---- @@ -12628,7 +12628,7 @@ weechat_nicklist_group_set (buffer, group, "color", "yellow"); weechat_nicklist_group_set (buffer, group, "visible", "0"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12653,7 +12653,7 @@ _WeeChat ≥ 0.3.4._ Retourner une valeur entière pour une propriété du pseudo. -Prototype : +Prototype : [source,C] ---- @@ -12662,25 +12662,25 @@ int weechat_nicklist_nick_get_integer (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _nick_ : pointeur vers le pseudo -* _property_ : nom de la propriété : -** _visible_ : 1 si le pseudo est visible, sinon 0 +* _buffer_ : pointeur vers le tampon +* _nick_ : pointeur vers le pseudo +* _property_ : nom de la propriété : +** _visible_ : 1 si le pseudo est visible, sinon 0 -Valeur de retour : +Valeur de retour : * valeur entière de la propriété -Exemple en C : +Exemple en C : [source,C] ---- int visible = weechat_nicklist_nick_get_integer (buffer, nick, "visible"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12697,7 +12697,7 @@ _WeeChat ≥ 0.3.4._ Retourner la valeur d'une propriété du pseudo sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- @@ -12706,28 +12706,28 @@ const char *weechat_nicklist_nick_get_string (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _nick_ : pointeur vers le pseudo -* _property_ : nom de la propriété : -** _name_ : nom du pseudo -** _color_ : couleur du pseudo dans la liste des pseudos -** _prefix_ : préfixe du pseudo -** _prefix_color_ : couleur du préfixe dans la liste des pseudos +* _buffer_ : pointeur vers le tampon +* _nick_ : pointeur vers le pseudo +* _property_ : nom de la propriété : +** _name_ : nom du pseudo +** _color_ : couleur du pseudo dans la liste des pseudos +** _prefix_ : préfixe du pseudo +** _prefix_color_ : couleur du préfixe dans la liste des pseudos -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de chaîne -Exemple en C : +Exemple en C : [source,C] ---- const char *color = weechat_nicklist_nick_get_string (buffer, nick, "color"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12744,7 +12744,7 @@ _WeeChat ≥ 0.3.4._ Retourner la valeur d'une propriété du pseudo sous forme d'un pointeur. -Prototype : +Prototype : [source,C] ---- @@ -12753,25 +12753,25 @@ void *weechat_nicklist_nick_get_pointer (struct t_gui_buffer *buffer, const char *property); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _nick_ : pointeur vers le pseudo -* _property_ : nom de la propriété : -** _group_ : pointeur vers le groupe contenant ce pseudo +* _buffer_ : pointeur vers le tampon +* _nick_ : pointeur vers le pseudo +* _property_ : nom de la propriété : +** _group_ : pointeur vers le groupe contenant ce pseudo -Valeur de retour : +Valeur de retour : * valeur de la propriété, sous forme de pointeur -Exemple en C : +Exemple en C : [source,C] ---- struct t_gui_nick_group *group = weechat_nicklist_nick_get_pointer (buffer, nick, "group"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12788,7 +12788,7 @@ _WeeChat ≥ 0.3.4._ Affecter une valeur à une propriété d'un pseudo. -Prototype : +Prototype : [source,C] ---- @@ -12798,14 +12798,14 @@ void weechat_nicklist_nick_set (struct t_gui_buffer *buffer, const char *value); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon -* _nick_ : pointeur vers le pseudo -* _property_ : nom de la propriété (voir le tableau ci-dessous) -* _value_ : nouvelle valeur pour la propriété +* _buffer_ : pointeur vers le tampon +* _nick_ : pointeur vers le pseudo +* _property_ : nom de la propriété (voir le tableau ci-dessous) +* _value_ : nouvelle valeur pour la propriété -Propriétés : +Propriétés : [width="100%",cols="^2,4,8",options="header"] |=== @@ -12826,7 +12826,7 @@ Propriétés : "0" = pseudo caché, "1" = pseudo visible. |=== -Exemples en C : +Exemples en C : [source,C] ---- @@ -12843,7 +12843,7 @@ weechat_nicklist_nick_set (buffer, nick, "prefix_color", "yellow"); weechat_nicklist_nick_set (buffer, nick, "visible", "0"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12874,29 +12874,29 @@ Fonctions pour les barres. Rechercher un objet de barre. -Prototype : +Prototype : [source,C] ---- struct t_gui_bar_item *weechat_bar_item_search (const char *name); ---- -Paramètres : +Paramètres : -* _name_ : nom de l'objet de barre +* _name_ : nom de l'objet de barre -Valeur de retour : +Valeur de retour : * pointeur vers l'objet de barre trouvé, NULL s'il n'a pas été trouvé -Exemple en C : +Exemple en C : [source,C] ---- struct t_gui_bar_item *bar_item = weechat_bar_item_search ("myitem"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -12913,7 +12913,7 @@ _Mis à jour dans la 0.4.2, 1.5._ Créer un nouvel objet de barre. -Prototype : +Prototype : [source,C] ---- @@ -12928,34 +12928,34 @@ struct t_gui_bar_item *weechat_bar_item_new (const char *name, void *build_callback_data); ---- -Paramètres : +Paramètres : -* _name_ : nom de l'objet de barre -* _build_callback_ : fonction appelée lorsque l'objet est construit, paramètres - et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_gui_bar_item *item_ : pointeur vers l'objet de barre -** _struct t_gui_window *window_ : pointeur vers la fenêtre (NULL lors d'un +* _name_ : nom de l'objet de barre +* _build_callback_ : fonction appelée lorsque l'objet est construit, paramètres + et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_gui_bar_item *item_ : pointeur vers l'objet de barre +** _struct t_gui_window *window_ : pointeur vers la fenêtre (NULL lors d'un appel pour une barre "root") -** _struct t_gui_buffer *buffer_ : tampon affiché dans la fenêtre (si la fenêtre +** _struct t_gui_buffer *buffer_ : tampon affiché dans la fenêtre (si la fenêtre est NULL alors c'est le tampon courant) ou tampon passé dans l'objet de - barre avec la syntaxe : "@buffer:item" _(WeeChat ≥ 0.4.2)_ -** _struct t_hashtable *extra_info_ : toujours NULL (le paramètre est réservé + barre avec la syntaxe : "@buffer:item" _(WeeChat ≥ 0.4.2)_ +** _struct t_hashtable *extra_info_ : toujours NULL (le paramètre est réservé pour une version future) _(WeeChat ≥ 0.4.2)_ -** valeur de retour : contenu de l'objet de barre -* _build_callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé +** valeur de retour : contenu de l'objet de barre +* _build_callback_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _build_callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _build_callback_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque l'objet de barre est supprimé -Valeur de retour : +Valeur de retour : * pointeur vers le nouvel objet de barre, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -12974,11 +12974,11 @@ struct t_gui_bar_item *my_item = weechat_bar_item_new ("myitem", NULL, NULL); ---- -Script (Python) : +Script (Python) : [IMPORTANT] Pour la compatibilité avec les versions ≤ 0.4.1, le "callback" par défaut a -seulement 3 paramètres : _data_, _item_ et _window_ (pas de _buffer_ et +seulement 3 paramètres : _data_, _item_ et _window_ (pas de _buffer_ et _extra_info_). + Pour utiliser le callback avec tous les paramètres, vous devez ajouter "(extra)" avant le nom, voir l'exemple ci-dessous (supporté seulement dans @@ -13007,25 +13007,25 @@ bar_item2 = weechat.bar_item_new("(extra)myitem2", "my_build_callback2", "") # Mettre à jour le contenu d'un objet de barre, en appelant son "callback" de construction. -Prototype : +Prototype : [source,C] ---- void weechat_bar_item_update (const char *name); ---- -Paramètres : +Paramètres : -* _name_ : nom de l'objet de barre +* _name_ : nom de l'objet de barre -Exemple en C : +Exemple en C : [source,C] ---- weechat_bar_item_update ("myobjet"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13040,25 +13040,25 @@ weechat.bar_item_update("myitem") Supprimer un objet de barre. -Prototype : +Prototype : [source,C] ---- void weechat_bar_item_remove (struct t_gui_bar_item *item); ---- -Paramètres : +Paramètres : -* _item_ : bar item pointer +* _item_ : bar item pointer -Exemple en C : +Exemple en C : [source,C] ---- weechat_bar_item_remove (&my_item); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13073,29 +13073,29 @@ weechat.bar_item_remove(myitem) Rechercher une barre. -Prototype : +Prototype : [source,C] ---- struct t_gui_bar *weechat_bar_search (const char *name); ---- -Paramètres : +Paramètres : -* _name_ : nom de la barre +* _name_ : nom de la barre -Valeur de retour : +Valeur de retour : * pointeur vers la barre trouvée, NULL si elle n'est pas trouvée -Exemple en C : +Exemple en C : [source,C] ---- struct t_gui_bar *bar = weechat_bar_search ("my_barre"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13110,7 +13110,7 @@ bar = weechat.bar_search("mybar") Créer une nouvelle barre. -Prototype : +Prototype : [source,C] ---- @@ -13131,59 +13131,59 @@ struct t_gui_bar *weechat_bar_new (const char *name, const char *items); ---- -Paramètres : +Paramètres : -* _name_ : nom de la barre -* _hidden_ : -** _on_ : la barre est cachée -** _off_ : la barre est visible -* _priority_ : priorité de la barre (nombre entier) -* _type_ : -** _root_ : la barre est affichée une seule fois, hors des fenêtres -** _window_ : la barre est affichée dans chaque fenêtre -* _condition_ : condition pour afficher la barre : -** _active_ : la barre est affichée dans la fenêtre active seulement -** _inactive_ : la barre est affichée dans les fenêtres inactives seulement -** _nicklist_ : la barre est affichée dans les fenêtres possédant une liste des +* _name_ : nom de la barre +* _hidden_ : +** _on_ : la barre est cachée +** _off_ : la barre est visible +* _priority_ : priorité de la barre (nombre entier) +* _type_ : +** _root_ : la barre est affichée une seule fois, hors des fenêtres +** _window_ : la barre est affichée dans chaque fenêtre +* _condition_ : condition pour afficher la barre : +** _active_ : la barre est affichée dans la fenêtre active seulement +** _inactive_ : la barre est affichée dans les fenêtres inactives seulement +** _nicklist_ : la barre est affichée dans les fenêtres possédant une liste des pseudos -** expression évaluée : voir le chapitre sur les barres dans le +** expression évaluée : voir le chapitre sur les barres dans le _Guide utilisateur WeeChat_ -* _position_ : _top_ (en haut), _bottom_ (en bas), _left_ (à gauche) ou _right_ +* _position_ : _top_ (en haut), _bottom_ (en bas), _left_ (à gauche) ou _right_ (à droite) -* _filling_top_bottom_ : -** _horizontal_ : les objets sont remplis horizontalement (avec un espace +* _filling_top_bottom_ : +** _horizontal_ : les objets sont remplis horizontalement (avec un espace entre chaque objet) -** _vertical_ : les objets sont remplis verticalement (avec une nouvelle ligne +** _vertical_ : les objets sont remplis verticalement (avec une nouvelle ligne entre chaque objet) -** _columns_horizontal_ : les objets sont remplis horizontalement, affichés +** _columns_horizontal_ : les objets sont remplis horizontalement, affichés sous forme de colonnes -** _columns_vertical_ : les objets sont remplis verticalement, affichés sous +** _columns_vertical_ : les objets sont remplis verticalement, affichés sous forme de colonnes -* _filling_left_right_ : -** _horizontal_ : les objets sont remplis horizontalement (avec un espace +* _filling_left_right_ : +** _horizontal_ : les objets sont remplis horizontalement (avec un espace entre chaque objet) -** _vertical_ : les objets sont remplis verticalement (avec une nouvelle ligne +** _vertical_ : les objets sont remplis verticalement (avec une nouvelle ligne entre chaque objet) -** _columns_horizontal_ : les objets sont remplis horizontalement, affichés +** _columns_horizontal_ : les objets sont remplis horizontalement, affichés sous forme de colonnes -** _columns_vertical_ : les objets sont remplis verticalement, affichés sous +** _columns_vertical_ : les objets sont remplis verticalement, affichés sous forme de colonnes -* _size_ : taille de la barre en caractères (0 indique une taille automatique) -* _size_max_ : taille maximum de la barre (0 pour pas de maximum) -* _color_fg_ : couleur du texte dans la barre -* _color_delim_ : couleur pour les délimiteurs dans la barre -* _color_bg_ : couleur de fond pour la barre -* _separator_ : -** _on_ : la barre a un séparateur avec les autres fenêtres/barres -** _off_ : pas de séparateur -* _items_ : liste des objets dans la barre, séparés par une virgule (espace +* _size_ : taille de la barre en caractères (0 indique une taille automatique) +* _size_max_ : taille maximum de la barre (0 pour pas de maximum) +* _color_fg_ : couleur du texte dans la barre +* _color_delim_ : couleur pour les délimiteurs dans la barre +* _color_bg_ : couleur de fond pour la barre +* _separator_ : +** _on_ : la barre a un séparateur avec les autres fenêtres/barres +** _off_ : pas de séparateur +* _items_ : liste des objets dans la barre, séparés par une virgule (espace entre les objets), ou "+" (objets collés) -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle barre, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -13204,7 +13204,7 @@ struct t_gui_bar *my_bar = weechat_bar_new ("mybar", "time,buffer_number+buffer_name"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13222,7 +13222,7 @@ bar = weechat.bar_new("mybar", "off", "100", "window", "", "top", "horizontal", Affecter une nouvelle valeur pour une propriété de la barre. -Prototype : +Prototype : [source,C] ---- @@ -13230,26 +13230,26 @@ int weechat_bar_set (struct t_gui_bar *bar, const char *property, const char *value); ---- -Paramètres : +Paramètres : -* _bar_ : pointeur vers la barre -* _property_ : name, hidden, priority, conditions, position, filling_top_bottom, +* _bar_ : pointeur vers la barre +* _property_ : name, hidden, priority, conditions, position, filling_top_bottom, filling_left_right, size, size_max, color_fg, color_delim, color_bg, separator, items (voir <<_bar_new,bar_new>>) -* _value_ : nouvelle valeur pour la propriété +* _value_ : nouvelle valeur pour la propriété -Valeur de retour : +Valeur de retour : * 1 si la valeur a été affectée, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- weechat_bar_set (my_bar, "position", "bottom"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13264,25 +13264,25 @@ weechat.bar_set(my_bar, "position", "bottom") Mettre à jour le contenu d'une barre à l'écran. -Prototype : +Prototype : [source,C] ---- void weechat_bar_update (const char *name); ---- -Paramètres : +Paramètres : -* _name_ : nom de la barre +* _name_ : nom de la barre -Exemple en C : +Exemple en C : [source,C] ---- weechat_bar_update ("mybar"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13297,25 +13297,25 @@ weechat.bar_update("mybar") Supprimer une barre. -Prototype : +Prototype : [source,C] ---- void weechat_bar_remove (struct t_gui_bar *bar); ---- -Paramètres : +Paramètres : -* _bar_ : pointeur vers la barre +* _bar_ : pointeur vers la barre -Exemple en C : +Exemple en C : [source,C] ---- weechat_bar_remove (my_bar); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13337,26 +13337,26 @@ _Mis à jour dans la 1.1._ Exécuter une commande ou envoyer du texte au tampon. -Prototype : +Prototype : [source,C] ---- int weechat_command (struct t_gui_buffer *buffer, const char *command); ---- -Paramètres : +Paramètres : -* _buffer_ : pointeur vers le tampon (la commande est exécutée sur ce tampon, +* _buffer_ : pointeur vers le tampon (la commande est exécutée sur ce tampon, NULL pour le tampon courant) -* _command_ : commande à exécuter (si elle commence par "/"), ou texte à +* _command_ : commande à exécuter (si elle commence par "/"), ou texte à envoyer au tampon -Valeur de retour : (_WeeChat ≥ 1.1_) +Valeur de retour : (_WeeChat ≥ 1.1_) * _WEECHAT_RC_OK_ si ok * _WEECHAT_RC_ERROR_ si erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -13365,7 +13365,7 @@ rc = weechat_command (weechat_buffer_search ("irc", "freenode.#weechat"), "/whois FlashCode"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13389,7 +13389,7 @@ Fonctions pour le réseau. Cette fonction est bloquante sur l'appel à connect(), donc elle doit être appelée sans un processus issu d'un "fork", pour ne pas bloquer WeeChat. -Prototype : +Prototype : [source,C] ---- @@ -13399,18 +13399,18 @@ int weechat_network_pass_proxy (const char *proxy, int port); ---- -Paramètres : +Paramètres : -* _proxy_ : nom du proxy à utiliser -* _sock_ : socket à utiliser -* _address_ : adresse (nom de machine ou adresse IP) -* _port_ : port +* _proxy_ : nom du proxy à utiliser +* _sock_ : socket à utiliser +* _address_ : adresse (nom de machine ou adresse IP) +* _port_ : port -Valeur de retour : +Valeur de retour : * 1 si la connexion est ok, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -13437,7 +13437,7 @@ _Mis à jour dans la 0.4.3._ Cette fonction est bloquante sur l'appel à connect(), donc elle doit être appelée sans un processus issu d'un "fork", pour ne pas bloquer WeeChat. -Prototype : +Prototype : [source,C] ---- @@ -13446,17 +13446,17 @@ int weechat_network_connect_to (const char *proxy, socklen_t address_length); ---- -Paramètres : +Paramètres : -* _proxy_ : nom du proxy à utiliser -* _address_ : adresse où se connecter (avec le port) -* _address_length_ : longueur du paramètre _address_ +* _proxy_ : nom du proxy à utiliser +* _address_ : adresse où se connecter (avec le port) +* _address_length_ : longueur du paramètre _address_ -Valeur de retour : +Valeur de retour : * numéro de socket (>= 0) si la connexion est OK, -1 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -13490,39 +13490,39 @@ Fonctions pour obtenir des informations. Retourner une information, sous forme de chaîne, de WeeChat ou d'une extension. -Prototype : +Prototype : [source,C] ---- const char *weechat_info_get (const char *info_name, const char *arguments); ---- -Paramètres : +Paramètres : -* _info_name_ : nom de l'information à lire (voir le tableau ci-dessous) -* _arguments_ : paramètres pour l'information demandée (optionnels, NULL si +* _info_name_ : nom de l'information à lire (voir le tableau ci-dessous) +* _arguments_ : paramètres pour l'information demandée (optionnels, NULL si aucun paramètre n'est nécessaire) -Valeur de retour : +Valeur de retour : * chaîne avec l'information demandée, NULL en cas d'erreur -Infos : +Infos : include::autogen/plugin_api/infos.adoc[] -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "La version de WeeChat est : %s (compilée le %s)", +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_printf (NULL, "Le répertoire de WeeChat est : %s", weechat_info_get ("weechat_dir", NULL)); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13530,9 +13530,9 @@ Script (Python) : value = weechat.info_get(info_name, arguments) # exemple -weechat.prnt("", "La version de WeeChat est : %s (compilée le %s)" +weechat.prnt("", "La version de WeeChat est : %s (compilée le %s)" % (weechat.info_get("version", ""), weechat.info_get("date", "")) -weechat.prnt("", "Le répertoire de WeeChat est : %s" % weechat.info_get("weechat_dir", "")) +weechat.prnt("", "Le répertoire de WeeChat est : %s" % weechat.info_get("weechat_dir", "")) ---- ==== info_get_hashtable @@ -13542,7 +13542,7 @@ _WeeChat ≥ 0.3.4._ Retourner une information, sous forme de table de hachage, de WeeChat ou d'une extension. -Prototype : +Prototype : [source,C] ---- @@ -13550,21 +13550,21 @@ struct t_hashtable *weechat_info_get_hashtable (const char *info_name, struct t_hashtable *hashtable); ---- -Paramètres : +Paramètres : -* _info_name_ : nom de l'information à lire (voir le tableau ci-dessous) -* _hashtable_ : table de hachage avec les paramètres (dépendant de l'information +* _info_name_ : nom de l'information à lire (voir le tableau ci-dessous) +* _hashtable_ : table de hachage avec les paramètres (dépendant de l'information demandée) (optionnel, NULL si aucun paramètre n'est nécessaire) -Valeur de retour : +Valeur de retour : * table de hachage avec l'information demandée, NULL en cas d'erreur -Infos : +Infos : include::autogen/plugin_api/infos_hashtable.adoc[] -Exemple en C : +Exemple en C : [source,C] ---- @@ -13584,7 +13584,7 @@ if (hashtable_in) hashtable_out = weechat_info_get_hashtable ("irc_message_parse", hashtable_in); /* - * maintenant hashtable_out a les clés/valeurs suivantes : + * maintenant hashtable_out a les clés/valeurs suivantes : * "tags" : "time=2015-06-27T16:40:35.000Z" * "message_without_tags": ":nick!user@host PRIVMSG #weechat :hello!" * "nick" : "nick" @@ -13607,7 +13607,7 @@ if (hashtable_in) Voir le _Guide pour Scripts WeeChat_ pour plus d'infos sur la sortie de "irc_message_parse". -Script (Python) : +Script (Python) : [source,python] ---- @@ -13616,7 +13616,7 @@ dict = weechat.info_get_hashtable(info_name, dict_in) # exemple dict_in = {"message": ":nick!user@host PRIVMSG #weechat :message ici"} -weechat.prnt("", "message analysé : %s" +weechat.prnt("", "message analysé : %s" % weechat.info_get_hashtable("irc_message_parse", dict_in)) ---- @@ -13630,38 +13630,38 @@ Par exemple, l'infolist "irc_server" a N objets (N est le nombre de serveurs IRC définis). Pour chaque objet, il y a des variables, comme "name", "buffer", "is_connected", ... -Chaque variable a un type et une valeur. Les types possibles sont : +Chaque variable a un type et une valeur. Les types possibles sont : -* _integer_ : nombre entier -* _string_ : chaîne de caractères -* _pointer_ : pointeur -* _buffer_ : tampon avec une taille fixe, peut contenir n'importe quel type de +* _integer_ : nombre entier +* _string_ : chaîne de caractères +* _pointer_ : pointeur +* _buffer_ : tampon avec une taille fixe, peut contenir n'importe quel type de données -* _time_ : date/heure +* _time_ : date/heure ==== infolist_new Créer une "infolist". -Prototype : +Prototype : [source,C] ---- struct t_infolist *weechat_infolist_new (); ---- -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle "infolist" -Exemple en C : +Exemple en C : [source,C] ---- struct t_infolist *infolist = weechat_infolist_new (); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13676,29 +13676,29 @@ infolist = weechat.infolist_new() Ajouter un objet dans l'infolist. -Prototype : +Prototype : [source,C] ---- struct t_infolist_item *weechat_infolist_new_item (struct t_infolist *infolist); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist +* _infolist_ : pointeur vers l'infolist -Valeur de retour : +Valeur de retour : * pointeur vers le nouvel objet -Exemple en C : +Exemple en C : [source,C] ---- struct t_infolist_item *item = weechat_infolist_new_item (infolist); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13713,7 +13713,7 @@ item = weechat.infolist_new_item(infolist) Ajouter une variable de type "integer" dans l'objet de l'infolist. -Prototype : +Prototype : [source,C] ---- @@ -13722,17 +13722,17 @@ struct t_infolist_var *weechat_infolist_new_var_integer (struct t_infolist_item int value); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'objet de l'infolist -* _name_ : nom de la variable -* _value_ : valeur +* _item_ : pointeur vers l'objet de l'infolist +* _name_ : nom de la variable +* _value_ : valeur -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle variable -Exemple en C : +Exemple en C : [source,C] ---- @@ -13741,7 +13741,7 @@ struct t_infolist_var *var = weechat_infolist_new_var_integer (item, 123); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13756,7 +13756,7 @@ var = weechat.infolist_new_var_integer(item, "mon_entier", 123) Ajouter une variable de type "string" dans l'objet de l'infolist. -Prototype : +Prototype : [source,C] ---- @@ -13765,17 +13765,17 @@ struct t_infolist_var *weechat_infolist_new_var_string (struct t_infolist_item * const char *value); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'objet de l'infolist -* _name_ : nom de la variable -* _value_ : valeur +* _item_ : pointeur vers l'objet de l'infolist +* _name_ : nom de la variable +* _value_ : valeur -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle variable -Exemple en C : +Exemple en C : [source,C] ---- @@ -13784,7 +13784,7 @@ struct t_infolist_var *var = weechat_infolist_new_var_string (item, "valeur"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13799,7 +13799,7 @@ var = weechat.infolist_new_var_string(item, "ma_chaine", "valeur") Ajouter une variable de type "pointer" dans l'objet de l'infolist. -Prototype : +Prototype : [source,C] ---- @@ -13808,17 +13808,17 @@ struct t_infolist_var *weechat_infolist_new_var_pointer (struct t_infolist_item void *pointer); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'objet de l'infolist -* _name_ : nom de la variable -* _pointer_ : pointeur +* _item_ : pointeur vers l'objet de l'infolist +* _name_ : nom de la variable +* _pointer_ : pointeur -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle variable -Exemple en C : +Exemple en C : [source,C] ---- @@ -13827,7 +13827,7 @@ struct t_infolist_var *var = weechat_infolist_new_var_pointer (item, &pointer); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13842,7 +13842,7 @@ var = weechat.infolist_new_var_pointer(item, "mon_pointeur", pointer) Ajouter une variable de type "buffer" dans l'objet de l'infolist. -Prototype : +Prototype : [source,C] ---- @@ -13852,18 +13852,18 @@ struct t_infolist_var *weechat_infolist_new_var_buffer (struct t_infolist_item * int size); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'objet de l'infolist -* _name_ : nom de la variable -* _pointer_ : pointeur -* _size_ : taille du tampon +* _item_ : pointeur vers l'objet de l'infolist +* _name_ : nom de la variable +* _pointer_ : pointeur +* _size_ : taille du tampon -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle variable -Exemple en C : +Exemple en C : [source,C] ---- @@ -13882,7 +13882,7 @@ Cette fonction n'est pas disponible dans l'API script. Ajouter une variable de type "time" dans l'objet de l'infolist. -Prototype : +Prototype : [source,C] ---- @@ -13891,17 +13891,17 @@ struct t_infolist_var *weechat_infolist_new_var_time (struct t_infolist_item *it time_t time); ---- -Paramètres : +Paramètres : -* _item_ : pointeur vers l'objet de l'infolist -* _name_ : nom de la variable -* _time_ : valeur +* _item_ : pointeur vers l'objet de l'infolist +* _name_ : nom de la variable +* _time_ : valeur -Valeur de retour : +Valeur de retour : * pointeur vers la nouvelle variable -Exemple en C : +Exemple en C : [source,C] ---- @@ -13910,7 +13910,7 @@ struct t_infolist_var *var = weechat_infolist_new_var_time (item, time (NULL)); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13934,7 +13934,7 @@ Au lieu d'utiliser une grosse infolist, il est préférable d'utiliser un hdata (mais l'infolist peut contenir plus de données que le hdata, qui contient des données brutes), voir <>. -Prototype : +Prototype : [source,C] ---- @@ -13943,30 +13943,30 @@ struct t_infolist *weechat_infolist_get (const char *infolist_name, const char *arguments); ---- -Paramètres : +Paramètres : -* _infolist_name_ : nom de l'infolist à lire (voir le tableau ci-dessous) -* _pointer_ : pointeur vers un objet, pour n'obtenir que celui-ci dans +* _infolist_name_ : nom de l'infolist à lire (voir le tableau ci-dessous) +* _pointer_ : pointeur vers un objet, pour n'obtenir que celui-ci dans l'infolist (optionnel, peut être NULL) -* _arguments_ : paramètres pour l'infolist demandée (optionnels, NULL si aucun +* _arguments_ : paramètres pour l'infolist demandée (optionnels, NULL si aucun paramètre n'est nécessaire) -Valeur de retour : +Valeur de retour : * pointeur vers l'infolist, NULL en cas d'erreur -Infolists : +Infolists : include::autogen/plugin_api/infolists.adoc[] -Exemple en C : +Exemple en C : [source,C] ---- struct t_infolist *infolist = weechat_infolist_get ("irc_server", NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -13983,23 +13983,23 @@ Déplacer le "curseur" vers l'objet suivant dans l'infolist. Le premier appel à cette fonction sur une infolist déplace le curseur sur le premier objet de l'infolist. -Prototype : +Prototype : [source,C] ---- int weechat_infolist_next (struct t_infolist *infolist); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist +* _infolist_ : pointeur vers l'infolist -Valeur de retour : +Valeur de retour : * 1 si le curseur a été déplacé sur l'objet suivant, 0 si la fin de la liste a été atteinte -Exemple en C : +Exemple en C : [source,C] ---- @@ -14013,7 +14013,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14034,23 +14034,23 @@ Déplacer le "curseur" vers l'objet précédent dans l'infolist. Le premier appe cette fonction sur une infolist déplace le curseur sur le dernier objet de l'infolist. -Prototype : +Prototype : [source,C] ---- int weechat_infolist_prev (struct t_infolist *infolist); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist +* _infolist_ : pointeur vers l'infolist -Valeur de retour : +Valeur de retour : * 1 si le curseur a été déplacé sur l'objet précédent, 0 si le début de liste a été atteint -Exemple en C : +Exemple en C : [source,C] ---- @@ -14064,7 +14064,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14083,25 +14083,25 @@ else: Réinitialiser le "curseur" de l'infolist. -Prototype : +Prototype : [source,C] ---- void weechat_infolist_reset_item_cursor (struct t_infolist *infolist); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist +* _infolist_ : pointeur vers l'infolist -Exemple en C : +Exemple en C : [source,C] ---- weechat_infolist_reset_item_cursor (infolist); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14118,7 +14118,7 @@ _WeeChat ≥ 0.4.3._ Chercher une variable dans l'objet courant de l'infolist. -Prototype : +Prototype : [source,C] ---- @@ -14126,16 +14126,16 @@ struct t_infolist_var *weechat_infolist_search_var (struct t_infolist *infolist, const char *name); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist -* _name_ : nom de la variable +* _infolist_ : pointeur vers l'infolist +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * pointeur vers la variable trouvée, NULL si la variable n'est pas trouvée -Exemple en C : +Exemple en C : [source,C] ---- @@ -14146,7 +14146,7 @@ if (weechat_infolist_search_var (infolist, "name")) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14163,34 +14163,34 @@ if weechat.infolist_search_var(infolist, "name"): Retourner la liste des champs pour l'objet courant de l'infolist. -Prototype : +Prototype : [source,C] ---- const char *weechat_infolist_fields (struct t_infolist *infolist); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist +* _infolist_ : pointeur vers l'infolist -Valeur de retour : +Valeur de retour : * chaîne avec la liste des champs pour l'objet courant de l'infolist. La liste, séparée par des virgules, contient la lettre pour le type, suivi du nom de la - variable. Les types sont : "i" (nombre entier), "s" (chaîne), "p" (pointeur), + variable. Les types sont : "i" (nombre entier), "s" (chaîne), "p" (pointeur), "b" (buffer), "t" (date/heure). -Exemple en C : +Exemple en C : [source,C] ---- const char *fields = weechat_infolist_fields (infolist); -/* fields contient quelque chose comme : +/* fields contient quelque chose comme : "i:mon_entier,s:ma_chaine,p:mon_pointeur,b:mon_buffer,t:ma_date" */ ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14199,7 +14199,7 @@ fields = weechat.infolist_fields(infolist) # exemple fields = weechat.infolist_fields(infolist) -# fields contient quelque chose comme : +# fields contient quelque chose comme : # "i:mon_entier,s:ma_chaine,p:mon_pointeur,b:mon_buffer,t:ma_date" ---- @@ -14208,23 +14208,23 @@ fields = weechat.infolist_fields(infolist) Retourner la valeur de la variable de l'objet courant de l'infolist, sous forme d'entier. -Prototype : +Prototype : [source,C] ---- int weechat_infolist_integer (struct t_infolist *infolist, const char *var); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist -* _var_ : nom de la variable (doit être de type "integer") +* _infolist_ : pointeur vers l'infolist +* _var_ : nom de la variable (doit être de type "integer") -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme d'entier -Exemple en C : +Exemple en C : [source,C] ---- @@ -14232,7 +14232,7 @@ weechat_printf (NULL, "entier = %d", weechat_infolist_integer (infolist, "mon_entier")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14248,23 +14248,23 @@ weechat.prnt("", "entier = %d" % weechat.infolist_integer(infolist, "mon_entier" Retourner la valeur de la variable de l'objet courant de l'infolist, sous forme de chaîne de caractères. -Prototype : +Prototype : [source,C] ---- const char *weechat_infolist_string (struct t_infolist *infolist, const char *var); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist -* _var_ : nom de la variable (doit être de type "string") +* _infolist_ : pointeur vers l'infolist +* _var_ : nom de la variable (doit être de type "string") -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de chaîne -Exemple en C : +Exemple en C : [source,C] ---- @@ -14272,7 +14272,7 @@ weechat_printf (NULL, "chaîne = %s", weechat_infolist_string (infolist, "ma_chaine")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14288,23 +14288,23 @@ weechat.prnt("", "chaîne = %s" % weechat.infolist_string(infolist, "ma_chaine") Retourner la valeur de la variable de l'objet courant de l'infolist, sous forme de pointeur. -Prototype : +Prototype : [source,C] ---- void *weechat_infolist_pointer (struct t_infolist *infolist, const char *var); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist -* _var_ : nom de la variable (doit être de type "pointer") +* _infolist_ : pointeur vers l'infolist +* _var_ : nom de la variable (doit être de type "pointer") -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de pointeur -Exemple en C : +Exemple en C : [source,C] ---- @@ -14312,7 +14312,7 @@ weechat_printf (NULL, "pointeur = 0x%lx", weechat_infolist_pointer (infolist, "mon_pointeur")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14328,7 +14328,7 @@ weechat.prnt("", "pointeur = 0x%s" % weechat.infolist_pointer(infolist, "mon_poi Retourner la valeur de la variable de l'objet courant de l'infolist, sous forme de tampon de données. -Prototype : +Prototype : [source,C] ---- @@ -14336,18 +14336,18 @@ void *weechat_infolist_buffer (struct t_infolist *infolist, const char *var, int *size); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist -* _var_ : nom de la variable (doit être de type "buffer") -* _size_ : pointeur vers une variable entière, qui sera alimenté avec la taille +* _infolist_ : pointeur vers l'infolist +* _var_ : nom de la variable (doit être de type "buffer") +* _size_ : pointeur vers une variable entière, qui sera alimenté avec la taille de la zone -Valeur de retour : +Valeur de retour : * pointeur vers le tampon de données -Exemple en C : +Exemple en C : [source,C] ---- @@ -14365,23 +14365,23 @@ Cette fonction n'est pas disponible dans l'API script. Retourner la valeur de la variable de l'objet courant de l'infolist, sous forme de date/heure. -Prototype : +Prototype : [source,C] ---- time_t weechat_infolist_time (struct t_infolist *infolist, const char *var); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist -* _var_ : nom de la variable (doit être de type "time") +* _infolist_ : pointeur vers l'infolist +* _var_ : nom de la variable (doit être de type "time") -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de date/heure -Exemple en C : +Exemple en C : [source,C] ---- @@ -14389,7 +14389,7 @@ weechat_printf (NULL, "date/heure = %ld", weechat_infolist_time (infolist, "mon_time")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14404,25 +14404,25 @@ weechat.prnt("", "date/heure = %ld" % weechat.infolist_time(infolist, "mon_time" Supprimer une infolist. -Prototype : +Prototype : [source,C] ---- void weechat_infolist_free (struct t_infolist *infolist); ---- -Paramètres : +Paramètres : -* _infolist_ : pointeur vers l'infolist +* _infolist_ : pointeur vers l'infolist -Exemple en C : +Exemple en C : [source,C] ---- weechat_infolist_free (infolist); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14455,16 +14455,16 @@ Créer un "hdata". .hdata vs infolist ==== Le "hdata" est un moyen rapide de lire des données de WeeChat ou des extensions. -Il est similaire à l'infolist, mais il y a quelques différences : +Il est similaire à l'infolist, mais il y a quelques différences : -* Il est plus rapide et utilise moins de mémoire : accès direct aux données sans +* Il est plus rapide et utilise moins de mémoire : accès direct aux données sans duplication. -* Il peut contenir des informations différentes de l'infolist : il contient +* Il peut contenir des informations différentes de l'infolist : il contient seulement les données brutes des structures (l'infolist peut ajouter des données supplémentaires pour plus de commodité). ==== -Prototype : +Prototype : [source,C] ---- @@ -14477,35 +14477,35 @@ struct t_hdata *weechat_hdata_new (const char *hdata_name, const char *var_prev, void *callback_update_data); ---- -Paramètres : +Paramètres : -* _hdata_name_ : nom du hdata -* _var_prev_ : nom de la variable dans la structure qui est un pointeur vers +* _hdata_name_ : nom du hdata +* _var_prev_ : nom de la variable dans la structure qui est un pointeur vers l'élément précédent dans la liste (peut être NULL si une telle variable n'existe pas) -* _var_next_ : nom de la variable dans la structure qui est un pointeur vers +* _var_next_ : nom de la variable dans la structure qui est un pointeur vers l'élément suivant dans la liste (peut être NULL si une telle variable n'existe pas) -* _create_allowed_ : 1 si la création de structure est autorisée, sinon 0 +* _create_allowed_ : 1 si la création de structure est autorisée, sinon 0 _(WeeChat ≥ 0.4.0)_ -* _delete_allowed_ : 1 si la suppression de structure est autorisée, sinon 0 +* _delete_allowed_ : 1 si la suppression de structure est autorisée, sinon 0 _(WeeChat ≥ 0.3.9)_ -* _callback_update_ : fonction appelée pour mettre à jour des données dans le +* _callback_update_ : fonction appelée pour mettre à jour des données dans le hdata, peut être NULL si aucune mise à jour n'est autorisée - _(WeeChat ≥ 0.3.9)_, paramètres et valeur de retour : -** _void *data_ : pointeur -** _struct t_hdata *hdata_ : pointeur vers le hdata -** _struct t_hashtable *hashtable_ : table de hachage avec les variables à + _(WeeChat ≥ 0.3.9)_, paramètres et valeur de retour : +** _void *data_ : pointeur +** _struct t_hdata *hdata_ : pointeur vers le hdata +** _struct t_hashtable *hashtable_ : table de hachage avec les variables à mettre à jour (voir <<_hdata_update,hdata_update>>) -** valeur de retour : nombre de variables mises à jour -* _callback_update_data_ : pointeur donné au "callback" lorsqu'il est appelé par +** valeur de retour : nombre de variables mises à jour +* _callback_update_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat _(WeeChat ≥ 0.3.9)_ -Valeur de retour : +Valeur de retour : * pointeur vers le nouveau "hdata" -Exemple en C : +Exemple en C : [source,C] ---- @@ -14521,7 +14521,7 @@ _WeeChat ≥ 0.3.6._ Créer une nouvelle variable dans le hdata. -Prototype : +Prototype : [source,C] ---- @@ -14529,12 +14529,12 @@ void weechat_hdata_new_var (struct t_hdata *hdata, const char *name, int offset, int update_allowed, const char *array_size, const char *hdata_name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _name_ : nom de la variable -* _offset_ : position (offset) de la variable dans la structure -* _type_ : type de la variable, un parmi ceux-ci : +* _hdata_ : pointeur vers le hdata +* _name_ : nom de la variable +* _offset_ : position (offset) de la variable dans la structure +* _type_ : type de la variable, un parmi ceux-ci : ** WEECHAT_HDATA_CHAR ** WEECHAT_HDATA_INTEGER ** WEECHAT_HDATA_LONG @@ -14544,20 +14544,20 @@ Paramètres : ** WEECHAT_HDATA_TIME ** WEECHAT_HDATA_HASHTABLE ** WEECHAT_HDATA_OTHER -* _update_allowed_ : 1 si la mise à jour de la variable est autorisée, sinon 0 +* _update_allowed_ : 1 si la mise à jour de la variable est autorisée, sinon 0 _(WeeChat ≥ 0.3.9)_ -* _array_size_ : non NULL seulement si la variable est un tableau, et peut - être : _(WeeChat ≥ 0.3.9)_ -** nom d'une variable du hdata : cette variable sera utilisée comme taille de +* _array_size_ : non NULL seulement si la variable est un tableau, et peut + être : _(WeeChat ≥ 0.3.9)_ +** nom d'une variable du hdata : cette variable sera utilisée comme taille de tableau (taille dynamique pour le tableau) -** entier (sous forme de chaîne) : taille fixe pour le tableau -** _*_ : taille automatique : la taille est calculée en examinant les valeurs, +** entier (sous forme de chaîne) : taille fixe pour le tableau +** _*_ : taille automatique : la taille est calculée en examinant les valeurs, lorsque le premier NULL est trouvé (seulement pour le type string, pointer ou hashtable) -* _hdata_name_ : nom d'un hdata (si c'est un pointeur vers une structure qui a +* _hdata_name_ : nom d'un hdata (si c'est un pointeur vers une structure qui a un hdata) -Exemple en C : +Exemple en C : [source,C] ---- @@ -14584,7 +14584,7 @@ weechat_hdata_new_var (hdata, "prev", offsetof (struct t_myplugin_list, prev), W weechat_hdata_new_var (hdata, "next", offsetof (struct t_myplugin_list, next), WEECHAT_HDATA_POINTER, 0, NULL, "myplugin_list"); ---- -La macro "WEECHAT_HDATA_VAR" peut être utilisée pour raccourcir le code : +La macro "WEECHAT_HDATA_VAR" peut être utilisée pour raccourcir le code : [source,C] ---- @@ -14606,23 +14606,23 @@ _WeeChat ≥ 0.3.6, mis à jour dans la 1.0._ Créer un nouveau pointer vers une liste dans le hdata. -Prototype : +Prototype : [source,C] ---- void weechat_hdata_new_list (struct t_hdata *hdata, const char *name, void *pointer, int flags); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _name_ : nom de la variable -* _pointer_ : pointeur vers la liste -* _flags_ : combinaison des valeurs suivantes : _(WeeChat ≥ 1.0)_ -** _WEECHAT_HDATA_LIST_CHECK_POINTERS_ : liste utilisée pour vérifier les +* _hdata_ : pointeur vers le hdata +* _name_ : nom de la variable +* _pointer_ : pointeur vers la liste +* _flags_ : combinaison des valeurs suivantes : _(WeeChat ≥ 1.0)_ +** _WEECHAT_HDATA_LIST_CHECK_POINTERS_ : liste utilisée pour vérifier les pointeurs -Exemple en C : +Exemple en C : [source,C] ---- @@ -14652,7 +14652,7 @@ weechat_hdata_new_list (hdata, "buffers", &buffers, WEECHAT_HDATA_LIST_CHECK_POI weechat_hdata_new_list (hdata, "last_buffer", &last_buffer, 0); ---- -La macro "WEECHAT_HDATA_LIST" peut être utilisée pour raccourcir le code : +La macro "WEECHAT_HDATA_LIST" peut être utilisée pour raccourcir le code : [source,C] ---- @@ -14675,33 +14675,33 @@ avec la position (offset) des variables dans la structure. Cela signifie que vous aurez besoin de ce hdata et d'un pointeur vers un objet WeeChat ou d'une extension pour lire des données. -Prototype : +Prototype : [source,C] ---- struct t_hdata *weechat_hdata_get (const char *hdata_name); ---- -Paramètres : +Paramètres : -* _hdata_name_ : nom du hdata (voir la liste ci-dessous) +* _hdata_name_ : nom du hdata (voir la liste ci-dessous) -Valeur de retour : +Valeur de retour : * pointeur vers le hdata, NULL en cas d'erreur -Liste des hdata : +Liste des hdata : include::autogen/plugin_api/hdata.adoc[] -Exemple en C : +Exemple en C : [source,C] ---- struct t_hdata *hdata = weechat_hdata_get ("irc_server"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14718,30 +14718,30 @@ _WeeChat ≥ 0.3.6._ Retourner la position (offset) de la variable dans le hdata. -Prototype : +Prototype : [source,C] ---- int weechat_hdata_get_var_offset (struct t_hdata *hdata, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _name_ : nom de la variable +* _hdata_ : pointeur vers le hdata +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * position (offset) de la variable, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- int offset = weechat_hdata_get_var_offset (hdata, "name"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14758,23 +14758,23 @@ _WeeChat ≥ 0.3.6._ Retourner le type de la variable dans le hdata (sous forme d'entier). -Prototype : +Prototype : [source,C] ---- int weechat_hdata_get_var_type (struct t_hdata *hdata, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _name_ : nom de la variable +* _hdata_ : pointeur vers le hdata +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * type de la variable, -1 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -14823,30 +14823,30 @@ _WeeChat ≥ 0.3.6._ Retourner le type de la variable dans le hdata (sous forme de chaîne). -Prototype : +Prototype : [source,C] ---- const char *weechat_hdata_get_var_type_string (struct t_hdata *hdata, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _name_ : nom de la variable +* _hdata_ : pointeur vers le hdata +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * type de la variable, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (NULL, "type = %s", weechat_hdata_get_var_type_string (hdata, "name")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14863,32 +14863,32 @@ _WeeChat ≥ 0.3.9._ Retourner la taille du tableau pour la variable dans le hdata. -Prototype : +Prototype : [source,C] ---- int weechat_hdata_get_var_array_size (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * taille du tableau pour la variable, -1 si la variable n'est pas un tableau ou en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- int array_size = weechat_hdata_get_var_array_size (hdata, pointer, "name"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14906,7 +14906,7 @@ _WeeChat ≥ 0.3.9._ Retourner la taille du tableau pour la variable dans le hdata (sous forme de chaîne). -Prototype : +Prototype : [source,C] ---- @@ -14914,25 +14914,25 @@ const char *weechat_hdata_get_var_count_array_size (struct t_hdata *hdata, void const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * taille du tableau pour la variable sous forme de chaîne, -1 si la variable n'est pas un tableau ou en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- const char *array_size = weechat_hdata_get_var_array_size_string (hdata, pointer, "name"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14949,30 +14949,30 @@ _WeeChat ≥ 0.3.6._ Retourner le hdata pour la variable dans le hdata. -Prototype : +Prototype : [source,C] ---- const char *weechat_hdata_get_var_hdata (struct t_hdata *hdata, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _name_ : nom de la variable +* _hdata_ : pointeur vers le hdata +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * hdata pour la variable, NULL si pas de hdata ou en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (NULL, "hdata = %s", weechat_hdata_get_var_hdata (hdata, "name")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -14989,24 +14989,24 @@ _WeeChat ≥ 0.3.6._ Retourner un pointeur vers le contenu de la variable dans le hdata. -Prototype : +Prototype : [source,C] ---- void *weechat_hdata_get_var (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable -Valeur de retour : +Valeur de retour : * pointeur vers le contenu de la variable, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -15025,24 +15025,24 @@ _WeeChat ≥ 0.3.6._ Retourner un pointeur vers le contenu de la variable dans le hdata, en utilisant une position (offset). -Prototype : +Prototype : [source,C] ---- void *weechat_hdata_get_var_at_offset (struct t_hdata *hdata, void *pointer, int offset); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _offset_ : position (offset) de la variable +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _offset_ : position (offset) de la variable -Valeur de retour : +Valeur de retour : * pointeur vers le contenu de la variable, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -15061,23 +15061,23 @@ _WeeChat ≥ 0.3.6._ Retourner un pointeur de liste du hdata. -Prototype : +Prototype : [source,C] ---- void *weechat_hdata_get_list (struct t_hdata *hdata, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _name_ : nom de la liste +* _hdata_ : pointeur vers le hdata +* _name_ : nom de la liste -Valeur de retour : +Valeur de retour : * pointeur vers la liste, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -15085,7 +15085,7 @@ struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffers = weechat_hdata_get_list (hdata, "gui_buffers"); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15103,28 +15103,28 @@ _WeeChat ≥ 0.3.7, mis à jour dans la 1.0._ Vérifier si un pointeur est valide pour un hdata et un pointeur de liste. -Prototype : +Prototype : [source,C] ---- int weechat_hdata_check_pointer (struct t_hdata *hdata, void *list, void *pointer); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _list_ : pointeur vers une liste; si NULL _(WeeChat ≥ 1.0)_, le pointeur est +* _hdata_ : pointeur vers le hdata +* _list_ : pointeur vers une liste; si NULL _(WeeChat ≥ 1.0)_, le pointeur est vérifié avec les listes dans le hdata qui ont le drapeau "vérifier les pointeurs" (voir <<_hdata_new_list,hdata_new_list>>), et s'il n'y a pas de telle liste, le pointeur est considéré comme valide -* _pointer_ : pointeur à vérifier +* _pointer_ : pointeur à vérifier -Valeur de retour : +Valeur de retour : * 1 si le pointeur est dans la liste, 0 si non trouvé -Exemple en C : +Exemple en C : [source,C] ---- @@ -15142,7 +15142,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15165,25 +15165,25 @@ _WeeChat ≥ 0.3.6._ Déplacer le pointeur vers un autre élément dans la liste. -Prototype : +Prototype : [source,C] ---- void *weechat_hdata_move (struct t_hdata *hdata, void *pointer, int count); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _count_ : nombre de saut(s) à exécuter (entier négatif ou positif, différent +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _count_ : nombre de saut(s) à exécuter (entier négatif ou positif, différent de 0) -Valeur de retour : +Valeur de retour : * pointeur vers l'élément atteint, NULL en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -15198,7 +15198,7 @@ if (buffer) buffer = weechat_hdata_move (hdata, buffer, -1); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15221,32 +15221,32 @@ if buffer: _WeeChat ≥ 0.4.1._ -Chercher un élément dans la liste : l'expression _search_ est évaluée pour +Chercher un élément dans la liste : l'expression _search_ est évaluée pour chaque élément dans la liste, jusqu'à trouver l'élément (ou la fin de la liste). -Prototype : +Prototype : [source,C] ---- void *weechat_hdata_search (struct t_hdata *hdata, void *pointer, const char *search, int move); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _search_ : expression à évaluer, le pointeur par défaut dans l'expression est +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _search_ : expression à évaluer, le pointeur par défaut dans l'expression est le nom du hdata (et ce pointeur change pour chaque élément dans la liste); pour l'aide sur l'expression, voir la commande `/eval` dans le _Guide utilisateur WeeChat_ -* _move_ : nombre de saut(s) à exécuter après une recherche infructueuse (entier +* _move_ : nombre de saut(s) à exécuter après une recherche infructueuse (entier négatif ou positif, différent de 0) -Valeur de retour : +Valeur de retour : * pointeur vers l'élément trouvé, ou NULL si non trouvé -Exemple en C : +Exemple en C : [source,C] ---- @@ -15261,7 +15261,7 @@ if (server) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15285,33 +15285,33 @@ _WeeChat ≥ 0.3.7._ Retourner la valeur de la variable dans la structure en utilisant le hdata, sous forme de caractère. -Prototype : +Prototype : [source,C] ---- char weechat_hdata_char (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (doit être de type "char"); pour les tableaux, +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (doit être de type "char"); pour les tableaux, le nom peut être "N|name" où N est un index dans le tableau (démarrant à 0), - par exemple : "2|name" + par exemple : "2|name" -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de caractère -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (NULL, "letter = %c", weechat_hdata_char (hdata, pointer, "letter")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15329,26 +15329,26 @@ _WeeChat ≥ 0.3.6._ Retourner la valeur de la variable dans la structure en utilisant le hdata, sous forme d'entier. -Prototype : +Prototype : [source,C] ---- int weechat_hdata_integer (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (doit être de type "integer"); pour les tableaux, +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (doit être de type "integer"); pour les tableaux, le nom peut être "N|name" où N est un index dans le tableau (démarrant à 0), - par exemple : "2|name" + par exemple : "2|name" -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme d'entier -Exemple en C : +Exemple en C : [source,C] ---- @@ -15357,7 +15357,7 @@ struct t_gui_buffer *buffer = weechat_buffer_search_main (); weechat_printf (NULL, "number = %d", weechat_hdata_integer (hdata, buffer, "number")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15377,33 +15377,33 @@ _WeeChat ≥ 0.3.6._ Retourner la valeur de la variable dans la structure en utilisant le hdata, sous forme d'entier long. -Prototype : +Prototype : [source,C] ---- long weechat_hdata_long (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (doit être de type "long"); pour les tableaux, +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (doit être de type "long"); pour les tableaux, le nom peut être "N|name" où N est un index dans le tableau (démarrant à 0), - par exemple : "2|name" + par exemple : "2|name" -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme d'entier long -Exemple en C : +Exemple en C : [source,C] ---- weechat_printf (NULL, "longvar = %ld", weechat_hdata_long (hdata, pointer, "longvar")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15421,26 +15421,26 @@ _WeeChat ≥ 0.3.6._ Retourner la valeur de la variable dans la structure en utilisant le hdata, sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- const char *weechat_hdata_string (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (doit être de type "string"); pour les tableaux, +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (doit être de type "string"); pour les tableaux, le nom peut être "N|name" où N est un index dans le tableau (démarrant à 0), - par exemple : "2|name" + par exemple : "2|name" -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de chaîne -Exemple en C : +Exemple en C : [source,C] ---- @@ -15449,7 +15449,7 @@ struct t_gui_buffer *buffer = weechat_buffer_search_main (); weechat_printf (NULL, "name = %s", weechat_hdata_string (hdata, buffer, "name")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15469,26 +15469,26 @@ _WeeChat ≥ 0.3.6._ Retourner la valeur de la variable dans la structure en utilisant le hdata, sous forme de pointeur. -Prototype : +Prototype : [source,C] ---- void *weechat_hdata_pointer (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (doit être de type "pointeur"); pour les tableaux, +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (doit être de type "pointeur"); pour les tableaux, le nom peut être "N|name" où N est un index dans le tableau (démarrant à 0), - par exemple : "2|name" + par exemple : "2|name" -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de pointeur -Exemple en C : +Exemple en C : [source,C] ---- @@ -15497,7 +15497,7 @@ struct t_gui_buffer *buffer = weechat_buffer_search_main (); weechat_printf (NULL, "lines = %lx", weechat_hdata_pointer (hdata, buffer, "lines")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15517,26 +15517,26 @@ _WeeChat ≥ 0.3.6._ Retourner la valeur de la variable dans la structure en utilisant le hdata, sous forme de date/heure. -Prototype : +Prototype : [source,C] ---- time_t weechat_hdata_time (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (doit être de type "time"); pour les tableaux, +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (doit être de type "time"); pour les tableaux, le nom peut être "N|name" où N est un index dans le tableau (démarrant à 0), - par exemple : "2|name" + par exemple : "2|name" -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de date/heure -Exemple en C : +Exemple en C : [source,C] ---- @@ -15561,7 +15561,7 @@ if (ptr) } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15587,26 +15587,26 @@ _WeeChat ≥ 0.3.7._ Retourner la valeur de la variable dans la structure en utilisant le hdata, sous forme de table de hachage. -Prototype : +Prototype : [source,C] ---- struct t_hashtable *weechat_hdata_hashtable (struct t_hdata *hdata, void *pointer, const char *name); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (doit être de type "hashtable"); pour les +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (doit être de type "hashtable"); pour les tableaux, le nom peut être "N|name" où N est un index dans le tableau - (démarrant à 0), par exemple : "2|name" + (démarrant à 0), par exemple : "2|name" -Valeur de retour : +Valeur de retour : * valeur de la variable, sous forme de pointeur vers la table de hachage -Exemple en C : +Exemple en C : [source,C] ---- @@ -15617,7 +15617,7 @@ weechat_printf (NULL, "%d variables locales dans le tampon principal", weechat_hashtable_get_integer (hashtable, "items_count")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15628,7 +15628,7 @@ hashtable = weechat.hdata_hashtable(hdata, pointer, name) hdata = weechat.hdata_get("buffer") buffer = weechat.buffer_search_main() hash = weechat.hdata_hashtable(hdata, buffer, "local_variables") -weechat.prnt("", "variables locales dans le tampon principal :") +weechat.prnt("", "variables locales dans le tampon principal :") for key in hash: weechat.prnt("", " %s == %s" % (key, hash[key])) ---- @@ -15644,26 +15644,26 @@ Cette fonction ne peut être appelée que dans un "callback" de mise à jour (voir <<_hdata_new,hdata_new>> et <<_hdata_update,hdata_update>>), si la variable peut être mise à jour. -Prototype : +Prototype : [source,C] ---- int weechat_hdata_set (struct t_hdata *hdata, void *pointer, const char *name, const char *value); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _name_ : nom de la variable (types autorisés : char, integer, long, string, +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _name_ : nom de la variable (types autorisés : char, integer, long, string, pointer, time) -* _value_ : nouvelle valeur pour la variable +* _value_ : nouvelle valeur pour la variable -Valeur de retour : +Valeur de retour : * 1 si ok, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -15679,36 +15679,36 @@ _WeeChat ≥ 0.3.9._ Mettre à jour des données dans le hdata. -Prototype : +Prototype : [source,C] ---- int weechat_hdata_update (struct t_hdata *hdata, void *pointer, struct t_hashtable *hashtable); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _pointer_ : pointeur vers un objet WeeChat ou d'une extension -* _hashtable_ : variables à mettre à jour : les clés sont les noms des +* _hdata_ : pointeur vers le hdata +* _pointer_ : pointeur vers un objet WeeChat ou d'une extension +* _hashtable_ : variables à mettre à jour : les clés sont les noms des variables, les valeurs sont les nouvelles valeurs pour les variables (clés et valeurs sont des chaînes de caractères), quelques clés spéciales sont - acceptées : -** clé `__create_allowed` (avec n'importe quelle valeur) : retourne 1 si la + acceptées : +** clé `__create_allowed` (avec n'importe quelle valeur) : retourne 1 si la création est autorisée pour la structure, sinon 0 _(WeeChat ≥ 0.4.0)_ -** clé `__delete_allowed` (avec n'importe quelle valeur) : retourne 1 si la +** clé `__delete_allowed` (avec n'importe quelle valeur) : retourne 1 si la suppression est autorisée pour la structure, sinon 0 -** clé `__update_allowed`, la valeur est le nom d'une variable : retourne 1 si +** clé `__update_allowed`, la valeur est le nom d'une variable : retourne 1 si la mise à jour est autorisée pour la variable, sinon 0 -** clé `__delete` (avec n'importe quelle valeur) : supprime la structure +** clé `__delete` (avec n'importe quelle valeur) : supprime la structure (si autorisé) -Valeur de retour : +Valeur de retour : * nombre de variables mises à jour -Exemple en C : +Exemple en C : [source,C] ---- @@ -15716,7 +15716,7 @@ Exemple en C : struct t_gui_lines *own_lines; struct t_gui_line *line; -struct t_gui_line_data *line_data; +struct t_gui_line_data *line_data; struct t_hdata *hdata; struct t_hashtable *hashtable; char str_date[64]; @@ -15745,14 +15745,14 @@ if (own_lines) } ---- -Script (Python) : +Script (Python) : [source,python] ---- # prototype count = weechat.hdata_update(hdata, pointer, hashtable) -# exemple : soustrait une heure sur le dernier message affiché dans le tampon courant +# exemple : soustrait une heure sur le dernier message affiché dans le tampon courant own_lines = weechat.hdata_pointer(weechat.hdata_get("buffer"), weechat.current_buffer(), "own_lines") if own_lines: line = weechat.hdata_pointer(weechat.hdata_get("lines"), own_lines, "last_line") @@ -15768,47 +15768,47 @@ _WeeChat ≥ 0.3.6._ Retourner une valeur pour une propriété d'un hdata sous forme de chaîne. -Prototype : +Prototype : [source,C] ---- const char *weechat_hdata_get_string (struct t_hdata *hdata, const char *property); ---- -Paramètres : +Paramètres : -* _hdata_ : pointeur vers le hdata -* _property_ : nom de la propriété : -** _var_keys_ : chaîne avec la liste des clés pour les variables du hdata - (format : "key1,key2,key3") -** _var_values_ : chaîne avec la liste des valeurs pour les variables du hdata - (format : "value1,value2,value3") -** _var_keys_values_ : chaîne avec la liste des clés et valeurs pour les - variables du hdata (format : "key1:value1,key2:value2,key3:value3") -** _var_prev_ : nom de la variable dans la structure qui est un pointeur vers +* _hdata_ : pointeur vers le hdata +* _property_ : nom de la propriété : +** _var_keys_ : chaîne avec la liste des clés pour les variables du hdata + (format : "key1,key2,key3") +** _var_values_ : chaîne avec la liste des valeurs pour les variables du hdata + (format : "value1,value2,value3") +** _var_keys_values_ : chaîne avec la liste des clés et valeurs pour les + variables du hdata (format : "key1:value1,key2:value2,key3:value3") +** _var_prev_ : nom de la variable dans la structure qui est un pointeur vers l'élément précédent dans la liste -** _var_next_ : nom de la variable dans la structure qui est un pointeur vers +** _var_next_ : nom de la variable dans la structure qui est un pointeur vers l'élément suivant dans la liste -** _list_keys_ : chaîne avec la liste des clés pour les listes du hdata - (format : "key1,key2,key3") -** _list_values_ : chaîne avec la liste des valeurs pour les listes du hdata - (format : "value1,value2,value3") -** _list_keys_values_ : chaîne avec la liste des clés et valeurs pour les listes - du hdata (format : "key1:value1,key2:value2,key3:value3") +** _list_keys_ : chaîne avec la liste des clés pour les listes du hdata + (format : "key1,key2,key3") +** _list_values_ : chaîne avec la liste des valeurs pour les listes du hdata + (format : "value1,value2,value3") +** _list_keys_values_ : chaîne avec la liste des clés et valeurs pour les listes + du hdata (format : "key1:value1,key2:value2,key3:value3") -Valeur de retour : +Valeur de retour : * valeur de la propriété sous forme de chaîne -Exemple en C : +Exemple en C : [source,C] ---- -weechat_printf (NULL, "variables dans le hdata : %s", weechat_hdata_get_string (hdata, "var_keys")); -weechat_printf (NULL, "listes dans le hdata : %s", weechat_hdata_get_string (hdata, "list_keys")); +weechat_printf (NULL, "variables dans le hdata : %s", weechat_hdata_get_string (hdata, "var_keys")); +weechat_printf (NULL, "listes dans le hdata : %s", weechat_hdata_get_string (hdata, "list_keys")); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15816,8 +15816,8 @@ Script (Python) : value = weechat.hdata_get_string(hdata, property) # exemple -weechat.prnt("", "variables dans le hdata : %s" % weechat.hdata_get_string(hdata, "var_keys")) -weechat.prnt("", "listes dans le hdata : %s" % weechat.hdata_get_string(hdata, "list_keys")) +weechat.prnt("", "variables dans le hdata : %s" % weechat.hdata_get_string(hdata, "var_keys")) +weechat.prnt("", "listes dans le hdata : %s" % weechat.hdata_get_string(hdata, "list_keys")) ---- [[upgrade]] @@ -15831,7 +15831,7 @@ _Mis à jour dans la 1.5._ Créer ou lire un fichier pour la mise à jour. -Prototype : +Prototype : [source,C] ---- @@ -15845,34 +15845,34 @@ struct t_upgrade_file *upgrade_file_new (const char *filename, void *callback_read_data); ---- -Paramètres : +Paramètres : -* _filename_ : nom du fichier (l'extension ".upgrade" est ajoutée +* _filename_ : nom du fichier (l'extension ".upgrade" est ajoutée automatiquement par WeeChat) -* _callback_read_ : fonction appelée pour chaque objet lu dans le fichier de +* _callback_read_ : fonction appelée pour chaque objet lu dans le fichier de mise à jour (si NULL, le fichier pour la mise à jour est ouvert en - écriture), paramètres et valeur de retour : -** _const void *pointer_ : pointeur -** _void *data_ : pointeur -** _struct t_upgrade_file *upgrade_file_ : pointeur vers le fichier de mise à + écriture), paramètres et valeur de retour : +** _const void *pointer_ : pointeur +** _void *data_ : pointeur +** _struct t_upgrade_file *upgrade_file_ : pointeur vers le fichier de mise à jour -** _int object_id_ : identifiant de l'objet -** _struct t_infolist *infolist_ : infolist avec le contenu de l'objet -** valeur de retour : +** _int object_id_ : identifiant de l'objet +** _struct t_infolist *infolist_ : infolist avec le contenu de l'objet +** valeur de retour : *** _WEECHAT_RC_OK_ *** _WEECHAT_RC_ERROR_ -* _callback_read_pointer_ : pointeur donné au "callback" lorsqu'il est appelé +* _callback_read_pointer_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat -* _callback_read_data_ : pointeur donné au "callback" lorsqu'il est appelé par +* _callback_read_data_ : pointeur donné au "callback" lorsqu'il est appelé par WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction similaire) et est automatiquement libéré (par free) lorsque le fichier de mise à jour est fermé -Valeur de retour : +Valeur de retour : * pointeur vers le fichier de mise à jour -Exemple en C : +Exemple en C : [source,C] ---- @@ -15880,7 +15880,7 @@ struct t_upgrade_file *upgrade_file = weechat_upgrade_new ("mon_fichier", NULL, NULL, NULL); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15895,7 +15895,7 @@ upgrade_file = weechat.upgrade_new("mon_fichier", "", "") Écrire un objet dans le fichier de mise à jour. -Prototype : +Prototype : [source,C] ---- @@ -15904,17 +15904,17 @@ int weechat_upgrade_write_object (struct t_upgrade_file *upgrade_file, struct t_infolist *infolist); ---- -Paramètres : +Paramètres : -* _upgrade_file_ : pointeur vers le fichier de mise à jour -* _object_id_ : identifiant de l'objet -* _infolist_ : infolist à écrire dans le fichier +* _upgrade_file_ : pointeur vers le fichier de mise à jour +* _object_id_ : identifiant de l'objet +* _infolist_ : infolist à écrire dans le fichier -Valeur de retour : +Valeur de retour : * 1 si ok, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- @@ -15928,7 +15928,7 @@ else } ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15945,29 +15945,29 @@ _Mis à jour dans la 1.5._ Lire un fichier de mise à jour. -Prototype : +Prototype : [source,C] ---- int weechat_upgrade_read (struct t_upgrade_file *upgrade_file); ---- -Paramètres : +Paramètres : -* _upgrade_file_ : pointeur vers le fichier de mise à jour +* _upgrade_file_ : pointeur vers le fichier de mise à jour -Valeur de retour : +Valeur de retour : * 1 si ok, 0 en cas d'erreur -Exemple en C : +Exemple en C : [source,C] ---- weechat_upgrade_read (upgrade_file); ---- -Script (Python) : +Script (Python) : [source,python] ---- @@ -15982,25 +15982,25 @@ weechat.upgrade_read(upgrade_file) Fermer un fichier de mise à jour. -Prototype : +Prototype : [source,C] ---- void weechat_upgrade_close (struct t_upgrade_file *upgrade_file); ---- -Paramètres : +Paramètres : -* _upgrade_file_ : pointeur vers le fichier de mise à jour +* _upgrade_file_ : pointeur vers le fichier de mise à jour -Exemple en C : +Exemple en C : [source,C] ---- weechat_upgrade_close (upgrade_file); ---- -Script (Python) : +Script (Python) : [source,python] ---- diff --git a/doc/fr/weechat_quickstart.fr.adoc b/doc/fr/weechat_quickstart.fr.adoc index e6c73c221..b7fb911e6 100644 --- a/doc/fr/weechat_quickstart.fr.adoc +++ b/doc/fr/weechat_quickstart.fr.adoc @@ -12,10 +12,10 @@ == Démarrer WeeChat Un émulateur de terminal recommandé pour X (mais pas obligatoire) est -rxvt-unicode : il a un bon support UTF-8, et aucun problème avec les +rxvt-unicode : il a un bon support UTF-8, et aucun problème avec les touches par défaut. -Lancer depuis votre shell : +Lancer depuis votre shell : ---- $ weechat @@ -24,19 +24,19 @@ $ weechat [[help_options]] == Aide en ligne / options -WeeChat dispose d'aide pour toutes les commandes, tapez simplement : +WeeChat dispose d'aide pour toutes les commandes, tapez simplement : ---- /help ---- -Pour avoir de l'aide sur une commande, tapez : +Pour avoir de l'aide sur une commande, tapez : ---- /help commande ---- -Pour modifier des options, tapez : +Pour modifier des options, tapez : ---- /set config.section.option valeur @@ -52,28 +52,28 @@ besoin de redémarrer WeeChat après avoir changé la configuration). Vous pouvez utiliser `/set` avec un nom partiel d'option et le caractère joker "*" au début ou à la fin pour afficher toutes les options contenant ces lettres. -Par exemple : +Par exemple : -* Afficher toutes les options (WeeChat et extensions) : +* Afficher toutes les options (WeeChat et extensions) : ---- /set ---- -* Afficher les options WeeChat : +* Afficher les options WeeChat : ---- /set weechat.* ---- -* Afficher les options de l'extension IRC : +* Afficher les options de l'extension IRC : ---- /set irc.* ---- -Vous pouvez afficher de l'aide sur une option avec `/help`, par exemple : +Vous pouvez afficher de l'aide sur une option avec `/help`, par exemple : ---- /help weechat.look.highlight @@ -96,7 +96,7 @@ valeur et applique les changements immédiatement. Le cœur de WeeChat ("core") ne fait qu'afficher les données à l'écran et interagir avec l'utilisateur, cela signifie que le cœur sans extension -n'a pas grand intérêt (utilisateurs fidèles : IRC faisait partie du cœur +n'a pas grand intérêt (utilisateurs fidèles : IRC faisait partie du cœur dans les versions ≤ 0.2.6). Tous les protocoles réseau comme IRC sont fournis sous forme d'extensions. @@ -107,13 +107,13 @@ devriez voir "irc" et d'autres extensions dans cette liste. [[add_irc_server]] == Ajouter un serveur IRC -Vous pouvez ajouter un serveur IRC avec la commande `/server`, par exemple : +Vous pouvez ajouter un serveur IRC avec la commande `/server`, par exemple : ---- /server add freenode chat.freenode.net ---- -Comme d'habitude, de l'aide est disponible si vous êtes perdus : +Comme d'habitude, de l'aide est disponible si vous êtes perdus : ---- /help server @@ -131,26 +131,26 @@ définie (non "null"). Sinon WeeChat utilise la valeur par défaut ("irc.server_default.xxx"). Par exemple il y a des pseudos par défaut (basés sur votre login un*x), et -vous pouvez les écraser pour le serveur freenode avec la commande suivante : +vous pouvez les écraser pour le serveur freenode avec la commande suivante : ---- /set irc.server.freenode.nicks "pseudo,pseudo2,pseudo3,pseudo4,pseudo5" ---- -Pour modifier le nom d'utilisateur et nom réel : +Pour modifier le nom d'utilisateur et nom réel : ---- /set irc.server.freenode.username "Mon nom d'utilisateur" /set irc.server.freenode.realname "Mon nom réel" ---- -Pour activer la connexion automatique au serveur lors du démarrage : +Pour activer la connexion automatique au serveur lors du démarrage : ---- /set irc.server.freenode.autoconnect on ---- -Pour se connecter avec SSL : +Pour se connecter avec SSL : ---- /set irc.server.freenode.addresses "chat.freenode.net/7000" @@ -158,7 +158,7 @@ Pour se connecter avec SSL : ---- Si SASL est disponible sur le serveur, vous pouvez l'utiliser pour -l'authentification (vous serez identifié avant de rejoindre les canaux) : +l'authentification (vous serez identifié avant de rejoindre les canaux) : ---- /set irc.server.freenode.sasl_username "pseudo" @@ -167,7 +167,7 @@ l'authentification (vous serez identifié avant de rejoindre les canaux) : Pour lancer une commande après connexion au serveur, par exemple pour s'authentifier auprès de nickserv (seulement si vous n'utilisez pas SASL pour -l'authentification) : +l'authentification) : ---- /set irc.server.freenode.command "/msg nickserv identify xxxxxxx" @@ -180,26 +180,26 @@ Plusieurs commandes dans l'option _command_ peuvent être séparées par `;` Si vous souhaitez protéger votre mot de passe dans les fichiers de configuration, vous pouvez utiliser les données sécurisées. -Définissez d'abord une phrase de chiffrement : +Définissez d'abord une phrase de chiffrement : ---- /secure passphrase this is my secret passphrase ---- -Puis ajoutez une donnée sécurisée avec votre mot de passe freenode : +Puis ajoutez une donnée sécurisée avec votre mot de passe freenode : ---- /secure set freenode_password xxxxxxx ---- Vous pouvez alors utiliser `+${sec.data.freenode_password}+` au lieu de votre -mot de passe dans les options IRC mentionnées ci-dessus, par exemple : +mot de passe dans les options IRC mentionnées ci-dessus, par exemple : ---- /set irc.server.freenode.sasl_password "${sec.data.freenode_password}" ---- -Pour rejoindre automatiquement des canaux lors de la connexion au serveur : +Pour rejoindre automatiquement des canaux lors de la connexion au serveur : ---- /set irc.server.freenode.autojoin "#canal1,#canal2" @@ -207,14 +207,14 @@ Pour rejoindre automatiquement des canaux lors de la connexion au serveur : Pour supprimer la valeur d'une option du serveur et utiliser sa valeur par défaut à la place, par exemple pour utiliser les pseudos par défaut -(irc.server_default.nicks) : +(irc.server_default.nicks) : ---- /set irc.server.freenode.nicks null ---- -Autres options : vous pouvez modifier les autres options avec la commande -suivante ("xxx" est le nom d'une option) : +Autres options : vous pouvez modifier les autres options avec la commande +suivante ("xxx" est le nom d'une option) : ---- /set irc.server.freenode.xxx valeur @@ -237,7 +237,7 @@ WeeChat. Pour basculer entre le tampon _core_ et les tampons des serveurs, il faut utiliser la touche kbd:[Ctrl+x]. Il est possible de désactiver le mélange des tampons serveurs pour avoir un -tampon distinct par serveur : +tampon distinct par serveur : ---- /set irc.look.server_buffer independent @@ -246,20 +246,20 @@ tampon distinct par serveur : [[join_part_irc_channels]] == Rejoindre/quitter les canaux IRC -Rejoindre un canal : +Rejoindre un canal : ---- /join #channel ---- -Quitter un canal (en laissant le tampon ouvert) : +Quitter un canal (en laissant le tampon ouvert) : ---- /part [message de fin] ---- Fermer un tampon serveur, canal ou privé (`/close` est un alias sur -`/buffer close`) : +`/buffer close`) : ---- /close @@ -268,7 +268,7 @@ Fermer un tampon serveur, canal ou privé (`/close` est un alias sur [WARNING] Fermer le tampon du serveur fermera tous les tampons canaux/privés. -Se déconnecter du serveur, sur le tampon du serveur : +Se déconnecter du serveur, sur le tampon du serveur : ---- /disconnect @@ -277,13 +277,13 @@ Se déconnecter du serveur, sur le tampon du serveur : [[irc_private_messages]] == Messages privés IRC -Ouvrir un tampon et envoyer un message à un autre utilisateur (pseudo _foo_) : +Ouvrir un tampon et envoyer un message à un autre utilisateur (pseudo _foo_) : ---- /query foo ceci est un message ---- -Fermer le tampon privé : +Fermer le tampon privé : ---- /close @@ -299,7 +299,7 @@ Une fenêtre ("window") est une vue sur un tampon. Par défaut il n'y a qu'une fenêtre affichant un tampon. Si vous divisez l'écran, vous verrez alors plusieurs fenêtres avec plusieurs tampons en même temps. -Commandes pour gérer les tampons et les fenêtres : +Commandes pour gérer les tampons et les fenêtres : ---- /buffer @@ -310,13 +310,13 @@ Commandes pour gérer les tampons et les fenêtres : avec /help) Par exemple, pour découper verticalement l'écran en une petite fenêtre -(1/3 de la largeur) et une large (2/3), utilisez la commande : +(1/3 de la largeur) et une large (2/3), utilisez la commande : ---- /window splitv 33 ---- -Pour supprimer le découpage : +Pour supprimer le découpage : ---- /window merge @@ -327,35 +327,35 @@ Pour supprimer le découpage : WeeChat utilise un certain nombre de touches par défaut. Toutes ces touches sont dans la documentation, mais vous devriez connaître au moins -les touches vitales : +les touches vitales : -- kbd:[Alt+←] / kbd:[Alt+→] ou kbd:[F5] / kbd:[F6] : aller au tampon +- kbd:[Alt+←] / kbd:[Alt+→] ou kbd:[F5] / kbd:[F6] : aller au tampon précédent/suivant -- kbd:[F7] / kbd:[F8] : aller à la fenêtre précédente/suivante (quand l'écran +- kbd:[F7] / kbd:[F8] : aller à la fenêtre précédente/suivante (quand l'écran est divisé) -- kbd:[F9] / kbd:[F10] : faire défiler la barre de titre -- kbd:[F11] / kbd:[F12] : faire défiler la liste des pseudos -- kbd:[Tab] : compléter le texte de la barre d'entrée, comme avec votre shell -- kbd:[PgUp] / kbd:[PgDn] : faire défiler le texte dans le tampon courant -- kbd:[Alt+a] : sauter au tampon avec de l'activité (dans la "hotlist") +- kbd:[F9] / kbd:[F10] : faire défiler la barre de titre +- kbd:[F11] / kbd:[F12] : faire défiler la liste des pseudos +- kbd:[Tab] : compléter le texte de la barre d'entrée, comme avec votre shell +- kbd:[PgUp] / kbd:[PgDn] : faire défiler le texte dans le tampon courant +- kbd:[Alt+a] : sauter au tampon avec de l'activité (dans la "hotlist") Selon votre clavier et/ou vos besoins, vous pouvez associer n'importe quelle touche à une commande avec la commande `/key`. Une touche utile est kbd:[Alt+k] pour trouver le code des touches. -Par exemple, pour associer kbd:[Alt+!] à la commande `/buffer close` : +Par exemple, pour associer kbd:[Alt+!] à la commande `/buffer close` : ---- /key bind (pressez alt-k) (pressez alt-!) /buffer close ---- -Vous aurez une ligne de commande qui ressemble à ceci : +Vous aurez une ligne de commande qui ressemble à ceci : ---- /key bind meta-! /buffer close ---- -Pour enlever la touche : +Pour enlever la touche : ---- /key unbind meta-! @@ -372,7 +372,7 @@ extensions ou des scripts). De nombreux scripts externes (de contributeurs) sont disponibles pour WeeChat, vous pouvez télécharger et installer les scripts avec la commande `/script`, -par exemple : +par exemple : ---- /script install iset.pl @@ -380,13 +380,13 @@ par exemple : Voir `/help script` pour plus d'infos. -Une liste des scripts est disponible avec `/script` ou à cette URL : +Une liste des scripts est disponible avec `/script` ou à cette URL : https://weechat.org/scripts [[more_doc]] == Plus de documentation Vous pouvez maintenant utiliser WeeChat et lire la FAQ/documentation pour -toute autre question : https://weechat.org/doc +toute autre question : https://weechat.org/doc Bon WeeChat ! diff --git a/doc/fr/weechat_relay_protocol.fr.adoc b/doc/fr/weechat_relay_protocol.fr.adoc index 6d41acf55..384efdbea 100644 --- a/doc/fr/weechat_relay_protocol.fr.adoc +++ b/doc/fr/weechat_relay_protocol.fr.adoc @@ -9,7 +9,7 @@ :docinfo1: -Ce document est une spécification du protocole Relay de WeeChat : le protocole +Ce document est une spécification du protocole Relay de WeeChat : le protocole utilisé pour relayer les données de WeeChat aux clients, qui sont surtout des interfaces distantes. @@ -20,18 +20,18 @@ interfaces distantes. [[terminology]] === Terminologie -Les termes suivants sont utilisés dans ce document : +Les termes suivants sont utilisés dans ce document : -* _relay_ : il s'agit de l'extension "relay" de WeeChat, qui agit comme un +* _relay_ : il s'agit de l'extension "relay" de WeeChat, qui agit comme un "serveur" et autorise les _clients_ à se connecter -* _client_ : il s'agit d'un autre logiciel, connecté au _relay_ via une +* _client_ : il s'agit d'un autre logiciel, connecté au _relay_ via une connexion réseau; dans la plupart des cas, ce _client_ est une interface distante. [[network_diagram]] === Diagramme réseau -Les _clients_ sont connectés au _relay_ comme dans le diagramme ci-dessous : +Les _clients_ sont connectés au _relay_ comme dans le diagramme ci-dessous : .... ┌──────────┐ Station de travail @@ -71,19 +71,19 @@ un _proxy IRC_ (non décrit dans ce document). [[commands]] == Commandes (client → relay) -Les commandes ont le format : "(id) commande paramètres\n". +Les commandes ont le format : "(id) commande paramètres\n". -Les champs sont : +Les champs sont : -* _id_ : identifiant du message (facultatif) qui sera envoyée dans la réponse de +* _id_ : identifiant du message (facultatif) qui sera envoyée dans la réponse de _relay_; elle doit être entre parenthèses, et ne doit pas commencer par un underscore ("_") (les identifiants commençant par un underscore sont réservés pour les messages _évènements_ de WeeChat) -* _commande_ : une commande (voir le tableau ci-dessous) -* _paramètres_ : paramètres facultatifs pour la commande (plusieurs paramètres +* _commande_ : une commande (voir le tableau ci-dessous) +* _paramètres_ : paramètres facultatifs pour la commande (plusieurs paramètres sont séparés par des espaces). -Liste des commandes disponibles (détail dans les chapitres suivants) : +Liste des commandes disponibles (détail dans les chapitres suivants) : [width="80%",cols="^3m,14",options="header"] |=== @@ -106,27 +106,27 @@ Initialiser la connexion avec _relay_. Il doit s'agir de la première commande envoyée à _relay_. Si elle n'est pas envoyée, _relay_ coupera la connexion à la première commande reçue, sans avertissement. -Syntaxe : +Syntaxe : ---- init [