api: add function "infolist_search_var"

4 files changed, 196 insertions, 0 deletions

diff --git a/doc/en/weechat_plugin_api.en.txt b/doc/en/weechat_plugin_api.en.txt
index 6e2466985..cc0fa8bf7 100644
--- a/doc/en/weechat_plugin_api.en.txt
+++ b/doc/en/weechat_plugin_api.en.txt
@@ -12718,6 +12718,53 @@ weechat.infolist_reset_item_cursor(infolist)
 weechat.infolist_reset_item_cursor(infolist)
 ----
 
+==== weechat_infolist_search_var
+
+_WeeChat ≥ 0.4.3._
+
+Search a variable in the current infolist item.
+
+Prototype:
+
+[source,C]
+----
+struct t_infolist_var *weechat_infolist_search_var (struct t_infolist *infolist,
+                                                    const char *name);
+----
+
+Arguments:
+
+* 'infolist': infolist pointer
+* 'name': variable name
+
+Return value:
+
+* pointer to variable found, NULL if the variable was not found
+
+C example:
+
+[source,C]
+----
+if (weechat_infolist_search_var (infolist, "name"))
+{
+    /* variable "name" exists */
+    /* ... */
+}
+----
+
+Script (Python):
+
+[source,python]
+----
+# prototype
+var = weechat.infolist_search_var(infolist, name)
+
+# example
+if weechat.infolist_search_var(infolist, "name"):
+    # variable "name" exists
+    # ...
+----
+
 ==== weechat_infolist_fields
 
 Return list of fields for current infolist item.
diff --git a/doc/fr/weechat_plugin_api.fr.txt b/doc/fr/weechat_plugin_api.fr.txt
index 9a0318ea7..c46cd955c 100644
--- a/doc/fr/weechat_plugin_api.fr.txt
+++ b/doc/fr/weechat_plugin_api.fr.txt
@@ -12941,6 +12941,53 @@ weechat.infolist_reset_item_cursor(infolist)
 weechat.infolist_reset_item_cursor(infolist)
 ----
 
+==== weechat_infolist_search_var
+
+_WeeChat ≥ 0.4.3._
+
+Chercher une variable dans l'objet courant de l'infolist.
+
+Prototype :
+
+[source,C]
+----
+struct t_infolist_var *weechat_infolist_search_var (struct t_infolist *infolist,
+                                                    const char *name);
+----
+
+Paramètres :
+
+* 'infolist' : pointeur vers l'infolist
+* 'name' : nom de la variable
+
+Valeur de retour :
+
+* ponteur vers la variable trouvée, NULL si la variable n'est pas trouvée
+
+Exemple en C :
+
+[source,C]
+----
+if (weechat_infolist_search_var (infolist, "name"))
+{
+    /* la variable "name" existe */
+    /* ... */
+}
+----
+
+Script (Python) :
+
+[source,python]
+----
+# prototype
+var = weechat.infolist_search_var(infolist, name)
+
+# exemple
+if weechat.infolist_search_var(infolist, "name"):
+    # la variable "name" existe
+    # ...
+----
+
 ==== weechat_infolist_fields
 
 Retourner la liste des champs pour l'objet courant de l'infolist.
diff --git a/doc/it/weechat_plugin_api.it.txt b/doc/it/weechat_plugin_api.it.txt
index c746a682a..f52d63a6c 100644
--- a/doc/it/weechat_plugin_api.it.txt
+++ b/doc/it/weechat_plugin_api.it.txt
@@ -13025,6 +13025,57 @@ weechat.infolist_reset_item_cursor(infolist)
 weechat.infolist_reset_item_cursor(infolist)
 ----
 
+==== weechat_infolist_search_var
+
+_WeeChat ≥ 0.4.3._
+
+// TRANSLATION MISSING
+Search a variable in the current infolist item.
+
+Prototipo:
+
+[source,C]
+----
+struct t_infolist_var *weechat_infolist_search_var (struct t_infolist *infolist,
+                                                    const char *name);
+----
+
+Argomenti:
+
+* 'infolist': puntatore alla lista info
+* 'name': nome della variabile
+
+Valore restituito:
+
+// TRANSLATION MISSING
+* pointer to variable found, NULL if the variable was not found
+
+Esempio in C:
+
+// TRANSLATION MISSING
+[source,C]
+----
+if (weechat_infolist_search_var (infolist, "name"))
+{
+    /* variable "name" exists */
+    /* ... */
+}
+----
+
+Script (Python):
+
+// TRANSLATION MISSING
+[source,python]
+----
+# prototipo
+var = weechat.infolist_search_var(infolist, name)
+
+# esempio
+if weechat.infolist_search_var(infolist, "name"):
+    # variable "name" exists
+    # ...
+----
+
 ==== weechat_infolist_fields
 
 Restituisce una lista di campi per l'elemento della
diff --git a/doc/ja/weechat_plugin_api.ja.txt b/doc/ja/weechat_plugin_api.ja.txt
index 387161722..52f9b8961 100644
--- a/doc/ja/weechat_plugin_api.ja.txt
+++ b/doc/ja/weechat_plugin_api.ja.txt
@@ -12715,6 +12715,57 @@ weechat.infolist_reset_item_cursor(infolist)
 weechat.infolist_reset_item_cursor(infolist)
 ----
 
+==== weechat_infolist_search_var
+
+_WeeChat バージョン 0.4.3 以上で利用可。_
+
+// TRANSLATION MISSING
+Search a variable in the current infolist item.
+
+プロトタイプ:
+
+[source,C]
+----
+struct t_infolist_var *weechat_infolist_search_var (struct t_infolist *infolist,
+                                                    const char *name);
+----
+
+引数:
+
+* 'infolist': インフォリストへのポインタ
+* 'name': 変数名
+
+戻り値:
+
+// TRANSLATION MISSING
+* pointer to variable found, NULL if the variable was not found
+
+C 言語での使用例:
+
+// TRANSLATION MISSING
+[source,C]
+----
+if (weechat_infolist_search_var (infolist, "name"))
+{
+    /* variable "name" exists */
+    /* ... */
+}
+----
+
+スクリプト (Python) での使用例:
+
+// TRANSLATION MISSING
+[source,python]
+----
+# prototype
+var = weechat.infolist_search_var(infolist, name)
+
+# example
+if weechat.infolist_search_var(infolist, "name"):
+    # variable "name" exists
+    # ...
+----
+
 ==== weechat_infolist_fields
 
 現在のインフォリストの要素に対するフィールドのリストを返す。