1
0
mirror of https://github.com/weechat/weechat.git synced 2026-06-27 13:26:38 +02:00

doc: update doc of function exec_on_files (plugin API reference)

This commit is contained in:
Sébastien Helleu
2016-03-27 11:08:04 +02:00
parent d3c21e355c
commit c5bb723298
4 changed files with 26 additions and 16 deletions
+6 -4
View File
@@ -2834,6 +2834,8 @@ weechat.mkdir_parents("/tmp/my/dir", 0755)
==== exec_on_files
_Updated in 1.5._
Find files in a directory and execute a callback on each file.
Prototype:
@@ -2842,19 +2844,19 @@ Prototype:
----
void weechat_exec_on_files (const char *directory,
int hidden_files,
void *data,
void (*callback)(void *data,
const char *filename));
const char *filename),
void *callback_data);
----
Arguments:
* 'directory': directory for searching files
* 'hidden_files': 1 to include hidden files, otherwise 0
* 'data': pointer given to callback when it is called by WeeChat
* 'callback': function called for each file found, arguments:
** 'void *data': pointer
** 'const char *filename': filename found
* 'callback_data': pointer given to callback when it is called by WeeChat
C example:
@@ -2865,7 +2867,7 @@ void callback (void *data, const char *filename)
/* ... */
}
...
weechat_exec_on_files ("/tmp", 0, NULL, &callback);
weechat_exec_on_files ("/tmp", 0, &callback, NULL);
----
[NOTE]
+7 -4
View File
@@ -2888,6 +2888,8 @@ weechat.mkdir_parents("/tmp/my/dir", 0755)
==== exec_on_files
_Mis à jour dans la 1.5._
Balayer les fichiers dans un répertoire et exécuter un "callback" pour chaque
fichier.
@@ -2897,19 +2899,20 @@ Prototype :
----
void weechat_exec_on_files (const char *directory,
int hidden_files,
void *data,
void (*callback)(void *data,
const char *filename));
const char *filename),
void *callback_data);
----
Paramètres :
* 'directory' : répertoire où chercher les fichiers
* 'hidden_files' : 1 pour inclure les fichiers cachés, sinon 0
* 'data' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat
* '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 :
@@ -2920,7 +2923,7 @@ void callback (void *data, const char *filename)
/* ... */
}
...
weechat_exec_on_files ("/tmp", 0, NULL, &callback);
weechat_exec_on_files ("/tmp", 0, &callback, NULL);
----
[NOTE]
+7 -4
View File
@@ -2930,6 +2930,9 @@ weechat.mkdir_parents("/tmp/my/dir", 0755)
==== exec_on_files
// TRANSLATION MISSING
_Updated in 1.5._
Cerca i file in una cartella ed esegue una callback su ogni file.
Prototipo:
@@ -2938,19 +2941,19 @@ Prototipo:
----
void weechat_exec_on_files (const char *directory,
int hidden_files,
void *data,
void (*callback)(void *data,
const char *filename));
const char *filename),
void *callback_data);
----
Argomenti:
* 'directory': cartella in cui cercare i file
* 'hidden_files': 1 per includere i file nascosti, altrimenti 0
* 'data': puntatore fornito alla callback quando chiamata da WeeChat
* 'callback': funzione chiamata per ogni file trovato, argomenti:
** 'void *data': puntatore
** 'const char *filename': nome file trovato
* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat
Esempio in C:
@@ -2961,7 +2964,7 @@ void callback (void *data, const char *filename)
/* ... */
}
...
weechat_exec_on_files ("/tmp", 0, NULL, &callback);
weechat_exec_on_files ("/tmp", 0, &callback, NULL);
----
[NOTE]
+6 -4
View File
@@ -2835,6 +2835,8 @@ weechat.mkdir_parents("/tmp/my/dir", 0755)
==== exec_on_files
_バージョン 1.5 で更新。_
ディレクトリ中のファイルを探し、各ファイルに対してコールバックを実行。
プロトタイプ:
@@ -2843,19 +2845,19 @@ weechat.mkdir_parents("/tmp/my/dir", 0755)
----
void weechat_exec_on_files (const char *directory,
int hidden_files,
void *data,
void (*callback)(void *data,
const char *filename));
const char *filename),
void *callback_data);
----
引数:
* 'directory': ファイルを検索するディレクトリ
* 'hidden_files': 検索対象に隠しファイルを含める場合は 1、含めない場合は 0
* 'data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ
* 'callback': 各ファイルに対して呼び出す関数、引数:
** 'void *data': ポインタ
** 'const char *filename': 見つかったファイルの名前
* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ
C 言語での使用例:
@@ -2866,7 +2868,7 @@ void callback (void *data, const char *filename)
/* ... */
}
...
weechat_exec_on_files ("/tmp", 0, NULL, &callback);
weechat_exec_on_files ("/tmp", 0, &callback, NULL);
----
[NOTE]