1
0
mirror of https://github.com/weechat/weechat.git synced 2026-07-06 09:43:13 +02:00

api: allow to catch multiple signals in functions hook_signal and hook_hsignal (closes #1780)

This commit is contained in:
Sébastien Helleu
2022-04-24 21:37:38 +02:00
parent f69ef840e0
commit b7f3127bf8
14 changed files with 226 additions and 199 deletions
+10 -8
View File
@@ -10282,7 +10282,7 @@ hook = weechat.hook_print("", "", "", 1, "my_print_cb", "")
==== hook_signal
_Updated in 1.5._
_Updated in 1.5, 3.6._
Hook a signal.
@@ -10302,7 +10302,8 @@ struct t_hook *weechat_hook_signal (const char *signal,
Arguments:
* _signal_: signal to catch, wildcard `+*+` is allowed
* _signal_: signal to catch, wildcard `+*+` is allowed; multiple signals can
be separated by semi-colons
(priority allowed, see note about <<hook_priority,priority>>)
(see table below)
* _callback_: function called when signal is received, arguments and return
@@ -10982,8 +10983,8 @@ my_signal_cb (const void *pointer, void *data, const char *signal,
return WEECHAT_RC_OK;
}
/* catch signal "quit" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit",
/* catch signals "quit" and "upgrade" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit;upgrade",
&my_signal_cb, NULL, NULL);
----
@@ -10999,8 +11000,8 @@ def my_signal_cb(data, signal, signal_data):
# ...
return weechat.WEECHAT_RC_OK
# catch signal "quit"
hook = weechat.hook_signal("quit", "my_signal_cb", "")
# catch signals "quit" and "upgrade"
hook = weechat.hook_signal("quit;upgrade", "my_signal_cb", "")
----
==== hook_signal_send
@@ -11204,7 +11205,7 @@ weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
==== hook_hsignal
_WeeChat ≥ 0.3.4, updated in 1.5._
_WeeChat ≥ 0.3.4, updated in 1.5, 3.6._
Hook a hsignal (signal with hashtable).
@@ -11223,7 +11224,8 @@ struct t_hook *weechat_hook_hsignal (const char *signal,
Arguments:
* _signal_: signal to catch, wildcard `+*+` is allowed
* _signal_: signal to catch, wildcard `+*+` is allowed; multiple signals can
be separated by semi-colons
(priority allowed, see note about <<hook_priority,priority>>)
(see table below)
* _callback_: function called when signal is received, arguments and return
+10 -8
View File
@@ -10487,7 +10487,7 @@ hook = weechat.hook_print("", "", "", 1, "my_print_cb", "")
==== hook_signal
_Mis à jour dans la 1.5._
_Mis à jour dans la 1.5, 3.6._
S'accrocher à un signal.
@@ -10507,7 +10507,8 @@ struct t_hook *weechat_hook_signal (const char *signal,
Paramètres :
* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé
* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé,
plusieurs signaux peuvent être séparés par des point-virgules
(priorité autorisée, voir la note sur la <<hook_priority,priorité>>)
(voir le tableau ci-dessous)
* _callback_ : fonction appelée quand le signal est reçu, paramètres et valeur
@@ -11201,8 +11202,8 @@ my_signal_cb (const void *pointer, void *data, const char *signal,
return WEECHAT_RC_OK;
}
/* intercepter le signal "quit" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit",
/* intercepter les signaux "quit" et "upgrade" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit;upgrade",
&my_signal_cb, NULL, NULL);
----
@@ -11218,8 +11219,8 @@ def my_signal_cb(data, signal, signal_data):
# ...
return weechat.WEECHAT_RC_OK
# intercepter le signal "quit"
hook = weechat.hook_signal("quit", "my_signal_cb", "")
# intercepter les signaux "quit" et "upgrade"
hook = weechat.hook_signal("quit;upgrade", "my_signal_cb", "")
----
==== hook_signal_send
@@ -11431,7 +11432,7 @@ weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
==== hook_hsignal
_WeeChat ≥ 0.3.4, mis à jour dans la 1.5._
_WeeChat ≥ 0.3.4, mis à jour dans la 1.5, 3.6._
S'accrocher à un hsignal (signal avec une table de hachage).
@@ -11450,7 +11451,8 @@ struct t_hook *weechat_hook_hsignal (const char *signal,
Paramètres :
* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé
* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé,
plusieurs signaux peuvent être séparés par des point-virgules
(priorité autorisée, voir la note sur la <<hook_priority,priorité>>)
(voir le tableau ci-dessous)
* _callback_ : fonction appelée quand le signal est reçu, paramètres et valeur
+12 -8
View File
@@ -10610,7 +10610,7 @@ hook = weechat.hook_print("", "", "", 1, "my_print_cb", "")
==== hook_signal
// TRANSLATION MISSING
_Updated in 1.5._
_Updated in 1.5, 3.6._
Hook su un segnale.
@@ -10631,7 +10631,8 @@ struct t_hook *weechat_hook_signal (const char *signal,
Argomenti:
// TRANSLATION MISSING
* _signal_: segnale da catturare, wildcard `+*+` is allowed
* _signal_: segnale da catturare, wildcard `+*+` is allowed, multiple signals
can be separated by semi-colons
(priorità consentita, consultare la nota riguardo la
<<hook_priority,priority>>), see table below
* _callback_: funzione chiamata a segnale ricevuto, argomenti e valore
@@ -11402,6 +11403,7 @@ List of signals sent by WeeChat and plugins:
Esempio in C:
// TRANSLATION MISSING
[source,c]
----
int
@@ -11412,13 +11414,14 @@ my_signal_cb (const void *pointer, void *data, const char *signal,
return WEECHAT_RC_OK;
}
/* cattura il segnale "quit" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit",
/* catch signals "quit" and "upgrade" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit;upgrade",
&my_signal_cb, NULL, NULL);
----
Script (Python):
// TRANLSATION MISSING
[source,python]
----
# prototipo
@@ -11429,8 +11432,8 @@ def my_signal_cb(data, signal, signal_data):
# ...
return weechat.WEECHAT_RC_OK
# cattura il segnale "quit"
hook = weechat.hook_signal("quit", "my_signal_cb", "")
# catch signals "quit" and "upgrade"
hook = weechat.hook_signal("quit;upgrade", "my_signal_cb", "")
----
==== hook_signal_send
@@ -11648,7 +11651,7 @@ weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
==== hook_hsignal
_WeeChat ≥ 0.3.4, updated in 1.5._
_WeeChat ≥ 0.3.4, updated in 1.5, 3.6._
Hook su hsignal (segnale con tabella hash).
@@ -11668,7 +11671,8 @@ struct t_hook *weechat_hook_hsignal (const char *signal,
Argomenti:
// TRANSLATION MISSING
* _signal_: segnale da catturare, wildcard `+*+` is allowed
* _signal_: segnale da catturare, wildcard `+*+` is allowed, multiple signals can
be separated by semi-colons
(priorità consentita, consultare la nota a proposito di <<hook_priority,priority>>),
see table below
* _callback_: funzione chiamata a segnale ricevuto, argomenti e valore
+12 -8
View File
@@ -10311,7 +10311,7 @@ hook = weechat.hook_print("", "", "", 1, "my_print_cb", "")
==== hook_signal
_WeeChat バージョン 1.5 で更新。_
_WeeChat バージョン 1.5, 3.6 で更新。_
シグナルをフックする。
@@ -10331,7 +10331,9 @@ struct t_hook *weechat_hook_signal (const char *signal,
引数:
* _signal_: キャッチするシグナル、ワイルドカード `+*+` を使うことができます
// TRANSLATION MISSING
* _signal_: キャッチするシグナル、ワイルドカード `+*+` を使うことができます,
multiple signals can be separated by semi-colons
(優先度の設定が可能、<<hook_priority,フックの優先度>>に関する注意を参照)
(以下の表を参照)
* _callback_:
@@ -11024,8 +11026,8 @@ my_signal_cb (const void *pointer, void *data, const char *signal,
return WEECHAT_RC_OK;
}
/* catch signal "quit" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit",
/* catch signals "quit" and "upgrade" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit;upgrade",
&my_signal_cb, NULL, NULL);
----
@@ -11041,8 +11043,8 @@ def my_signal_cb(data, signal, signal_data):
# ...
return weechat.WEECHAT_RC_OK
# catch signal "quit"
hook = weechat.hook_signal("quit", "my_signal_cb", "")
# catch signals "quit" and "upgrade"
hook = weechat.hook_signal("quit;upgrade", "my_signal_cb", "")
----
==== hook_signal_send
@@ -11247,7 +11249,7 @@ weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
==== hook_hsignal
_WeeChat バージョン 0.3.4 以上で利用可、バージョン 1.5 で更新。_
_WeeChat バージョン 0.3.4 以上で利用可、バージョン 1.5, 3.6 で更新。_
hsignal (ハッシュテーブルを持つシグナル) をフック。
@@ -11266,7 +11268,9 @@ struct t_hook *weechat_hook_hsignal (const char *signal,
引数:
* _signal_: キャッチするシグナル、ワイルドカード `+*+` を使うことができます
// TRANSLATION MISSING
* _signal_: キャッチするシグナル、ワイルドカード `+*+` を使うことができます,
multiple signals can be separated by semi-colons
(優先度の設定が可能、<<hook_priority,フックの優先度>>に関する注意を参照)
(以下の表を参照)
* _callback_:
+15 -8
View File
@@ -9912,7 +9912,7 @@ hook = weechat.hook_print("", "", "", 1, "my_print_cb", "")
==== hook_signal
_Ажурирано у верзији 1.5._
_Ажурирано у верзији 1.5, 3.6._
Качи се на сигнал.
@@ -9932,7 +9932,10 @@ struct t_hook *weechat_hook_signal (const char *signal,
Аргументи:
* _signal_: сигнал који се хвата, дозвољава се џокер `+*+` (дозвољен је приоритет, погледајте напомену о <<hook_priority,приоритетима>>) (погледајте табелу испод)
// TRANSLATION MISSING
* _signal_: сигнал који се хвата, дозвољава се џокер `+*+`, multiple signals can
be separated by semi-colons
(дозвољен је приоритет, погледајте напомену о <<hook_priority,приоритетима>>) (погледајте табелу испод)
* _callback_: функција која се позива када се прими сигнал, аргументи и повратна вредност су:
** _const void *pointer_: показивач
** _void *data_: показивач
@@ -10596,6 +10599,7 @@ struct t_hook *weechat_hook_signal (const char *signal,
C пример:
// TRANSLATION MISSING
[source,c]
----
int
@@ -10606,13 +10610,14 @@ my_signal_cb (const void *pointer, void *data, const char *signal,
return WEECHAT_RC_OK;
}
/* хвата сигнал "quit" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit",
/* catch signals "quit" and "upgrade" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit;upgrade",
&my_signal_cb, NULL, NULL);
----
Скрипта (Python):
// TRANSLATION MISSING
[source,python]
----
# прототип
@@ -10623,8 +10628,8 @@ def my_signal_cb(data, signal, signal_data):
# ...
return weechat.WEECHAT_RC_OK
# хвата сигнал "quit"
hook = weechat.hook_signal("quit", "my_signal_cb", "")
# catch signals "quit" and "upgrade"
hook = weechat.hook_signal("quit;upgrade", "my_signal_cb", "")
----
==== hook_signal_send
@@ -10820,7 +10825,7 @@ weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
==== hook_hsignal
_WeeChat ≥ 0.3.4, ажурирано у верзији 1.5._
_WeeChat ≥ 0.3.4, ажурирано у верзији 1.5, 3.6._
Качи се на hsignal (сигнал са хеш табелом).
@@ -10839,7 +10844,9 @@ struct t_hook *weechat_hook_hsignal (const char *signal,
Аргументи:
* _signal_: сигнал који се хвата, дозвољава се џокер `+*+` (дозвољен је приоритет, погледајте напомену о <<hook_priority,приоритетима>>) (погледајте табелу испод)
* _signal_: сигнал који се хвата, дозвољава се џокер `+*+`, multiple signals can
be separated by semi-colons
(дозвољен је приоритет, погледајте напомену о <<hook_priority,приоритетима>>) (погледајте табелу испод)
* _callback_: функција која се позива када се прими сигнал, аргументи и повратна вредност су:
** _const void *pointer_: показивач
** _void *data_: показивач