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

v2.8-utf8proc
Sébastien Helleu 2016-03-27 11:08:04 +02:00
parent d3c21e355c
commit c5bb723298
4 changed files with 26 additions and 16 deletions

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]

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]

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]

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]