diff options
| -rw-r--r-- | ChangeLog.adoc | 4 | ||||
| -rw-r--r-- | configure.ac | 2 | ||||
| -rw-r--r-- | doc/CMakeLists.txt | 2 | ||||
| -rw-r--r-- | doc/de/weechat_user.de.adoc | 2 | ||||
| -rw-r--r-- | doc/docinfo.html | 10 | ||||
| -rw-r--r-- | doc/en/weechat_dev.en.adoc | 32 | ||||
| -rw-r--r-- | doc/en/weechat_plugin_api.en.adoc | 1234 | ||||
| -rw-r--r-- | doc/en/weechat_user.en.adoc | 2 | ||||
| -rw-r--r-- | doc/fr/weechat_dev.fr.adoc | 32 | ||||
| -rw-r--r-- | doc/fr/weechat_plugin_api.fr.adoc | 1234 | ||||
| -rw-r--r-- | doc/fr/weechat_user.fr.adoc | 2 | ||||
| -rw-r--r-- | doc/it/weechat_plugin_api.it.adoc | 1234 | ||||
| -rw-r--r-- | doc/it/weechat_user.it.adoc | 2 | ||||
| -rw-r--r-- | doc/ja/weechat_dev.ja.adoc | 32 | ||||
| -rw-r--r-- | doc/ja/weechat_plugin_api.ja.adoc | 1230 | ||||
| -rw-r--r-- | doc/ja/weechat_user.ja.adoc | 2 | ||||
| -rw-r--r-- | doc/pl/weechat_user.pl.adoc | 2 | ||||
| -rw-r--r-- | doc/sr/weechat_plugin_api.sr.adoc | 8 |
18 files changed, 2540 insertions, 2526 deletions
diff --git a/ChangeLog.adoc b/ChangeLog.adoc index 347bdc07b..56f02909b 100644 --- a/ChangeLog.adoc +++ b/ChangeLog.adoc @@ -40,6 +40,10 @@ Bug fixes:: * irc: fix parsing of CAP message when there is no prefix (issue #1707) * irc: fix parsing of TAGMSG message when there is a colon before the channel +Documentation:: + + * doc: switch from prettify to pygments for syntax highlighting + Tests:: * core: add build with CMake and Ninja in CI diff --git a/configure.ac b/configure.ac index 27a6a1259..efcecaead 100644 --- a/configure.ac +++ b/configure.ac @@ -1263,7 +1263,7 @@ if test "x$enable_man" = "xyes" -o "x$enable_doc" = "xyes"; then enable_man="no" enable_doc="no" fi - ASCIIDOCTOR_ARGS="-a experimental -a 'prewrap!' -a icons=font -a sectanchors -a source-highlighter=prettify" + ASCIIDOCTOR_ARGS="-a experimental -a 'prewrap!' -a icons=font -a sectanchors -a source-highlighter=pygments -a pygments-style=native" AC_SUBST(ASCIIDOCTOR) AC_SUBST(ASCIIDOCTOR_ARGS) fi diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index 8ab0a8575..44cf718ea 100644 --- a/doc/CMakeLists.txt +++ b/doc/CMakeLists.txt @@ -22,7 +22,7 @@ if(ENABLE_MAN OR ENABLE_DOC) find_package(Asciidoctor) if(ASCIIDOCTOR_FOUND) # common asciidoctor arguments - set(ASCIIDOCTOR_ARGS -a experimental -a "prewrap!" -a icons=font -a revnumber="${VERSION}" -a sectanchors -a source-highlighter=prettify) + set(ASCIIDOCTOR_ARGS -a experimental -a "prewrap!" -a icons=font -a revnumber="${VERSION}" -a sectanchors -a source-highlighter=pygments -a pygments-style=native) # sed arguments used to replace links in ChangeLog and release notes set(SED_LINKS_ARGS diff --git a/doc/de/weechat_user.de.adoc b/doc/de/weechat_user.de.adoc index 5d67e4fe6..50bf91bdd 100644 --- a/doc/de/weechat_user.de.adoc +++ b/doc/de/weechat_user.de.adoc @@ -3941,7 +3941,7 @@ bestätigt wurde (siehe Option <<option_relay.network.websocket_allowed_origins, Ein WebSocket kann in HTML5, mit einer JavaScript Zeile, geöffnet werden: -[source,js] +[source,javascript] ---- websocket = new WebSocket("ws://server.com:9000/weechat"); ---- diff --git a/doc/docinfo.html b/doc/docinfo.html index 8020a1265..64bd9fcdd 100644 --- a/doc/docinfo.html +++ b/doc/docinfo.html @@ -35,4 +35,14 @@ kbd { margin: 0 .2em; font-family: monospace; } +/* syntax highlighting tuning */ +pre.pygments .tok-cp { + color: #ed4848; +} +pre.pygments .tok-nc, pre.pygments .tok-nf { + color: #649fef; +} +pre.pygments .tok-gu, pre.pygments .tok-nc, pre.pygments .tok-nn { + text-decoration: none; +} </style> diff --git a/doc/en/weechat_dev.en.adoc b/doc/en/weechat_dev.en.adoc index 2f9bfa91a..34ff6c1a7 100644 --- a/doc/en/weechat_dev.en.adoc +++ b/doc/en/weechat_dev.en.adoc @@ -511,7 +511,7 @@ directory: Example in C: -[source,C] +[source,c] ---- /* * weechat.c - core functions for WeeChat @@ -549,7 +549,7 @@ Some basic rules you *must* follow when you write C code: Example: -[source,C] +[source,c] ---- /* * Checks if a string with boolean value is valid. @@ -580,7 +580,7 @@ foo () Exception: in `for` loops, where variables like "i" or "n" are OK. * Initialize local variables after declaration, in body of function, example: -[source,C] +[source,c] ---- void foo () @@ -598,7 +598,7 @@ foo () * Place curly brackets `+{ }+` alone on lines, and indent them with number of spaces used for line above opening curly bracket (the `if` in example): -[source,C] +[source,c] ---- if (nicks_count == 1) { @@ -609,7 +609,7 @@ if (nicks_count == 1) * Use empty lines to separate many different blocks inside functions, and if possible add a comment for each one, like this: -[source,C] +[source,c] ---- /* * Sends a message from out queue. @@ -652,7 +652,7 @@ irc_server_outqueue_send (struct t_irc_server *server) * Indent the `if` conditions, and use parentheses around conditions with an operator (not needed for single boolean), like this: -[source,C] +[source,c] ---- if (something) { @@ -676,7 +676,7 @@ else * Indent the `switch` statements like this: -[source,C] +[source,c] ---- switch (string[0]) { @@ -694,7 +694,7 @@ switch (string[0]) * Use `typedef` for function prototypes but not for structures: -[source,C] +[source,c] ---- typedef int (t_hook_callback_fd)(void *data, int fd); @@ -776,7 +776,7 @@ Structures have name _t_X_Y_ or _t_X_Y_Z_: Example: an IRC nick (from _src/plugins/irc/irc-nick.h_): -[source,C] +[source,c] ---- struct t_irc_nick { @@ -806,7 +806,7 @@ _X_ is name of variable, using singular form). Example: windows (from _src/gui/gui-window.c_): -[source,C] +[source,c] ---- struct t_gui_window *gui_windows = NULL; /* first window */ struct t_gui_window *last_gui_window = NULL; /* last window */ @@ -826,7 +826,7 @@ Naming convention for functions is the same as Example: creation of a new window (from _src/gui/gui-window.c_): -[source,C] +[source,c] ---- /* * Creates a new window. @@ -862,7 +862,7 @@ and next node. Example: list of buffers (from _src/gui/gui-buffer.h_): -[source,C] +[source,c] ---- struct t_gui_buffer { @@ -877,7 +877,7 @@ struct t_gui_buffer Then the two list pointers, to the head and tail of list: -[source,C] +[source,c] ---- struct t_gui_buffer *gui_buffers = NULL; /* first buffer */ struct t_gui_buffer *last_gui_buffer = NULL; /* last buffer */ @@ -1067,7 +1067,7 @@ Then some macros are defined to call these functions. For example, function _hook_timer_ is defined in structure _t_weechat_plugin_ like this: -[source,C] +[source,c] ---- struct t_hook *(*hook_timer) (struct t_weechat_plugin *plugin, long interval, @@ -1080,7 +1080,7 @@ struct t_hook *(*hook_timer) (struct t_weechat_plugin *plugin, And the macro used to call this function is: -[source,C] +[source,c] ---- #define weechat_hook_timer(__interval, __align_second, __max_calls, \ __callback, __data) \ @@ -1091,7 +1091,7 @@ And the macro used to call this function is: So in a plugin, the call to function will be for example: -[source,C] +[source,c] ---- server->hook_timer_sasl = weechat_hook_timer (timeout * 1000, 0, 1, diff --git a/doc/en/weechat_plugin_api.en.adoc b/doc/en/weechat_plugin_api.en.adoc index 1b207b68b..cd9304372 100644 --- a/doc/en/weechat_plugin_api.en.adoc +++ b/doc/en/weechat_plugin_api.en.adoc @@ -45,7 +45,7 @@ In order to call WeeChat functions in the format displayed in <<plugin_api>>, the following global pointer must be declared and initialized in the function <<_weechat_plugin_init,weechat_plugin_init>>: -[source,C] +[source,c] ---- struct t_weechat_plugin *weechat_plugin; ---- @@ -84,7 +84,7 @@ This function is called when plugin is loaded by WeeChat. Prototype: -[source,C] +[source,c] ---- int weechat_plugin_init (struct t_weechat_plugin *plugin, int argc, char *argv[]); @@ -147,7 +147,7 @@ This function is called when plugin is unloaded by WeeChat. Prototype: -[source,C] +[source,c] ---- int weechat_plugin_end (struct t_weechat_plugin *plugin); ---- @@ -194,7 +194,7 @@ Full example of plugin, which adds a command `/double`: displays two times arguments on current buffer, or execute two times a command (OK that's not very useful, but that's just an example!): -[source,C] +[source,c] ---- #include <stdlib.h> @@ -307,7 +307,7 @@ Get plugin name. Prototype: -[source,C] +[source,c] ---- const char *weechat_plugin_get_name (struct t_weechat_plugin *plugin); ---- @@ -322,7 +322,7 @@ Return value: C example: -[source,C] +[source,c] ---- const char *name = weechat_plugin_get_name (plugin); ---- @@ -353,7 +353,7 @@ _UTF-8_, you don't need to call this function). Prototype: -[source,C] +[source,c] ---- void weechat_charset_set (const char *charset); ---- @@ -364,7 +364,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_charset_set ("iso-8859-1"); ---- @@ -386,7 +386,7 @@ Convert string to WeeChat internal charset (UTF-8). Prototype: -[source,C] +[source,c] ---- char *weechat_iconv_to_internal (const char *charset, const char *string); ---- @@ -402,7 +402,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *str = weechat_iconv_to_internal ("iso-8859-1", "iso string: é à"); /* ... */ @@ -426,7 +426,7 @@ Convert string from internal WeeChat charset (UTF-8) to another. Prototype: -[source,C] +[source,c] ---- char *weechat_iconv_from_internal (const char *charset, const char *string); ---- @@ -442,7 +442,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *str = weechat_iconv_from_internal ("iso-8859-1", "utf-8 string: é à"); /* ... */ @@ -466,7 +466,7 @@ Return translated string (depends on local language). Prototype: -[source,C] +[source,c] ---- const char *weechat_gettext (const char *string); ---- @@ -481,7 +481,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *str = weechat_gettext ("hello"); ---- @@ -504,7 +504,7 @@ argument. Prototype: -[source,C] +[source,c] ---- const char *weechat_ngettext (const char *string, const char *plural, int count); @@ -524,7 +524,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *str = weechat_ngettext ("file", "files", num_files); ---- @@ -547,7 +547,7 @@ Return duplicated string, with _length_ chars max. Prototype: -[source,C] +[source,c] ---- char *weechat_strndup (const char *string, int length); ---- @@ -563,7 +563,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *str = weechat_strndup ("abcdef", 3); /* result: "abc" */ /* ... */ @@ -582,7 +582,7 @@ string if it is cut. Prototype: -[source,C] +[source,c] ---- char *weechat_string_cut (const char *string, int length, int count_suffix, int screen, const char *cut_suffix); ---- @@ -601,7 +601,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *str = weechat_string_cut ("this is a test", 5, 1, 1, "…"); /* result: "this…" */ /* ... */ @@ -617,7 +617,7 @@ Convert UTF-8 string to lower case. Prototype: -[source,C] +[source,c] ---- void weechat_string_tolower (char *string); ---- @@ -628,7 +628,7 @@ Arguments: C example: -[source,C] +[source,c] ---- char str[] = "AbCdé"; weechat_string_tolower (str); /* str is now: "abcdé" */ @@ -643,7 +643,7 @@ Convert UTF-8 string to upper case. Prototype: -[source,C] +[source,c] ---- void weechat_string_toupper (char *string); ---- @@ -654,7 +654,7 @@ Arguments: C example: -[source,C] +[source,c] ---- char str[] = "AbCdé"; weechat_string_toupper (str); /* str is now: "ABCDé" */ @@ -671,7 +671,7 @@ Locale and case independent string comparison. Prototype: -[source,C] +[source,c] ---- int weechat_strcasecmp (const char *string1, const char *string2); ---- @@ -689,7 +689,7 @@ Return value: C example: -[source,C] +[source,c] ---- int diff = weechat_strcasecmp ("aaa", "CCC"); /* == -2 */ ---- @@ -706,7 +706,7 @@ comparison. Prototype: -[source,C] +[source,c] ---- int weechat_strcasecmp_range (const char *string1, const char *string2, int range); ---- @@ -731,7 +731,7 @@ Return value: C example: -[source,C] +[source,c] ---- int diff = weechat_strcasecmp_range ("nick{away}", "NICK[away]", 29); /* == 0 */ ---- @@ -747,7 +747,7 @@ Locale and case independent string comparison, for _max_ chars. Prototype: -[source,C] +[source,c] ---- int weechat_strncasecmp (const char *string1, const char *string2, int max); ---- @@ -766,7 +766,7 @@ Return value: C example: -[source,C] +[source,c] ---- int diff = weechat_strncasecmp ("aabb", "aacc", 2); /* == 0 */ ---- @@ -783,7 +783,7 @@ for case comparison. Prototype: -[source,C] +[source,c] ---- int weechat_strncasecmp_range (const char *string1, const char *string2, int max, int range); ---- @@ -809,7 +809,7 @@ Return value: C example: -[source,C] +[source,c] ---- int diff = weechat_strncasecmp_range ("nick{away}", "NICK[away]", 6, 29); /* == 0 */ ---- @@ -826,7 +826,7 @@ chars. Prototype: -[source,C] +[source,c] ---- int weechat_strcmp_ignore_chars (const char *string1, const char *string2, const char *chars_ignored, @@ -848,7 +848,7 @@ Return value: C example: -[source,C] +[source,c] ---- int diff = weechat_strcmp_ignore_chars ("a-b", "--a-e", "-", 1); /* == -3 */ ---- @@ -864,7 +864,7 @@ Locale and case independent string search. Prototype: -[source,C] +[source,c] ---- const char *weechat_strcasestr (const char *string, const char *search); ---- @@ -881,7 +881,7 @@ Return value: C example: -[source,C] +[source,c] ---- const char *pos = weechat_strcasestr ("aBcDeF", "de"); /* result: pointer to "DeF" */ ---- @@ -899,7 +899,7 @@ Non-printable chars have a width of 1 (this is the difference with the function Prototype: -[source,C] +[source,c] ---- int weechat_strlen_screen (const char *string); ---- @@ -914,7 +914,7 @@ Return value: C example: -[source,C] +[source,c] ---- int length_on_screen = weechat_strlen_screen ("é"); /* == 1 */ ---- @@ -938,7 +938,7 @@ Check if a string matches a mask. Prototype: -[source,C] +[source,c] ---- int weechat_string_match (const char *string, const char *mask, int case_sensitive); @@ -961,7 +961,7 @@ Return value: C example: -[source,C] +[source,c] ---- int match1 = weechat_string_match ("abcdef", "abc*", 0); /* == 1 */ int match2 = weechat_string_match ("abcdef", "*dd*", 0); /* == 0 */ @@ -995,7 +995,7 @@ mask. Prototype: -[source,C] +[source,c] ---- int weechat_string_match_list (const char *string, const char **masks, int case_sensitive); @@ -1015,7 +1015,7 @@ Return value: C example: -[source,C] +[source,c] ---- const char *masks[3] = { "*", "!abc*", NULL }; int match1 = weechat_string_match_list ("abc", masks, 0); /* == 0 */ @@ -1045,7 +1045,7 @@ with `+~+`, then same string is returned. Prototype: -[source,C] +[source,c] ---- char *weechat_string_expand_home (const char *path); ---- @@ -1061,7 +1061,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *str = weechat_string_expand_home ("~/file.txt"); /* result: "/home/user/file.txt" */ @@ -1085,7 +1085,7 @@ Evaluate a path in 3 steps: Prototype: -[source,C] +[source,c] ---- char *weechat_string_eval_path_home (const char *path, struct t_hashtable *pointers, @@ -1115,7 +1115,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *str = weechat_string_eval_path_home ("${weechat_config_dir}/test.conf", NULL, NULL, NULL); /* result: "/home/user/.config/weechat/test.conf" */ @@ -1142,7 +1142,7 @@ first quote or after last quote). Prototype: -[source,C] +[source,c] ---- char *weechat_string_remove_quotes (const char *string, const char *quotes); ---- @@ -1159,7 +1159,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *str = weechat_string_remove_quotes (string, " 'I can't' ", "'"); /* result: "I can't" */ @@ -1176,7 +1176,7 @@ Strip chars at beginning and/or end of string. Prototype: -[source,C] +[source,c] ---- char *weechat_string_strip (const char *string, int left, int right, const char *chars); @@ -1195,7 +1195,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *str = weechat_string_strip (".abc -", 0, 1, "- ."); /* result: ".abc" */ /* ... */ @@ -1228,7 +1228,7 @@ Convert escaped chars to their value: Prototype: -[source,C] +[source,c] ---- char *weechat_string_convert_escaped_chars (const char *string); ---- @@ -1244,7 +1244,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *str = weechat_string_convert_escaped_chars ("snowman: \\u2603"); /* str == "snowman: ☃" */ @@ -1262,7 +1262,7 @@ special chars for regex are escaped. Prototype: -[source,C] +[source,c] ---- char *weechat_string_mask_to_regex (const char *mask); ---- @@ -1277,7 +1277,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *str_regex = weechat_string_mask_to_regex ("test*mask"); /* result: "test.*mask" */ @@ -1305,7 +1305,7 @@ expression. Prototype: -[source,C] +[source,c] ---- const char *weechat_string_regex_flags (const char *regex, int default_flags, int *flags) ---- @@ -1337,7 +1337,7 @@ Return value: C example: -[source,C] +[source,c] ---- const char *regex = "(?i)test"; int flags; @@ -1358,7 +1358,7 @@ of string (for format of flags, see Prototype: -[source,C] +[source,c] ---- int weechat_string_regcomp (void *preg, const char *regex, int default_flags) ---- @@ -1384,7 +1384,7 @@ if the function returned 0 (OK). C example: -[source,C] +[source,c] ---- regex_t my_regex; if (weechat_string_regcomp (&my_regex, "(?i)test", REG_EXTENDED) == 0) @@ -1409,7 +1409,7 @@ Check if a string has one or more highlights, using list of highlight words. Prototype: -[source,C] +[source,c] ---- int weechat_string_has_highlight (const char *string, const char highlight_words); @@ -1426,7 +1426,7 @@ Return value: C example: -[source,C] +[source,c] ---- int hl = weechat_string_has_highlight ("my test string", "test,word2"); /* == 1 */ ---- @@ -1453,7 +1453,7 @@ by delimiters (chars different from: alphanumeric, `+-+`, `+_+` and `+|+`). Prototype: -[source,C] +[source,c] ---- int weechat_string_has_highlight_regex (const char *string, const char *regex); ---- @@ -1469,7 +1469,7 @@ Return value: C example: -[source,C] +[source,c] ---- int hl = weechat_string_has_highlight_regex ("my test string", "test|word2"); /* == 1 */ ---- @@ -1491,7 +1491,7 @@ Replace all occurrences of a string by another string. Prototype: -[source,C] +[source,c] ---- char *weechat_string_replace (const char *string, const char *search, const char *replace); @@ -1510,7 +1510,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *str = weechat_string_replace ("test", "s", "x"); /* result: "text" */ /* ... */ @@ -1529,7 +1529,7 @@ optional callback. Prototype: -[source,C] +[source,c] ---- char *weechat_string_replace_regex (const char *string, void *regex, const char *replace, const char reference_char, @@ -1565,7 +1565,7 @@ Return value: C example: -[source,C] +[source,c] ---- regex_t my_regex; char *string; @@ -1592,7 +1592,7 @@ Split a string according to one or more delimiter(s). Prototype: -[source,C] +[source,c] ---- char **weechat_string_split (const char *string, const char *separators, const char *strip_items, int flags, @@ -1637,7 +1637,7 @@ Return value: C example: -[source,C] +[source,c] ---- char **argv; int argc; @@ -1721,7 +1721,7 @@ Python repository), see: https://docs.python.org/3/library/shlex.html. Prototype: -[source,C] +[source,c] ---- char **weechat_string_split_shell (const char *string, int *num_items); ---- @@ -1738,7 +1738,7 @@ Return value: C example: -[source,C] +[source,c] ---- char **argv; int argc; @@ -1761,7 +1761,7 @@ Free memory used by a split string. Prototype: -[source,C] +[source,c] ---- void weechat_string_free_split (char **split_string); ---- @@ -1772,7 +1772,7 @@ Arguments: C example: -[source,C] +[source,c] ---- char *argv; int argc; @@ -1790,7 +1790,7 @@ Build a string with a split string. Prototype: -[source,C] +[source,c] ---- char *weechat_string_build_with_split_string (char **split_string, const char *separator); @@ -1807,7 +1807,7 @@ Return value: C example: -[source,C] +[source,c] ---- char **argv; int argc; @@ -1828,7 +1828,7 @@ in string). Prototype: -[source,C] +[source,c] ---- char **weechat_string_split_command (const char *command, char separator); ---- @@ -1845,7 +1845,7 @@ Return value: C example: -[source,C] +[source,c] ---- char **argv = weechat_string_split_command ("/command1 arg;/command2", ';'); /* result: argv[0] == "/command1 arg" @@ -1864,7 +1864,7 @@ Free memory used by a split command. Prototype: -[source,C] +[source,c] ---- void weechat_string_free_split_command (char **split_command); ---- @@ -1875,7 +1875,7 @@ Arguments: C example: -[source,C] +[source,c] ---- char **argv = weechat_string_split_command ("/command1 arg;/command2", ';'); /* ... */ @@ -1892,7 +1892,7 @@ language. Prototype: -[source,C] +[source,c] ---- char *weechat_string_format_size (unsigned long long size); ---- @@ -1907,7 +1907,7 @@ Return value: C examples: -[source,C] +[source,c] ---- /* examples with English locale */ @@ -1952,7 +1952,7 @@ the string. Prototype: -[source,C] +[source,c] ---- int weechat_string_color_code_size (const char *string); ---- @@ -1970,7 +1970,7 @@ Return value: C examples: -[source,C] +[source,c] ---- int size; @@ -1998,7 +1998,7 @@ Remove WeeChat colors from a string. Prototype: -[source,C] +[source,c] ---- char *weechat_string_remove_color (const char *string, const char *replacement); @@ -2017,7 +2017,7 @@ Return value: C examples: -[source,C] +[source,c] ---- /* remove color codes */ char *str = weechat_string_remove_color (my_string1, NULL); @@ -2049,7 +2049,7 @@ Encode a string in base 16, 32, or 64. Prototype: -[source,C] +[source,c] ---- int weechat_string_base_encode (int base, const char *from, int length, char *to); ---- @@ -2068,7 +2068,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *string = "abcdefgh", result[128]; int length; @@ -2091,7 +2091,7 @@ Decode a string encoded in base 16, 32, or 64. Prototype: -[source,C] +[source,c] ---- int weechat_string_base_decode (int base, const char *from, char *to); ---- @@ -2109,7 +2109,7 @@ Return value: C example: -[source,C] +[source,c] ---- char result[128]; int length; @@ -2132,7 +2132,7 @@ Display a dump of data as hexadecimal and ascii bytes. Prototype: -[source,C] +[source,c] ---- char *string_hex_dump (const char *data, int data_size, int bytes_per_line, const char *prefix, const char *suffix); @@ -2154,7 +2154,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *string = "abc def-ghi"; char *dump = weechat_string_hex_dump (string, strlen (string), 8, " >> ", NULL); @@ -2173,7 +2173,7 @@ Check if first char of string is a command char (default command char is `+/+`). Prototype: -[source,C] +[source,c] ---- int weechat_string_is_command_char (const char *string); ---- @@ -2188,7 +2188,7 @@ Return value: C examples: -[source,C] +[source,c] ---- int command_char1 = weechat_string_is_command_char ("/test"); /* == 1 */ int command_char2 = weechat_string_is_command_char ("test"); /* == 0 */ @@ -2215,7 +2215,7 @@ NULL if it's a command. Prototype: -[source,C] +[source,c] ---- const char *weechat_string_input_for_buffer (const char *string); ---- @@ -2230,7 +2230,7 @@ Return value: C examples: -[source,C] +[source,c] ---- const char *str1 = weechat_string_input_for_buffer ("test"); /* "test" */ const char *str2 = weechat_string_input_for_buffer ("/test"); /* NULL */ @@ -2264,7 +2264,7 @@ Since version 1.0, nested variables are supported, for example: Prototype: -[source,C] +[source,c] ---- char *weechat_string_eval_expression (const char *expr, struct t_hashtable *pointers, @@ -2313,7 +2313,7 @@ Return value: C examples: -[source,C] +[source,c] ---- /* conditions */ struct t_hashtable *options1 = weechat_hashtable_new (8, @@ -2921,7 +2921,7 @@ _pass:[string_dyn_*]_ functions. Prototype: -[source,C] +[source,c] ---- char **weechat_string_dyn_alloc (int size_alloc); ---- @@ -2936,7 +2936,7 @@ Return value: C example: -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); ---- @@ -2955,7 +2955,7 @@ not enough space to copy the string). Prototype: -[source,C] +[source,c] ---- int weechat_string_dyn_copy (char **string, const char *new_string); ---- @@ -2971,7 +2971,7 @@ Return value: C example: -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); if (weechat_string_dyn_copy (string, "test")) @@ -2998,7 +2998,7 @@ not enough space to concatenate the string). Prototype: -[source,C] +[source,c] ---- int weechat_string_dyn_concat (char **string, const char *add, int bytes); ---- @@ -3017,7 +3017,7 @@ Return value: C example: -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); if (weechat_string_dyn_copy (string, "test")) @@ -3040,7 +3040,7 @@ Free a dynamic string. Prototype: -[source,C] +[source,c] ---- char *weechat_string_dyn_free (char **string, int free_string); ---- @@ -3057,7 +3057,7 @@ Return value: C example: -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); if (weechat_string_dyn_concat (string, "test")) @@ -3086,7 +3086,7 @@ Check if a string has 8-bits chars. Prototype: -[source,C] +[source,c] ---- int weechat_utf8_has_8bits (const char *string); ---- @@ -3101,7 +3101,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (weechat_utf8_has_8bits (string)) { @@ -3120,7 +3120,7 @@ Check if a string is UTF-8 valid. Prototype: -[source,C] +[source,c] ---- int weechat_utf8_is_valid (const char *string, int length, char **error); ---- @@ -3139,7 +3139,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *error; if (weechat_utf8_is_valid (string, -1, &error)) @@ -3161,7 +3161,7 @@ Normalize UTF-8 string: remove non UTF-8 chars and replace them by a char. Prototype: -[source,C] +[source,c] ---- void weechat_utf8_normalize (char *string, char replacement); ---- @@ -3173,7 +3173,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_utf8_normalize (string, '?'); ---- @@ -3189,7 +3189,7 @@ Return pointer to previous UTF-8 char in a string. Prototype: -[source,C] +[source,c] ---- const char *weechat_utf8_prev_char (const char *string_start, const char *string); @@ -3208,7 +3208,7 @@ Return value: C example: -[source,C] +[source,c] ---- const char *prev_char = weechat_utf8_prev_char (string, ptr_in_string); ---- @@ -3224,7 +3224,7 @@ Return pointer to next UTF-8 char in a string. Prototype: -[source,C] +[source,c] ---- const char *weechat_utf8_next_char (const char *string); ---- @@ -3240,7 +3240,7 @@ Return value: C example: -[source,C] +[source,c] ---- const char *next_char = weechat_utf8_next_char (string); ---- @@ -3254,7 +3254,7 @@ Return UTF-8 char as integer. Prototype: -[source,C] +[source,c] ---- int weechat_utf8_char_int (const char *string); ---- @@ -3269,7 +3269,7 @@ Return value: C example: -[source,C] +[source,c] ---- int char_int = weechat_utf8_char_int ("être"); /* "ê" as integer */ ---- @@ -3283,7 +3283,7 @@ Return UTF-8 char size (in bytes). Prototype: -[source,C] +[source,c] ---- int weechat_utf8_char_size (const char *string); ---- @@ -3298,7 +3298,7 @@ Return value: C example: -[source,C] +[source,c] ---- int char_size = weechat_utf8_char_size ("être"); /* == 2 */ ---- @@ -3312,7 +3312,7 @@ Return UTF-8 string length (in UTF-8 chars). Prototype: -[source,C] +[source,c] ---- int weechat_utf8_strlen (const char *string); ---- @@ -3327,7 +3327,7 @@ Return value: C example: -[source,C] +[source,c] ---- int length = weechat_utf8_strlen ("chêne"); /* == 5 */ ---- @@ -3341,7 +3341,7 @@ Return UTF-8 string length (in UTF-8 chars), for max _bytes_ in string. Prototype: -[source,C] +[source,c] ---- int weechat_utf8_strnlen (const char *string, int bytes); ---- @@ -3357,7 +3357,7 @@ Return value: C example: -[source,C] +[source,c] ---- int length = weechat_utf8_strnlen ("chêne", 4); /* == 3 */ ---- @@ -3371,7 +3371,7 @@ Return number of chars needed on screen to display UTF-8 string. Prototype: -[source,C] +[source,c] ---- int weechat_utf8_strlen_screen (const char *string); ---- @@ -3386,7 +3386,7 @@ Return value: C example: -[source,C] +[source,c] ---- int length_on_screen = weechat_utf8_strlen_screen ("é"); /* == 1 */ ---- @@ -3402,7 +3402,7 @@ Compare two UTF-8 chars. Prototype: -[source,C] +[source,c] ---- int weechat_utf8_charcmp (const char *string1, const char *string2); ---- @@ -3420,7 +3420,7 @@ Return value: C example: -[source,C] +[source,c] ---- int diff = weechat_utf8_charcmp ("aaa", "ccc"); /* == -2 */ ---- @@ -3436,7 +3436,7 @@ Compare two UTF-8 chars, ignoring case. Prototype: -[source,C] +[source,c] ---- int weechat_utf8_charcasecmp (const char *string1, const char *string2); ---- @@ -3454,7 +3454,7 @@ Return value: C example: -[source,C] +[source,c] ---- int diff = weechat_utf8_charcasecmp ("aaa", "CCC"); /* == -2 */ ---- @@ -3468,7 +3468,7 @@ Return number of chars needed on screen to display UTF-8 char. Prototype: -[source,C] +[source,c] ---- int weechat_utf8_char_size_screen (const char *string); ---- @@ -3483,7 +3483,7 @@ Return value: C example: -[source,C] +[source,c] ---- int length_on_screen = weechat_utf8_char_size_screen ("é"); /* == 1 */ ---- @@ -3499,7 +3499,7 @@ Move forward N chars in an UTF-8 string. Prototype: -[source,C] +[source,c] ---- const char *weechat_utf8_add_offset (const char *string, int offset); ---- @@ -3516,7 +3516,7 @@ Return value: C example: -[source,C] +[source,c] ---- const char *str = "chêne"; const char *str2 = weechat_utf8_add_offset (str, 3); /* points to "ne" */ @@ -3531,7 +3531,7 @@ Return real position in UTF-8 string. Prototype: -[source,C] +[source,c] ---- int weechat_utf8_real_pos (const char *string, int pos); ---- @@ -3547,7 +3547,7 @@ Return value: C example: -[source,C] +[source,c] ---- int pos = weechat_utf8_real_pos ("chêne", 3); /* == 4 */ ---- @@ -3561,7 +3561,7 @@ Return position in UTF-8 string. Prototype: -[source,C] +[source,c] ---- int weechat_utf8_pos (const char *string, int real_pos); ---- @@ -3577,7 +3577,7 @@ Return value: C example: -[source,C] +[source,c] ---- int pos = weechat_utf8_pos ("chêne", 4); /* == 3 */ ---- @@ -3591,7 +3591,7 @@ Return duplicate string, with _length_ chars max. Prototype: -[source,C] +[source,c] ---- char *weechat_utf8_strndup (const char *string, int length); ---- @@ -3607,7 +3607,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *string = weechat_utf8_strndup ("chêne", 3); /* returns "chê" */ /* ... */ @@ -3630,7 +3630,7 @@ Compute hash of data. Prototype: -[source,C] +[source,c] ---- int weechat_crypto_hash (const void *data, int data_size, const char *hash_algo, void *hash, int *hash_size); @@ -3671,7 +3671,7 @@ Return value: C example: -[source,C] +[source,c] ---- const char *data = "abcdefghijklmnopqrstuvwxyz"; char hash[256 / 8]; @@ -3693,7 +3693,7 @@ of data. Prototype: -[source,C] +[source,c] ---- int weechat_crypto_hash_pbkdf2 (const void *data, int data_size, const char *hash_algo, @@ -3723,7 +3723,7 @@ Return value: C example: -[source,C] +[source,c] ---- const char *data = "abcdefghijklmnopqrstuvwxyz"; const char *salt = "12345678901234567890123456789012"; /* 32 bytes */ @@ -3746,7 +3746,7 @@ Compute keyed-hash message authentication code (HMAC). Prototype: -[source,C] +[source,c] ---- int weechat_crypto_hmac (const void *key, int key_size, const void *message, int message_size, int hash_algo, void *hash, int *hash_size); @@ -3772,7 +3772,7 @@ Return value: C example: -[source,C] +[source,c] ---- const char *key = "the key"; const char *message = "the message"; @@ -3799,7 +3799,7 @@ Create a directory in WeeChat home. Prototype: -[source,C] +[source,c] ---- int weechat_mkdir_home (char *directory, int mode); ---- @@ -3820,7 +3820,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (!weechat_mkdir_home ("${weechat_cache_dir}/temp", 0755)) { @@ -3845,7 +3845,7 @@ Create a directory. Prototype: -[source,C] +[source,c] ---- int weechat_mkdir (char *directory, int mode); ---- @@ -3861,7 +3861,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (!weechat_mkdir ("/tmp/mydir", 0755)) { @@ -3886,7 +3886,7 @@ Create a directory and make parent directories as needed. Prototype: -[source,C] +[source,c] ---- int weechat_mkdir_parents (char *directory, int mode); ---- @@ -3902,7 +3902,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (!weechat_mkdir_parents ("/tmp/my/dir", 0755)) { @@ -3929,7 +3929,7 @@ Find files in a directory and execute a callback on each file. Prototype: -[source,C] +[source,c] ---- void weechat_exec_on_files (const char *directory, int recurse_subdirs, @@ -3951,7 +3951,7 @@ Arguments: C example: -[source,C] +[source,c] ---- void callback (void *data, const char *filename) { @@ -3972,7 +3972,7 @@ Get content of text file in a string. Prototype: -[source,C] +[source,c] ---- char *weechat_file_get_content (const char *filename); ---- @@ -3987,7 +3987,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *content; @@ -4007,7 +4007,7 @@ Copy a file to another location. Prototype: -[source,C] +[source,c] ---- int weechat_file_copy (const char *from, const char *to); ---- @@ -4023,7 +4023,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (weechat_file_copy ("/tmp/test.txt", "/path/to/test2.txt")) { @@ -4045,7 +4045,7 @@ Compare two "timeval" structures. Prototype: -[source,C] +[source,c] ---- int weechat_util_timeval_cmp (struct timeval *tv1, struct timeval *tv2); ---- @@ -4063,7 +4063,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (weechat_util_timeval_cmp (&tv1, &tv2) > 0) { @@ -4082,7 +4082,7 @@ Return difference (in microseconds) between two "timeval" structures. Prototype: -[source,C] +[source,c] ---- long long weechat_util_timeval_diff (struct timeval *tv1, struct timeval *tv2); ---- @@ -4101,7 +4101,7 @@ With WeeChat ≤ 1.0, the returned value was in milliseconds. C example: -[source,C] +[source,c] ---- long long diff = weechat_util_timeval_diff (&tv1, &tv2); ---- @@ -4117,7 +4117,7 @@ Add interval (in microseconds) to a timeval structure. Prototype: -[source,C] +[source,c] ---- void weechat_util_timeval_add (struct timeval *tv, long long interval); ---- @@ -4132,7 +4132,7 @@ With WeeChat ≤ 1.0, the interval was expressed in milliseconds. C example: -[source,C] +[source,c] ---- weechat_util_timeval_add (&tv, 2000000); /* add 2 seconds */ ---- @@ -4149,7 +4149,7 @@ option _weechat.look.time_format_. Prototype: -[source,C] +[source,c] ---- const char *weechat_util_get_time_string (const time_t *date); ---- @@ -4164,7 +4164,7 @@ Return value: C example: -[source,C] +[source,c] ---- time_t date = time (NULL); weechat_printf (NULL, "date: %s", @@ -4182,7 +4182,7 @@ Convert a string with WeeChat version to a number. Prototype: -[source,C] +[source,c] ---- int weechat_util_version_number (const char *version); ---- @@ -4193,7 +4193,7 @@ Arguments: C example: -[source,C] +[source,c] ---- version_number = weechat_util_version_number ("0.3.8"); /* == 0x00030800 */ version_number = weechat_util_version_number ("0.3.9-dev"); /* == 0x00030900 */ @@ -4215,7 +4215,7 @@ Create a new list. Prototype: -[source,C] +[source,c] ---- struct t_weelist *weechat_list_new (); ---- @@ -4226,7 +4226,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_weelist *list = weechat_list_new (); ---- @@ -4248,7 +4248,7 @@ Add an item in a list. Prototype: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_add (struct t_weelist *weelist, const char *data, @@ -4272,7 +4272,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_weelist_item *my_item = weechat_list_add (list, "my data", WEECHAT_LIST_POS_SORT, NULL); @@ -4295,7 +4295,7 @@ Search an item in a list. Prototype: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_search (struct t_weelist *weelist, const char *data); @@ -4312,7 +4312,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_weelist_item *item = weechat_list_search (list, "my data"); ---- @@ -4336,7 +4336,7 @@ Search an item position in a list. Prototype: -[source,C] +[source,c] ---- int weechat_list_search_pos (struct t_weelist *weelist, const char *data); @@ -4353,7 +4353,7 @@ Return value: C example: -[source,C] +[source,c] ---- int pos_item = weechat_list_search_pos (list, "my data"); ---- @@ -4375,7 +4375,7 @@ Search an item in a list, ignoring case. Prototype: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_casesearch (struct t_weelist *weelist, const char *data); @@ -4392,7 +4392,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_weelist_item *item = weechat_list_casesearch (list, "my data"); ---- @@ -4416,7 +4416,7 @@ Search an item position in a list, ignoring case. Prototype: -[source,C] +[source,c] ---- int weechat_list_casesearch_pos (struct t_weelist *weelist, const char *data); @@ -4433,7 +4433,7 @@ Return value: C example: -[source,C] +[source,c] ---- int pos_item = weechat_list_casesearch_pos (list, "my data"); ---- @@ -4455,7 +4455,7 @@ Return an item in a list by position. Prototype: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_get (struct t_weelist *weelist, int position); @@ -4472,7 +4472,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_weelist_item *item = weechat_list_get (list, 0); /* first item */ ---- @@ -4494,7 +4494,7 @@ Set new value for an item. Prototype: -[source,C] +[source,c] ---- void weechat_list_set (struct t_weelist_item *item, const char *value); ---- @@ -4506,7 +4506,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_list_set (item, "new data"); ---- @@ -4528,7 +4528,7 @@ Return next item in list. Prototype: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_next (struct t_weelist_item *item); ---- @@ -4543,7 +4543,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_weelist_item *next_item = weechat_list_next (item); ---- @@ -4565,7 +4565,7 @@ Return previous item in list. Prototype: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_prev (struct t_weelist_item *item); ---- @@ -4580,7 +4580,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_weelist_item *prev_item = weechat_list_prev (item); ---- @@ -4602,7 +4602,7 @@ Return string value of an item. Prototype: -[source,C] +[source,c] ---- const char *weechat_list_string (struct t_weelist_item *item); ---- @@ -4617,7 +4617,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "value of item: %s", weechat_list_string (item)); ---- @@ -4641,7 +4641,7 @@ Return pointer to the user data of an item. Prototype: -[source,C] +[source,c] ---- void *weechat_list_user_data (struct t_weelist_item *item); ---- @@ -4656,7 +4656,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "user data of item: 0x%lx", weechat_list_user_data (item)); ---- @@ -4670,7 +4670,7 @@ Return size of list (number of items). Prototype: -[source,C] +[source,c] ---- char *weechat_list_size (struct t_weelist *weelist); ---- @@ -4685,7 +4685,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "size of list: %d", weechat_list_size (list)); ---- @@ -4707,7 +4707,7 @@ Remove an item in a list. Prototype: -[source,C] +[source,c] ---- void weechat_list_remove (struct t_weelist *weelist, struct t_weelist_item *item); @@ -4720,7 +4720,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_list_remove (list, item); ---- @@ -4742,7 +4742,7 @@ Remove all items from a list. Prototype: -[source,C] +[source,c] ---- void weechat_list_remove_all (struct t_weelist *weelist); ---- @@ -4753,7 +4753,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_list_remove_all (list); ---- @@ -4775,7 +4775,7 @@ Free a list. Prototype: -[source,C] +[source,c] ---- void weechat_list_free (struct t_weelist *weelist); ---- @@ -4786,7 +4786,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_list_free (list); ---- @@ -4817,7 +4817,7 @@ Create a new array list. Prototype: -[source,C] +[source,c] ---- struct t_arraylist *weechat_arraylist_new (int initial_size, int sorted, @@ -4862,7 +4862,7 @@ Return value: C example: -[source,C] +[source,c] ---- int cmp_cb (void *data, struct t_arraylist *arraylist, @@ -4891,7 +4891,7 @@ Return size of array list (number of item pointers). Prototype: -[source,C] +[source,c] ---- int weechat_list_size (struct t_arraylist *arraylist); ---- @@ -4906,7 +4906,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "size of array list: %d", weechat_arraylist_size (arraylist)); ---- @@ -4922,7 +4922,7 @@ Return an item pointer by position. Prototype: -[source,C] +[source,c] ---- void *weechat_arraylist_get (struct t_arraylist *arraylist, int index); ---- @@ -4938,7 +4938,7 @@ Return value: C example: -[source,C] +[source,c] ---- void *pointer = weechat_arraylist_get (arraylist, 0); /* first item */ ---- @@ -4954,7 +4954,7 @@ Search an item in an array list. Prototype: -[source,C] +[source,c] ---- void *weechat_arraylist_search (struct t_arraylist *arraylist, void *pointer, int *index, int *index_insert); @@ -4975,7 +4975,7 @@ Return value: C example: -[source,C] +[source,c] ---- int index, index_insert; void *item = weechat_arraylist_search (arraylist, pointer, &index, &index_insert); @@ -4992,7 +4992,7 @@ Insert an item in an array list. Prototype: -[source,C] +[source,c] ---- int weechat_arraylist_insert (struct t_arraylist *arraylist, int index, void *pointer); ---- @@ -5011,7 +5011,7 @@ Return value: C example: -[source,C] +[source,c] ---- int index = weechat_arraylist_insert (arraylist, -1, pointer); /* insert at the end if not sorted */ ---- @@ -5027,7 +5027,7 @@ Add an item in an array list. Prototype: -[source,C] +[source,c] ---- int weechat_arraylist_add (struct t_arraylist *arraylist, void *pointer); ---- @@ -5043,7 +5043,7 @@ Return value: C example: -[source,C] +[source,c] ---- int index = weechat_arraylist_add (arraylist, pointer); ---- @@ -5059,7 +5059,7 @@ Remove an item from an array list. Prototype: -[source,C] +[source,c] ---- int weechat_arraylist_remove (struct t_arraylist *arraylist, int index); ---- @@ -5075,7 +5075,7 @@ Return value: C example: -[source,C] +[source,c] ---- int index_removed = weechat_arraylist_remove (arraylist, index); ---- @@ -5091,7 +5091,7 @@ Remove all items from an array list. Prototype: -[source,C] +[source,c] ---- int weechat_arraylist_clear (struct t_arraylist *arraylist); ---- @@ -5106,7 +5106,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (weechat_arraylist_clear (arraylist)) { @@ -5125,7 +5125,7 @@ Free an array list. Prototype: -[source,C] +[source,c] ---- void weechat_arraylist_free (struct t_arraylist *arraylist); ---- @@ -5136,7 +5136,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_arraylist_free (arraylist); ---- @@ -5157,7 +5157,7 @@ Create a new hashtable. Prototype: -[source,C] +[source,c] ---- struct t_hashtable *weechat_hashtable_new (int size, const char *type_keys, @@ -5209,7 +5209,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hashtable *hashtable = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, @@ -5229,7 +5229,7 @@ Add or update item in a hashtable with size for key and value. Prototype: -[source,C] +[source,c] ---- struct t_hashtable_item *weechat_hashtable_set_with_size (struct t_hashtable *hashtable, const void *key, int key_size, @@ -5252,7 +5252,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_hashtable_set_with_size (hashtable, "my_key", 0, my_buffer, sizeof (my_buffer_struct)); @@ -5269,7 +5269,7 @@ Add or update item in a hashtable. Prototype: -[source,C] +[source,c] ---- struct t_hashtable_item *weechat_hashtable_set (struct t_hashtable *hashtable, const void *key, const void *value); @@ -5287,7 +5287,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_hashtable_set (hashtable, "my_key", "my_value"); ---- @@ -5303,7 +5303,7 @@ Get value associated with a key in a hashtable. Prototype: -[source,C] +[source,c] ---- void *weechat_hashtable_get (struct t_hashtable *hashtable, void *key); ---- @@ -5319,7 +5319,7 @@ Return value: C example: -[source,C] +[source,c] ---- void *value = weechat_hashtable_get (hashtable, "my_key"); ---- @@ -5335,7 +5335,7 @@ Check if a key is in the hashtable. Prototype: -[source,C] +[source,c] ---- int weechat_hashtable_has_key (struct t_hashtable *hashtable, void *key); ---- @@ -5351,7 +5351,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (weechat_hashtable_has_key (hashtable, "my_key")) { @@ -5372,7 +5372,7 @@ Call a function on all hashtable entries, by insertion order in the hashtable Prototype: -[source,C] +[source,c] ---- void weechat_hashtable_map (struct t_hashtable *hashtable, void (*callback_map)(void *data, @@ -5390,7 +5390,7 @@ Arguments: C example: -[source,C] +[source,c] ---- void map_cb (void *data, struct t_hashtable *hashtable, @@ -5417,7 +5417,7 @@ Call a function on all hashtable entries, by insertion order in the hashtable Prototype: -[source,C] +[source,c] ---- void weechat_hashtable_map_string (struct t_hashtable *hashtable, void (*callback_map)(void *data, @@ -5439,7 +5439,7 @@ are deleted after call to callback. C example: -[source,C] +[source,c] ---- void map_cb (void *data, struct t_hashtable *hashtable, @@ -5464,7 +5464,7 @@ Duplicate a hashtable. Prototype: -[source,C] +[source,c] ---- struct t_hashtable *weechat_hashtable_dup (struct t_hashtable *hashtable); ---- @@ -5479,7 +5479,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hashtable *new_hashtable = weechat_hashtable_dup (hashtable); ---- @@ -5495,7 +5495,7 @@ Return integer value of a hashtable property. Prototype: -[source,C] +[source,c] ---- int weechat_hashtable_get_integer (struct t_hashtable *hashtable, void *property); @@ -5514,7 +5514,7 @@ Return value: C example: -[source,C] +[source,c] ---- int items_count = weechat_hashtable_get_integer (hashtable, "items_count"); ---- @@ -5530,7 +5530,7 @@ Return string value of a hashtable property. Prototype: -[source,C] +[source,c] ---- const char *weechat_hashtable_get_string (struct t_hashtable *hashtable, const char *property); @@ -5566,7 +5566,7 @@ Return value: C examples: -[source,C] +[source,c] ---- weechat_printf (NULL, "keys are type: %s", weechat_hashtable_get_string (hashtable, "type_keys")); @@ -5585,7 +5585,7 @@ Set pointer value of a hashtable property. Prototype: -[source,C] +[source,c] ---- void weechat_hashtable_set_pointer (struct t_hashtable *hashtable, const char *property, void *pointer); @@ -5602,7 +5602,7 @@ Arguments: C example: -[source,C] +[source,c] ---- void my_free_value_cb (struct t_hashtable *hashtable, const void *key, void *value) @@ -5632,7 +5632,7 @@ Add hashtable items to an infolist item, by insertion order in the hashtable Prototype: -[source,C] +[source,c] ---- int weechat_hashtable_add_to_infolist (struct t_hashtable *hashtable, struct t_infolist_item *infolist_item, @@ -5651,7 +5651,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_hashtable_add_to_infolist (hashtable, infolist_item, "testhash"); @@ -5677,7 +5677,7 @@ Add infolist items in a hashtable. Prototype: -[source,C] +[source,c] ---- int weechat_hashtable_add_from_infolist (struct t_hashtable *hashtable, struct t_infolist *infolist, @@ -5696,7 +5696,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_hashtable_add_from_infolist (hashtable, infolist, "testhash"); @@ -5722,7 +5722,7 @@ Remove an item from a hashtable. Prototype: -[source,C] +[source,c] ---- void weechat_hashtable_remove (struct t_hashtable *hashtable, const void *key); ---- @@ -5734,7 +5734,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_hashtable_remove (hashtable, "my_key"); ---- @@ -5750,7 +5750,7 @@ Remove all items from a hashtable. Prototype: -[source,C] +[source,c] ---- void weechat_hashtable_remove_all (struct t_hashtable *hashtable); ---- @@ -5761,7 +5761,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_hashtable_remove_all (hashtable); ---- @@ -5777,7 +5777,7 @@ Free a hashtable. Prototype: -[source,C] +[source,c] ---- void weechat_hashtable_free (struct t_hashtable *hashtable); ---- @@ -5788,7 +5788,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_hashtable_free (hashtable); ---- @@ -5809,7 +5809,7 @@ Create a new configuration file. Prototype: -[source,C] +[source,c] ---- struct t_config_file *weechat_config_new (const char *name, int (*callback_reload)(const void *pointer, @@ -5859,7 +5859,7 @@ You should call this function only after adding some sections (with C example: -[source,C] +[source,c] ---- int my_config_reload_cb (const void *pointer, void *data, @@ -5898,7 +5898,7 @@ Create a new section in configuration file. Prototype: -[source,C] +[source,c] ---- struct t_config_section *weechat_config_new_section ( struct t_config_file *config_file, @@ -6044,7 +6044,7 @@ Return value: C example: -[source,C] +[source,c] ---- int my_section_read_cb (const void *pointer, void *data, @@ -6183,7 +6183,7 @@ Search a section in a configuration file. Prototype: -[source,C] +[source,c] ---- struct t_config_section *weechat_config_search_section ( struct t_config_file *config_file, @@ -6201,7 +6201,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_config_section *section = weechat_config_search_section (config_file, "section"); @@ -6226,7 +6226,7 @@ Create a new option in a section of a configuration file. Prototype: -[source,C] +[source,c] ---- struct t_config_option *weechat_config_new_option ( struct t_config_file *config_file, @@ -6321,7 +6321,7 @@ Return value: C example: -[source,C] +[source,c] ---- /* boolean */ struct t_config_option *option1 = @@ -6462,7 +6462,7 @@ Search an option in a section of a configuration file. Prototype: -[source,C] +[source,c] ---- struct t_config_option *weechat_config_search_option ( struct t_config_file *config_file, @@ -6482,7 +6482,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_search_option (config_file, section, "option"); @@ -6505,7 +6505,7 @@ Search a section and an option in a configuration file or section. Prototype: -[source,C] +[source,c] ---- void weechat_config_search_section_option (struct t_config_file *config_file, struct t_config_section *section, @@ -6526,7 +6526,7 @@ Arguments: C example: -[source,C] +[source,c] ---- struct t_config_section *ptr_section; struct t_config_option *ptr_option; @@ -6555,7 +6555,7 @@ Get file/section/option info about an option with full name. Prototype: -[source,C] +[source,c] ---- void weechat_config_search_with_string (const char *option_name, struct t_config_file **config_file, @@ -6578,7 +6578,7 @@ Arguments: C example: -[source,C] +[source,c] ---- struct t_config_file *ptr_config_file; struct t_config_section *ptr_section; @@ -6609,7 +6609,7 @@ Check if a text is "true" or "false", as boolean value. Prototype: -[source,C] +[source,c] ---- int weechat_config_string_to_boolean (const char *text); ---- @@ -6625,7 +6625,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (weechat_config_string_to_boolean (option_value)) { @@ -6655,7 +6655,7 @@ Reset an option to its default value. Prototype: -[source,C] +[source,c] ---- int weechat_config_option_reset (struct t_config_option *option, int run_callback); @@ -6675,7 +6675,7 @@ Return value: C example: -[source,C] +[source,c] ---- switch (weechat_config_option_reset (option, 1)) { @@ -6714,7 +6714,7 @@ Set new value for an option. Prototype: -[source,C] +[source,c] ---- int weechat_config_option_set (struct t_config_option *option, const char *value, int run_callback); @@ -6741,7 +6741,7 @@ Return value: C example: -[source,C] +[source,c] ---- switch (weechat_config_option_set (option, "new_value", 1)) { @@ -6780,7 +6780,7 @@ Set null (undefined value) for an option. Prototype: -[source,C] +[source,c] ---- int weechat_config_option_set_null (struct t_config_option *option, int run_callback); @@ -6804,7 +6804,7 @@ Return value: C example: -[source,C] +[source,c] ---- switch (weechat_config_option_set_null (option, 1)) { @@ -6843,7 +6843,7 @@ Unset/reset option. Prototype: -[source,C] +[source,c] ---- int weechat_config_option_unset (struct t_config_option *option); ---- @@ -6861,7 +6861,7 @@ Return value: C example: -[source,C] +[source,c] ---- switch (weechat_config_option_unset (option)) { @@ -6905,7 +6905,7 @@ Rename an option. Prototype: -[source,C] +[source,c] ---- void weechat_config_option_rename (struct t_config_option *option, const char *new_name); @@ -6918,7 +6918,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_config_option_rename (option, "new_name"); ---- @@ -6942,7 +6942,7 @@ Return string value of an option property. Prototype: -[source,C] +[source,c] ---- const char *weechat_config_option_get_string (struct t_config_option *option, const char *property); @@ -6969,7 +6969,7 @@ Return value: C example: -[source,C] +[source,c] ---- const char *type = weechat_config_option_get_string (option, "type"); ---- @@ -6983,7 +6983,7 @@ Return a pointer on an option property. Prototype: -[source,C] +[source,c] ---- void *weechat_config_option_get_pointer (struct t_config_option *option, const char *property); @@ -7013,7 +7013,7 @@ Return value: C example: -[source,C] +[source,c] ---- char *description = weechat_config_option_get_pointer (option, "description"); ---- @@ -7027,7 +7027,7 @@ Check if an option is "null" (undefined value). Prototype: -[source,C] +[source,c] ---- int weechat_config_option_is_null (struct t_config_option *option); ---- @@ -7043,7 +7043,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (weechat_config_option_is_null (option)) { @@ -7073,7 +7073,7 @@ Check if default value for an option is "null" (undefined value). Prototype: -[source,C] +[source,c] ---- int weechat_config_option_default_is_null (struct t_config_option *option); ---- @@ -7089,7 +7089,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (weechat_config_option_default_is_null (option)) { @@ -7119,7 +7119,7 @@ Return boolean value of option. Prototype: -[source,C] +[source,c] ---- int weechat_config_boolean (struct t_config_option *option); ---- @@ -7137,7 +7137,7 @@ Return value, depending on the option type: C example: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); if (weechat_config_boolean (option)) @@ -7169,7 +7169,7 @@ Return default boolean value of option. Prototype: -[source,C] +[source,c] ---- int weechat_config_boolean_default (struct t_config_option *option); ---- @@ -7187,7 +7187,7 @@ Return value, depending on the option type: C example: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); if (weechat_config_boolean_default (option)) @@ -7219,7 +7219,7 @@ Return integer value of option. Prototype: -[source,C] +[source,c] ---- int weechat_config_integer (struct t_config_option *option); ---- @@ -7237,7 +7237,7 @@ Return value, depending on the option type: C example: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); int value = weechat_config_integer (option); @@ -7261,7 +7261,7 @@ Return default integer value of option. Prototype: -[source,C] +[source,c] ---- int weechat_config_integer_default (struct t_config_option *option); ---- @@ -7279,7 +7279,7 @@ Return value, depending on the option type: C example: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); int value = weechat_config_integer_default (option); @@ -7303,7 +7303,7 @@ Return string value of option. Prototype: -[source,C] +[source,c] ---- const char *weechat_config_string (struct t_config_option *option); ---- @@ -7322,7 +7322,7 @@ Return value, depending on the option type: C example: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *value = weechat_config_string (option); @@ -7346,7 +7346,7 @@ Return default string value of option. Prototype: -[source,C] +[source,c] ---- const char *weechat_config_string_default (struct t_config_option *option); ---- @@ -7365,7 +7365,7 @@ Return value, depending on the option type: C example: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *value = weechat_config_string_default (option); @@ -7389,7 +7389,7 @@ Return color value of option. Prototype: -[source,C] +[source,c] ---- const char *weechat_config_color (struct t_config_option *option); ---- @@ -7407,7 +7407,7 @@ Return value, depending on the option type: C example: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *color = weechat_config_color (option); @@ -7431,7 +7431,7 @@ Return default color value of option. Prototype: -[source,C] +[source,c] ---- const char *weechat_config_color_default (struct t_config_option *option); ---- @@ -7449,7 +7449,7 @@ Return value, depending on the option type: C example: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *color = weechat_config_color_default (option); @@ -7474,7 +7474,7 @@ should be called only in "write" or "write_default" callbacks for a section). Prototype: -[source,C] +[source,c] ---- void weechat_config_write_option (struct t_config_file *config_file, struct t_config_option *option); @@ -7487,7 +7487,7 @@ Arguments: C example: -[source,C] +[source,c] ---- int my_section_write_cb (const void *pointer, void *data, @@ -7523,7 +7523,7 @@ Write a line in a configuration file (this function should be called only in Prototype: -[source,C] +[source,c] ---- void weechat_config_write_line (struct t_config_file *config_file, const char *option_name, @@ -7539,7 +7539,7 @@ Arguments: C example: -[source,C] +[source,c] ---- int my_section_write_cb (const void *pointer, void *data, @@ -7575,7 +7575,7 @@ Write configuration file to disk. Prototype: -[source,C] +[source,c] ---- int weechat_config_write (struct t_config_file *config_file); ---- @@ -7592,7 +7592,7 @@ Return value: C example: -[source,C] +[source,c] ---- switch (weechat_config_write (config_file)) { @@ -7631,7 +7631,7 @@ Read configuration file from disk. Prototype: -[source,C] +[source,c] ---- int weechat_config_read (struct t_config_file *config_file); ---- @@ -7648,7 +7648,7 @@ Return value: C example: -[source,C] +[source,c] ---- switch (weechat_config_read (config_file)) { @@ -7687,7 +7687,7 @@ Reload configuration file from disk. Prototype: -[source,C] +[source,c] ---- int weechat_config_reload (struct t_config_file *config_file); ---- @@ -7704,7 +7704,7 @@ Return value: C example: -[source,C] +[source,c] ---- switch (weechat_config_reload (config_file)) { @@ -7743,7 +7743,7 @@ Free an option. Prototype: -[source,C] +[source,c] ---- void weechat_config_option_free (struct t_config_option *option); ---- @@ -7754,7 +7754,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_config_option_free (option); ---- @@ -7776,7 +7776,7 @@ Free all options in a section. Prototype: -[source,C] +[source,c] ---- void weechat_config_section_free_options (struct t_config_section *section); ---- @@ -7787,7 +7787,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_config_section_free_options (section); ---- @@ -7809,7 +7809,7 @@ Free a section. Prototype: -[source,C] +[source,c] ---- void weechat_config_section_free (struct t_config_section *section); ---- @@ -7820,7 +7820,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_config_section_free (section); ---- @@ -7842,7 +7842,7 @@ Free a configuration file. Prototype: -[source,C] +[source,c] ---- void weechat_config_free (struct t_config_file *config_file); ---- @@ -7853,7 +7853,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_config_free (config_file); ---- @@ -7875,7 +7875,7 @@ Search an option with full name. Prototype: -[source,C] +[source,c] ---- struct t_config_option *weechat_config_get (const char *option_name); ---- @@ -7890,7 +7890,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("weechat.look.item_time_format"); ---- @@ -7912,7 +7912,7 @@ Search an option in plugins configuration file (plugins.conf). Prototype: -[source,C] +[source,c] ---- const char *weechat_config_get_plugin (const char *option_name); ---- @@ -7928,7 +7928,7 @@ Return value: C example: -[source,C] +[source,c] ---- /* if current plugin is "test", then look for value of option "plugins.var.test.option" in file plugins.conf */ @@ -7952,7 +7952,7 @@ Check if option is set in plugins configuration file (plugins.conf). Prototype: -[source,C] +[source,c] ---- int weechat_config_is_set_plugin (const char *option_name); ---- @@ -7968,7 +7968,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (weechat_config_is_set_plugin ("option")) { @@ -8002,7 +8002,7 @@ Set new value for option in plugins configuration file (plugins.conf). Prototype: -[source,C] +[source,c] ---- int weechat_config_set_plugin (const char *option_name, const char *value); ---- @@ -8022,7 +8022,7 @@ Return value: C example: -[source,C] +[source,c] ---- switch (weechat_config_set_plugin ("option", "test_value")) { @@ -8068,7 +8068,7 @@ Set description for option in plugins configuration file (plugins.conf). Prototype: -[source,C] +[source,c] ---- void weechat_config_set_desc_plugin (const char *option_name, const char *description); @@ -8086,7 +8086,7 @@ A future creation of option with this name will use this description. C example: -[source,C] +[source,c] ---- weechat_config_set_desc_plugin ("option", "description of option"); ---- @@ -8110,7 +8110,7 @@ Unset option in plugins configuration file (plugins.conf). Prototype: -[source,C] +[source,c] ---- int weechat_config_unset_plugin (const char *option_name); ---- @@ -8129,7 +8129,7 @@ Return value: C example: -[source,C] +[source,c] ---- switch (weechat_config_unset_plugin ("option")) { @@ -8184,7 +8184,7 @@ binding, only new keys are created. To remove a key binding, use <<_key_unbind,k Prototype: -[source,C] +[source,c] ---- int weechat_key_bind (const char *context, struct t_hashtable *keys); ---- @@ -8208,7 +8208,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hashtable *keys = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, @@ -8250,7 +8250,7 @@ When calling this function, ensure that you will not remove a user key binding. Prototype: -[source,C] +[source,c] ---- int weechat_key_unbind (const char *context, const char *key); ---- @@ -8268,7 +8268,7 @@ Return value: C examples: -[source,C] +[source,c] ---- /* remove a single key */ weechat_key_unbind ("mouse", "@chat(plugin.buffer):button1"); @@ -8304,7 +8304,7 @@ Return a prefix. Prototype: -[source,C] +[source,c] ---- const char *weechat_prefix (const char *prefix); ---- @@ -8335,7 +8335,7 @@ Values and colors can be customized with command `/set`. C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "%sThis is an error...", weechat_prefix ("error")); ---- @@ -8357,7 +8357,7 @@ Return a string color code for display. Prototype: -[source,C] +[source,c] ---- const char *weechat_color (const char *color_name); ---- @@ -8414,7 +8414,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "Color: %sblue %sdefault color %syellow on red", weechat_color ("blue"), @@ -8440,7 +8440,7 @@ Display a message on a buffer. Prototype: -[source,C] +[source,c] ---- void weechat_printf (struct t_gui_buffer *buffer, const char *message, ...); ---- @@ -8448,7 +8448,7 @@ void weechat_printf (struct t_gui_buffer *buffer, const char *message, ...); This function is a shortcut for function printf_date_tags. These two calls give exactly same result: -[source,C] +[source,c] ---- weechat_printf (buffer, "message"); weechat_printf_date_tags (buffer, 0, NULL, "message"); @@ -8472,7 +8472,7 @@ set to 0. C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "Hello on WeeChat buffer"); weechat_printf (buffer, "Hello on this buffer"); @@ -8507,7 +8507,7 @@ Display a message on a buffer, using a custom date and tags. Prototype: -[source,C] +[source,c] ---- void weechat_printf_date_tags (struct t_gui_buffer *buffer, time_t date, const char *tags, const char *message, ...); @@ -8525,7 +8525,7 @@ for a list of commonly used tags in WeeChat. C example: -[source,C] +[source,c] ---- weechat_printf_date_tags (NULL, time (NULL) - 120, "notify_message", "Message 2 minutes ago, with a tag 'notify_message'"); @@ -8553,7 +8553,7 @@ Display a message on a line of a buffer with free content. Prototype: -[source,C] +[source,c] ---- void weechat_printf_y (struct t_gui_buffer *buffer, int y, const char *message, ...); @@ -8570,7 +8570,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_printf_y (buffer, 2, "My message on third line"); ---- @@ -8595,7 +8595,7 @@ Write a message in WeeChat log file (weechat.log). Prototype: -[source,C] +[source,c] ---- void weechat_log_printf (const char *message, ...); ---- @@ -8606,7 +8606,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_log_printf ("My message in log file"); ---- @@ -8647,7 +8647,7 @@ Default priority is 1000. C example: -[source,C] +[source,c] ---- /* hook modifier with priority = 2000 */ weechat_hook_modifier ("2000|input_text_display", &modifier_cb, NULL, NULL); @@ -8664,7 +8664,7 @@ Hook a command. Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_command (const char *command, const char *description, @@ -8741,7 +8741,7 @@ Return value: C example: -[source,C] +[source,c] ---- int my_command_cb (const void *pointer, void *data, struct t_gui_buffer *buffer, @@ -8817,7 +8817,7 @@ Hook a completion. Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_completion (const char *completion_item, const char *description, @@ -8873,7 +8873,7 @@ Return value: C example: -[source,C] +[source,c] ---- int my_completion_cb (const void *pointer, void *data, const char *completion_item, @@ -8927,7 +8927,7 @@ Hook a command when WeeChat runs it. Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_command_run (const char *command, int (*callback)(const void *pointer, @@ -8962,7 +8962,7 @@ Return value: C example: -[source,C] +[source,c] ---- int my_command_run_cb (const void *pointer, void *data, @@ -9000,7 +9000,7 @@ Hook a timer. Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_timer (long interval, int align_second, @@ -9037,7 +9037,7 @@ Return value: C example: -[source,C] +[source,c] ---- int my_timer_cb (const void *pointer, void *data, int remaining_calls) @@ -9075,7 +9075,7 @@ Hook a file descriptor (file or socket). Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_fd (int fd, int flag_read, @@ -9120,7 +9120,7 @@ to integer before using it, for example in Python: `int(fd)`. C example: -[source,C] +[source,c] ---- int my_fd_cb (const void *pointer, void *data, int fd) @@ -9168,7 +9168,7 @@ _options_ _(WeeChat ≥ 0.4.0)_. Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_process (const char *command, int timeout, @@ -9253,7 +9253,7 @@ many calls and use data only when return code is non-negative. C example: -[source,C] +[source,c] ---- /* example with an external command */ int @@ -9386,7 +9386,7 @@ output. Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_process_hashtable (const char *command, struct t_hashtable *options, @@ -9455,7 +9455,7 @@ Return value: C example: -[source,C] +[source,c] ---- int my_process_cb (const void *pointer, void *data, const char *command, @@ -9615,7 +9615,7 @@ Hook a connection (background connection to a remote host). Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_connect (const char *proxy, const char *address, @@ -9700,7 +9700,7 @@ to integer before using it, for example in Python: `int(sock)`. C example: -[source,C] +[source,c] ---- int my_connect_cb (const void *pointer, void *data, int status, int gnutls_rc, @@ -9812,7 +9812,7 @@ buffers with free content. Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_line (const char *buffer_type, const char *buffer_name, @@ -10026,7 +10026,7 @@ in this hashtable): C example: -[source,C] +[source,c] ---- int my_line_cb (const void *pointer, void *data, struct t_hasbtable *line) @@ -10076,7 +10076,7 @@ For more information on the hooks called when a line is printed, see Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_print (struct t_gui_buffer *buffer, const char *tags, @@ -10141,7 +10141,7 @@ to integer before testing it, for example in Python: `if int(highlight):`. C example: -[source,C] +[source,c] ---- int my_print_cb (const void *pointer, void *data, struct t_gui_buffer *buffer, @@ -10183,7 +10183,7 @@ Hook a signal. Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_signal (const char *signal, int (*callback)(const void *pointer, @@ -10867,7 +10867,7 @@ List of signals sent by WeeChat and plugins: C example: -[source,C] +[source,c] ---- int my_signal_cb (const void *pointer, void *data, const char *signal, @@ -10906,7 +10906,7 @@ Send a signal. Prototype: -[source,C] +[source,c] ---- int weechat_hook_signal_send (const char *signal, const char *type_data, void *signal_data); @@ -10928,7 +10928,7 @@ Return value _(WeeChat ≥ 1.0)_: C example: -[source,C] +[source,c] ---- int rc = weechat_hook_signal_send ("my_signal", WEECHAT_HOOK_SIGNAL_STRING, my_string); ---- @@ -10954,7 +10954,7 @@ Argument is a pointer to buffer. C example: -[source,C] +[source,c] ---- weechat_hook_signal_send ("logger_backlog", WEECHAT_HOOK_SIGNAL_POINTER, buffer); ---- @@ -10995,7 +10995,7 @@ Argument is a string with path to script to install. C example: -[source,C] +[source,c] ---- weechat_hook_signal_send ("python_script_install", WEECHAT_HOOK_SIGNAL_STRING, "/path/to/test.py"); ---- @@ -11030,7 +11030,7 @@ is name without path, for example _script.py_). C example: -[source,C] +[source,c] ---- /* unload and remove scripts test.py and script.py */ weechat_hook_signal_send ("python_script_remove", WEECHAT_HOOK_SIGNAL_STRING, @@ -11073,7 +11073,7 @@ Argument is a string with following format: C examples: -[source,C] +[source,c] ---- /* say "Hello!" on libera server, #weechat channel */ weechat_hook_signal_send ("irc_input_send", WEECHAT_HOOK_SIGNAL_STRING, @@ -11105,7 +11105,7 @@ Hook a hsignal (signal with hashtable). Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_hsignal (const char *signal, int (*callback)(const void *pointer, @@ -11194,7 +11194,7 @@ pattern. C example: -[source,C] +[source,c] ---- int my_hsignal_cb (const void *pointer, void *data, const char *signal, @@ -11231,7 +11231,7 @@ Send a hsignal (signal with hashtable). Prototype: -[source,C] +[source,c] ---- int weechat_hook_hsignal_send (const char *signal, struct t_hashtable *hashtable); ---- @@ -11251,7 +11251,7 @@ Return value _(WeeChat ≥ 1.0)_: C example: -[source,C] +[source,c] ---- int rc; struct t_hashtable *hashtable = weechat_hashtable_new (8, @@ -11336,7 +11336,7 @@ Hashtable sent in hsignal has following content (key and values are strings): C example: -[source,C] +[source,c] ---- int test_whois_cb (const void *pointer, void *data, const char *signal, @@ -11417,7 +11417,7 @@ for many redirections, you must create pattern before each redirect. C example: -[source,C] +[source,c] ---- struct t_hashtable *hashtable = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, @@ -11463,7 +11463,7 @@ Hook a configuration option. Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_config (const char *option, int (*callback)(const void *pointer, @@ -11499,7 +11499,7 @@ Return value: C example: -[source,C] +[source,c] ---- int my_config_cb (const void *pointer, void *data, const char *option, @@ -11538,7 +11538,7 @@ Hook a modifier. Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_modifier (const char *modifier, char *(*callback)(const void *pointer, @@ -11647,7 +11647,7 @@ List of modifiers used by WeeChat and plugins: C example: -[source,C] +[source,c] ---- char * my_modifier_cb (const void *pointer, void *data, const char *modifier, @@ -11695,7 +11695,7 @@ Execute modifier(s). Prototype: -[source,C] +[source,c] ---- char *weechat_hook_modifier_exec (const char *modifier, const char *modifier_data, @@ -11784,7 +11784,7 @@ List of modifiers defined by WeeChat and plugins that can be used: C example: -[source,C] +[source,c] ---- char *new_string = weechat_hook_modifier_exec ("my_modifier", my_data, my_string); @@ -11809,7 +11809,7 @@ Hook an information (callback takes and returns a string). Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_info (const char *info_name, const char *description, @@ -11849,7 +11849,7 @@ With WeeChat ≥ 2.5, the callback returns an allocated string C example: -[source,C] +[source,c] ---- char * my_info_cb (const void *pointer, void *data, const char *info_name, @@ -11890,7 +11890,7 @@ Hook an information (callback takes and returns a hashtable). Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_info_hashtable (const char *info_name, const char *description, @@ -11929,7 +11929,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hashtable * my_info_hashtable_cb (const void *pointer, void *data, const char *info_name, @@ -11973,7 +11973,7 @@ Hook an infolist: callback will return pointer to infolist asked. Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_infolist (const char *infolist_name, const char *description, @@ -12015,7 +12015,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_infolist * my_infolist_cb (const void *pointer, void *data, const char *infolist_name, @@ -12064,7 +12064,7 @@ Hook a hdata: callback will return pointer to hdata asked. Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_hdata (const char *hdata_name, const char *description, @@ -12097,7 +12097,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hdata * my_hdata_cb (const void *pointer, void *data, const char *hdata_name) @@ -12128,7 +12128,7 @@ cursor). Prototype: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_focus (const char *area, struct t_hashtable *(*callback)(const void *pointer, @@ -12296,7 +12296,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hashtable * my_focus_nicklist_cb (const void *pointer, void *data, struct t_hashtable *info) @@ -12336,7 +12336,7 @@ Set string value of a hook property. Prototype: -[source,C] +[source,c] ---- void weechat_hook_set (struct t_hook *hook, const char *property, const char *value); @@ -12375,7 +12375,7 @@ Properties: C example: -[source,C] +[source,c] ---- struct t_hook *my_command_hook = weechat_hook_command ("abcd", "description", @@ -12408,7 +12408,7 @@ Unhook something hooked. Prototype: -[source,C] +[source,c] ---- void weechat_unhook (struct t_hook *hook); ---- @@ -12419,7 +12419,7 @@ Arguments: C example: -[source,C] +[source,c] ---- struct t_hook *my_hook = weechat_hook_command ( /* ... */ ); /* ... */ @@ -12445,7 +12445,7 @@ Unhook everything that has been hooked by current plugin. Prototype: -[source,C] +[source,c] ---- void weechat_unhook_all (const char *subplugin); ---- @@ -12457,7 +12457,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_unhook_all (NULL); ---- @@ -12486,7 +12486,7 @@ Open a new buffer. Prototype: -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer_new (const char *name, int (*input_callback)(const void *pointer, @@ -12539,7 +12539,7 @@ Return value: C example: -[source,C] +[source,c] ---- int my_input_cb (const void *pointer, void *data, @@ -12588,7 +12588,7 @@ Return pointer to current buffer (buffer displayed by current window). Prototype: -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_current_buffer (); ---- @@ -12599,7 +12599,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (weechat_current_buffer (), "Text on current buffer"); ---- @@ -12623,7 +12623,7 @@ Search a buffer by plugin and/or name. Prototype: -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer_search (const char *plugin, const char *name); @@ -12645,7 +12645,7 @@ Return value: C examples: -[source,C] +[source,c] ---- struct t_gui_buffer *buffer1 = weechat_buffer_search ("irc", "libera.#weechat"); struct t_gui_buffer *buffer2 = weechat_buffer_search ("==", "irc.libera.#test"); /* WeeChat ≥ 1.0 */ @@ -12669,7 +12669,7 @@ is starting). Prototype: -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer_search_main (); ---- @@ -12680,7 +12680,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer = weechat_buffer_search_main (); ---- @@ -12702,7 +12702,7 @@ Clear content of a buffer. Prototype: -[source,C] +[source,c] ---- void weechat_buffer_clear (struct t_gui_buffer *buffer); ---- @@ -12713,7 +12713,7 @@ Arguments: C example: -[source,C] +[source,c] ---- struct t_gui_buffer *my_buffer = weechat_buffer_search ("my_plugin", "my_buffer"); @@ -12742,7 +12742,7 @@ Close a buffer. Prototype: -[source,C] +[source,c] ---- void weechat_buffer_close (struct t_gui_buffer *buffer); ---- @@ -12753,7 +12753,7 @@ Arguments: C example: -[source,C] +[source,c] ---- struct t_gui_buffer *my_buffer = weechat_buffer_new ("my_buffer", &my_input_cb, NULL, @@ -12783,7 +12783,7 @@ lines). Prototype: -[source,C] +[source,c] ---- void weechat_buffer_merge (struct t_gui_buffer *buffer, struct t_gui_buffer *target_buffer); @@ -12796,7 +12796,7 @@ Arguments: C example: -[source,C] +[source,c] ---- /* merge current buffer with weechat "core" buffer */ weechat_buffer_merge (weechat_current_buffer (), @@ -12821,7 +12821,7 @@ Unmerge buffer from a group of merged buffers. Prototype: -[source,C] +[source,c] ---- void weechat_buffer_unmerge (struct t_gui_buffer *buffer, int number); @@ -12835,7 +12835,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_buffer_unmerge (weechat_current_buffer (), 1); ---- @@ -12857,7 +12857,7 @@ Return integer value of a buffer property. Prototype: -[source,C] +[source,c] ---- int weechat_buffer_get_integer (struct t_gui_buffer *buffer, const char *property); @@ -12926,7 +12926,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "my buffer number is: %d", weechat_buffer_get_integer (my_buffer, "number")); @@ -12949,7 +12949,7 @@ Return string value of a buffer property. Prototype: -[source,C] +[source,c] ---- const char *weechat_buffer_get_string (struct t_gui_buffer *buffer, const char *property); @@ -12983,7 +12983,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "name / short name of buffer are: %s / %s", weechat_buffer_get_string (my_buffer, "name"), @@ -13009,7 +13009,7 @@ Return pointer value of a buffer property. Prototype: -[source,C] +[source,c] ---- void *weechat_buffer_pointer (struct t_gui_buffer *buffer, const char *property); @@ -13029,7 +13029,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "plugin pointer of my buffer: %lx", weechat_buffer_get_pointer (my_buffer, "plugin")); @@ -13052,7 +13052,7 @@ Set string value of a buffer property. Prototype: -[source,C] +[source,c] ---- void weechat_buffer_set (struct t_gui_buffer *buffer, const char *property, const char *value); @@ -13219,7 +13219,7 @@ Properties: C example: -[source,C] +[source,c] ---- /* disable hotlist (for all buffers) */ weechat_buffer_set (NULL, "hotlist", "-"); @@ -13268,7 +13268,7 @@ Set pointer value of a buffer property. Prototype: -[source,C] +[source,c] ---- void weechat_buffer_set_pointer (struct t_gui_buffer *buffer, const char *property, void *pointer); @@ -13290,7 +13290,7 @@ Arguments: Prototypes for callbacks: -[source,C] +[source,c] ---- int close_callback (const void *pointer, void *data, struct t_gui_buffer *buffer); @@ -13305,7 +13305,7 @@ int nickcmp_callback (const void *pointer, void *data, C example: -[source,C] +[source,c] ---- int my_close_cb (const void *pointer, void *data, struct t_gui_buffer *buffer) @@ -13327,7 +13327,7 @@ variables. Prototype: -[source,C] +[source,c] ---- char *weechat_buffer_string_replace_local_var (struct t_gui_buffer *buffer, const char *string); @@ -13344,7 +13344,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_buffer_set (my_buffer, "localvar_set_toto", "abc"); @@ -13374,7 +13374,7 @@ Check if buffer matches a list of buffers. Prototype: -[source,C] +[source,c] ---- int weechat_buffer_match_list (struct t_gui_buffer *buffer, const char *string); ---- @@ -13393,7 +13393,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_gui_buffer *buffer = weechat_buffer_search ("irc", "libera.#weechat"); if (buffer) @@ -13432,7 +13432,7 @@ Return pointer to current window. Prototype: -[source,C] +[source,c] ---- struct t_gui_window *weechat_current_window (); ---- @@ -13443,7 +13443,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_gui_window *current_window = weechat_current_window (); ---- @@ -13467,7 +13467,7 @@ Return pointer to window displaying buffer. Prototype: -[source,C] +[source,c] ---- struct t_gui_window *weechat_window_search_with_buffer (struct t_gui_buffer *buffer); ---- @@ -13482,7 +13482,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "window displaying core buffer: %lx", @@ -13507,7 +13507,7 @@ Return integer value of a window property. Prototype: -[source,C] +[source,c] ---- int weechat_window_get_integer (struct t_gui_window *window, const char *property); @@ -13542,7 +13542,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "current window is at position (x,y): (%d,%d)", weechat_window_get_integer (weechat_current_window (), "win_x"), @@ -13571,7 +13571,7 @@ This function is not used today, it is reserved for a future version. Prototype: -[source,C] +[source,c] ---- const char *weechat_window_get_string (struct t_gui_window *window, const char *property); @@ -13600,7 +13600,7 @@ Return pointer value of a window property. Prototype: -[source,C] +[source,c] ---- void *weechat_window_get_pointer (struct t_gui_window *window, const char *property); @@ -13619,7 +13619,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "buffer displayed in current window: %lx", @@ -13644,7 +13644,7 @@ Set title for terminal. Prototype: -[source,C] +[source,c] ---- void weechat_window_set_title (const char *title); ---- @@ -13657,7 +13657,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_window_set_title ("new title here"); ---- @@ -13684,7 +13684,7 @@ Add a group in a nicklist. Prototype: -[source,C] +[source,c] ---- struct t_gui_nick_group *weechat_nicklist_add_group (struct t_gui_buffer *buffer, struct t_gui_nick_group *parent_group, @@ -13722,7 +13722,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_gui_nick_group *my_group = weechat_nicklist_add_group (my_buffer, @@ -13750,7 +13750,7 @@ Search a group in a nicklist. Prototype: -[source,C] +[source,c] ---- struct t_gui_nick_group *weechat_nicklist_search_group (struct t_gui_buffer *buffer, struct t_gui_nick_group *from_group, @@ -13770,7 +13770,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_gui_nick_group *ptr_group = weechat_nicklist_search_group (my_buffer, NULL, "test_group"); @@ -13793,7 +13793,7 @@ Add a nick in a group. Prototype: -[source,C] +[source,c] ---- struct t_gui_nick_group *weechat_nicklist_add_nick (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -13834,7 +13834,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_gui_nick *my_nick = weechat_nicklist_add_nick (my_buffer, my_group, @@ -13865,7 +13865,7 @@ Search a nick in a nicklist. Prototype: -[source,C] +[source,c] ---- struct t_gui_nick *weechat_nicklist_search_nick (struct t_gui_buffer *buffer, struct t_gui_nick_group *from_group, @@ -13885,7 +13885,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_gui_nick *ptr_nick = weechat_nicklist_search_nick (my_buffer, NULL, "test_nick"); @@ -13908,7 +13908,7 @@ Remove a group from a nicklist. Prototype: -[source,C] +[source,c] ---- void weechat_nicklist_remove_group (struct t_gui_buffer *buffer, struct t_gui_nick_group *group); @@ -13921,7 +13921,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_nicklist_remove_group (my_buffer, my_group); ---- @@ -13943,7 +13943,7 @@ Remove a nick from a nicklist. Prototype: -[source,C] +[source,c] ---- void weechat_nicklist_remove_nick (struct t_gui_buffer *buffer, struct t_gui_nick *nick); @@ -13956,7 +13956,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_nicklist_remove_nick (my_buffer, my_nick); ---- @@ -13978,7 +13978,7 @@ Remove all groups/nicks from a nicklist. Prototype: -[source,C] +[source,c] ---- void weechat_nicklist_remove_all (struct t_gui_buffer *buffer); ---- @@ -13989,7 +13989,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_nicklist_remove_all (my_buffer); ---- @@ -14013,7 +14013,7 @@ Get next group or nick from nicklist (mainly used to display nicklist). Prototype: -[source,C] +[source,c] ---- void weechat_nicklist_get_next_item (struct t_gui_buffer *buffer, struct t_gui_nick_group **group, @@ -14028,7 +14028,7 @@ Arguments: C example: -[source,C] +[source,c] ---- struct t_gui_nick_group *ptr_group; struct t_gui_nick *ptr_nick; @@ -14063,7 +14063,7 @@ Return integer value of a group property. Prototype: -[source,C] +[source,c] ---- int weechat_nicklist_group_get_integer (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14084,7 +14084,7 @@ Return value: C example: -[source,C] +[source,c] ---- int visible = weechat_nicklist_group_get_integer (buffer, group, "visible"); ---- @@ -14108,7 +14108,7 @@ Return string value of a group property. Prototype: -[source,C] +[source,c] ---- const char *weechat_nicklist_group_get_string (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14129,7 +14129,7 @@ Return value: C example: -[source,C] +[source,c] ---- const char *color = weechat_nicklist_group_get_string (buffer, group, "color"); ---- @@ -14153,7 +14153,7 @@ Return pointer value of a group property. Prototype: -[source,C] +[source,c] ---- void *weechat_nicklist_group_get_pointer (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14173,7 +14173,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_gui_nick_group *parent = weechat_nicklist_group_get_pointer (buffer, group, "parent"); ---- @@ -14197,7 +14197,7 @@ Set string value of a group property. Prototype: -[source,C] +[source,c] ---- void weechat_nicklist_group_set (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14227,7 +14227,7 @@ Properties: C examples: -[source,C] +[source,c] ---- /* change group color to "bar_fg" */ weechat_nicklist_group_set (buffer, group, "color", "bar_fg"); @@ -14266,7 +14266,7 @@ Return integer value of a nick property. Prototype: -[source,C] +[source,c] ---- int weechat_nicklist_nick_get_integer (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -14286,7 +14286,7 @@ Return value: C example: -[source,C] +[source,c] ---- int visible = weechat_nicklist_nick_get_integer (buffer, nick, "visible"); ---- @@ -14310,7 +14310,7 @@ Return string value of a nick property. Prototype: -[source,C] +[source,c] ---- const char *weechat_nicklist_nick_get_string (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -14333,7 +14333,7 @@ Return value: C example: -[source,C] +[source,c] ---- const char *color = weechat_nicklist_nick_get_string (buffer, nick, "color"); ---- @@ -14357,7 +14357,7 @@ Return pointer value of a nick property. Prototype: -[source,C] +[source,c] ---- void *weechat_nicklist_nick_get_pointer (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -14377,7 +14377,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_gui_nick_group *group = weechat_nicklist_nick_get_pointer (buffer, nick, "group"); ---- @@ -14401,7 +14401,7 @@ Set string value of a nick property. Prototype: -[source,C] +[source,c] ---- void weechat_nicklist_nick_set (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -14437,7 +14437,7 @@ Properties: C examples: -[source,C] +[source,c] ---- /* change nick color to cyan */ weechat_nicklist_nick_set (buffer, nick, "color", "cyan"); @@ -14485,7 +14485,7 @@ Search a bar item. Prototype: -[source,C] +[source,c] ---- struct t_gui_bar_item *weechat_bar_item_search (const char *name); ---- @@ -14500,7 +14500,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_gui_bar_item *bar_item = weechat_bar_item_search ("myitem"); ---- @@ -14524,7 +14524,7 @@ Create a new bar item. Prototype: -[source,C] +[source,c] ---- struct t_gui_bar_item *weechat_bar_item_new (const char *name, char *(*build_callback)(const void *pointer, @@ -14565,7 +14565,7 @@ Return value: C example: -[source,C] +[source,c] ---- char * my_build_callback (const void *pointer, void *data, @@ -14614,7 +14614,7 @@ Update content of a bar item, by calling its build callback. Prototype: -[source,C] +[source,c] ---- void weechat_bar_item_update (const char *name); ---- @@ -14625,7 +14625,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_bar_item_update ("myitem"); ---- @@ -14647,7 +14647,7 @@ Remove a bar item. Prototype: -[source,C] +[source,c] ---- void weechat_bar_item_remove (struct t_gui_bar_item *item); ---- @@ -14658,7 +14658,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_bar_item_remove (&my_item); ---- @@ -14680,7 +14680,7 @@ Search a bar. Prototype: -[source,C] +[source,c] ---- struct t_gui_bar *weechat_bar_search (const char *name); ---- @@ -14695,7 +14695,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_gui_bar *bar = weechat_bar_search ("mybar"); ---- @@ -14719,7 +14719,7 @@ Create a new bar. Prototype: -[source,C] +[source,c] ---- struct t_gui_bar *weechat_bar_new (const char *name, const char *hidden, @@ -14785,7 +14785,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_gui_bar *my_bar = weechat_bar_new ("mybar", "off", @@ -14832,7 +14832,7 @@ Set a new value for a bar property. Prototype: -[source,C] +[source,c] ---- int weechat_bar_set (struct t_gui_bar *bar, const char *property, const char *value); @@ -14852,7 +14852,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_bar_set (mybar, "position", "bottom"); ---- @@ -14874,7 +14874,7 @@ Refresh content of a bar on screen. Prototype: -[source,C] +[source,c] ---- void weechat_bar_update (const char *name); ---- @@ -14885,7 +14885,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_bar_update ("mybar"); ---- @@ -14907,7 +14907,7 @@ Remove a bar. Prototype: -[source,C] +[source,c] ---- void weechat_bar_remove (struct t_gui_bar *bar); ---- @@ -14918,7 +14918,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_bar_remove (mybar); ---- @@ -14947,7 +14947,7 @@ Execute a command or send text to buffer. Prototype: -[source,C] +[source,c] ---- int weechat_command (struct t_gui_buffer *buffer, const char *command); ---- @@ -14966,7 +14966,7 @@ Return value _(WeeChat ≥ 1.1)_: C example: -[source,C] +[source,c] ---- int rc; rc = weechat_command (weechat_buffer_search ("irc", "libera.#weechat"), @@ -14992,7 +14992,7 @@ Execute a command or send text to buffer with options. Prototype: -[source,C] +[source,c] ---- int weechat_command_options (struct t_gui_buffer *buffer, const char *command, struct t_hashtable *options); @@ -15018,7 +15018,7 @@ Return value: C example: -[source,C] +[source,c] ---- /* allow any command except /exec, run command in 2 seconds */ int rc; @@ -15056,7 +15056,7 @@ Create a new completion. Prototype: -[source,C] +[source,c] ---- struct t_gui_completion *weechat_completion_new (struct t_gui_buffer *buffer); ---- @@ -15071,7 +15071,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_gui_completion *completion = weechat_completion_new (weechat_buffer_search_main ()); ---- @@ -15096,7 +15096,7 @@ context. Prototype: -[source,C] +[source,c] ---- int weechat_completion_search (struct t_gui_completion *completion, const char *data, int position, int direction); @@ -15115,7 +15115,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_gui_completion *completion = weechat_completion_new (weechat_buffer_search_main ()); if (weechat_completion_search (completion, "/help filt", 10, 1)) @@ -15145,7 +15145,7 @@ Get a completion property as string. Prototype: -[source,C] +[source,c] ---- const char *weechat_completion_get_string (struct t_gui_completion *completion, const char *property); @@ -15161,7 +15161,7 @@ Arguments: C example: -[source,C] +[source,c] ---- int my_completion_cb (const void *pointer, void *data, const char *completion_item, @@ -15202,7 +15202,7 @@ Add a word for a completion. Prototype: -[source,C] +[source,c] ---- void weechat_completion_list_add (struct t_gui_completion *completion, const char *word, @@ -15240,7 +15240,7 @@ Free a completion. Prototype: -[source,C] +[source,c] ---- void weechat_completion_free (struct t_gui_completion *completion); ---- @@ -15251,7 +15251,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_completion_free (completion); ---- @@ -15282,7 +15282,7 @@ process only, to not block WeeChat. Prototype: -[source,C] +[source,c] ---- int weechat_network_pass_proxy (const char *proxy, int sock, @@ -15303,7 +15303,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (weechat_network_pass_proxy ("my_proxy", sock, "irc.libera.chat", 6667)) { @@ -15330,7 +15330,7 @@ process only, to not block WeeChat. Prototype: -[source,C] +[source,c] ---- int weechat_network_connect_to (const char *proxy, struct sockaddr *address, @@ -15349,7 +15349,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct sockaddr *addr; socklen_t length; @@ -15385,7 +15385,7 @@ Return info, as string, from WeeChat or a plugin. Prototype: -[source,C] +[source,c] ---- char *weechat_info_get (const char *info_name, const char *arguments); ---- @@ -15411,7 +15411,7 @@ include::includes/autogen_api_infos.en.adoc[tag=infos] C example: -[source,C] +[source,c] ---- char *version = weechat_info_get ("version", NULL); char *date = weechat_info_get ("date", NULL); @@ -15449,7 +15449,7 @@ Return info, as hashtable, from WeeChat or a plugin. Prototype: -[source,C] +[source,c] ---- struct t_hashtable *weechat_info_get_hashtable (const char *info_name, struct t_hashtable *hashtable); @@ -15471,7 +15471,7 @@ include::includes/autogen_api_infos_hashtable.en.adoc[tag=infos_hashtable] C example: -[source,C] +[source,c] ---- struct t_hashtable *hashtable_in, *hashtable_out; @@ -15554,7 +15554,7 @@ Create a new infolist. Prototype: -[source,C] +[source,c] ---- struct t_infolist *weechat_infolist_new (); ---- @@ -15565,7 +15565,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_infolist *infolist = weechat_infolist_new (); ---- @@ -15587,7 +15587,7 @@ Add an item in an infolist. Prototype: -[source,C] +[source,c] ---- struct t_infolist_item *weechat_infolist_new_item (struct t_infolist *infolist); ---- @@ -15602,7 +15602,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_infolist_item *item = weechat_infolist_new_item (infolist); ---- @@ -15624,7 +15624,7 @@ Add an integer variable to an infolist item. Prototype: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_integer (struct t_infolist_item *item, const char *name, @@ -15643,7 +15643,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_integer (item, "my_integer", @@ -15667,7 +15667,7 @@ Add a string variable to an infolist item. Prototype: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_string (struct t_infolist_item *item, const char *name, @@ -15686,7 +15686,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_string (item, "my_string", @@ -15710,7 +15710,7 @@ Add a pointer variable to an infolist item. Prototype: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_pointer (struct t_infolist_item *item, const char *name, @@ -15729,7 +15729,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_pointer (item, "my_pointer", @@ -15753,7 +15753,7 @@ Add a buffer variable to an infolist item. Prototype: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_buffer (struct t_infolist_item *item, const char *name, @@ -15774,7 +15774,7 @@ Return value: C example: -[source,C] +[source,c] ---- char buffer[256]; /* ... */ @@ -15793,7 +15793,7 @@ Add a time variable to an infolist item. Prototype: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_time (struct t_infolist_item *item, const char *name, @@ -15812,7 +15812,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_time (item, "my_time", @@ -15843,7 +15843,7 @@ have more info than hdata, which is raw data), see <<hdata,hdata>>. Prototype: -[source,C] +[source,c] ---- struct t_infolist *weechat_infolist_get (const char *infolist_name, void *pointer, @@ -15868,7 +15868,7 @@ include::includes/autogen_api_infolists.en.adoc[tag=infolists] C example: -[source,C] +[source,c] ---- struct t_infolist *infolist = weechat_infolist_get ("irc_server", NULL, NULL); ---- @@ -15891,7 +15891,7 @@ an infolist moves cursor to first item in infolist. Prototype: -[source,C] +[source,c] ---- int weechat_infolist_next (struct t_infolist *infolist); ---- @@ -15906,7 +15906,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (weechat_infolist_next (infolist)) { @@ -15940,7 +15940,7 @@ for an infolist moves cursor to last item in infolist. Prototype: -[source,C] +[source,c] ---- int weechat_infolist_prev (struct t_infolist *infolist); ---- @@ -15956,7 +15956,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (weechat_infolist_prev (infolist)) { @@ -15989,7 +15989,7 @@ Reset "cursor" for infolist. Prototype: -[source,C] +[source,c] ---- void weechat_infolist_reset_item_cursor (struct t_infolist *infolist); ---- @@ -16000,7 +16000,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_infolist_reset_item_cursor (infolist); ---- @@ -16024,7 +16024,7 @@ Search a variable in the current infolist item. Prototype: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_search_var (struct t_infolist *infolist, const char *name); @@ -16041,7 +16041,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (weechat_infolist_search_var (infolist, "name")) { @@ -16069,7 +16069,7 @@ Return list of fields for current infolist item. Prototype: -[source,C] +[source,c] ---- const char *weechat_infolist_fields (struct t_infolist *infolist); ---- @@ -16086,7 +16086,7 @@ Return value: C example: -[source,C] +[source,c] ---- const char *fields = weechat_infolist_fields (infolist); /* fields contains something like: @@ -16112,7 +16112,7 @@ Return value of integer variable in current infolist item. Prototype: -[source,C] +[source,c] ---- int weechat_infolist_integer (struct t_infolist *infolist, const char *var); ---- @@ -16128,7 +16128,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "integer = %d", weechat_infolist_integer (infolist, "my_integer")); @@ -16151,7 +16151,7 @@ Return value of string variable in current infolist item. Prototype: -[source,C] +[source,c] ---- const char *weechat_infolist_string (struct t_infolist *infolist, const char *var); ---- @@ -16167,7 +16167,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "string = %s", weechat_infolist_string (infolist, "my_string")); @@ -16190,7 +16190,7 @@ Return value of pointer variable in current infolist item. Prototype: -[source,C] +[source,c] ---- void *weechat_infolist_pointer (struct t_infolist *infolist, const char *var); ---- @@ -16206,7 +16206,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "pointer = 0x%lx", weechat_infolist_pointer (infolist, "my_pointer")); @@ -16229,7 +16229,7 @@ Return value of buffer variable in current infolist item. Prototype: -[source,C] +[source,c] ---- void *weechat_infolist_buffer (struct t_infolist *infolist, const char *var, int *size); @@ -16247,7 +16247,7 @@ Return value: C example: -[source,C] +[source,c] ---- int size; void *pointer = weechat_infolist_buffer (infolist, "my_buffer", &size); @@ -16264,7 +16264,7 @@ Return value of time variable in current infolist item. Prototype: -[source,C] +[source,c] ---- time_t weechat_infolist_time (struct t_infolist *infolist, const char *var); ---- @@ -16280,7 +16280,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "time = %ld", weechat_infolist_time (infolist, "my_time")); @@ -16303,7 +16303,7 @@ Free an infolist. Prototype: -[source,C] +[source,c] ---- void weechat_infolist_free (struct t_infolist *infolist); ---- @@ -16314,7 +16314,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_infolist_free (infolist); ---- @@ -16360,7 +16360,7 @@ infolist, but there are some differences: Prototype: -[source,C] +[source,c] ---- struct t_hdata *weechat_hdata_new (const char *hdata_name, const char *var_prev, const char *var_next, int create_allowed, int delete_allowed, @@ -16398,7 +16398,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_new ("myplugin_list", "prev", "next", 0, 0, &callback_update, NULL); ---- @@ -16414,7 +16414,7 @@ Create a new variable in hdata. Prototype: -[source,C] +[source,c] ---- void weechat_hdata_new_var (struct t_hdata *hdata, const char *name, int offset, int type, int update_allowed, const char *array_size, const char *hdata_name); @@ -16477,7 +16477,7 @@ Examples of variables and the corresponding array size (_WeeChat ≥ 3.4_): C example: -[source,C] +[source,c] ---- struct t_myplugin_list { @@ -16506,7 +16506,7 @@ weechat_hdata_new_var (hdata, "next", offsetof (struct t_myplugin_list, next), W The macro "WEECHAT_HDATA_VAR" can be used to shorten code: -[source,C] +[source,c] ---- WEECHAT_HDATA_VAR(struct t_myplugin_list, name, STRING, 0, NULL, NULL); WEECHAT_HDATA_VAR(struct t_myplugin_list, buffer, POINTER, 0, NULL, NULL); @@ -16529,7 +16529,7 @@ Create a new list pointer in hdata. Prototype: -[source,C] +[source,c] ---- void weechat_hdata_new_list (struct t_hdata *hdata, const char *name, void *pointer, int flags); ---- @@ -16544,7 +16544,7 @@ Arguments: C example: -[source,C] +[source,c] ---- struct t_myplugin_list { @@ -16574,7 +16574,7 @@ weechat_hdata_new_list (hdata, "last_buffer", &last_buffer, 0); The macro "WEECHAT_HDATA_LIST" can be used to shorten code: -[source,C] +[source,c] ---- WEECHAT_HDATA_LIST(buffers, WEECHAT_HDATA_LIST_CHECK_POINTERS); WEECHAT_HDATA_LIST(last_buffer, 0); @@ -16596,7 +16596,7 @@ WeeChat/plugin object to read some data. Prototype: -[source,C] +[source,c] ---- struct t_hdata *weechat_hdata_get (const char *hdata_name); ---- @@ -16615,7 +16615,7 @@ include::includes/autogen_api_hdata.en.adoc[tag=hdata] C example: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("irc_server"); ---- @@ -16639,7 +16639,7 @@ Return offset of variable in hdata. Prototype: -[source,C] +[source,c] ---- int weechat_hdata_get_var_offset (struct t_hdata *hdata, const char *name); ---- @@ -16655,7 +16655,7 @@ Return value: C example: -[source,C] +[source,c] ---- int offset = weechat_hdata_get_var_offset (hdata, "name"); ---- @@ -16679,7 +16679,7 @@ Return type of variable in hdata (as integer). Prototype: -[source,C] +[source,c] ---- int weechat_hdata_get_var_type (struct t_hdata *hdata, const char *name); ---- @@ -16695,7 +16695,7 @@ Return value: C example: -[source,C] +[source,c] ---- int type = weechat_hdata_get_var_type (hdata, "name"); switch (type) @@ -16744,7 +16744,7 @@ Return type of variable in hdata (as string). Prototype: -[source,C] +[source,c] ---- const char *weechat_hdata_get_var_type_string (struct t_hdata *hdata, const char *name); ---- @@ -16760,7 +16760,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "type = %s", weechat_hdata_get_var_type_string (hdata, "name")); ---- @@ -16784,7 +16784,7 @@ Return array size for variable in hdata. Prototype: -[source,C] +[source,c] ---- int weechat_hdata_get_var_array_size (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -16801,7 +16801,7 @@ Return value: C example: -[source,C] +[source,c] ---- int array_size = weechat_hdata_get_var_array_size (hdata, pointer, "name"); ---- @@ -16825,7 +16825,7 @@ Return array size for variable in hdata (as string). Prototype: -[source,C] +[source,c] ---- const char *weechat_hdata_get_var_array_size_string (struct t_hdata *hdata, void *pointer, const char *name); @@ -16844,7 +16844,7 @@ Return value: C example: -[source,C] +[source,c] ---- const char *array_size = weechat_hdata_get_var_array_size_string (hdata, pointer, "name"); ---- @@ -16868,7 +16868,7 @@ Return hdata for a variable in hdata. Prototype: -[source,C] +[source,c] ---- const char *weechat_hdata_get_var_hdata (struct t_hdata *hdata, const char *name); ---- @@ -16884,7 +16884,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "hdata = %s", weechat_hdata_get_var_hdata (hdata, "name")); ---- @@ -16908,7 +16908,7 @@ Return pointer to content of variable in hdata. Prototype: -[source,C] +[source,c] ---- void *weechat_hdata_get_var (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -16925,7 +16925,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -16943,7 +16943,7 @@ Return pointer to content of variable in hdata, using offset. Prototype: -[source,C] +[source,c] ---- void *weechat_hdata_get_var_at_offset (struct t_hdata *hdata, void *pointer, int offset); ---- @@ -16960,7 +16960,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -16979,7 +16979,7 @@ Return list pointer from hdata. Prototype: -[source,C] +[source,c] ---- void *weechat_hdata_get_list (struct t_hdata *hdata, const char *name); ---- @@ -16995,7 +16995,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffers = weechat_hdata_get_list (hdata, "gui_buffers"); @@ -17021,7 +17021,7 @@ Check if a pointer is valid for a hdata and a list pointer. Prototype: -[source,C] +[source,c] ---- int weechat_hdata_check_pointer (struct t_hdata *hdata, void *list, void *pointer); ---- @@ -17041,7 +17041,7 @@ Return value: C example: -[source,C] +[source,c] ---- /* check if a buffer pointer is valid */ struct t_hdata *hdata = weechat_hdata_get ("buffer"); @@ -17082,7 +17082,7 @@ Move pointer to another element in list. Prototype: -[source,C] +[source,c] ---- void *weechat_hdata_move (struct t_hdata *hdata, void *pointer, int count); ---- @@ -17101,7 +17101,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17142,7 +17142,7 @@ in list, until element is found (or end of list). Prototype: -[source,C] +[source,c] ---- void *weechat_hdata_search (struct t_hdata *hdata, void *pointer, const char *search, struct t_hashtable *pointers, struct t_hashtable *extra_vars, @@ -17177,7 +17177,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("irc_server"); void *servers = weechat_hdata_get_list (hdata, "irc_servers"); @@ -17226,7 +17226,7 @@ Return value of char variable in structure using hdata. Prototype: -[source,C] +[source,c] ---- char weechat_hdata_char (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17244,7 +17244,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "letter = %c", weechat_hdata_char (hdata, pointer, "letter")); ---- @@ -17268,7 +17268,7 @@ Return value of integer variable in structure using hdata. Prototype: -[source,C] +[source,c] ---- int weechat_hdata_integer (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17286,7 +17286,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17314,7 +17314,7 @@ Return value of long variable in structure using hdata. Prototype: -[source,C] +[source,c] ---- long weechat_hdata_long (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17332,7 +17332,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "longvar = %ld", weechat_hdata_long (hdata, pointer, "longvar")); ---- @@ -17356,7 +17356,7 @@ Return value of string variable in structure using hdata. Prototype: -[source,C] +[source,c] ---- const char *weechat_hdata_string (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17374,7 +17374,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17402,7 +17402,7 @@ Return value of pointer variable in structure using hdata. Prototype: -[source,C] +[source,c] ---- void *weechat_hdata_pointer (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17420,7 +17420,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17448,7 +17448,7 @@ Return value of time variable in structure using hdata. Prototype: -[source,C] +[source,c] ---- time_t weechat_hdata_time (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17466,7 +17466,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *ptr = weechat_buffer_search_main (); @@ -17516,7 +17516,7 @@ Return value of hashtable variable in structure using hdata. Prototype: -[source,C] +[source,c] ---- struct t_hashtable *weechat_hdata_hashtable (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17534,7 +17534,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17567,7 +17567,7 @@ Compare a hdata variable of two objects. Prototype: -[source,C] +[source,c] ---- int weechat_hdata_compare (struct t_hdata *hdata, void *pointer1, void *pointer2, const char *name, int case_sensitive); ---- @@ -17589,7 +17589,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer1 = weechat_buffer_search ("irc", "libera.#weechat"); @@ -17625,7 +17625,7 @@ if the variable can be updated. Prototype: -[source,C] +[source,c] ---- int weechat_hdata_set (struct t_hdata *hdata, void *pointer, const char *name, const char *value); ---- @@ -17644,7 +17644,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_hdata_set (hdata, pointer, "message", "test"); ---- @@ -17660,7 +17660,7 @@ Update data in a hdata. Prototype: -[source,C] +[source,c] ---- int weechat_hdata_update (struct t_hdata *hdata, void *pointer, struct t_hashtable *hashtable); ---- @@ -17686,7 +17686,7 @@ Return value: C example: -[source,C] +[source,c] ---- /* subtract one hour on last message displayed in current buffer */ @@ -17746,7 +17746,7 @@ Return string value of a hdata property. Prototype: -[source,C] +[source,c] ---- const char *weechat_hdata_get_string (struct t_hdata *hdata, const char *property); ---- @@ -17778,7 +17778,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_printf (NULL, "variables in hdata: %s", weechat_hdata_get_string (hdata, "var_keys")); weechat_printf (NULL, "lists in hdata: %s", weechat_hdata_get_string (hdata, "list_keys")); @@ -17809,7 +17809,7 @@ Create or read a file for upgrade. Prototype: -[source,C] +[source,c] ---- struct t_upgrade_file *upgrade_file_new (const char *filename, int (*callback_read)(const void *pointer, @@ -17848,7 +17848,7 @@ Return value: C example: -[source,C] +[source,c] ---- struct t_upgrade_file *upgrade_file = weechat_upgrade_new ("my_file", NULL, NULL, NULL); @@ -17871,7 +17871,7 @@ Write an object in upgrade file. Prototype: -[source,C] +[source,c] ---- int weechat_upgrade_write_object (struct t_upgrade_file *upgrade_file, int object_id, @@ -17890,7 +17890,7 @@ Return value: C example: -[source,C] +[source,c] ---- if (weechat_upgrade_write_object (upgrade_file, 1, &infolist)) { @@ -17921,7 +17921,7 @@ Read an upgrade file. Prototype: -[source,C] +[source,c] ---- int weechat_upgrade_read (struct t_upgrade_file *upgrade_file); ---- @@ -17936,7 +17936,7 @@ Return value: C example: -[source,C] +[source,c] ---- weechat_upgrade_read (upgrade_file); ---- @@ -17958,7 +17958,7 @@ Close an upgrade file. Prototype: -[source,C] +[source,c] ---- void weechat_upgrade_close (struct t_upgrade_file *upgrade_file); ---- @@ -17969,7 +17969,7 @@ Arguments: C example: -[source,C] +[source,c] ---- weechat_upgrade_close (upgrade_file); ---- diff --git a/doc/en/weechat_user.en.adoc b/doc/en/weechat_user.en.adoc index 8678aec8d..1b476d0f7 100644 --- a/doc/en/weechat_user.en.adoc +++ b/doc/en/weechat_user.en.adoc @@ -3853,7 +3853,7 @@ WebSocket if required headers are found in handshake and if origin is allowed A WebSocket can be opened in a HTML5 with a single line of JavaScript: -[source,js] +[source,javascript] ---- websocket = new WebSocket("ws://server.com:9000/weechat"); ---- diff --git a/doc/fr/weechat_dev.fr.adoc b/doc/fr/weechat_dev.fr.adoc index 380357def..d0e80d919 100644 --- a/doc/fr/weechat_dev.fr.adoc +++ b/doc/fr/weechat_dev.fr.adoc @@ -513,7 +513,7 @@ fichiers sont dans le répertoire _po/_ : Exemple en C : -[source,C] +[source,c] ---- /* * weechat.c - core functions for WeeChat @@ -554,7 +554,7 @@ Quelques règles basiques que vous *devez* suivre quand vous écrivez du code C Exemple : -[source,C] +[source,c] ---- /* * Checks if a string with boolean value is valid. @@ -587,7 +587,7 @@ foo () * Initialisez les variables locales après la déclaration, dans le corps de la fonction, exemple : -[source,C] +[source,c] ---- void foo () @@ -607,7 +607,7 @@ foo () nombre d'espaces utilisés sur la ligne au dessus de l'accolade ouvrante (le `if` dans l'exemple) : -[source,C] +[source,c] ---- if (nicks_count == 1) { @@ -618,7 +618,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 : -[source,C] +[source,c] ---- /* * Sends a message from out queue. @@ -662,7 +662,7 @@ irc_server_outqueue_send (struct t_irc_server *server) conditions avec un opérateur (pas nécessaire pour un booléen simple), comme ceci : -[source,C] +[source,c] ---- if (something) { @@ -686,7 +686,7 @@ else * Indentez les `switch` comme ceci : -[source,C] +[source,c] ---- switch (string[0]) { @@ -705,7 +705,7 @@ switch (string[0]) * Utilisez `typedef` pur les prototypes de fonctions mais pas pour les structures : -[source,C] +[source,c] ---- typedef int (t_hook_callback_fd)(void *data, int fd); @@ -787,7 +787,7 @@ Les structures ont le nom _t_X_Y_ ou _t_X_Y_Z_ : Exemple : un pseudo IRC (de _src/plugins/irc/irc-nick.h_) : -[source,C] +[source,c] ---- struct t_irc_nick { @@ -817,7 +817,7 @@ _last_X_ (où _X_ est le nom de la variable, en utilisant le singulier). Exemple : fenêtres (de _src/gui/gui-window.c_) : -[source,C] +[source,c] ---- struct t_gui_window *gui_windows = NULL; /* first window */ struct t_gui_window *last_gui_window = NULL; /* last window */ @@ -837,7 +837,7 @@ 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_) : -[source,C] +[source,c] ---- /* * Creates a new window. @@ -875,7 +875,7 @@ pointeur vers le nœud précédent/suivant. Exemple : liste des tampons (de _src/gui/gui-buffer.h_) : -[source,C] +[source,c] ---- struct t_gui_buffer { @@ -890,7 +890,7 @@ struct t_gui_buffer Et les deux pointeurs vers la tête et la fin de liste : -[source,C] +[source,c] ---- struct t_gui_buffer *gui_buffers = NULL; /* first buffer */ struct t_gui_buffer *last_gui_buffer = NULL; /* last buffer */ @@ -1086,7 +1086,7 @@ 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 : -[source,C] +[source,c] ---- struct t_hook *(*hook_timer) (struct t_weechat_plugin *plugin, long interval, @@ -1099,7 +1099,7 @@ struct t_hook *(*hook_timer) (struct t_weechat_plugin *plugin, Et la macro utilisée pour appeler cette fonction est : -[source,C] +[source,c] ---- #define weechat_hook_timer(__interval, __align_second, __max_calls, \ __callback, __data) \ @@ -1110,7 +1110,7 @@ Et la macro utilisée pour appeler cette fonction est : Donc dans une extension, l'appel à cette fonction sera par exemple : -[source,C] +[source,c] ---- server->hook_timer_sasl = weechat_hook_timer (timeout * 1000, 0, 1, diff --git a/doc/fr/weechat_plugin_api.fr.adoc b/doc/fr/weechat_plugin_api.fr.adoc index fa61c4fba..0f4d69e94 100644 --- a/doc/fr/weechat_plugin_api.fr.adoc +++ b/doc/fr/weechat_plugin_api.fr.adoc @@ -48,7 +48,7 @@ Pour appeler les fonctions de WeeChat dans le format affiché dans <<plugin_api> le pointeur global suivant doit être déclaré et initialisé dans la fonction <<_weechat_plugin_init,weechat_plugin_init>> : -[source,C] +[source,c] ---- struct t_weechat_plugin *weechat_plugin; ---- @@ -87,7 +87,7 @@ Cette fonction est appelée quand l'extension est chargée par WeeChat. Prototype : -[source,C] +[source,c] ---- int weechat_plugin_init (struct t_weechat_plugin *plugin, int argc, char *argv[]); @@ -152,7 +152,7 @@ Cette fonction est appelée quand l'extension est déchargée par WeeChat. Prototype : -[source,C] +[source,c] ---- int weechat_plugin_end (struct t_weechat_plugin *plugin); ---- @@ -199,7 +199,7 @@ 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 !) : -[source,C] +[source,c] ---- #include <stdlib.h> @@ -315,7 +315,7 @@ Retourner le nom d'une extension. Prototype : -[source,C] +[source,c] ---- const char *weechat_plugin_get_name (struct t_weechat_plugin *plugin); ---- @@ -331,7 +331,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- const char *name = weechat_plugin_get_name (plugin); ---- @@ -363,7 +363,7 @@ d'appeler cette fonction). Prototype : -[source,C] +[source,c] ---- void weechat_charset_set (const char *charset); ---- @@ -374,7 +374,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_charset_set ("iso-8859-1"); ---- @@ -396,7 +396,7 @@ Convertir une chaîne vers le jeu de caractères interne (UTF-8). Prototype : -[source,C] +[source,c] ---- char *weechat_iconv_to_internal (const char *charset, const char *string); ---- @@ -412,7 +412,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *str = weechat_iconv_to_internal ("iso-8859-1", "chaîne iso : é à"); /* ... */ @@ -436,7 +436,7 @@ Convertir une chaîne du jeu de caractères interne (UTF-8) vers un autre. Prototype : -[source,C] +[source,c] ---- char *weechat_iconv_from_internal (const char *charset, const char *string); ---- @@ -452,7 +452,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *str = weechat_iconv_from_internal ("iso-8859-1", "chaîne utf-8 : é à"); /* ... */ @@ -476,7 +476,7 @@ Retourner la chaîne traduite (dépend de la langue locale). Prototype : -[source,C] +[source,c] ---- const char *weechat_gettext (const char *string); ---- @@ -491,7 +491,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *str = weechat_gettext ("hello"); ---- @@ -514,7 +514,7 @@ le paramètre _count_. Prototype : -[source,C] +[source,c] ---- const char *weechat_ngettext (const char *string, const char *plural, int count); @@ -534,7 +534,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *str = weechat_ngettext ("file", "files", num_files); ---- @@ -557,7 +557,7 @@ Retourner la chaîne dupliquée, avec au plus _length_ caractères. Prototype : -[source,C] +[source,c] ---- char *weechat_strndup (const char *string, int length); ---- @@ -573,7 +573,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *str = weechat_strndup ("abcdef", 3); /* résultat : "abc" */ /* ... */ @@ -592,7 +592,7 @@ facultatif après la chaîne si elle est coupée. Prototype : -[source,C] +[source,c] ---- char *weechat_string_cut (const char *string, int length, int count_suffix, int screen, const char *cut_suffix); ---- @@ -611,7 +611,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *str = weechat_string_cut ("ceci est un test", 5, 1, 1, "…"); /* résultat : "ceci…" */ /* ... */ @@ -627,7 +627,7 @@ Convertir une chaîne UTF-8 en minuscules. Prototype : -[source,C] +[source,c] ---- void weechat_string_tolower (char *string); ---- @@ -638,7 +638,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- char str[] = "AbCdé"; weechat_string_tolower (str); /* str vaut maintenant : "abcdé" */ @@ -653,7 +653,7 @@ Convertir une chaîne UTF-8 en majuscules. Prototype : -[source,C] +[source,c] ---- void weechat_string_toupper (char *string); ---- @@ -664,7 +664,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- char str[] = "AbCdé"; weechat_string_toupper (str); /* str vaut maintenant : "ABCDé" */ @@ -681,7 +681,7 @@ Comparer deux chaînes indépendemment de la locale et de la casse. Prototype : -[source,C] +[source,c] ---- int weechat_strcasecmp (const char *string1, const char *string2); ---- @@ -699,7 +699,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int diff = weechat_strcasecmp ("aaa", "CCC"); /* == -2 */ ---- @@ -716,7 +716,7 @@ intervalle pour comparer la casse. Prototype : -[source,C] +[source,c] ---- int weechat_strcasecmp_range (const char *string1, const char *string2, int range); ---- @@ -741,7 +741,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int diff = weechat_strcasecmp_range ("nick{away}", "NICK[away]", 29); /* == 0 */ ---- @@ -758,7 +758,7 @@ caractères. Prototype : -[source,C] +[source,c] ---- int weechat_strncasecmp (const char *string1, const char *string2, int max); ---- @@ -777,7 +777,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int diff = weechat_strncasecmp ("aabb", "aacc", 2); /* == 0 */ ---- @@ -794,7 +794,7 @@ caractères, avec un intervalle pour comparer la casse. Prototype : -[source,C] +[source,c] ---- int weechat_strncasecmp_range (const char *string1, const char *string2, int max, int range); ---- @@ -820,7 +820,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int diff = weechat_strncasecmp_range ("nick{away}", "NICK[away]", 6, 29); /* == 0 */ ---- @@ -837,7 +837,7 @@ ignorant des caractères. Prototype : -[source,C] +[source,c] ---- int weechat_strcmp_ignore_chars (const char *string1, const char *string2, const char *chars_ignored, @@ -859,7 +859,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int diff = weechat_strcmp_ignore_chars ("a-b", "--a-e", "-", 1); /* == -3 */ ---- @@ -875,7 +875,7 @@ Rechercher une chaîne indépendemment de la locale et de la casse. Prototype : -[source,C] +[source,c] ---- const char *weechat_strcasestr (const char *string, const char *search); ---- @@ -893,7 +893,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- const char *pos = weechat_strcasestr ("aBcDeF", "de"); /* résultat : pointeur vers "DeF" */ ---- @@ -912,7 +912,7 @@ la fonction <<_utf8_strlen_screen,utf8_strlen_screen>>). Prototype : -[source,C] +[source,c] ---- int weechat_strlen_screen (const char *string); ---- @@ -927,7 +927,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int length_on_screen = weechat_strlen_screen ("é"); /* == 1 */ ---- @@ -951,7 +951,7 @@ Vérifier si une chaîne correspond à un masque. Prototype : -[source,C] +[source,c] ---- int weechat_string_match (const char *string, const char *mask, int case_sensitive); @@ -974,7 +974,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int match1 = weechat_string_match ("abcdef", "abc*", 0); /* == 1 */ int match2 = weechat_string_match ("abcdef", "*dd*", 0); /* == 0 */ @@ -1008,7 +1008,7 @@ haute qu'un masque standard. Prototype : -[source,C] +[source,c] ---- int weechat_string_match_list (const char *string, const char **masks, int case_sensitive); @@ -1029,7 +1029,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- const char *masks[3] = { "*", "!abc*", NULL }; int match1 = weechat_string_match_list ("abc", masks, 0); /* == 0 */ @@ -1059,7 +1059,7 @@ débute pas par `+~+`, alors une chaîne identique est retournée. Prototype : -[source,C] +[source,c] ---- char *weechat_string_expand_home (const char *path); ---- @@ -1075,7 +1075,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *str = weechat_string_expand_home ("~/fichier.txt"); /* résultat : "/home/user/fichier.txt" */ @@ -1099,7 +1099,7 @@ _WeeChat ≥ 1.3, mis à jour dans la 3.2._ Prototype : -[source,C] +[source,c] ---- char *weechat_string_eval_path_home (const char *path, struct t_hashtable *pointers, @@ -1130,7 +1130,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *str = weechat_string_eval_path_home ("${weechat_config_dir}/test.conf", NULL, NULL, NULL); /* résultat : "/home/user/.config/weechat/test.conf" */ @@ -1157,7 +1157,7 @@ espaces avant la première apostrophe ou après la dernière sont ignorés). Prototype : -[source,C] +[source,c] ---- char *weechat_string_remove_quotes (const char *string, const char *quotes); ---- @@ -1174,7 +1174,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *str = weechat_string_remove_quotes (string, " 'aujourd'hui' ", "'"); /* résultat : "aujourd'hui" */ @@ -1191,7 +1191,7 @@ Supprimer des caractères au début et/ou à la fin d'une chaîne. Prototype : -[source,C] +[source,c] ---- char *weechat_string_strip (const char *string, int left, int right, const char *chars); @@ -1211,7 +1211,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *str = weechat_string_strip (".abc -", 0, 1, "- ."); /* résultat : ".abc" */ /* ... */ @@ -1246,7 +1246,7 @@ Convertir les caractères échappés par leur valeur : Prototype : -[source,C] +[source,c] ---- char *weechat_string_convert_escaped_chars (const char *string); ---- @@ -1262,7 +1262,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *str = weechat_string_convert_escaped_chars ("snowman : \\u2603"); /* str == "snowman : ☃" */ @@ -1281,7 +1281,7 @@ d'expression régulière sont échappés. Prototype : -[source,C] +[source,c] ---- char *weechat_string_mask_to_regex (const char *mask); ---- @@ -1297,7 +1297,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *str_regex = weechat_string_mask_to_regex ("test*mask"); /* résultat : "test.*mask" */ @@ -1325,7 +1325,7 @@ Retourner un pointeur dans la chaîne après les "flags" et le masque avec les Prototype : -[source,C] +[source,c] ---- const char *weechat_string_regex_flags (const char *regex, int default_flags, int *flags) ---- @@ -1360,7 +1360,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- const char *regex = "(?i)test"; int flags; @@ -1380,7 +1380,7 @@ Compiler une expression régulière avec des "flags" optionnels en début de cha Prototype : -[source,C] +[source,c] ---- int weechat_string_regcomp (void *preg, const char *regex, int default_flags) ---- @@ -1406,7 +1406,7 @@ utilisation, si la fonction a retourné 0 (OK). Exemple en C : -[source,C] +[source,c] ---- regex_t my_regex; if (weechat_string_regcomp (&my_regex, "(?i)test", REG_EXTENDED) == 0) @@ -1432,7 +1432,7 @@ de mots "highlight". Prototype : -[source,C] +[source,c] ---- int weechat_string_has_highlight (const char *string, const char highlight_words); @@ -1449,7 +1449,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int hl = weechat_string_has_highlight ("my test string", "test,word2"); /* == 1 */ ---- @@ -1476,7 +1476,7 @@ délimiteurs (caractères différents de : alphanumérique, `+-+`, `+_+` et `+| Prototype : -[source,C] +[source,c] ---- int weechat_string_has_highlight_regex (const char *string, const char *regex); ---- @@ -1492,7 +1492,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int hl = weechat_string_has_highlight_regex ("my test string", "test|word2"); /* == 1 */ ---- @@ -1514,7 +1514,7 @@ Remplacer toutes les occurrences d'une chaîne par une autre chaîne. Prototype : -[source,C] +[source,c] ---- char *weechat_string_replace (const char *string, const char *search, const char *replace); @@ -1533,7 +1533,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *str = weechat_string_replace ("test, test", "s", "x"); /* résultat : "text" */ /* ... */ @@ -1552,7 +1552,7 @@ texte de remplacement et une fonction de rappel optionnelle. Prototype : -[source,C] +[source,c] ---- char *weechat_string_replace_regex (const char *string, void *regex, const char *replace, const char reference_char, @@ -1593,7 +1593,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- regex_t my_regex; char *string; @@ -1620,7 +1620,7 @@ Découper une chaîne à l'aide de délimiteur(s). Prototype : -[source,C] +[source,c] ---- char **weechat_string_split (const char *string, const char *separators, const char *strip_items, int flags, @@ -1667,7 +1667,7 @@ Valeur de retour : Exemples en C : -[source,C] +[source,c] ---- char **argv; int argc; @@ -1753,7 +1753,7 @@ https://docs.python.org/3/library/shlex.html. Prototype : -[source,C] +[source,c] ---- char **weechat_string_split_shell (const char *string, int *num_items); ---- @@ -1771,7 +1771,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char **argv; int argc; @@ -1794,7 +1794,7 @@ Supprimer une chaîne découpée. Prototype : -[source,C] +[source,c] ---- void weechat_string_free_split (char **split_string); ---- @@ -1805,7 +1805,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- char *argv; int argc; @@ -1823,7 +1823,7 @@ Construire une chaîne à partir d'une chaîne découpée. Prototype : -[source,C] +[source,c] ---- char *weechat_string_build_with_split_string (char **split_string const char *separator); @@ -1841,7 +1841,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char **argv; int argc; @@ -1862,7 +1862,7 @@ par `+\+` dans la chaîne). Prototype : -[source,C] +[source,c] ---- char **weechat_string_split_command (const char *command, char separator); ---- @@ -1879,7 +1879,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char **argv = weechat_string_split_command ("/commande1 arg;/commande2", ';'); /* résultat : argv[0] == "/commande1 arg" @@ -1898,7 +1898,7 @@ Supprimer une commande découpée. Prototype : -[source,C] +[source,c] ---- void weechat_string_free_split_command (char **split_command); ---- @@ -1910,7 +1910,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- char **argv = weechat_string_split_command ("/commande1 arg;/commande2", ';'); /* ... */ @@ -1927,7 +1927,7 @@ dans la langue locale. Prototype : -[source,C] +[source,c] ---- char *weechat_string_format_size (unsigned long long size); ---- @@ -1942,7 +1942,7 @@ Valeur de retour : Exemples en C : -[source,C] +[source,c] ---- /* exemples avec la langue française */ @@ -1986,7 +1986,7 @@ Retourner la taille (en octets) du code couleur WeeChat au début de la chaîne. Prototype : -[source,C] +[source,c] ---- int weechat_string_color_code_size (const char *string); ---- @@ -2003,7 +2003,7 @@ Valeur de retour : Exemples en C : -[source,C] +[source,c] ---- int size; @@ -2031,7 +2031,7 @@ Supprimer les couleurs WeeChat dans une chaîne. Prototype : -[source,C] +[source,c] ---- char *weechat_string_remove_color (const char *string, const char *replacement); @@ -2051,7 +2051,7 @@ Valeur de retour : Exemples en C : -[source,C] +[source,c] ---- /* supprime les codes couleur */ char *str = weechat_string_remove_color (ma_chaine1, NULL); @@ -2083,7 +2083,7 @@ Encoder une chaîne en base 16, 32 ou 64. Prototype : -[source,C] +[source,c] ---- int weechat_string_base_encode (int base, const char *from, int length, char *to); ---- @@ -2103,7 +2103,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *string = "abcdefgh", result[128]; int length; @@ -2126,7 +2126,7 @@ Décoder une chaîne encodée en base 16, 32 ou 64. Prototype : -[source,C] +[source,c] ---- int weechat_string_base_decode (int base, const char *from, char *to); ---- @@ -2145,7 +2145,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char result[128]; int length; @@ -2168,7 +2168,7 @@ Afficher les données sous forme d'octets en hexadécimal et ascii. Prototype : -[source,C] +[source,c] ---- char *string_hex_dump (const char *data, int data_size, int bytes_per_line, const char *prefix, const char *suffix); @@ -2191,7 +2191,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *string = "abc def-ghi"; char *dump = weechat_string_hex_dump (string, strlen (string), 8, " >> ", NULL); @@ -2211,7 +2211,7 @@ caractère par défaut de commande est `+/+`). Prototype : -[source,C] +[source,c] ---- int weechat_string_is_command_char (const char *string); ---- @@ -2226,7 +2226,7 @@ Valeur de retour : Exemples en C : -[source,C] +[source,c] ---- int command_char1 = weechat_string_is_command_char ("/test"); /* == 1 */ int command_char2 = weechat_string_is_command_char ("test"); /* == 0 */ @@ -2253,7 +2253,7 @@ l'intérieur du paramètre "string"), ou NULL si c'est une commande. Prototype : -[source,C] +[source,c] ---- const char *weechat_string_input_for_buffer (const char *string); ---- @@ -2268,7 +2268,7 @@ Valeur de retour : Exemples en C : -[source,C] +[source,c] ---- const char *str1 = weechat_string_input_for_buffer ("test"); /* "test" */ const char *str2 = weechat_string_input_for_buffer ("/test"); /* NULL */ @@ -2303,7 +2303,7 @@ Depuis la version 1.0, les variables imbriquées sont supportées, par exemple Prototype : -[source,C] +[source,c] ---- char *weechat_string_eval_expression (const char *expr, struct t_hashtable *pointers, @@ -2357,7 +2357,7 @@ Valeur de retour : Exemples en C : -[source,C] +[source,c] ---- /* conditions */ struct t_hashtable *options1 = weechat_hashtable_new (8, @@ -2969,7 +2969,7 @@ _pass:[string_dyn_*]_. Prototype : -[source,C] +[source,c] ---- char **weechat_string_dyn_alloc (int size_alloc); ---- @@ -2984,7 +2984,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); ---- @@ -3003,7 +3003,7 @@ assez de place pour copier la chaîne). Prototype : -[source,C] +[source,c] ---- int weechat_string_dyn_copy (char **string, const char *new_string); ---- @@ -3019,7 +3019,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); if (weechat_string_dyn_copy (string, "test")) @@ -3046,7 +3046,7 @@ assez de place pour concaténer la chaîne). Prototype : -[source,C] +[source,c] ---- int weechat_string_dyn_concat (char **string, const char *add, int bytes); ---- @@ -3065,7 +3065,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); if (weechat_string_dyn_copy (string, "test")) @@ -3088,7 +3088,7 @@ Libérer une chaîne dynamique. Prototype : -[source,C] +[source,c] ---- char *weechat_string_dyn_free (char **string, int free_string); ---- @@ -3105,7 +3105,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); if (weechat_string_dyn_concat (string, "test")) @@ -3134,7 +3134,7 @@ Vérifier si une chaîne a des caractères 8-bits. Prototype : -[source,C] +[source,c] ---- int weechat_utf8_has_8bits (const char *string); ---- @@ -3150,7 +3150,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (weechat_utf8_has_8bits (string)) { @@ -3169,7 +3169,7 @@ Vérifier si une chaîne est valide UTF-8. Prototype : -[source,C] +[source,c] ---- int weechat_utf8_is_valid (const char *string, int length, char **error); ---- @@ -3188,7 +3188,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *error; if (weechat_utf8_is_valid (string, -1, &error)) @@ -3211,7 +3211,7 @@ en les remplaçant par un caractère. Prototype : -[source,C] +[source,c] ---- void weechat_utf8_normalize (char *string, char replacement); ---- @@ -3223,7 +3223,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_utf8_normalize (string, '?'); ---- @@ -3239,7 +3239,7 @@ Retourner un pointeur vers le caractère UTF-8 précédent dans une chaîne. Prototype : -[source,C] +[source,c] ---- const char *weechat_utf8_prev_char (const char *string_start, const char *string); @@ -3260,7 +3260,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- const char *prev_char = weechat_utf8_prev_char (string, ptr_in_string); ---- @@ -3276,7 +3276,7 @@ Retourner un pointeur vers le caractère UTF-8 suivant dans une chaîne. Prototype : -[source,C] +[source,c] ---- const char *weechat_utf8_next_char (const char *string); ---- @@ -3294,7 +3294,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- const char *next_char = weechat_utf8_next_char (string); ---- @@ -3308,7 +3308,7 @@ Retourner un caractère UTF-8 sous forme d'entier. Prototype : -[source,C] +[source,c] ---- int weechat_utf8_char_int (const char *string); ---- @@ -3323,7 +3323,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int char_int = weechat_utf8_char_int ("être"); /* "ê" comme entier */ ---- @@ -3337,7 +3337,7 @@ Retourner la taille d'un caractère UTF-8 (en octets). Prototype : -[source,C] +[source,c] ---- int weechat_utf8_char_size (const char *string); ---- @@ -3352,7 +3352,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int char_size = weechat_utf8_char_size ("être"); /* == 2 */ ---- @@ -3366,7 +3366,7 @@ Retourner la taille d'une chaîne UTF-8 (en nombre de caractères UTF-8). Prototype : -[source,C] +[source,c] ---- int weechat_utf8_strlen (const char *string); ---- @@ -3381,7 +3381,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int length = weechat_utf8_strlen ("chêne"); /* == 5 */ ---- @@ -3396,7 +3396,7 @@ maximum _bytes_ octets dans la chaîne. Prototype : -[source,C] +[source,c] ---- int weechat_utf8_strnlen (const char *string, int bytes); ---- @@ -3412,7 +3412,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int length = weechat_utf8_strnlen ("chêne", 4); /* == 3 */ ---- @@ -3427,7 +3427,7 @@ sur l'écran. Prototype : -[source,C] +[source,c] ---- int weechat_utf8_strlen_screen (const char *string); ---- @@ -3442,7 +3442,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int length_on_screen = weechat_utf8_strlen_screen ("é"); /* == 1 */ ---- @@ -3458,7 +3458,7 @@ Comparer deux caractères UTF-8. Prototype : -[source,C] +[source,c] ---- int weechat_utf8_charcmp (const char *string1, const char *string2); ---- @@ -3476,7 +3476,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int diff = weechat_utf8_charcmp ("aaa", "ccc"); /* == -2 */ ---- @@ -3492,7 +3492,7 @@ Comparer deux caractères UTF-8 en ignorant la casse. Prototype : -[source,C] +[source,c] ---- int weechat_utf8_charcasecmp (const char *string1, const char *string2); ---- @@ -3510,7 +3510,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int diff = weechat_utf8_charcasecmp ("aaa", "CCC"); /* == -2 */ ---- @@ -3525,7 +3525,7 @@ sur l'écran. Prototype : -[source,C] +[source,c] ---- int weechat_utf8_char_size_screen (const char *string); ---- @@ -3540,7 +3540,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int length_on_screen = weechat_utf8_char_size_screen ("é"); /* == 1 */ ---- @@ -3556,7 +3556,7 @@ Avancer de N caractères dans une chaîne UTF-8. Prototype : -[source,C] +[source,c] ---- const char *weechat_utf8_add_offset (const char *string, int offset); ---- @@ -3575,7 +3575,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- const char *str = "chêne"; const char *str2 = weechat_utf8_add_offset (str, 3); /* pointe vers "ne" */ @@ -3590,7 +3590,7 @@ Retourner la position réelle dans une chaîne UTF-8. Prototype : -[source,C] +[source,c] ---- int weechat_utf8_real_pos (const char *string, int pos); ---- @@ -3606,7 +3606,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int pos = weechat_utf8_real_pos ("chêne", 3); /* == 4 */ ---- @@ -3620,7 +3620,7 @@ Retourner la position dans une chaîne UTF-8. Prototype : -[source,C] +[source,c] ---- int weechat_utf8_pos (const char *string, int real_pos); ---- @@ -3636,7 +3636,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int pos = weechat_utf8_pos ("chêne", 4); /* == 3 */ ---- @@ -3650,7 +3650,7 @@ Retourner une chaîne dupliquée, avec au plus _length_ caractères. Prototype : -[source,C] +[source,c] ---- char *weechat_utf8_strndup (const char *string, int length); ---- @@ -3667,7 +3667,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *string = weechat_utf8_strndup ("chêne", 3); /* retourne "chê" */ /* ... */ @@ -3690,7 +3690,7 @@ Calculer le hachage des données. Prototype : -[source,C] +[source,c] ---- int weechat_crypto_hash (const void *data, int data_size, const char *hash_algo, void *hash, int *hash_size); @@ -3732,7 +3732,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- const char *data = "abcdefghijklmnopqrstuvwxyz"; char hash[256 / 8]; @@ -3754,7 +3754,7 @@ des données. Prototype : -[source,C] +[source,c] ---- int weechat_crypto_hash_pbkdf2 (const void *data, int data_size, const char *hash_algo, @@ -3784,7 +3784,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- const char *data = "abcdefghijklmnopqrstuvwxyz"; const char *salt = "12345678901234567890123456789012"; /* 32 octets */ @@ -3808,7 +3808,7 @@ avec clé (HMAC). Prototype : -[source,C] +[source,c] ---- int weechat_crypto_hmac (const void *key, int key_size, const void *message, int message_size, int hash_algo, void *hash, int *hash_size); @@ -3835,7 +3835,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- const char *key = "the key"; const char *message = "the message"; @@ -3862,7 +3862,7 @@ Créer un répertoire dans le répertoire de WeeChat. Prototype : -[source,C] +[source,c] ---- int weechat_mkdir_home (char *directory, int mode); ---- @@ -3883,7 +3883,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (!weechat_mkdir_home ("${weechat_cache_dir}/temp", 0755)) { @@ -3908,7 +3908,7 @@ Créer un répertoire. Prototype : -[source,C] +[source,c] ---- int weechat_mkdir (char *directory, int mode); ---- @@ -3924,7 +3924,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (!weechat_mkdir ("/tmp/mydir", 0755)) { @@ -3949,7 +3949,7 @@ Créer un répertoire et ses parents si besoin. Prototype : -[source,C] +[source,c] ---- int weechat_mkdir_parents (char *directory, int mode); ---- @@ -3965,7 +3965,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (!weechat_mkdir_parents ("/tmp/my/dir", 0755)) { @@ -3993,7 +3993,7 @@ pour chaque fichier. Prototype : -[source,C] +[source,c] ---- void weechat_exec_on_files (const char *directory, int recurse_subdirs, @@ -4016,7 +4016,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- void callback (void *data, const char *filename) { @@ -4037,7 +4037,7 @@ Lire le contenu d'un fichier texte dans une chaîne de caractères. Prototype : -[source,C] +[source,c] ---- char *weechat_file_get_content (const char *filename); ---- @@ -4053,7 +4053,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *contenu; @@ -4073,7 +4073,7 @@ Copier un fichier vers une autre destination. Prototype : -[source,C] +[source,c] ---- int weechat_file_copy (const char *from, const char *to); ---- @@ -4089,7 +4089,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (weechat_file_copy ("/tmp/test.txt", "/path/to/test2.txt")) { @@ -4111,7 +4111,7 @@ Comparer deux structures "timeval". Prototype : -[source,C] +[source,c] ---- int weechat_util_timeval_cmp (struct timeval *tv1, struct timeval *tv2); ---- @@ -4129,7 +4129,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (weechat_util_timeval_cmp (&tv1, &tv2) > 0) { @@ -4148,7 +4148,7 @@ Retourner la différence (en microsecondes) entre deux structures "timeval". Prototype : -[source,C] +[source,c] ---- long long weechat_util_timeval_diff (struct timeval *tv1, struct timeval *tv2); ---- @@ -4167,7 +4167,7 @@ Avec WeeChat ≤ 1.0, la valeur retournée était en millisecondes. Exemple en C : -[source,C] +[source,c] ---- long long diff = weechat_util_timeval_diff (&tv1, &tv2); ---- @@ -4183,7 +4183,7 @@ Ajouter un intervalle (en microsecondes) à une structure "timeval". Prototype : -[source,C] +[source,c] ---- void weechat_util_timeval_add (struct timeval *tv, long long interval); ---- @@ -4198,7 +4198,7 @@ Avec WeeChat ≤ 1.0, l'intervalle était exprimé en millisecondes. Exemple en C : -[source,C] +[source,c] ---- weechat_util_timeval_add (&tv, 2000000); /* ajouter 2 secondes */ ---- @@ -4215,7 +4215,7 @@ format défini dans l'option _weechat.look.time_format_. Prototype : -[source,C] +[source,c] ---- const char *weechat_util_get_time_string (const time_t *date); ---- @@ -4230,7 +4230,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- time_t date = time (NULL); weechat_printf (NULL, "date : %s", @@ -4248,7 +4248,7 @@ Convertir une chaîne avec la version WeeChat en nombre. Prototype : -[source,C] +[source,c] ---- int weechat_util_version_number (const char *version); ---- @@ -4260,7 +4260,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- version_number = weechat_util_version_number ("0.3.8"); /* == 0x00030800 */ version_number = weechat_util_version_number ("0.3.9-dev"); /* == 0x00030900 */ @@ -4282,7 +4282,7 @@ Créer une nouvelle liste. Prototype : -[source,C] +[source,c] ---- struct t_weelist *weechat_list_new (); ---- @@ -4293,7 +4293,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_weelist *list = weechat_list_new (); ---- @@ -4315,7 +4315,7 @@ Ajouter un élément dans une liste. Prototype : -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_add (struct t_weelist *weelist, const char *data, @@ -4339,7 +4339,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_weelist_item *my_item = weechat_list_add (list, "ma donnée", WEECHAT_LIST_POS_SORT, NULL); @@ -4362,7 +4362,7 @@ Rechercher un élément dans une liste. Prototype : -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_search (struct t_weelist *weelist, const char *data); @@ -4379,7 +4379,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_weelist_item *item = weechat_list_search (list, "ma donnée"); ---- @@ -4403,7 +4403,7 @@ Rechercher la position d'un élément dans une liste. Prototype : -[source,C] +[source,c] ---- int weechat_list_search_pos (struct t_weelist *weelist, const char *data); @@ -4420,7 +4420,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int pos_item = weechat_list_search_pos (list, "ma donnée"); ---- @@ -4442,7 +4442,7 @@ Rechercher un élément dans la liste, sans tenir compte de la casse. Prototype : -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_casesearch (struct t_weelist *weelist, const char *data); @@ -4459,7 +4459,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_weelist_item *item = weechat_list_casesearch (list, "ma donnée"); ---- @@ -4484,7 +4484,7 @@ casse. Prototype : -[source,C] +[source,c] ---- int weechat_list_casesearch_pos (struct t_weelist *weelist, const char *data); @@ -4501,7 +4501,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int pos_item = weechat_list_casesearch_pos (list, "ma donnée"); ---- @@ -4523,7 +4523,7 @@ Retourner un élément de la liste par sa position. Prototype : -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_get (struct t_weelist *weelist, int position); @@ -4540,7 +4540,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_weelist_item *item = weechat_list_get (list, 0); /* premier élément */ ---- @@ -4562,7 +4562,7 @@ Affecter une nouvelle valeur pour un élément. Prototype : -[source,C] +[source,c] ---- void weechat_list_set (struct t_weelist_item *item, const char *value); ---- @@ -4574,7 +4574,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_list_set (item, "nouvelle donnée"); ---- @@ -4596,7 +4596,7 @@ Retourner l'élément suivant dans la liste. Prototype : -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_next (struct t_weelist_item *item); ---- @@ -4612,7 +4612,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_weelist_item *next_item = weechat_list_next (item); ---- @@ -4634,7 +4634,7 @@ Retourner l'élément précédent dans la liste. Prototype : -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_prev (struct t_weelist_item *item); ---- @@ -4650,7 +4650,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_weelist_item *prev_item = weechat_list_prev (item); ---- @@ -4672,7 +4672,7 @@ Retourner la valeur de l'élément sous forme de chaîne. Prototype : -[source,C] +[source,c] ---- const char *weechat_list_string (struct t_weelist_item *item); ---- @@ -4687,7 +4687,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "valeur de l'élément : %s", weechat_list_string (item)); ---- @@ -4711,7 +4711,7 @@ Retourner le pointeur vers les données utilisateur de l'élément. Prototype : -[source,C] +[source,c] ---- void *weechat_list_user_data (struct t_weelist_item *item); ---- @@ -4726,7 +4726,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "données utilisateur de l'élément : 0x%lx", weechat_list_user_data (item)); ---- @@ -4740,7 +4740,7 @@ Retourner la taille de la liste (nombre d'éléments). Prototype : -[source,C] +[source,c] ---- char *weechat_list_size (struct t_weelist *weelist); ---- @@ -4755,7 +4755,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "taille de la liste : %d", weechat_list_size (list)); ---- @@ -4777,7 +4777,7 @@ Supprimer un élément de la liste. Prototype : -[source,C] +[source,c] ---- void weechat_list_remove (struct t_weelist *weelist, struct t_weelist_item *item); @@ -4790,7 +4790,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_list_remove (list, item); ---- @@ -4812,7 +4812,7 @@ Supprimer tous les éléments de la liste. Prototype : -[source,C] +[source,c] ---- void weechat_list_remove_all (struct t_weelist *weelist); ---- @@ -4823,7 +4823,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_list_remove_all (list); ---- @@ -4845,7 +4845,7 @@ Supprimer une liste. Prototype : -[source,C] +[source,c] ---- void weechat_list_free (struct t_weelist *weelist); ---- @@ -4856,7 +4856,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_list_free (list); ---- @@ -4887,7 +4887,7 @@ Créer une nouvelle liste avec tableau. Prototype : -[source,C] +[source,c] ---- struct t_arraylist *weechat_arraylist_new (int initial_size, int sorted, @@ -4935,7 +4935,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int cmp_cb (void *data, struct t_arraylist *arraylist, @@ -4964,7 +4964,7 @@ Retourner la taille de la liste (nombre de pointeurs vers des éléments). Prototype : -[source,C] +[source,c] ---- int weechat_list_size (struct t_arraylist *arraylist); ---- @@ -4979,7 +4979,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "size of array list: %d", weechat_arraylist_size (arraylist)); ---- @@ -4995,7 +4995,7 @@ Retourner un pointeur avec un élément par sa position. Prototype : -[source,C] +[source,c] ---- void *weechat_arraylist_get (struct t_arraylist *arraylist, int index); ---- @@ -5011,7 +5011,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- void *pointer = weechat_arraylist_get (arraylist, 0); /* premier élément */ ---- @@ -5027,7 +5027,7 @@ Chercher un élément dans une liste avec tableau. Prototype : -[source,C] +[source,c] ---- void *weechat_arraylist_search (struct t_arraylist *arraylist, void *pointer, int *index, int *index_insert); @@ -5049,7 +5049,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int index, index_insert; void *item = weechat_arraylist_search (arraylist, pointer, &index, &index_insert); @@ -5066,7 +5066,7 @@ Insérer un élément dans une liste avec tableau. Prototype : -[source,C] +[source,c] ---- int weechat_arraylist_insert (struct t_arraylist *arraylist, int index, void *pointer); ---- @@ -5085,7 +5085,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int index = weechat_arraylist_insert (arraylist, -1, pointer); /* insert at the end if not sorted */ ---- @@ -5101,7 +5101,7 @@ Ajouter un élément dans une liste avec tableau. Prototype : -[source,C] +[source,c] ---- int weechat_arraylist_add (struct t_arraylist *arraylist, void *pointer); ---- @@ -5117,7 +5117,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int index = weechat_arraylist_add (arraylist, pointer); ---- @@ -5133,7 +5133,7 @@ Supprimer un élément d'une liste avec tableau. Prototype : -[source,C] +[source,c] ---- int weechat_arraylist_remove (struct t_arraylist *arraylist, int index); ---- @@ -5149,7 +5149,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int index_removed = weechat_arraylist_remove (arraylist, index); ---- @@ -5165,7 +5165,7 @@ Supprimer tous les éléments d'une liste avec tableau. Prototype : -[source,C] +[source,c] ---- int weechat_arraylist_clear (struct t_arraylist *arraylist); ---- @@ -5180,7 +5180,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (weechat_arraylist_clear (arraylist)) { @@ -5199,7 +5199,7 @@ Supprimer une liste avec tableau. Prototype : -[source,C] +[source,c] ---- void weechat_arraylist_free (struct t_arraylist *arraylist); ---- @@ -5210,7 +5210,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_arraylist_free (arraylist); ---- @@ -5231,7 +5231,7 @@ Créer une nouvelle table de hachage. Prototype : -[source,C] +[source,c] ---- struct t_hashtable *weechat_hashtable_new (int size, const char *type_keys, @@ -5285,7 +5285,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hashtable *hashtable = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, @@ -5306,7 +5306,7 @@ pour la clé et la valeur. Prototype : -[source,C] +[source,c] ---- struct t_hashtable_item *weechat_hashtable_set_with_size (struct t_hashtable *hashtable, const void *key, int key_size, @@ -5329,7 +5329,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_hashtable_set_with_size (hashtable, "ma_cle", 0, my_buffer, sizeof (my_buffer_struct)); @@ -5346,7 +5346,7 @@ Ajouter ou mettre à jour une entrée dans la table de hachage. Prototype : -[source,C] +[source,c] ---- struct t_hashtable_item *weechat_hashtable_set (struct t_hashtable *hashtable, const void *key, const void *value); @@ -5364,7 +5364,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_hashtable_set (hashtable, "ma_cle", "ma_valeur"); ---- @@ -5380,7 +5380,7 @@ Retourner la valeur associée à une clé dans une table de hachage. Prototype : -[source,C] +[source,c] ---- void *weechat_hashtable_get (struct t_hashtable *hashtable, void *key); ---- @@ -5396,7 +5396,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- void *value = weechat_hashtable_get (hashtable, "ma_cle"); ---- @@ -5412,7 +5412,7 @@ Vérifier si une clé est présente dans la table de hachage. Prototype : -[source,C] +[source,c] ---- int weechat_hashtable_has_key (struct t_hashtable *hashtable, void *key); ---- @@ -5429,7 +5429,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (weechat_hashtable_has_key (hashtable, "ma_cle")) { @@ -5450,7 +5450,7 @@ d'insertion dans la table de hachage (de la plus ancienne à la plus récente). Prototype : -[source,C] +[source,c] ---- void weechat_hashtable_map (struct t_hashtable *hashtable, void (*callback_map)(void *data, @@ -5469,7 +5469,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- void map_cb (void *data, struct t_hashtable *hashtable, @@ -5497,7 +5497,7 @@ en envoyant les clés et valeurs sous forme de chaînes. Prototype : -[source,C] +[source,c] ---- void weechat_hashtable_map_string (struct t_hashtable *hashtable, void (*callback_map)(void *data, @@ -5520,7 +5520,7 @@ temporaires, elles sont supprimées après l'appel à cette fonction. Exemple en C : -[source,C] +[source,c] ---- void map_cb (void *data, struct t_hashtable *hashtable, @@ -5545,7 +5545,7 @@ Dupliquer une table de hachage. Prototype : -[source,C] +[source,c] ---- struct t_hashtable *weechat_hashtable_dup (struct t_hashtable *hashtable); ---- @@ -5560,7 +5560,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hashtable *new_hashtable = weechat_hashtable_dup (hashtable); ---- @@ -5576,7 +5576,7 @@ Retourner une valeur entière pour une propriété d'une table de hachage. Prototype : -[source,C] +[source,c] ---- int weechat_hashtable_get_integer (struct t_hashtable *hashtable, void *property); @@ -5595,7 +5595,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int items_count = weechat_hashtable_get_integer (hashtable, "items_count"); ---- @@ -5612,7 +5612,7 @@ chaîne. Prototype : -[source,C] +[source,c] ---- const char *weechat_hashtable_get_string (struct t_hashtable *hashtable, const char *property); @@ -5650,7 +5650,7 @@ Valeur de retour : Exemples en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "les clés sont de type : %s", weechat_hashtable_get_string (hashtable, "type_keys")); @@ -5669,7 +5669,7 @@ Affecter un pointeur à une propriété d'une table de hachage. Prototype : -[source,C] +[source,c] ---- void weechat_hashtable_set_pointer (struct t_hashtable *hashtable, const char *property, void *pointer); @@ -5687,7 +5687,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- void my_free_value_cb (struct t_hashtable *hashtable, const void *key, void *value) @@ -5717,7 +5717,7 @@ d'insertion dans la table de hachage (de la plus ancienne à la plus récente). Prototype : -[source,C] +[source,c] ---- int weechat_hashtable_add_to_infolist (struct t_hashtable *hashtable, struct t_infolist_item *infolist_item, @@ -5736,7 +5736,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_hashtable_add_to_infolist (hashtable, infolist_item, "testhash"); @@ -5762,7 +5762,7 @@ Ajouter les éléments d'une infolist dans une table de hachage. Prototype: -[source,C] +[source,c] ---- int weechat_hashtable_add_from_infolist (struct t_hashtable *hashtable, struct t_infolist *infolist, @@ -5781,7 +5781,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_hashtable_add_from_infolist (hashtable, infolist, "testhash"); @@ -5807,7 +5807,7 @@ Supprimer un élément d'une table de hachage. Prototype : -[source,C] +[source,c] ---- void weechat_hashtable_remove (struct t_hashtable *hashtable, const void *key); ---- @@ -5819,7 +5819,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_hashtable_remove (hashtable, "ma_cle"); ---- @@ -5835,7 +5835,7 @@ Supprimer tous les éléments d'une table de hachage. Prototype : -[source,C] +[source,c] ---- void weechat_hashtable_remove_all (struct t_hashtable *hashtable); ---- @@ -5846,7 +5846,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_hashtable_remove_all (hashtable); ---- @@ -5862,7 +5862,7 @@ Supprimer une table de hachage. Prototype : -[source,C] +[source,c] ---- void weechat_hashtable_free (struct t_hashtable *hashtable); ---- @@ -5873,7 +5873,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_hashtable_free (hashtable); ---- @@ -5894,7 +5894,7 @@ Créer un nouveau fichier de configuration. Prototype : -[source,C] +[source,c] ---- struct t_config_file *weechat_config_new (const char *name, int (*callback_reload)(const void *pointer, @@ -5949,7 +5949,7 @@ Vous ne devriez appeler cette fonction qu'après avoir créé les sections (avec Exemple en C : -[source,C] +[source,c] ---- int my_config_reload_cb (const void *pointer, void *data, @@ -5988,7 +5988,7 @@ Créer une nouvelle section dans un fichier de configuration. Prototype : -[source,C] +[source,c] ---- struct t_config_section *weechat_config_new_section ( struct t_config_file *config_file, @@ -6141,7 +6141,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int my_section_read_cb (const void *pointer, void *data, @@ -6280,7 +6280,7 @@ Rechercher une section dans un fichier de configuration. Prototype : -[source,C] +[source,c] ---- struct t_config_section *weechat_config_search_section ( struct t_config_file *config_file, @@ -6298,7 +6298,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_config_section *section = weechat_config_search_section (config_file, "section"); @@ -6323,7 +6323,7 @@ Créer une nouvelle option dans une section d'un fichier de configuration. Prototype : -[source,C] +[source,c] ---- struct t_config_option *weechat_config_new_option ( struct t_config_file *config_file, @@ -6422,7 +6422,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- /* booléen */ struct t_config_option *option1 = @@ -6565,7 +6565,7 @@ Rechercher une option dans une section d'un fichier de configuration. Prototype : -[source,C] +[source,c] ---- struct t_config_option *weechat_config_search_option ( struct t_config_file *config_file, @@ -6585,7 +6585,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_search_option (config_file, section, "option"); @@ -6609,7 +6609,7 @@ section. Prototype : -[source,C] +[source,c] ---- void weechat_config_search_section_option (struct t_config_file *config_file, struct t_config_section *section, @@ -6630,7 +6630,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- struct t_config_section *ptr_section; struct t_config_option *ptr_option; @@ -6660,7 +6660,7 @@ complet. Prototype : -[source,C] +[source,c] ---- void weechat_config_search_with_string (const char *option_name, struct t_config_file **config_file, @@ -6684,7 +6684,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- struct t_config_file *ptr_config_file; struct t_config_section *ptr_section; @@ -6715,7 +6715,7 @@ Vérifier si un texte est "vrai" ou "faux", au sens booléen. Prototype : -[source,C] +[source,c] ---- int weechat_config_string_to_boolean (const char *text); ---- @@ -6731,7 +6731,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (weechat_config_string_to_boolean (option_value)) { @@ -6761,7 +6761,7 @@ Réinitialiser une option à sa valeur par défaut. Prototype : -[source,C] +[source,c] ---- int weechat_config_option_reset (struct t_config_option *option, int run_callback); @@ -6782,7 +6782,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- switch (weechat_config_option_reset (option, 1)) { @@ -6821,7 +6821,7 @@ Affecter une nouvelle valeur pour une option. Prototype : -[source,C] +[source,c] ---- int weechat_config_option_set (struct t_config_option *option, const char *value, int run_callback); @@ -6848,7 +6848,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- switch (weechat_config_option_set (option, "nouvelle_valeur", 1)) { @@ -6887,7 +6887,7 @@ Affecter "null" (valeur indéfinie) à une option. Prototype : -[source,C] +[source,c] ---- int weechat_config_option_set_null (struct t_config_option *option, int run_callback); @@ -6911,7 +6911,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- switch (weechat_config_option_set_null (option, 1)) { @@ -6950,7 +6950,7 @@ Réinitialiser ou supprimer une option. Prototype : -[source,C] +[source,c] ---- int weechat_config_option_unset (struct t_config_option *option); ---- @@ -6970,7 +6970,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- switch (weechat_config_option_unset (option)) { @@ -7014,7 +7014,7 @@ Renommer une option. Prototype : -[source,C] +[source,c] ---- void weechat_config_option_rename (struct t_config_option *option, const char *new_name); @@ -7027,7 +7027,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_config_option_rename (option, "nouveau_nom"); ---- @@ -7051,7 +7051,7 @@ Retourner la valeur d'une propriété de l'option sous forme de chaîne. Prototype : -[source,C] +[source,c] ---- const char *weechat_config_option_get_string (struct t_config_option *option, const char *property); @@ -7078,7 +7078,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- const char *type = weechat_config_option_get_string (option, "type"); ---- @@ -7092,7 +7092,7 @@ Retourner un pointeur vers une propriété de l'option. Prototype : -[source,C] +[source,c] ---- void *weechat_config_option_get_pointer (struct t_config_option *option, const char *property); @@ -7125,7 +7125,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char *description = weechat_config_option_get_pointer (option, "description"); ---- @@ -7139,7 +7139,7 @@ Vérifier si une option est "null" (valeur non définie). Prototype : -[source,C] +[source,c] ---- int weechat_config_option_is_null (struct t_config_option *option); ---- @@ -7155,7 +7155,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (weechat_config_option_is_null (option)) { @@ -7185,7 +7185,7 @@ Vérifier si la valeur par défaut d'une option est "null" (valeur non définie) Prototype : -[source,C] +[source,c] ---- int weechat_config_option_default_is_null (struct t_config_option *option); ---- @@ -7201,7 +7201,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (weechat_config_option_default_is_null (option)) { @@ -7231,7 +7231,7 @@ Retourner la valeur booléenne de l'option. Prototype : -[source,C] +[source,c] ---- int weechat_config_boolean (struct t_config_option *option); ---- @@ -7249,7 +7249,7 @@ Valeur de retour, selon le type de l'option : Exemple en C : -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); if (weechat_config_boolean (option)) @@ -7281,7 +7281,7 @@ Retourner la valeur booléenne par défaut de l'option. Prototype : -[source,C] +[source,c] ---- int weechat_config_boolean_default (struct t_config_option *option); ---- @@ -7299,7 +7299,7 @@ Valeur de retour, selon le type de l'option : Exemple en C : -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); if (weechat_config_boolean_default (option)) @@ -7331,7 +7331,7 @@ Retourner la valeur entière de l'option. Prototype : -[source,C] +[source,c] ---- int weechat_config_integer (struct t_config_option *option); ---- @@ -7349,7 +7349,7 @@ Valeur de retour, selon le type de l'option : Exemple en C : -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); int value = weechat_config_integer (option); @@ -7373,7 +7373,7 @@ Retourner la valeur entière par défaut de l'option. Prototype : -[source,C] +[source,c] ---- int weechat_config_integer_default (struct t_config_option *option); ---- @@ -7391,7 +7391,7 @@ Valeur de retour, selon le type de l'option : Exemple en C : -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); int value = weechat_config_integer_default (option); @@ -7415,7 +7415,7 @@ Retourner la valeur de l'option, sous forme de chaîne. Prototype : -[source,C] +[source,c] ---- const char *weechat_config_string (struct t_config_option *option); ---- @@ -7434,7 +7434,7 @@ Valeur de retour, selon le type de l'option : Exemple en C : -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *value = weechat_config_string (option); @@ -7458,7 +7458,7 @@ Retourner la valeur par défaut de l'option, sous forme de chaîne. Prototype : -[source,C] +[source,c] ---- const char *weechat_config_string_default (struct t_config_option *option); ---- @@ -7477,7 +7477,7 @@ Valeur de retour, selon le type de l'option : Exemple en C : -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *value = weechat_config_string_default (option); @@ -7501,7 +7501,7 @@ Retourner la valeur de l'option, sous forme de couleur. Prototype : -[source,C] +[source,c] ---- const char *weechat_config_color (struct t_config_option *option); ---- @@ -7519,7 +7519,7 @@ Valeur de retour, selon le type de l'option : Exemple en C : -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *color = weechat_config_color (option); @@ -7543,7 +7543,7 @@ Retourner la valeur par défaut de l'option, sous forme de couleur. Prototype : -[source,C] +[source,c] ---- const char *weechat_config_color_default (struct t_config_option *option); ---- @@ -7561,7 +7561,7 @@ Valeur de retour, selon le type de l'option : Exemple en C : -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *color = weechat_config_color_default (option); @@ -7587,7 +7587,7 @@ value = weechat.config_color_default(option) Prototype : -[source,C] +[source,c] ---- void weechat_config_write_option (struct t_config_file *config_file, struct t_config_option *option); @@ -7600,7 +7600,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- int my_section_write_cb (const void *pointer, void *data, @@ -7637,7 +7637,7 @@ une section). Prototype : -[source,C] +[source,c] ---- void weechat_config_write_line (struct t_config_file *config_file, const char *option_name, @@ -7653,7 +7653,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- int my_section_write_cb (const void *pointer, void *data, @@ -7689,7 +7689,7 @@ def my_section_write_cb(data, config_file, section_name): Prototype : -[source,C] +[source,c] ---- int weechat_config_write (struct t_config_file *config_file); ---- @@ -7706,7 +7706,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- switch (weechat_config_write (config_file)) { @@ -7745,7 +7745,7 @@ Lire un fichier de configuration depuis le disque. Prototype : -[source,C] +[source,c] ---- int weechat_config_read (struct t_config_file *config_file); ---- @@ -7762,7 +7762,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- switch (weechat_config_read (config_file)) { @@ -7801,7 +7801,7 @@ Relire un fichier de configuration depuis le disque. Prototype : -[source,C] +[source,c] ---- int weechat_config_reload (struct t_config_file *config_file); ---- @@ -7818,7 +7818,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- switch (weechat_config_reload (config_file)) { @@ -7857,7 +7857,7 @@ Supprimer une option. Prototype : -[source,C] +[source,c] ---- void weechat_config_option_free (struct t_config_option *option); ---- @@ -7868,7 +7868,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_config_option_free (option); ---- @@ -7890,7 +7890,7 @@ Supprimer toutes les options dans une section. Prototype : -[source,C] +[source,c] ---- void weechat_config_section_free_options (struct t_config_section *section); ---- @@ -7901,7 +7901,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_config_section_free_options (section); ---- @@ -7923,7 +7923,7 @@ Supprimer une section. Prototype : -[source,C] +[source,c] ---- void weechat_config_section_free (struct t_config_section *section); ---- @@ -7934,7 +7934,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_config_section_free (section); ---- @@ -7956,7 +7956,7 @@ Supprimer un fichier de configuration. Prototype : -[source,C] +[source,c] ---- void weechat_config_free (struct t_config_file *config_file); ---- @@ -7967,7 +7967,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_config_free (config_file); ---- @@ -7989,7 +7989,7 @@ Rechercher une option avec le nom complet. Prototype : -[source,C] +[source,c] ---- struct t_config_option *weechat_config_get (const char *option_name); ---- @@ -8004,7 +8004,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("weechat.look.item_time_format"); ---- @@ -8027,7 +8027,7 @@ Rechercher une option dans le fichier de configuration des extensions Prototype : -[source,C] +[source,c] ---- const char *weechat_config_get_plugin (const char *option_name); ---- @@ -8043,7 +8043,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- /* si l'extension courante est "test", alors on cherche la valeur de l'option "plugins.var.test.option" dans le fichier plugins.conf */ @@ -8068,7 +8068,7 @@ Vérifier si une option existe dans le fichier de configuration des extensions Prototype : -[source,C] +[source,c] ---- int weechat_config_is_set_plugin (const char *option_name); ---- @@ -8084,7 +8084,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (weechat_config_is_set_plugin ("option")) { @@ -8119,7 +8119,7 @@ des extensions (plugins.conf). Prototype : -[source,C] +[source,c] ---- int weechat_config_set_plugin (const char *option_name, const char *value); ---- @@ -8139,7 +8139,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- switch (weechat_config_set_plugin ("option", "valeur_test")) { @@ -8186,7 +8186,7 @@ extensions (plugins.conf). Prototype : -[source,C] +[source,c] ---- void weechat_config_set_desc_plugin (const char *option_name, const char *description); @@ -8204,7 +8204,7 @@ Une création future de cette option utilisera cette description. Exemple en C : -[source,C] +[source,c] ---- weechat_config_set_desc_plugin ("option", "description de l'option"); ---- @@ -8228,7 +8228,7 @@ Supprimer une option du fichier de configuration des extensions (plugins.conf). Prototype : -[source,C] +[source,c] ---- int weechat_config_unset_plugin (const char *option_name); ---- @@ -8249,7 +8249,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- switch (weechat_config_unset_plugin ("option")) { @@ -8305,7 +8305,7 @@ créées. Pour supprimer une association de touche, utilisez <<_key_unbind,key_u Prototype : -[source,C] +[source,c] ---- int weechat_key_bind (const char *context, struct t_hashtable *keys); ---- @@ -8331,7 +8331,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hashtable *keys = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, @@ -8374,7 +8374,7 @@ une touche définie par l'utilisateur. Prototype : -[source,C] +[source,c] ---- int weechat_key_unbind (const char *context, const char *key); ---- @@ -8393,7 +8393,7 @@ Valeur de retour : Exemples en C : -[source,C] +[source,c] ---- /* supprimer une seule touche */ weechat_key_unbind ("mouse", "@chat(plugin.buffer):button1"); @@ -8429,7 +8429,7 @@ Retourner un préfixe. Prototype : -[source,C] +[source,c] ---- const char *weechat_prefix (const char *prefix); ---- @@ -8460,7 +8460,7 @@ Les valeurs et couleurs peuvent être configurées avec la commande `/set`. Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "%sCeci est une erreur...", weechat_prefix ("error")); ---- @@ -8482,7 +8482,7 @@ Retourner une chaîne avec un code couleur pour affichage. Prototype : -[source,C] +[source,c] ---- const char *weechat_color (const char *color_name); ---- @@ -8543,7 +8543,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "Couleur : %sbleu %scouleur par défaut %sjaune sur rouge", weechat_color ("blue"), @@ -8569,7 +8569,7 @@ Afficher un message sur un tampon. Prototype : -[source,C] +[source,c] ---- void weechat_printf (struct t_gui_buffer *buffer, const char *message, ...); ---- @@ -8577,7 +8577,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 : -[source,C] +[source,c] ---- weechat_printf (buffer, "message"); weechat_printf_date_tags (buffer, 0, NULL, "message"); @@ -8603,7 +8603,7 @@ positionnée à 0. Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "Bonjour sur le tampon WeeChat"); weechat_printf (buffer, "Bonjour sur ce tampon"); @@ -8639,7 +8639,7 @@ personnalisées. Prototype : -[source,C] +[source,c] ---- void weechat_printf_date_tags (struct t_gui_buffer *buffer, time_t date, const char *tags, const char *message, ...); @@ -8659,7 +8659,7 @@ pour une liste des étiquettes couramment utilisées dans WeeChat. Exemple en C : -[source,C] +[source,c] ---- weechat_printf_date_tags (NULL, time (NULL) - 120, "notify_message", "Message il y a 2 minutes avec une étiquette 'notify_message'"); @@ -8688,7 +8688,7 @@ Afficher un message sur une ligne d'un tampon avec contenu libre. Prototype : -[source,C] +[source,c] ---- void weechat_printf_y (struct t_gui_buffer *buffer, int y, const char *message, ...); @@ -8706,7 +8706,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_printf_y (buffer, 2, "Mon message sur la 3ème ligne"); ---- @@ -8731,7 +8731,7 @@ La fonction s'appelle "print_y" dans les scripts ("prnt_y" en Python). Prototype : -[source,C] +[source,c] ---- void weechat_log_printf (const char *message, ...); ---- @@ -8742,7 +8742,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_log_printf ("Mon message dans le fichier log"); ---- @@ -8784,7 +8784,7 @@ La priorité par défaut est 1000. Exemple en C : -[source,C] +[source,c] ---- /* accroche un modificateur avec priorité = 2000 */ weechat_hook_modifier ("2000|input_text_display", &modifier_cb, NULL, NULL); @@ -8802,7 +8802,7 @@ Accrocher une commande. Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_command (const char *command, const char *description, @@ -8884,7 +8884,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int my_command_cb (const void *pointer, void *data, struct t_gui_buffer *buffer, @@ -8960,7 +8960,7 @@ Accrocher une complétion. Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_completion (const char *completion_item, const char *description, @@ -9021,7 +9021,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int my_completion_cb (const void *pointer, void *data, const char *completion_item, @@ -9075,7 +9075,7 @@ Intercepter une commande lorsqu'elle est exécutée par WeeChat. Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_command_run (const char *command, int (*callback)(const void *pointer, @@ -9114,7 +9114,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int my_command_run_cb (const void *pointer, void *data, @@ -9152,7 +9152,7 @@ Accrocher un minuteur (fonction appelée à intervalles réguliers). Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_timer (long interval, int align_second, @@ -9195,7 +9195,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int my_timer_cb (const void *pointer, void *data, int remaining_calls) @@ -9233,7 +9233,7 @@ Accrocher un descripteur de fichier (fichier ou socket). Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_fd (int fd, int flag_read, @@ -9280,7 +9280,7 @@ paramètre en entier avant de l'utiliser, par exemple en Python : `int(fd)`. Exemple en C : -[source,C] +[source,c] ---- int my_fd_cb (const void *pointer, void *data, int fd) @@ -9328,7 +9328,7 @@ les paramètres dans la table de hachage _options_ _(WeeChat ≥ 0.4.0)_. Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_process (const char *command, int timeout, @@ -9425,7 +9425,7 @@ appels et n'utiliser les données que lorsque le code retour est positif ou nul. Exemple en C : -[source,C] +[source,c] ---- /* exemple avec une commande externe */ int @@ -9558,7 +9558,7 @@ table de hachage, et intercepter sa sortie. Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_process_hashtable (const char *command, struct t_hashtable *options, @@ -9632,7 +9632,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int my_process_cb (const void *pointer, void *data, const char *command, @@ -9792,7 +9792,7 @@ Accrocher une connexion (connexion à une machine distante en tâche de fond). Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_connect (const char *proxy, const char *address, @@ -9884,7 +9884,7 @@ le paramètre avant de l'utiliser, par exemple en Python: `int(sock)`. Exemple en C : -[source,C] +[source,c] ---- int my_connect_cb (const void *pointer, void *data, int status, int gnutls_rc, @@ -9998,7 +9998,7 @@ buffers with free content. Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_line (const char *buffer_type, const char *buffer_name, @@ -10222,7 +10222,7 @@ valeurs sont des chaînes dans cette table de hachage) : Exemple en C : -[source,C] +[source,c] ---- int my_line_cb (const void *pointer, void *data, struct t_hasbtable *line) @@ -10272,7 +10272,7 @@ voir <<_hook_line,hook_line>>. Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_print (struct t_gui_buffer *buffer, const char *tags, @@ -10343,7 +10343,7 @@ le paramètre en entier avant de le tester, par exemple en Python : Exemple en C : -[source,C] +[source,c] ---- int my_print_cb (const void *pointer, void *data, struct t_gui_buffer *buffer, @@ -10385,7 +10385,7 @@ S'accrocher à un signal. Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_signal (const char *signal, int (*callback)(const void *pointer, @@ -11083,7 +11083,7 @@ Liste des signaux envoyés par WeeChat et les extensions : Exemple en C : -[source,C] +[source,c] ---- int my_signal_cb (const void *pointer, void *data, const char *signal, @@ -11122,7 +11122,7 @@ Envoyer un signal. Prototype : -[source,C] +[source,c] ---- int weechat_hook_signal_send (const char *signal, const char *type_data, void *signal_data); @@ -11145,7 +11145,7 @@ Valeur de retour _(WeeChat ≥ 1.0)_ : Exemple en C : -[source,C] +[source,c] ---- int rc = weechat_hook_signal_send ("mon_signal", WEECHAT_HOOK_SIGNAL_STRING, ma_chaine); ---- @@ -11172,7 +11172,7 @@ Le paramètre est un pointeur vers le tampon. Exemple en C : -[source,C] +[source,c] ---- weechat_hook_signal_send ("logger_backlog", WEECHAT_HOOK_SIGNAL_POINTER, buffer); ---- @@ -11216,7 +11216,7 @@ Le paramètre est une chaîne avec le chemin vers le script à installer. Exemple en C : -[source,C] +[source,c] ---- weechat_hook_signal_send ("python_script_install", WEECHAT_HOOK_SIGNAL_STRING, "/path/to/test.py"); ---- @@ -11253,7 +11253,7 @@ des virgules, nom du script sans le chemin, par exemple _script.py_). Exemple en C : -[source,C] +[source,c] ---- /* décharge et supprime les scripts test.py et script.py */ weechat_hook_signal_send ("python_script_remove", WEECHAT_HOOK_SIGNAL_STRING, @@ -11297,7 +11297,7 @@ Le paramètre est une chaîne avec le format suivant : Exemples en C : -[source,C] +[source,c] ---- /* dis "Bonjour !" sur le serveur libera, canal #weechat */ weechat_hook_signal_send ("irc_input_send", WEECHAT_HOOK_SIGNAL_STRING, @@ -11329,7 +11329,7 @@ S'accrocher à un hsignal (signal avec une table de hachage). Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_hsignal (const char *signal, int (*callback)(const void *pointer, @@ -11420,7 +11420,7 @@ modèle de redirection ("pattern"). Exemple en C : -[source,C] +[source,c] ---- int my_hsignal_cb (const void *pointer, void *data, const char *signal, @@ -11457,7 +11457,7 @@ Envoyer un hsignal (signal avec table de hachage). Prototype : -[source,C] +[source,c] ---- int weechat_hook_hsignal_send (const char *signal, struct t_hashtable *hashtable); ---- @@ -11477,7 +11477,7 @@ Valeur de retour _(WeeChat ≥ 1.0)_ : Exemple en C : -[source,C] +[source,c] ---- int rc; struct t_hashtable *hashtable = weechat_hashtable_new (8, @@ -11567,7 +11567,7 @@ valeurs sont des chaînes) : Exemple en C : -[source,C] +[source,c] ---- int test_whois_cb (const void *pointer, void *data, const char *signal, @@ -11653,7 +11653,7 @@ chaque redirection. Exemple en C : -[source,C] +[source,c] ---- struct t_hashtable *hashtable = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, @@ -11699,7 +11699,7 @@ S'accrocher à une option de configuration. Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_config (const char *option, int (*callback)(const void *pointer, @@ -11738,7 +11738,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int my_config_cb (const void *pointer, void *data, const char *option, @@ -11777,7 +11777,7 @@ Accrocher un modificateur. Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_modifier (const char *modifier, char *(*callback)(const void *pointer, @@ -11894,7 +11894,7 @@ Liste des modificateurs utilisés par WeeChat et les extensions : Exemple en C : -[source,C] +[source,c] ---- char * my_modifier_cb (const void *pointer, void *data, const char *modifier, @@ -11942,7 +11942,7 @@ Exécuter un ou plusieurs modificateurs. Prototype : -[source,C] +[source,c] ---- char *weechat_hook_modifier_exec (const char *modifier, const char *modifier_data, @@ -12037,7 +12037,7 @@ utilisés : Exemple en C : -[source,C] +[source,c] ---- char *new_string = weechat_hook_modifier_exec ("mon_modifier", mes_donnees, ma_chaine); @@ -12062,7 +12062,7 @@ Accrocher une information (la fonction de rappel prend et retourne une chaîne). Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_info (const char *info_name, const char *description, @@ -12106,7 +12106,7 @@ Avec WeeChat ≥ 2.5, la fonction de rappel renvoie une chaîne allouée Exemple en C : -[source,C] +[source,c] ---- char * my_info_cb (const void *pointer, void *data, const char *info_name, @@ -12148,7 +12148,7 @@ hachage). Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_info_hashtable (const char *info_name, const char *description, @@ -12192,7 +12192,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hashtable * my_info_hashtable_cb (const void *pointer, void *data, const char *info_name, @@ -12237,7 +12237,7 @@ l'infolist demandée. Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_infolist (const char *infolist_name, const char *description, @@ -12281,7 +12281,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_infolist * my_infolist_cb (const void *pointer, void *data, const char *infolist_name, @@ -12331,7 +12331,7 @@ demandé. Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_hdata (const char *hdata_name, const char *description, @@ -12366,7 +12366,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hdata * my_hdata_cb (const void *pointer, void *data, const char *hdata_name) @@ -12397,7 +12397,7 @@ Accrocher un focus : évènement souris ou touche du clavier pressée dans le m Prototype : -[source,C] +[source,c] ---- struct t_hook *weechat_hook_focus (const char *area, struct t_hashtable *(*callback)(const void *pointer, @@ -12571,7 +12571,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hashtable * my_focus_nicklist_cb (const void *pointer, void *data, struct t_hashtable *info) @@ -12611,7 +12611,7 @@ Affecter une valeur à une propriété d'un hook. Prototype : -[source,C] +[source,c] ---- void weechat_hook_set (struct t_hook *hook, const char *property, const char *value); @@ -12649,7 +12649,7 @@ Propriétés : Exemple en C : -[source,C] +[source,c] ---- struct t_hook *my_command_hook = weechat_hook_command ("abcd", "description", @@ -12682,7 +12682,7 @@ Décrocher quelque chose qui est a été accroché. Prototype : -[source,C] +[source,c] ---- void weechat_unhook (struct t_hook *hook); ---- @@ -12693,7 +12693,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- struct t_hook *my_hook = weechat_hook_command ( /* ... */ ); /* ... */ @@ -12719,7 +12719,7 @@ Décrocher tout ce qui a été accroché par l'extension courante. Prototype : -[source,C] +[source,c] ---- void weechat_unhook_all (const char *subplugin); ---- @@ -12731,7 +12731,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_unhook_all (NULL); ---- @@ -12760,7 +12760,7 @@ Ouvrir un nouveau tampon. Prototype : -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer_new (const char *name, int (*input_callback)(const void *pointer, @@ -12815,7 +12815,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int my_input_cb (const void *pointer, void *data, @@ -12865,7 +12865,7 @@ courante). Prototype : -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_current_buffer (); ---- @@ -12876,7 +12876,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (weechat_current_buffer (), "Texte sur le tampon courant"); ---- @@ -12900,7 +12900,7 @@ Rechercher un tampon par l'extension et/ou le nom. Prototype : -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer_search (const char *plugin, const char *name); @@ -12922,7 +12922,7 @@ Valeur de retour : Exemples en C : -[source,C] +[source,c] ---- struct t_gui_buffer *buffer1 = weechat_buffer_search ("irc", "libera.#weechat"); struct t_gui_buffer *buffer2 = weechat_buffer_search ("==", "irc.libera.#test"); /* WeeChat ≥ 1.0 */ @@ -12946,7 +12946,7 @@ affiché lorsque WeeChat démarre). Prototype : -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer_search_main (); ---- @@ -12957,7 +12957,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer = weechat_buffer_search_main (); ---- @@ -12979,7 +12979,7 @@ Effacer le contenu d'un tampon. Prototype : -[source,C] +[source,c] ---- void weechat_buffer_clear (struct t_gui_buffer *buffer); ---- @@ -12990,7 +12990,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_buffer *my_buffer = weechat_buffer_search ("mon_extension", "mon_tampon"); @@ -13019,7 +13019,7 @@ Fermer un tampon. Prototype : -[source,C] +[source,c] ---- void weechat_buffer_close (struct t_gui_buffer *buffer); ---- @@ -13030,7 +13030,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_buffer *my_buffer = weechat_buffer_new ("mon_tampon", &my_input_cb, NULL, @@ -13060,7 +13060,7 @@ les lignes des deux tampons (lignes mélangées). Prototype : -[source,C] +[source,c] ---- void weechat_buffer_merge (struct t_gui_buffer *buffer, struct t_gui_buffer *target_buffer); @@ -13073,7 +13073,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- /* mélanger le tampon courant avec le tampon "core" */ weechat_buffer_merge (weechat_current_buffer (), @@ -13098,7 +13098,7 @@ Supprimer le mélange d'un tampon. Prototype : -[source,C] +[source,c] ---- void weechat_buffer_unmerge (struct t_gui_buffer *buffer, int number); @@ -13112,7 +13112,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_buffer_unmerge (weechat_current_buffer (), 1); ---- @@ -13134,7 +13134,7 @@ Retourner une valeur entière pour une propriété du tampon. Prototype : -[source,C] +[source,c] ---- int weechat_buffer_get_integer (struct t_gui_buffer *buffer, const char *property); @@ -13203,7 +13203,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "mon numéro de tampon est : %d", weechat_buffer_get_integer (mon_tampon, "number")); @@ -13226,7 +13226,7 @@ Retourner la valeur d'une propriété du tampon sous forme de chaîne. Prototype : -[source,C] +[source,c] ---- const char *weechat_buffer_get_string (struct t_gui_buffer *buffer, const char *property); @@ -13263,7 +13263,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "nom / nom court du tampon sont : %s / %s", weechat_buffer_get_string (my_buffer, "name"), @@ -13289,7 +13289,7 @@ Retourner la valeur d'une propriété sous forme d'un pointeur. Prototype : -[source,C] +[source,c] ---- void *weechat_buffer_pointer (struct t_gui_buffer *buffer, const char *property); @@ -13309,7 +13309,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "pointeur vers l'extension de mon tampon : %lx", weechat_buffer_get_pointer (mon_tampon, "plugin")); @@ -13332,7 +13332,7 @@ Affecter une valeur à une propriété d'un tampon. Prototype : -[source,C] +[source,c] ---- void weechat_buffer_set (struct t_gui_buffer *buffer, const char *property, const char *value); @@ -13510,7 +13510,7 @@ Propriétés : Exemple en C : -[source,C] +[source,c] ---- /* désactiver la hotlist (pour tous les tampons) */ weechat_buffer_set (NULL, "hotlist", "-"); @@ -13559,7 +13559,7 @@ Affecter un pointeur à une propriété d'un tampon. Prototype : -[source,C] +[source,c] ---- void weechat_buffer_set_pointer (struct t_gui_buffer *buffer, const char *property, void *pointer); @@ -13584,7 +13584,7 @@ Paramètres : Prototypes pour les fonctions de rappel : -[source,C] +[source,c] ---- int close_callback (const void *pointer, void *data, struct t_gui_buffer *buffer); @@ -13599,7 +13599,7 @@ int nickcmp_callback (const void *pointer, void *data, Exemple en C : -[source,C] +[source,c] ---- int my_close_cb (const void *pointer, void *data, struct t_gui_buffer *buffer) @@ -13621,7 +13621,7 @@ les variables locales du tampon. Prototype : -[source,C] +[source,c] ---- char *weechat_buffer_string_replace_local_var (struct t_gui_buffer *buffer, const char *string); @@ -13638,7 +13638,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_buffer_set (mon_tampon, "localvar_set_toto", "abc"); @@ -13668,7 +13668,7 @@ Vérifier si le tampon correspond à la liste de tampons. Prototype : -[source,C] +[source,c] ---- int weechat_buffer_match_list (struct t_gui_buffer *buffer, const char *string); ---- @@ -13687,7 +13687,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_buffer *buffer = weechat_buffer_search ("irc", "libera.#weechat"); if (buffer) @@ -13726,7 +13726,7 @@ Retourner le pointeur vers la fenêtre courante. Prototype : -[source,C] +[source,c] ---- struct t_gui_window *weechat_current_window (); ---- @@ -13737,7 +13737,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_window *current_window = weechat_current_window (); ---- @@ -13761,7 +13761,7 @@ Retourner le pointeur vers la fenêtre affichant un tampon. Prototype : -[source,C] +[source,c] ---- struct t_gui_window *weechat_window_search_with_buffer (struct t_gui_buffer *buffer); ---- @@ -13777,7 +13777,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "fenêtre affichant le tampon core : %lx", @@ -13802,7 +13802,7 @@ Retourner la valeur entière d'une propriété de la fenêtre. Prototype : -[source,C] +[source,c] ---- int weechat_window_get_integer (struct t_gui_window *window, const char *property); @@ -13844,7 +13844,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "la fenêtre courante est en position (x,y) : (%d,%d)", weechat_window_get_integer (weechat_current_window (), "win_x"), @@ -13874,7 +13874,7 @@ version future. Prototype : -[source,C] +[source,c] ---- const char *weechat_window_get_string (struct t_gui_window *window, const char *property); @@ -13903,7 +13903,7 @@ Retourner la valeur d'une propriété, sous forme d'un pointeur. Prototype : -[source,C] +[source,c] ---- void *weechat_window_get_pointer (struct t_gui_window *window, const char *property); @@ -13922,7 +13922,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "tampon affiché dans la fenêtre courante : %lx", @@ -13947,7 +13947,7 @@ Définir le titre du terminal. Prototype : -[source,C] +[source,c] ---- void weechat_window_set_title (const char *title); ---- @@ -13960,7 +13960,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_window_set_title ("nouveau titre ici"); ---- @@ -13987,7 +13987,7 @@ Ajouter un groupe dans la liste des pseudos. Prototype : -[source,C] +[source,c] ---- struct t_gui_nick_group *weechat_nicklist_add_group (struct t_gui_buffer *buffer, struct t_gui_nick_group *parent_group, @@ -14026,7 +14026,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_nick_group *my_group = weechat_nicklist_add_group (my_buffer, @@ -14054,7 +14054,7 @@ Rechercher un groupe dans la liste des pseudos. Prototype : -[source,C] +[source,c] ---- struct t_gui_nick_group *weechat_nicklist_search_group (struct t_gui_buffer *buffer, struct t_gui_nick_group *from_group, @@ -14074,7 +14074,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_nick_group *ptr_group = weechat_nicklist_search_group (my_buffer, NULL, "groupe_test"); @@ -14097,7 +14097,7 @@ Ajouter un pseudo dans un groupe. Prototype : -[source,C] +[source,c] ---- struct t_gui_nick_group *weechat_nicklist_add_nick (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14138,7 +14138,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_nick *my_nick = weechat_nicklist_add_nick (my_buffer, my_group, @@ -14169,7 +14169,7 @@ Rechercher un pseudo dans la liste des pseudos. Prototype : -[source,C] +[source,c] ---- struct t_gui_nick *weechat_nicklist_search_nick (struct t_gui_buffer *buffer, struct t_gui_nick_group *from_group, @@ -14189,7 +14189,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_nick *ptr_nick = weechat_nicklist_search_nick (my_buffer, NULL, "test_nick"); @@ -14212,7 +14212,7 @@ Supprimer un groupe de la liste des pseudos. Prototype : -[source,C] +[source,c] ---- void weechat_nicklist_remove_group (struct t_gui_buffer *buffer, struct t_gui_nick_group *group); @@ -14226,7 +14226,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_nicklist_remove_group (my_buffer, my_group); ---- @@ -14248,7 +14248,7 @@ Supprimer un pseudo de la liste des pseudos. Prototype : -[source,C] +[source,c] ---- void weechat_nicklist_remove_nick (struct t_gui_buffer *buffer, struct t_gui_nick *nick); @@ -14261,7 +14261,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_nicklist_remove_nick (my_buffer, my_nick); ---- @@ -14283,7 +14283,7 @@ Supprimer tous les groupes/pseudos de la liste des pseudos. Prototype : -[source,C] +[source,c] ---- void weechat_nicklist_remove_all (struct t_gui_buffer *buffer); ---- @@ -14294,7 +14294,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_nicklist_remove_all (my_buffer); ---- @@ -14319,7 +14319,7 @@ principalement pour afficher la liste des pseudos). Prototype : -[source,C] +[source,c] ---- void weechat_nicklist_get_next_item (struct t_gui_buffer *buffer, struct t_gui_nick_group **group, @@ -14334,7 +14334,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_nick_group *ptr_group; struct t_gui_nick *ptr_nick; @@ -14369,7 +14369,7 @@ Retourner une valeur entière pour une propriété du groupe. Prototype : -[source,C] +[source,c] ---- int weechat_nicklist_group_get_integer (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14390,7 +14390,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int visible = weechat_nicklist_group_get_integer (buffer, group, "visible"); ---- @@ -14414,7 +14414,7 @@ Retourner la valeur d'une propriété du groupe sous forme de chaîne. Prototype : -[source,C] +[source,c] ---- const char *weechat_nicklist_group_get_string (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14435,7 +14435,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- const char *color = weechat_nicklist_group_get_string (buffer, group, "color"); ---- @@ -14459,7 +14459,7 @@ Retourner la valeur d'une propriété du groupe sous forme d'un pointeur. Prototype : -[source,C] +[source,c] ---- void *weechat_nicklist_group_get_pointer (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14479,7 +14479,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_nick_group *parent = weechat_nicklist_group_get_pointer (buffer, group, "parent"); ---- @@ -14503,7 +14503,7 @@ Affecter une valeur à une propriété d'un groupe. Prototype : -[source,C] +[source,c] ---- void weechat_nicklist_group_set (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14534,7 +14534,7 @@ Propriétés : Exemples en C : -[source,C] +[source,c] ---- /* changer la couleur du groupe en "bar_fg" */ weechat_nicklist_group_set (buffer, group, "color", "bar_fg"); @@ -14573,7 +14573,7 @@ Retourner une valeur entière pour une propriété du pseudo. Prototype : -[source,C] +[source,c] ---- int weechat_nicklist_nick_get_integer (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -14593,7 +14593,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int visible = weechat_nicklist_nick_get_integer (buffer, nick, "visible"); ---- @@ -14617,7 +14617,7 @@ Retourner la valeur d'une propriété du pseudo sous forme de chaîne. Prototype : -[source,C] +[source,c] ---- const char *weechat_nicklist_nick_get_string (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -14640,7 +14640,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- const char *color = weechat_nicklist_nick_get_string (buffer, nick, "color"); ---- @@ -14664,7 +14664,7 @@ Retourner la valeur d'une propriété du pseudo sous forme d'un pointeur. Prototype : -[source,C] +[source,c] ---- void *weechat_nicklist_nick_get_pointer (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -14684,7 +14684,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_nick_group *group = weechat_nicklist_nick_get_pointer (buffer, nick, "group"); ---- @@ -14708,7 +14708,7 @@ Affecter une valeur à une propriété d'un pseudo. Prototype : -[source,C] +[source,c] ---- void weechat_nicklist_nick_set (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -14746,7 +14746,7 @@ Propriétés : Exemples en C : -[source,C] +[source,c] ---- /* changer la couleur du pseudo en cyan */ weechat_nicklist_nick_set (buffer, nick, "color", "cyan"); @@ -14794,7 +14794,7 @@ Rechercher un objet de barre. Prototype : -[source,C] +[source,c] ---- struct t_gui_bar_item *weechat_bar_item_search (const char *name); ---- @@ -14809,7 +14809,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_bar_item *bar_item = weechat_bar_item_search ("myitem"); ---- @@ -14833,7 +14833,7 @@ Créer un nouvel objet de barre. Prototype : -[source,C] +[source,c] ---- struct t_gui_bar_item *weechat_bar_item_new (const char *name, char *(*build_callback)(const void *pointer, @@ -14875,7 +14875,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char * my_build_callback (const void *pointer, void *data, @@ -14927,7 +14927,7 @@ de construction. Prototype : -[source,C] +[source,c] ---- void weechat_bar_item_update (const char *name); ---- @@ -14938,7 +14938,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_bar_item_update ("myobjet"); ---- @@ -14960,7 +14960,7 @@ Supprimer un objet de barre. Prototype : -[source,C] +[source,c] ---- void weechat_bar_item_remove (struct t_gui_bar_item *item); ---- @@ -14971,7 +14971,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_bar_item_remove (&my_item); ---- @@ -14993,7 +14993,7 @@ Rechercher une barre. Prototype : -[source,C] +[source,c] ---- struct t_gui_bar *weechat_bar_search (const char *name); ---- @@ -15008,7 +15008,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_bar *bar = weechat_bar_search ("my_barre"); ---- @@ -15032,7 +15032,7 @@ Créer une nouvelle barre. Prototype : -[source,C] +[source,c] ---- struct t_gui_bar *weechat_bar_new (const char *name, const char *hidden, @@ -15108,7 +15108,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_bar *my_bar = weechat_bar_new ("mybar", "off", @@ -15156,7 +15156,7 @@ Affecter une nouvelle valeur pour une propriété de la barre. Prototype : -[source,C] +[source,c] ---- int weechat_bar_set (struct t_gui_bar *bar, const char *property, const char *value); @@ -15176,7 +15176,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_bar_set (my_bar, "position", "bottom"); ---- @@ -15198,7 +15198,7 @@ Mettre à jour le contenu d'une barre à l'écran. Prototype : -[source,C] +[source,c] ---- void weechat_bar_update (const char *name); ---- @@ -15209,7 +15209,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_bar_update ("mybar"); ---- @@ -15231,7 +15231,7 @@ Supprimer une barre. Prototype : -[source,C] +[source,c] ---- void weechat_bar_remove (struct t_gui_bar *bar); ---- @@ -15242,7 +15242,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_bar_remove (my_bar); ---- @@ -15271,7 +15271,7 @@ Exécuter une commande ou envoyer du texte au tampon. Prototype : -[source,C] +[source,c] ---- int weechat_command (struct t_gui_buffer *buffer, const char *command); ---- @@ -15290,7 +15290,7 @@ Valeur de retour _(WeeChat ≥ 1.1)_ : Exemple en C : -[source,C] +[source,c] ---- int rc; rc = weechat_command (weechat_buffer_search ("irc", "libera.#weechat"), @@ -15316,7 +15316,7 @@ Exécuter une commande ou envoyer du texte au tampon avec des options. Prototype : -[source,C] +[source,c] ---- int weechat_command_options (struct t_gui_buffer *buffer, const char *command, struct t_hashtable *options); @@ -15342,7 +15342,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- /* autoriser toute commande sauf /exec, lancer la commande dans 2 secondes */ int rc; @@ -15380,7 +15380,7 @@ Créer une complétion. Prototype : -[source,C] +[source,c] ---- struct t_gui_completion *weechat_completion_new (struct t_gui_buffer *buffer); ---- @@ -15395,7 +15395,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_completion *completion = weechat_completion_new (weechat_buffer_search_main ()); ---- @@ -15420,7 +15420,7 @@ de la complétion. Prototype : -[source,C] +[source,c] ---- int weechat_completion_search (struct t_gui_completion *completion, const char *data, int position, int direction); @@ -15439,7 +15439,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_gui_completion *completion = weechat_completion_new (weechat_buffer_search_main ()); if (weechat_completion_search (completion, "/help filt", 10, 1)) @@ -15469,7 +15469,7 @@ Retourner la valeur d'une propriété de la complétion sous forme de chaîne. Prototype : -[source,C] +[source,c] ---- const char *weechat_completion_get_string (struct t_gui_completion *completion, const char *property); @@ -15485,7 +15485,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- int my_completion_cb (const void *pointer, void *data, const char *completion_item, @@ -15526,7 +15526,7 @@ Ajouter un mot pour une complétion. Prototype : -[source,C] +[source,c] ---- void weechat_completion_list_add (struct t_gui_completion *completion, const char *word, @@ -15564,7 +15564,7 @@ Supprimer une complétion. Prototype : -[source,C] +[source,c] ---- void weechat_completion_free (struct t_gui_completion *completion); ---- @@ -15575,7 +15575,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_completion_free (completion); ---- @@ -15606,7 +15606,7 @@ appelée sans un processus issu d'un "fork", pour ne pas bloquer WeeChat. Prototype : -[source,C] +[source,c] ---- int weechat_network_pass_proxy (const char *proxy, int sock, @@ -15627,7 +15627,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (weechat_network_pass_proxy ("mon_proxy", sock, "irc.libera.chat", 6667)) { @@ -15654,7 +15654,7 @@ appelée sans un processus issu d'un "fork", pour ne pas bloquer WeeChat. Prototype : -[source,C] +[source,c] ---- int weechat_network_connect_to (const char *proxy, struct sockaddr *address, @@ -15673,7 +15673,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct sockaddr *addr; socklen_t length; @@ -15709,7 +15709,7 @@ Retourner une information, sous forme de chaîne, de WeeChat ou d'une extension. Prototype : -[source,C] +[source,c] ---- char *weechat_info_get (const char *info_name, const char *arguments); ---- @@ -15735,7 +15735,7 @@ include::includes/autogen_api_infos.fr.adoc[tag=infos] Exemple en C : -[source,C] +[source,c] ---- char *version = weechat_info_get ("version", NULL); char *date = weechat_info_get ("date", NULL); @@ -15774,7 +15774,7 @@ extension. Prototype : -[source,C] +[source,c] ---- struct t_hashtable *weechat_info_get_hashtable (const char *info_name, struct t_hashtable *hashtable); @@ -15796,7 +15796,7 @@ include::includes/autogen_api_infos_hashtable.fr.adoc[tag=infos_hashtable] Exemple en C : -[source,C] +[source,c] ---- struct t_hashtable *hashtable_in, *hashtable_out; @@ -15881,7 +15881,7 @@ Créer une "infolist". Prototype : -[source,C] +[source,c] ---- struct t_infolist *weechat_infolist_new (); ---- @@ -15892,7 +15892,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_infolist *infolist = weechat_infolist_new (); ---- @@ -15914,7 +15914,7 @@ Ajouter un objet dans l'infolist. Prototype : -[source,C] +[source,c] ---- struct t_infolist_item *weechat_infolist_new_item (struct t_infolist *infolist); ---- @@ -15929,7 +15929,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_infolist_item *item = weechat_infolist_new_item (infolist); ---- @@ -15951,7 +15951,7 @@ Ajouter une variable de type "integer" dans l'objet de l'infolist. Prototype : -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_integer (struct t_infolist_item *item, const char *name, @@ -15970,7 +15970,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_integer (item, "mon_entier", @@ -15994,7 +15994,7 @@ Ajouter une variable de type "string" dans l'objet de l'infolist. Prototype : -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_string (struct t_infolist_item *item, const char *name, @@ -16013,7 +16013,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_string (item, "ma_chaine", @@ -16037,7 +16037,7 @@ Ajouter une variable de type "pointer" dans l'objet de l'infolist. Prototype : -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_pointer (struct t_infolist_item *item, const char *name, @@ -16056,7 +16056,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_pointer (item, "mon_pointeur", @@ -16080,7 +16080,7 @@ Ajouter une variable de type "buffer" dans l'objet de l'infolist. Prototype : -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_buffer (struct t_infolist_item *item, const char *name, @@ -16101,7 +16101,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- char buffer[256]; /* ... */ @@ -16120,7 +16120,7 @@ Ajouter une variable de type "time" dans l'objet de l'infolist. Prototype : -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_time (struct t_infolist_item *item, const char *name, @@ -16139,7 +16139,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_time (item, "mon_time", @@ -16172,7 +16172,7 @@ données brutes), voir <<hdata,hdata>>. Prototype : -[source,C] +[source,c] ---- struct t_infolist *weechat_infolist_get (const char *infolist_name, void *pointer, @@ -16197,7 +16197,7 @@ include::includes/autogen_api_infolists.fr.adoc[tag=infolists] Exemple en C : -[source,C] +[source,c] ---- struct t_infolist *infolist = weechat_infolist_get ("irc_server", NULL, NULL); ---- @@ -16221,7 +16221,7 @@ l'infolist. Prototype : -[source,C] +[source,c] ---- int weechat_infolist_next (struct t_infolist *infolist); ---- @@ -16237,7 +16237,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (weechat_infolist_next (infolist)) { @@ -16272,7 +16272,7 @@ l'infolist. Prototype : -[source,C] +[source,c] ---- int weechat_infolist_prev (struct t_infolist *infolist); ---- @@ -16288,7 +16288,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (weechat_infolist_prev (infolist)) { @@ -16321,7 +16321,7 @@ Réinitialiser le "curseur" de l'infolist. Prototype : -[source,C] +[source,c] ---- void weechat_infolist_reset_item_cursor (struct t_infolist *infolist); ---- @@ -16332,7 +16332,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_infolist_reset_item_cursor (infolist); ---- @@ -16356,7 +16356,7 @@ Chercher une variable dans l'objet courant de l'infolist. Prototype : -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_search_var (struct t_infolist *infolist, const char *name); @@ -16373,7 +16373,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (weechat_infolist_search_var (infolist, "name")) { @@ -16401,7 +16401,7 @@ Retourner la liste des champs pour l'objet courant de l'infolist. Prototype : -[source,C] +[source,c] ---- const char *weechat_infolist_fields (struct t_infolist *infolist); ---- @@ -16419,7 +16419,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- const char *fields = weechat_infolist_fields (infolist); /* fields contient quelque chose comme : @@ -16446,7 +16446,7 @@ d'entier. Prototype : -[source,C] +[source,c] ---- int weechat_infolist_integer (struct t_infolist *infolist, const char *var); ---- @@ -16462,7 +16462,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "entier = %d", weechat_infolist_integer (infolist, "mon_entier")); @@ -16486,7 +16486,7 @@ de chaîne de caractères. Prototype : -[source,C] +[source,c] ---- const char *weechat_infolist_string (struct t_infolist *infolist, const char *var); ---- @@ -16502,7 +16502,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "chaîne = %s", weechat_infolist_string (infolist, "ma_chaine")); @@ -16526,7 +16526,7 @@ de pointeur. Prototype : -[source,C] +[source,c] ---- void *weechat_infolist_pointer (struct t_infolist *infolist, const char *var); ---- @@ -16542,7 +16542,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "pointeur = 0x%lx", weechat_infolist_pointer (infolist, "mon_pointeur")); @@ -16566,7 +16566,7 @@ de tampon de données. Prototype : -[source,C] +[source,c] ---- void *weechat_infolist_buffer (struct t_infolist *infolist, const char *var, int *size); @@ -16585,7 +16585,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int size; void *pointer = weechat_infolist_buffer (infolist, "mon_buffer", &size); @@ -16603,7 +16603,7 @@ de date/heure. Prototype : -[source,C] +[source,c] ---- time_t weechat_infolist_time (struct t_infolist *infolist, const char *var); ---- @@ -16619,7 +16619,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "date/heure = %ld", weechat_infolist_time (infolist, "mon_time")); @@ -16642,7 +16642,7 @@ Supprimer une infolist. Prototype : -[source,C] +[source,c] ---- void weechat_infolist_free (struct t_infolist *infolist); ---- @@ -16653,7 +16653,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_infolist_free (infolist); ---- @@ -16702,7 +16702,7 @@ Il est similaire à l'infolist, mais il y a quelques différences : Prototype : -[source,C] +[source,c] ---- struct t_hdata *weechat_hdata_new (const char *hdata_name, const char *var_prev, const char *var_next, int create_allowed, int delete_allowed, @@ -16743,7 +16743,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_new ("myplugin_list", "prev", "next", 0, 0, &callback_update, NULL); ---- @@ -16759,7 +16759,7 @@ Créer une nouvelle variable dans le hdata. Prototype : -[source,C] +[source,c] ---- void weechat_hdata_new_var (struct t_hdata *hdata, const char *name, int offset, int type, int update_allowed, const char *array_size, const char *hdata_name); @@ -16824,7 +16824,7 @@ Exemples de variables avec la taille de tableau correspondante (_WeeChat ≥ 3.4 Exemple en C : -[source,C] +[source,c] ---- struct t_myplugin_list { @@ -16853,7 +16853,7 @@ weechat_hdata_new_var (hdata, "next", offsetof (struct t_myplugin_list, next), W La macro "WEECHAT_HDATA_VAR" peut être utilisée pour raccourcir le code : -[source,C] +[source,c] ---- WEECHAT_HDATA_VAR(struct t_myplugin_list, name, STRING, 0, NULL, NULL); WEECHAT_HDATA_VAR(struct t_myplugin_list, buffer, POINTER, 0, NULL, NULL); @@ -16876,7 +16876,7 @@ Créer un nouveau pointeur vers une liste dans le hdata. Prototype : -[source,C] +[source,c] ---- void weechat_hdata_new_list (struct t_hdata *hdata, const char *name, void *pointer, int flags); ---- @@ -16892,7 +16892,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- struct t_myplugin_list { @@ -16922,7 +16922,7 @@ weechat_hdata_new_list (hdata, "last_buffer", &last_buffer, 0); La macro "WEECHAT_HDATA_LIST" peut être utilisée pour raccourcir le code : -[source,C] +[source,c] ---- WEECHAT_HDATA_LIST(buffers, WEECHAT_HDATA_LIST_CHECK_POINTERS); WEECHAT_HDATA_LIST(last_buffer, 0); @@ -16945,7 +16945,7 @@ extension pour lire des données. Prototype : -[source,C] +[source,c] ---- struct t_hdata *weechat_hdata_get (const char *hdata_name); ---- @@ -16964,7 +16964,7 @@ include::includes/autogen_api_hdata.fr.adoc[tag=hdata] Exemple en C : -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("irc_server"); ---- @@ -16988,7 +16988,7 @@ Retourner la position (offset) de la variable dans le hdata. Prototype : -[source,C] +[source,c] ---- int weechat_hdata_get_var_offset (struct t_hdata *hdata, const char *name); ---- @@ -17004,7 +17004,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int offset = weechat_hdata_get_var_offset (hdata, "name"); ---- @@ -17028,7 +17028,7 @@ Retourner le type de la variable dans le hdata (sous forme d'entier). Prototype : -[source,C] +[source,c] ---- int weechat_hdata_get_var_type (struct t_hdata *hdata, const char *name); ---- @@ -17044,7 +17044,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int type = weechat_hdata_get_var_type (hdata, "name"); switch (type) @@ -17093,7 +17093,7 @@ Retourner le type de la variable dans le hdata (sous forme de chaîne). Prototype : -[source,C] +[source,c] ---- const char *weechat_hdata_get_var_type_string (struct t_hdata *hdata, const char *name); ---- @@ -17109,7 +17109,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "type = %s", weechat_hdata_get_var_type_string (hdata, "name")); ---- @@ -17133,7 +17133,7 @@ Retourner la taille du tableau pour la variable dans le hdata. Prototype : -[source,C] +[source,c] ---- int weechat_hdata_get_var_array_size (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17151,7 +17151,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- int array_size = weechat_hdata_get_var_array_size (hdata, pointer, "name"); ---- @@ -17176,7 +17176,7 @@ chaîne). Prototype : -[source,C] +[source,c] ---- const char *weechat_hdata_get_var_count_array_size (struct t_hdata *hdata, void *pointer, const char *name); @@ -17195,7 +17195,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- const char *array_size = weechat_hdata_get_var_array_size_string (hdata, pointer, "name"); ---- @@ -17219,7 +17219,7 @@ Retourner le hdata pour la variable dans le hdata. Prototype : -[source,C] +[source,c] ---- const char *weechat_hdata_get_var_hdata (struct t_hdata *hdata, const char *name); ---- @@ -17235,7 +17235,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "hdata = %s", weechat_hdata_get_var_hdata (hdata, "name")); ---- @@ -17259,7 +17259,7 @@ Retourner un pointeur vers le contenu de la variable dans le hdata. Prototype : -[source,C] +[source,c] ---- void *weechat_hdata_get_var (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17276,7 +17276,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17295,7 +17295,7 @@ une position (offset). Prototype : -[source,C] +[source,c] ---- void *weechat_hdata_get_var_at_offset (struct t_hdata *hdata, void *pointer, int offset); ---- @@ -17312,7 +17312,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17331,7 +17331,7 @@ Retourner un pointeur de liste du hdata. Prototype : -[source,C] +[source,c] ---- void *weechat_hdata_get_list (struct t_hdata *hdata, const char *name); ---- @@ -17347,7 +17347,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffers = weechat_hdata_get_list (hdata, "gui_buffers"); @@ -17373,7 +17373,7 @@ Vérifier si un pointeur est valide pour un hdata et un pointeur de liste. Prototype : -[source,C] +[source,c] ---- int weechat_hdata_check_pointer (struct t_hdata *hdata, void *list, void *pointer); ---- @@ -17394,7 +17394,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- /* vérifie si le pointeur vers le tampon est valide */ struct t_hdata *hdata = weechat_hdata_get ("buffer"); @@ -17435,7 +17435,7 @@ Déplacer le pointeur vers un autre élément dans la liste. Prototype : -[source,C] +[source,c] ---- void *weechat_hdata_move (struct t_hdata *hdata, void *pointer, int count); ---- @@ -17454,7 +17454,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17495,7 +17495,7 @@ chaque élément dans la liste, jusqu'à trouver l'élément (ou la fin de la li Prototype : -[source,C] +[source,c] ---- void *weechat_hdata_search (struct t_hdata *hdata, void *pointer, const char *search, struct t_hashtable *pointers, struct t_hashtable *extra_vars, @@ -17532,7 +17532,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("irc_server"); void *servers = weechat_hdata_get_list (hdata, "irc_servers"); @@ -17582,7 +17582,7 @@ forme de caractère. Prototype : -[source,C] +[source,c] ---- char weechat_hdata_char (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17601,7 +17601,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "letter = %c", weechat_hdata_char (hdata, pointer, "letter")); ---- @@ -17626,7 +17626,7 @@ forme d'entier. Prototype : -[source,C] +[source,c] ---- int weechat_hdata_integer (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17645,7 +17645,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17674,7 +17674,7 @@ forme d'entier long. Prototype : -[source,C] +[source,c] ---- long weechat_hdata_long (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17693,7 +17693,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_printf (NULL, "longvar = %ld", weechat_hdata_long (hdata, pointer, "longvar")); ---- @@ -17718,7 +17718,7 @@ forme de chaîne. Prototype : -[source,C] +[source,c] ---- const char *weechat_hdata_string (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17737,7 +17737,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17766,7 +17766,7 @@ forme de pointeur. Prototype : -[source,C] +[source,c] ---- void *weechat_hdata_pointer (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17785,7 +17785,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17814,7 +17814,7 @@ forme de date/heure. Prototype : -[source,C] +[source,c] ---- time_t weechat_hdata_time (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17833,7 +17833,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *ptr = weechat_buffer_search_main (); @@ -17884,7 +17884,7 @@ forme de table de hachage. Prototype : -[source,C] +[source,c] ---- struct t_hashtable *weechat_hdata_hashtable (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17903,7 +17903,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17936,7 +17936,7 @@ Comparer une variable hdata de deux objets. Prototype : -[source,C] +[source,c] ---- int weechat_hdata_compare (struct t_hdata *hdata, void *pointer1, void *pointer2, const char *name, int case_sensitive); ---- @@ -17959,7 +17959,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer1 = weechat_buffer_search ("irc", "libera.#weechat"); @@ -17994,7 +17994,7 @@ variable peut être mise à jour. Prototype : -[source,C] +[source,c] ---- int weechat_hdata_set (struct t_hdata *hdata, void *pointer, const char *name, const char *value); ---- @@ -18013,7 +18013,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_hdata_set (hdata, pointer, "message", "test"); ---- @@ -18029,7 +18029,7 @@ Mettre à jour des données dans le hdata. Prototype : -[source,C] +[source,c] ---- int weechat_hdata_update (struct t_hdata *hdata, void *pointer, struct t_hashtable *hashtable); ---- @@ -18058,7 +18058,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- /* soustrait une heure sur le dernier message affiché dans le tampon courant */ @@ -18118,7 +18118,7 @@ Retourner une valeur pour une propriété d'un hdata sous forme de chaîne. Prototype : -[source,C] +[source,c] ---- const char *weechat_hdata_get_string (struct t_hdata *hdata, const char *property); ---- @@ -18150,7 +18150,7 @@ Valeur de retour : Exemple en C : -[source,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")); @@ -18181,7 +18181,7 @@ Créer ou lire un fichier pour la mise à jour. Prototype : -[source,C] +[source,c] ---- struct t_upgrade_file *upgrade_file_new (const char *filename, int (*callback_read)(const void *pointer, @@ -18222,7 +18222,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- struct t_upgrade_file *upgrade_file = weechat_upgrade_new ("mon_fichier", NULL, NULL, NULL); @@ -18245,7 +18245,7 @@ upgrade_file = weechat.upgrade_new("mon_fichier", "", "") Prototype : -[source,C] +[source,c] ---- int weechat_upgrade_write_object (struct t_upgrade_file *upgrade_file, int object_id, @@ -18264,7 +18264,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- if (weechat_upgrade_write_object (upgrade_file, 1, &infolist)) { @@ -18295,7 +18295,7 @@ Lire un fichier de mise à jour. Prototype : -[source,C] +[source,c] ---- int weechat_upgrade_read (struct t_upgrade_file *upgrade_file); ---- @@ -18310,7 +18310,7 @@ Valeur de retour : Exemple en C : -[source,C] +[source,c] ---- weechat_upgrade_read (upgrade_file); ---- @@ -18332,7 +18332,7 @@ Fermer un fichier de mise à jour. Prototype : -[source,C] +[source,c] ---- void weechat_upgrade_close (struct t_upgrade_file *upgrade_file); ---- @@ -18343,7 +18343,7 @@ Paramètres : Exemple en C : -[source,C] +[source,c] ---- weechat_upgrade_close (upgrade_file); ---- diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc index 499ea42d6..2d4c12a3f 100644 --- a/doc/fr/weechat_user.fr.adoc +++ b/doc/fr/weechat_user.fr.adoc @@ -3982,7 +3982,7 @@ poignée de main et si l'origine est autorisée (voir l'option Un WebSocket peut être ouvert dans une page HTML5 avec une seule ligne de JavaScript : -[source,js] +[source,javascript] ---- websocket = new WebSocket("ws://server.com:9000/weechat"); ---- diff --git a/doc/it/weechat_plugin_api.it.adoc b/doc/it/weechat_plugin_api.it.adoc index 8e4192785..1af3cb288 100644 --- a/doc/it/weechat_plugin_api.it.adoc +++ b/doc/it/weechat_plugin_api.it.adoc @@ -54,7 +54,7 @@ In order to call WeeChat functions in the format displayed in <<plugin_api>>, the following global pointer must be declared and initialized in the function <<_weechat_plugin_init,weechat_plugin_init>>: -[source,C] +[source,c] ---- struct t_weechat_plugin *weechat_plugin; ---- @@ -95,7 +95,7 @@ da WeeChat. Prototipo: -[source,C] +[source,c] ---- int weechat_plugin_init (struct t_weechat_plugin *plugin, int argc, char *argv[]); @@ -166,7 +166,7 @@ scaricato da WeeChat. Prototipo: -[source,C] +[source,c] ---- int weechat_plugin_end (struct t_weechat_plugin *plugin); ---- @@ -213,7 +213,7 @@ Un esempio completo di plugin, che aggiunge un comando `/double`: visualizza due volte gli argomenti nel buffer corrente, oppure esegue un comando due volte (ok, non sarà molto utile, ma è solo un esempio!): -[source,C] +[source,c] ---- #include <stdlib.h> @@ -329,7 +329,7 @@ Ottiene il nome del plugin. Prototipo: -[source,C] +[source,c] ---- const char *weechat_plugin_get_name (struct t_weechat_plugin *plugin); ---- @@ -345,7 +345,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- const char *name = weechat_plugin_get_name (plugin); ---- @@ -377,7 +377,7 @@ funzione). Prototipo: -[source,C] +[source,c] ---- void weechat_charset_set (const char *charset); ---- @@ -388,7 +388,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_charset_set ("iso-8859-1"); ---- @@ -411,7 +411,7 @@ WeeChat (UTF-8). Prototipo: -[source,C] +[source,c] ---- char *weechat_iconv_to_internal (const char *charset, const char *string); ---- @@ -428,7 +428,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *str = weechat_iconv_to_internal ("iso-8859-1", "iso string: é à"); /* ... */ @@ -453,7 +453,7 @@ in un'altra. Prototipo: -[source,C] +[source,c] ---- char *weechat_iconv_from_internal (const char *charset, const char *string); ---- @@ -470,7 +470,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *str = weechat_iconv_from_internal ("iso-8859-1", "utf-8 string: é à"); /* ... */ @@ -494,7 +494,7 @@ Restituisce la stringa tradotta (dipende dalla lingua). Prototipo: -[source,C] +[source,c] ---- const char *weechat_gettext (const char *string); ---- @@ -510,7 +510,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *str = weechat_gettext ("hello"); ---- @@ -533,7 +533,7 @@ all'argomento _count_ (contatore). Prototipo: -[source,C] +[source,c] ---- const char *weechat_ngettext (const char *string, const char *plural, int count); @@ -554,7 +554,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *str = weechat_ngettext ("file", "files", num_files); ---- @@ -578,7 +578,7 @@ impostato su _chars_. Prototipo: -[source,C] +[source,c] ---- char *weechat_strndup (const char *string, int length); ---- @@ -595,7 +595,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *str = weechat_strndup ("abcdef", 3); /* result: "abc" */ /* ... */ @@ -615,7 +615,7 @@ string if it is cut. Prototipo: -[source,C] +[source,c] ---- char *weechat_string_cut (const char *string, int length, int count_suffix, int screen, const char *cut_suffix); ---- @@ -634,7 +634,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *str = weechat_string_cut ("this is a test", 5, 1, 1, "…"); /* result: "this…" */ /* ... */ @@ -650,7 +650,7 @@ Converte una stringa UTF-8 in minuscolo. Prototipo: -[source,C] +[source,c] ---- void weechat_string_tolower (char *string); ---- @@ -661,7 +661,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- char str[] = "AbCdé"; weechat_string_tolower (str); /* str ora è: "abcdé" */ @@ -676,7 +676,7 @@ Converte una stringa UTF-8 in maiuscolo. Prototipo: -[source,C] +[source,c] ---- void weechat_string_toupper (char *string); ---- @@ -687,7 +687,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- char str[] = "AbCdé"; weechat_string_toupper (str); /* str ora è: "ABCDé" */ @@ -705,7 +705,7 @@ Confronta stringa non sensibile alle maiuscole e alla localizzazione. Prototipo: -[source,C] +[source,c] ---- int weechat_strcasecmp (const char *string1, const char *string2); ---- @@ -723,7 +723,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int diff = weechat_strcasecmp ("aaa", "CCC"); /* == -2 */ ---- @@ -741,7 +741,7 @@ serie per il confronto. Prototipo: -[source,C] +[source,c] ---- int weechat_strcasecmp_range (const char *string1, const char *string2, int range); ---- @@ -766,7 +766,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int diff = weechat_strcasecmp_range ("nick{away}", "NICK[away]", 29); /* == 0 */ ---- @@ -784,7 +784,7 @@ localizzazione, per un numero _max_ di caratteri. Prototipo: -[source,C] +[source,c] ---- int weechat_strncasecmp (const char *string1, const char *string2, int max); ---- @@ -803,7 +803,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int diff = weechat_strncasecmp ("aabb", "aacc", 2); /* == 0 */ ---- @@ -821,7 +821,7 @@ numero _max_ di caratteri, usando una serie per il confronto. Prototipo: -[source,C] +[source,c] ---- int weechat_strncasecmp_range (const char *string1, const char *string2, int max, int range); ---- @@ -847,7 +847,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int diff = weechat_strncasecmp_range ("nick{away}", "NICK[away]", 6, 29); /* == 0 */ ---- @@ -865,7 +865,7 @@ maiuscole), ignorando alcuni caratteri. Prototipo: -[source,C] +[source,c] ---- int weechat_strcmp_ignore_chars (const char *string1, const char *string2, const char *chars_ignored, @@ -887,7 +887,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int diff = weechat_strcmp_ignore_chars ("a-b", "--a-e", "-", 1); /* == -3 */ ---- @@ -905,7 +905,7 @@ localizzazione. Prototipo: -[source,C] +[source,c] ---- const char *weechat_strcasestr (const char *string, const char *search); ---- @@ -923,7 +923,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- const char *pos = weechat_strcasestr ("aBcDeF", "de"); /* risultato: puntatore a "DeF" */ ---- @@ -943,7 +943,7 @@ Non-printable chars have a width of 1 (this is the difference with the function Prototipo: -[source,C] +[source,c] ---- int weechat_strlen_screen (const char *string); ---- @@ -959,7 +959,7 @@ su schermo Esempio in C: -[source,C] +[source,c] ---- int length_on_screen = weechat_strlen_screen ("é"); /* == 1 */ ---- @@ -984,7 +984,7 @@ Verifica se una stringa coincide ad una mask. Prototipo: -[source,C] +[source,c] ---- int weechat_string_match (const char *string, const char *mask, int case_sensitive); @@ -1009,7 +1009,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int match1 = weechat_string_match ("abcdef", "abc*", 0); /* == 1 */ int match2 = weechat_string_match ("abcdef", "*dd*", 0); /* == 0 */ @@ -1044,7 +1044,7 @@ mask. Prototipo: -[source,C] +[source,c] ---- int weechat_string_match_list (const char *string, const char **masks, int case_sensitive); @@ -1066,7 +1066,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- const char *masks[3] = { "*", "!abc*", NULL }; int match1 = weechat_string_match_list ("abc", masks, 0); /* == 0 */ @@ -1096,7 +1096,7 @@ non inizia con `+~+`, viene restituita la stessa stringa. Prototipo: -[source,C] +[source,c] ---- char *weechat_string_expand_home (const char *path); ---- @@ -1112,7 +1112,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *str = weechat_string_expand_home ("~/file.txt"); /* result: "/home/user/file.txt" */ @@ -1137,7 +1137,7 @@ Evaluate a path in 3 steps: Prototipo: -[source,C] +[source,c] ---- char *weechat_string_eval_path_home (const char *path, struct t_hashtable *pointers, @@ -1169,7 +1169,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *str = weechat_string_eval_path_home ("${weechat_config_dir}/test.conf", NULL, NULL, NULL); /* result: "/home/user/.config/weechat/test.conf" */ @@ -1196,7 +1196,7 @@ spazi se presenti prima delle prime virgolette o dopo le ultime virgolette). Prototipo: -[source,C] +[source,c] ---- char *weechat_string_remove_quotes (const char *string, const char *quotes); ---- @@ -1213,7 +1213,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *str = weechat_string_remove_quotes (string, " 'Non posso' ", "'"); /* risultato: "Non posso" */ @@ -1230,7 +1230,7 @@ Rimuove i caratteri ad inizio/fine della stringa. Prototipo: -[source,C] +[source,c] ---- char *weechat_string_strip (const char *string, int left, int right, const char *chars); @@ -1249,7 +1249,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *str = weechat_string_strip (".abc -", 0, 1, "- ."); /* risultato: ".abc" */ /* ... */ @@ -1283,7 +1283,7 @@ Convert escaped chars to their value: Prototipo: -[source,C] +[source,c] ---- char *weechat_string_convert_escaped_chars (const char *string); ---- @@ -1300,7 +1300,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *str = weechat_string_convert_escaped_chars ("snowman: \\u2603"); /* str == "snowman: ☃" */ @@ -1319,7 +1319,7 @@ non vengono riconosciuti. Prototipo: -[source,C] +[source,c] ---- char *weechat_string_mask_to_regex (const char *mask); ---- @@ -1335,7 +1335,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *str_regex = weechat_string_mask_to_regex ("test*mask"); /* result: "test.*mask" */ @@ -1363,7 +1363,7 @@ per compilare l'espressione regolare. Prototipo: -[source,C] +[source,c] ---- const char *weechat_string_regex_flags (const char *regex, int default_flags, int *flags) ---- @@ -1401,7 +1401,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- const char *regex = "(?i)test"; int flags; @@ -1423,7 +1423,7 @@ of string (for format of flags, see Prototipo: -[source,C] +[source,c] ---- int weechat_string_regcomp (void *preg, const char *regex, int default_flags) ---- @@ -1452,7 +1452,7 @@ if the function returned 0 (OK). Esempio in C: -[source,C] +[source,c] ---- regex_t my_regex; if (weechat_string_regcomp (&my_regex, "(?i)test", REG_EXTENDED) == 0) @@ -1478,7 +1478,7 @@ gli eventi. Prototipo: -[source,C] +[source,c] ---- int weechat_string_has_highlight (const char *string, const char highlight_words); @@ -1495,7 +1495,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int hl = weechat_string_has_highlight ("my test string", "test,word2"); /* == 1 */ ---- @@ -1523,7 +1523,7 @@ by delimiters (chars different from: alphanumeric, `+-+`, `+_+` and `+|+`). Prototipo: -[source,C] +[source,c] ---- int weechat_string_has_highlight_regex (const char *string, const char *regex); ---- @@ -1540,7 +1540,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int hl = weechat_string_has_highlight_regex ("my test string", "test|word2"); /* == 1 */ ---- @@ -1562,7 +1562,7 @@ Sostituisce tutte le ricorrenze di una stringa con un'altra. Prototipo: -[source,C] +[source,c] ---- char *weechat_string_replace (const char *string, const char *search, const char *replace); @@ -1581,7 +1581,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *str = weechat_string_replace ("test", "s", "x"); /* result: "text" */ /* ... */ @@ -1601,7 +1601,7 @@ optional callback. Prototipo: -[source,C] +[source,c] ---- char *weechat_string_replace_regex (const char *string, void *regex, const char *replace, const char reference_char, @@ -1640,7 +1640,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- regex_t my_regex; char *string; @@ -1668,7 +1668,7 @@ Divide una stringa in base a uno o più delimitatori. Prototipo: -[source,C] +[source,c] ---- char **weechat_string_split (const char *string, const char *separators, const char *strip_items, int flags, @@ -1715,7 +1715,7 @@ Valore restituito: Esempi: -[source,C] +[source,c] ---- char **argv; int argc; @@ -1801,7 +1801,7 @@ Python repository), see: https://docs.python.org/3/library/shlex.html. Prototipo: -[source,C] +[source,c] ---- char **weechat_string_split_shell (const char *string, int *num_items); ---- @@ -1818,7 +1818,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char **argv; int argc; @@ -1841,7 +1841,7 @@ Libera la memoria usata per la divisione di una stringa. Prototipo: -[source,C] +[source,c] ---- void weechat_string_free_split (char **split_string); ---- @@ -1852,7 +1852,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- char *argv; int argc; @@ -1870,7 +1870,7 @@ Compila una stringa con una stringa divisa. Prototipo: -[source,C] +[source,c] ---- char *weechat_string_build_with_split_string (char **split_string, const char *separator); @@ -1888,7 +1888,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char **argv; int argc; @@ -1909,7 +1909,7 @@ omesso aggiungendo `+\+` nella stringa). Prototipo: -[source,C] +[source,c] ---- char **weechat_string_split_command (const char *command, char separator); ---- @@ -1926,7 +1926,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char **argv = weechat_string_split_command ("/command1 arg;/command2", ';'); /* result: argv[0] == "/command1 arg" @@ -1945,7 +1945,7 @@ Libera la memoria utilizzata dalla divisione di un comando. Prototipo: -[source,C] +[source,c] ---- void weechat_string_free_split_command (char **split_command); ---- @@ -1956,7 +1956,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- char **argv = weechat_string_split_command ("/command1 arg;/command2", ';'); /* ... */ @@ -1973,7 +1973,7 @@ tradotta nella lingua locale. Prototipo: -[source,C] +[source,c] ---- char *weechat_string_format_size (unsigned long long size); ---- @@ -1988,7 +1988,7 @@ Valore restituito: Esempi in C: -[source,C] +[source,c] ---- /* esempi in lingua inglese */ @@ -2034,7 +2034,7 @@ the string. Prototipo: -[source,C] +[source,c] ---- int weechat_string_color_code_size (const char *string); ---- @@ -2053,7 +2053,7 @@ Valore restituito: Esempi: -[source,C] +[source,c] ---- int size; @@ -2081,7 +2081,7 @@ Rimuove i colori di WeeChat da una stringa. Prototipo: -[source,C] +[source,c] ---- char *weechat_string_remove_color (const char *string, const char *replacement); @@ -2101,7 +2101,7 @@ Valore restituito: Esempi: -[source,C] +[source,c] ---- /* rimuove i codici colore */ char *str = weechat_string_remove_color (my_string1, NULL); @@ -2134,7 +2134,7 @@ Encode a string in base 16, 32, or 64. Prototipo: -[source,C] +[source,c] ---- int weechat_string_base_encode (int base, const char *from, int length, char *to); ---- @@ -2156,7 +2156,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *string = "abcdefgh", result[128]; int length; @@ -2180,7 +2180,7 @@ Decode a string encoded in base 16, 32, or 64. Prototipo: -[source,C] +[source,c] ---- int weechat_string_base_decode (int base, const char *from, char *to); ---- @@ -2201,7 +2201,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char result[128]; int length; @@ -2225,7 +2225,7 @@ Display a dump of data as hexadecimal and ascii bytes. Prototipo: -[source,C] +[source,c] ---- char *string_hex_dump (const char *data, int data_size, int bytes_per_line, const char *prefix, const char *suffix); @@ -2249,7 +2249,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *string = "abc def-ghi"; char *dump = weechat_string_hex_dump (string, strlen (string), 8, " >> ", NULL); @@ -2269,7 +2269,7 @@ Verifica che il primo carattere della stringa sia un carattere comando Prototipo: -[source,C] +[source,c] ---- int weechat_string_is_command_char (const char *string); ---- @@ -2285,7 +2285,7 @@ Valore restituito: Esempi in C: -[source,C] +[source,c] ---- int command_char1 = weechat_string_is_command_char ("/test"); /* == 1 */ int command_char2 = weechat_string_is_command_char ("test"); /* == 0 */ @@ -2312,7 +2312,7 @@ dell'argomento "string"), oppure NULL se è un comando. Prototipo: -[source,C] +[source,c] ---- const char *weechat_string_input_for_buffer (const char *string); ---- @@ -2327,7 +2327,7 @@ Valore restituito: Esempi in C: -[source,C] +[source,c] ---- const char *str1 = weechat_string_input_for_buffer ("test"); /* "test" */ const char *str2 = weechat_string_input_for_buffer ("/test"); /* NULL */ @@ -2362,7 +2362,7 @@ Since version 1.0, nested variables are supported, for example: Prototipo: -[source,C] +[source,c] ---- char *weechat_string_eval_expression (const char *expr, struct t_hashtable *pointers, @@ -2411,7 +2411,7 @@ Valore restituito: Esempi in C: -[source,C] +[source,c] ---- /* conditions */ struct t_hashtable *options1 = weechat_hashtable_new (8, @@ -3020,7 +3020,7 @@ _pass:[string_dyn_*]_ functions. Prototipo: -[source,C] +[source,c] ---- char **weechat_string_dyn_alloc (int size_alloc); ---- @@ -3037,7 +3037,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); ---- @@ -3058,7 +3058,7 @@ not enough space to copy the string). Prototipo: -[source,C] +[source,c] ---- int weechat_string_dyn_copy (char **string, const char *new_string); ---- @@ -3076,7 +3076,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); if (weechat_string_dyn_copy (string, "test")) @@ -3106,7 +3106,7 @@ not enough space to concatenate the string). Prototipo: -[source,C] +[source,c] ---- int weechat_string_dyn_concat (char **string, const char *add, int bytes); ---- @@ -3127,7 +3127,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); if (weechat_string_dyn_copy (string, "test")) @@ -3151,7 +3151,7 @@ Free a dynamic string. Prototipo: -[source,C] +[source,c] ---- char *weechat_string_dyn_free (char **string, int free_string); ---- @@ -3170,7 +3170,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); if (weechat_string_dyn_concat (string, "test")) @@ -3199,7 +3199,7 @@ Verifica che una stringa abbia caratteri a 8-bit. Prototipo: -[source,C] +[source,c] ---- int weechat_utf8_has_8bits (const char *string); ---- @@ -3214,7 +3214,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (weechat_utf8_has_8bits (string)) { @@ -3234,7 +3234,7 @@ Verifica che una stringa sia valida in UTF-8. Prototipo: -[source,C] +[source,c] ---- int weechat_utf8_is_valid (const char *string, int length, char **error); ---- @@ -3254,7 +3254,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *error; if (weechat_utf8_is_valid (string, -1, &error)) @@ -3277,7 +3277,7 @@ un carattere. Prototipo: -[source,C] +[source,c] ---- void weechat_utf8_normalize (char *string, char replacement); ---- @@ -3289,7 +3289,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_utf8_normalize (string, '?'); ---- @@ -3306,7 +3306,7 @@ Restituisce il puntatore al carattere UTF-8 precedente in una stringa. Prototipo: -[source,C] +[source,c] ---- const char *weechat_utf8_prev_char (const char *string_start, const char *string); @@ -3327,7 +3327,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- const char *prev_char = weechat_utf8_prev_char (string, ptr_in_string); ---- @@ -3344,7 +3344,7 @@ Restituisce il puntatore al successivo carattere UTF-8 in una stringa. Prototipo: -[source,C] +[source,c] ---- const char *weechat_utf8_next_char (const char *string); ---- @@ -3362,7 +3362,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- const char *next_char = weechat_utf8_next_char (string); ---- @@ -3376,7 +3376,7 @@ Restituisce un carattere UTF-8 come intero. Prototipo: -[source,C] +[source,c] ---- int weechat_utf8_char_int (const char *string); ---- @@ -3391,7 +3391,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int char_int = weechat_utf8_char_int ("être"); /* "ê" come intero */ ---- @@ -3405,7 +3405,7 @@ Restituisce la dimensione di un carattere UTF-8 (in byte). Prototipo: -[source,C] +[source,c] ---- int weechat_utf8_char_size (const char *string); ---- @@ -3420,7 +3420,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int char_size = weechat_utf8_char_size ("être"); /* == 2 */ ---- @@ -3434,7 +3434,7 @@ Restituisce la lunghezza della stringa UTF-8 (nei caratteri UTF-8). Prototipo: -[source,C] +[source,c] ---- int weechat_utf8_strlen (const char *string); ---- @@ -3449,7 +3449,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int length = weechat_utf8_strlen ("chêne"); /* == 5 */ ---- @@ -3464,7 +3464,7 @@ un massimo di _bytes_ nella stringa. Prototipo: -[source,C] +[source,c] ---- int weechat_utf8_strnlen (const char *string, int bytes); ---- @@ -3480,7 +3480,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int length = weechat_utf8_strnlen ("chêne", 4); /* == 3 */ ---- @@ -3495,7 +3495,7 @@ UTF-8 su schermo. Prototipo: -[source,C] +[source,c] ---- int weechat_utf8_strlen_screen (const char *string); ---- @@ -3511,7 +3511,7 @@ su schermo Esempio in C: -[source,C] +[source,c] ---- int length_on_screen = weechat_utf8_strlen_screen ("é"); /* == 1 */ ---- @@ -3528,7 +3528,7 @@ Confronta due caratteri UTF-8. Prototipo: -[source,C] +[source,c] ---- int weechat_utf8_charcmp (const char *string1, const char *string2); ---- @@ -3546,7 +3546,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int diff = weechat_utf8_charcmp ("aaa", "ccc"); /* == -2 */ ---- @@ -3563,7 +3563,7 @@ Confronta due caratteri UTF-8, ignorando la sensibilità alle maiuscole. Prototipo: -[source,C] +[source,c] ---- int weechat_utf8_charcasecmp (const char *string1, const char *string2); ---- @@ -3581,7 +3581,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int diff = weechat_utf8_charcasecmp ("aaa", "CCC"); /* == -2 */ ---- @@ -3596,7 +3596,7 @@ carattere UTF-8 sullo schermo. Prototipo: -[source,C] +[source,c] ---- int weechat_utf8_char_size_screen (const char *string); ---- @@ -3612,7 +3612,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int length_on_screen = weechat_utf8_char_size_screen ("é"); /* == 1 */ ---- @@ -3629,7 +3629,7 @@ Si sposta in avanti di N caratteri in una stringa UTF-8. Prototipo: -[source,C] +[source,c] ---- const char *weechat_utf8_add_offset (const char *string, int offset); ---- @@ -3647,7 +3647,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- const char *str = "chêne"; const char *str2 = weechat_utf8_add_offset (str, 3); /* points to "ne" */ @@ -3662,7 +3662,7 @@ Restituisce la posizione reale nella stringa UTF-8. Prototipo: -[source,C] +[source,c] ---- int weechat_utf8_real_pos (const char *string, int pos); ---- @@ -3678,7 +3678,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int pos = weechat_utf8_real_pos ("chêne", 3); /* == 4 */ ---- @@ -3692,7 +3692,7 @@ Restituisce la posizione nella stringa UTF-8. Prototipo: -[source,C] +[source,c] ---- int weechat_utf8_pos (const char *string, int real_pos); ---- @@ -3708,7 +3708,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int pos = weechat_utf8_pos ("chêne", 4); /* == 3 */ ---- @@ -3722,7 +3722,7 @@ Restituisce la stringa duplicata, di lunghezza massima _length_. Prototipo: -[source,C] +[source,c] ---- char *weechat_utf8_strndup (const char *string, int length); ---- @@ -3738,7 +3738,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *string = weechat_utf8_strndup ("chêne", 3); /* restituisce "chê" */ /* ... */ @@ -3763,7 +3763,7 @@ Compute hash of data. Prototipo: -[source,C] +[source,c] ---- int weechat_crypto_hash (const void *data, int data_size, const char *hash_algo, void *hash, int *hash_size); @@ -3804,7 +3804,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- const char *data = "abcdefghijklmnopqrstuvwxyz"; char hash[256 / 8]; @@ -3827,7 +3827,7 @@ of data. Prototipo: -[source,C] +[source,c] ---- int weechat_crypto_hash_pbkdf2 (const void *data, int data_size, const char *hash_algo, @@ -3857,7 +3857,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- const char *data = "abcdefghijklmnopqrstuvwxyz"; const char *salt = "12345678901234567890123456789012"; /* 32 bytes */ @@ -3886,7 +3886,7 @@ Compute keyed-hash message authentication code (HMAC). Prototipo: -[source,C] +[source,c] ---- int weechat_crypto_hmac (const void *key, int key_size, const void *message, int message_size, int hash_algo, void *hash, int *hash_size); @@ -3912,7 +3912,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- const char *key = "the key"; const char *message = "the message"; @@ -3935,7 +3935,7 @@ Crea una cartella nella home di WeeChat. Prototipo: -[source,C] +[source,c] ---- int weechat_mkdir_home (char *directory, int mode); ---- @@ -3957,7 +3957,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (!weechat_mkdir_home ("${weechat_cache_dir}/temp", 0755)) { @@ -3982,7 +3982,7 @@ Crea una cartella. Prototipo: -[source,C] +[source,c] ---- int weechat_mkdir (char *directory, int mode); ---- @@ -3998,7 +3998,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (!weechat_mkdir ("/tmp/mydir", 0755)) { @@ -4023,7 +4023,7 @@ Crea una cartella e le cartelle genitore se necessario. Prototipo: -[source,C] +[source,c] ---- int weechat_mkdir_parents (char *directory, int mode); ---- @@ -4039,7 +4039,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (!weechat_mkdir_parents ("/tmp/my/dir", 0755)) { @@ -4067,7 +4067,7 @@ Cerca i file in una cartella ed esegue una callback su ogni file. Prototipo: -[source,C] +[source,c] ---- void weechat_exec_on_files (const char *directory, int recurse_subdirs, @@ -4090,7 +4090,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- void callback (void *data, const char *filename) { @@ -4111,7 +4111,7 @@ Ottiene il contenuto del file di testo in una stringa. Prototipo: -[source,C] +[source,c] ---- char *weechat_file_get_content (const char *filename); ---- @@ -4127,7 +4127,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *content; @@ -4148,7 +4148,7 @@ Copy a file to another location. Prototipo: -[source,C] +[source,c] ---- int weechat_file_copy (const char *from, const char *to); ---- @@ -4164,7 +4164,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (weechat_file_copy ("/tmp/test.txt", "/path/to/test2.txt")) { @@ -4186,7 +4186,7 @@ Confronta due strutture "timeval". Prototipo: -[source,C] +[source,c] ---- int weechat_util_timeval_cmp (struct timeval *tv1, struct timeval *tv2); ---- @@ -4204,7 +4204,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (weechat_util_timeval_cmp (&tv1, &tv2) > 0) { @@ -4225,7 +4225,7 @@ Return difference (in microseconds) between two "timeval" structures. Prototipo: -[source,C] +[source,c] ---- long long weechat_util_timeval_diff (struct timeval *tv1, struct timeval *tv2); ---- @@ -4246,7 +4246,7 @@ With WeeChat ≤ 1.0, the returned value was in milliseconds. Esempio in C: -[source,C] +[source,c] ---- long long diff = weechat_util_timeval_diff (&tv1, &tv2); ---- @@ -4264,7 +4264,7 @@ Add interval (in microseconds) to a timeval structure. Prototipo: -[source,C] +[source,c] ---- void weechat_util_timeval_add (struct timeval *tv, long long interval); ---- @@ -4281,7 +4281,7 @@ With WeeChat ≤ 1.0, the interval was expressed in milliseconds. Esempio in C: -[source,C] +[source,c] ---- weechat_util_timeval_add (&tv, 2000000); /* aggiunge 2 secondi */ ---- @@ -4300,7 +4300,7 @@ option _weechat.look.time_format_. Prototipo: -[source,C] +[source,c] ---- const char *weechat_util_get_time_string (const time_t *date); ---- @@ -4316,7 +4316,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- time_t date = time (NULL); weechat_printf (NULL, "date: %s", @@ -4335,7 +4335,7 @@ Convert a string with WeeChat version to a number. Prototipo: -[source,C] +[source,c] ---- int weechat_util_version_number (const char *version); ---- @@ -4347,7 +4347,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- version_number = weechat_util_version_number ("0.3.8"); /* == 0x00030800 */ version_number = weechat_util_version_number ("0.3.9-dev"); /* == 0x00030900 */ @@ -4369,7 +4369,7 @@ Crea una nuova lista. Prototipo: -[source,C] +[source,c] ---- struct t_weelist *weechat_list_new (); ---- @@ -4380,7 +4380,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_weelist *list = weechat_list_new (); ---- @@ -4402,7 +4402,7 @@ Aggiunge un elemento in una lista. Prototipo: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_add (struct t_weelist *weelist, const char *data, @@ -4426,7 +4426,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_weelist_item *my_item = weechat_list_add (list, "my data", WEECHAT_LIST_POS_SORT, NULL); @@ -4449,7 +4449,7 @@ Cerca un elemento nella lista. Prototipo: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_search (struct t_weelist *weelist, const char *data); @@ -4466,7 +4466,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_weelist_item *item = weechat_list_search (list, "my data"); ---- @@ -4490,7 +4490,7 @@ Cerca la posizione di un elemento nella lista. Prototipo: -[source,C] +[source,c] ---- int weechat_list_search_pos (struct t_weelist *weelist, const char *data); @@ -4507,7 +4507,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int pos_item = weechat_list_search_pos (list, "my data"); ---- @@ -4530,7 +4530,7 @@ esatta. Prototipo: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_casesearch (struct t_weelist *weelist, const char *data); @@ -4547,7 +4547,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_weelist_item *item = weechat_list_casesearch (list, "my data"); ---- @@ -4571,7 +4571,7 @@ Cerca la posizione di un elemento in una lista, ricerca normale. Prototipo: -[source,C] +[source,c] ---- int weechat_list_casesearch_pos (struct t_weelist *weelist, const char *data); @@ -4588,7 +4588,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int pos_item = weechat_list_casesearch_pos (list, "my data"); ---- @@ -4610,7 +4610,7 @@ Restituisce un elemento in una lista in base alla sua posizione. Prototipo: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_get (struct t_weelist *weelist, int position); @@ -4627,7 +4627,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_weelist_item *item = weechat_list_get (list, 0); /* primo elemento */ ---- @@ -4649,7 +4649,7 @@ Imposta un nuovo valore per un elemento. Prototipo: -[source,C] +[source,c] ---- void weechat_list_set (struct t_weelist_item *item, const char *value); ---- @@ -4661,7 +4661,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_list_set (item, "nuovi dati"); ---- @@ -4683,7 +4683,7 @@ Restituisce l'elemento successivo nella lista. Prototipo: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_next (struct t_weelist_item *item); ---- @@ -4699,7 +4699,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_weelist_item *next_item = weechat_list_next (item); ---- @@ -4721,7 +4721,7 @@ Restituisce l'elemento precedente nella lista. Prototipo: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_prev (struct t_weelist_item *item); ---- @@ -4737,7 +4737,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_weelist_item *prev_item = weechat_list_prev (item); ---- @@ -4759,7 +4759,7 @@ Restituisce il valore stringa di un elemento. Prototipo: -[source,C] +[source,c] ---- const char *weechat_list_string (struct t_weelist_item *item); ---- @@ -4774,7 +4774,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "valore dell'elemento: %s", weechat_list_string (item)); ---- @@ -4799,7 +4799,7 @@ Return pointer to the user data of an item. Prototipo: -[source,C] +[source,c] ---- void *weechat_list_user_data (struct t_weelist_item *item); ---- @@ -4815,7 +4815,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "user data of item: 0x%lx", weechat_list_user_data (item)); ---- @@ -4829,7 +4829,7 @@ Restituisce la dimensione della lista (numero di elementi). Prototipo: -[source,C] +[source,c] ---- char *weechat_list_size (struct t_weelist *weelist); ---- @@ -4845,7 +4845,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "dimensione della lista: %d", weechat_list_size (list)); ---- @@ -4867,7 +4867,7 @@ Rimuove un elemento in una lista. Prototipo: -[source,C] +[source,c] ---- void weechat_list_remove (struct t_weelist *weelist, struct t_weelist_item *item); @@ -4880,7 +4880,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_list_remove (list, item); ---- @@ -4902,7 +4902,7 @@ Rimuove tutti gli elementi in una lista. Prototipo: -[source,C] +[source,c] ---- void weechat_list_remove_all (struct t_weelist *weelist); ---- @@ -4913,7 +4913,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_list_remove_all (list); ---- @@ -4935,7 +4935,7 @@ Libera una lista. Prototipo: -[source,C] +[source,c] ---- void weechat_list_free (struct t_weelist *weelist); ---- @@ -4946,7 +4946,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_list_free (list); ---- @@ -4979,7 +4979,7 @@ Create a new array list. Prototipo: -[source,C] +[source,c] ---- struct t_arraylist *weechat_arraylist_new (int initial_size, int sorted, @@ -5026,7 +5026,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int cmp_cb (void *data, struct t_arraylist *arraylist, @@ -5056,7 +5056,7 @@ Return size of array list (number of item pointers). Prototipo: -[source,C] +[source,c] ---- int weechat_list_size (struct t_arraylist *arraylist); ---- @@ -5073,7 +5073,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "size of array list: %d", weechat_arraylist_size (arraylist)); ---- @@ -5090,7 +5090,7 @@ Return an item pointer by position. Prototipo: -[source,C] +[source,c] ---- void *weechat_arraylist_get (struct t_arraylist *arraylist, int index); ---- @@ -5108,7 +5108,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- void *pointer = weechat_arraylist_get (arraylist, 0); /* first item */ ---- @@ -5125,7 +5125,7 @@ Search an item in an array list. Prototipo: -[source,C] +[source,c] ---- void *weechat_arraylist_search (struct t_arraylist *arraylist, void *pointer, int *index, int *index_insert); @@ -5148,7 +5148,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int index, index_insert; void *item = weechat_arraylist_search (arraylist, pointer, &index, &index_insert); @@ -5166,7 +5166,7 @@ Insert an item in an array list. Prototipo: -[source,C] +[source,c] ---- int weechat_arraylist_insert (struct t_arraylist *arraylist, int index, void *pointer); ---- @@ -5187,7 +5187,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int index = weechat_arraylist_insert (arraylist, -1, pointer); /* insert at the end if not sorted */ ---- @@ -5204,7 +5204,7 @@ Add an item in an array list. Prototipo: -[source,C] +[source,c] ---- int weechat_arraylist_add (struct t_arraylist *arraylist, void *pointer); ---- @@ -5222,7 +5222,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int index = weechat_arraylist_add (arraylist, pointer); ---- @@ -5239,7 +5239,7 @@ Remove an item from an array list. Prototipo: -[source,C] +[source,c] ---- int weechat_arraylist_remove (struct t_arraylist *arraylist, int index); ---- @@ -5257,7 +5257,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int index_removed = weechat_arraylist_remove (arraylist, index); ---- @@ -5274,7 +5274,7 @@ Remove all items from an array list. Prototipo: -[source,C] +[source,c] ---- int weechat_arraylist_clear (struct t_arraylist *arraylist); ---- @@ -5291,7 +5291,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (weechat_arraylist_clear (arraylist)) { @@ -5311,7 +5311,7 @@ Free an array list. Prototipo: -[source,C] +[source,c] ---- void weechat_arraylist_free (struct t_arraylist *arraylist); ---- @@ -5323,7 +5323,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_arraylist_free (arraylist); ---- @@ -5344,7 +5344,7 @@ Crea una nuova tabella hash. Prototipo: -[source,C] +[source,c] ---- struct t_hashtable *weechat_hashtable_new (int size, const char *type_keys, @@ -5398,7 +5398,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hashtable *hashtable = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, @@ -5420,7 +5420,7 @@ chiave ed il valore. Prototipo: -[source,C] +[source,c] ---- struct t_hashtable_item *weechat_hashtable_set_with_size (struct t_hashtable *hashtable, const void *key, int key_size, @@ -5444,7 +5444,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_hashtable_set_with_size (hashtable, "my_key", 0, my_buffer, sizeof (my_buffer_struct)); @@ -5462,7 +5462,7 @@ Aggiunge o aggiorna un elemento nella tabella hash. Prototipo: -[source,C] +[source,c] ---- struct t_hashtable_item *weechat_hashtable_set (struct t_hashtable *hashtable, const void *key, const void *value); @@ -5481,7 +5481,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_hashtable_set (hashtable, "my_key", "my_value"); ---- @@ -5494,7 +5494,7 @@ Ottiene il valore associato ad una chiave in una tabella hash. Prototipo: -[source,C] +[source,c] ---- void *weechat_hashtable_get (struct t_hashtable *hashtable, void *key); ---- @@ -5510,7 +5510,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- void *value = weechat_hashtable_get (hashtable, "my_key"); ---- @@ -5527,7 +5527,7 @@ Check if a key is in the hashtable. Prototipo: -[source,C] +[source,c] ---- int weechat_hashtable_has_key (struct t_hashtable *hashtable, void *key); ---- @@ -5543,7 +5543,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (weechat_hashtable_has_key (hashtable, "my_key")) { @@ -5565,7 +5565,7 @@ in the hashtable (from oldest to newest one). Prototipo: -[source,C] +[source,c] ---- void weechat_hashtable_map (struct t_hashtable *hashtable, void (*callback_map)(void *data, @@ -5583,7 +5583,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- void map_cb (void *data, struct t_hashtable *hashtable, @@ -5611,7 +5611,7 @@ in the hashtable (from oldest to newest one), inviando chiavi e valori come stri Prototipo: -[source,C] +[source,c] ---- void weechat_hashtable_map_string (struct t_hashtable *hashtable, void (*callback_map)(void *data, @@ -5633,7 +5633,7 @@ eliminate dopo la chiamata alla callback. Esempio in C: -[source,C] +[source,c] ---- void map_cb (void *data, struct t_hashtable *hashtable, @@ -5659,7 +5659,7 @@ Duplicate a hashtable. Prototipo: -[source,C] +[source,c] ---- struct t_hashtable *weechat_hashtable_dup (struct t_hashtable *hashtable); ---- @@ -5675,7 +5675,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hashtable *new_hashtable = weechat_hashtable_dup (hashtable); ---- @@ -5691,7 +5691,7 @@ Restituisce un valore intero per la proprietà di una tabella hash. Prototipo: -[source,C] +[source,c] ---- int weechat_hashtable_get_integer (struct t_hashtable *hashtable, void *property); @@ -5710,7 +5710,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int items_count = weechat_hashtable_get_integer (hashtable, "items_count"); ---- @@ -5726,7 +5726,7 @@ Restituisce il valore stringa della proprietà di una tabella hash. Prototipo: -[source,C] +[source,c] ---- const char *weechat_hashtable_get_string (struct t_hashtable *hashtable, const char *property); @@ -5762,7 +5762,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "keys are type: %s", weechat_hashtable_get_string (hashtable, "type_keys")); @@ -5781,7 +5781,7 @@ Imposta il valore puntatore della proprietà di una tabella hash. Prototipo: -[source,C] +[source,c] ---- void weechat_hashtable_set_pointer (struct t_hashtable *hashtable, const char *property, void *pointer); @@ -5801,7 +5801,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- void my_free_value_cb (struct t_hashtable *hashtable, const void *key, void *value) @@ -5832,7 +5832,7 @@ order in the hashtable (from oldest to newest one). Prototipo: -[source,C] +[source,c] ---- int weechat_hashtable_add_to_infolist (struct t_hashtable *hashtable, struct t_infolist_item *infolist_item, @@ -5851,7 +5851,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_hashtable_add_to_infolist (hashtable, infolist_item, "testhash"); @@ -5878,7 +5878,7 @@ Add infolist items in a hashtable. Prototipo: -[source,C] +[source,c] ---- int weechat_hashtable_add_from_infolist (struct t_hashtable *hashtable, struct t_infolist *infolist, @@ -5899,7 +5899,7 @@ Valore restituito: Esempio in C: // TRANSLATION MISSING -[source,C] +[source,c] ---- weechat_hashtable_add_from_infolist (hashtable, infolist, "testhash"); @@ -5925,7 +5925,7 @@ Rimuove un elemento in una tabella hash. Prototipo: -[source,C] +[source,c] ---- void weechat_hashtable_remove (struct t_hashtable *hashtable, const void *key); ---- @@ -5937,7 +5937,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_hashtable_remove (hashtable, "my_key"); ---- @@ -5953,7 +5953,7 @@ Rimuove tutti gli elementi in una tabella hash. Prototipo: -[source,C] +[source,c] ---- void weechat_hashtable_remove_all (struct t_hashtable *hashtable); ---- @@ -5964,7 +5964,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_hashtable_remove_all (hashtable); ---- @@ -5980,7 +5980,7 @@ Libera una tabella hash. Prototipo: -[source,C] +[source,c] ---- void weechat_hashtable_free (struct t_hashtable *hashtable); ---- @@ -5991,7 +5991,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_hashtable_free (hashtable); ---- @@ -6013,7 +6013,7 @@ Crea un nuovo file di configurazione. Prototipo: -[source,C] +[source,c] ---- struct t_config_file *weechat_config_new (const char *name, int (*callback_reload)(const void *pointer, @@ -6068,7 +6068,7 @@ opzioni (con <<_config_new_option,config_new_option>>). Esempio in C: -[source,C] +[source,c] ---- int my_config_reload_cb (const void *pointer, void *data, @@ -6108,7 +6108,7 @@ Crea una nuova sezione nel file di configurazione. Prototipo: -[source,C] +[source,c] ---- struct t_config_section *weechat_config_new_section ( struct t_config_file *config_file, @@ -6258,7 +6258,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int my_section_read_cb (const void *pointer, void *data, @@ -6397,7 +6397,7 @@ Cerca una sezione in un file di configurazione. Prototipo: -[source,C] +[source,c] ---- struct t_config_section *weechat_config_search_section ( struct t_config_file *config_file, @@ -6415,7 +6415,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_config_section *section = weechat_config_search_section (config_file, "section"); @@ -6441,7 +6441,7 @@ Crea una nuova opzione nella sezione di un file di configurazione. Prototipo: -[source,C] +[source,c] ---- struct t_config_option *weechat_config_new_option ( struct t_config_file *config_file, @@ -6540,7 +6540,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- /* booleano */ struct t_config_option *option1 = @@ -6682,7 +6682,7 @@ Cerca un'opzione nella sezione di un file di configurazione. Prototipo: -[source,C] +[source,c] ---- struct t_config_option *weechat_config_search_option ( struct t_config_file *config_file, @@ -6702,7 +6702,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_search_option (config_file, section, "option"); @@ -6725,7 +6725,7 @@ Cerca una sezione ed un'opzione in un file di configurazione o sezione. Prototipo: -[source,C] +[source,c] ---- void weechat_config_search_section_option (struct t_config_file *config_file, struct t_config_section *section, @@ -6746,7 +6746,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- struct t_config_section *ptr_section; struct t_config_option *ptr_option; @@ -6776,7 +6776,7 @@ Get file/section/option info about an option with full name. Prototipo: -[source,C] +[source,c] ---- void weechat_config_search_with_string (const char *option_name, struct t_config_file **config_file, @@ -6800,7 +6800,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- struct t_config_file *ptr_config_file; struct t_config_section *ptr_section; @@ -6831,7 +6831,7 @@ Verifica se un testo è "vero" o "falso", come valore booleano. Prototipo: -[source,C] +[source,c] ---- int weechat_config_string_to_boolean (const char *text); ---- @@ -6847,7 +6847,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (weechat_config_string_to_boolean (option_value)) { @@ -6877,7 +6877,7 @@ Resetta un'opzione al proprio valore predefinito. Prototipo: -[source,C] +[source,c] ---- int weechat_config_option_reset (struct t_config_option *option, int run_callback); @@ -6899,7 +6899,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- switch (weechat_config_option_reset (option, 1)) { @@ -6938,7 +6938,7 @@ Imposta un nuovo valore per l'opzione. Prototipo: -[source,C] +[source,c] ---- int weechat_config_option_set (struct t_config_option *option, const char *value, int run_callback); @@ -6972,7 +6972,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- switch (weechat_config_option_set (option, "new_value", 1)) { @@ -7011,7 +7011,7 @@ Imposta null (valore non definito) per un'opzione. Prototipo: -[source,C] +[source,c] ---- int weechat_config_option_set_null (struct t_config_option *option, int run_callback); @@ -7036,7 +7036,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- switch (weechat_config_option_set_null (option, 1)) { @@ -7075,7 +7075,7 @@ Rimuove/ripristina un'opzione. Prototipo: -[source,C] +[source,c] ---- int weechat_config_option_unset (struct t_config_option *option); ---- @@ -7095,7 +7095,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- switch (weechat_config_option_unset (option)) { @@ -7139,7 +7139,7 @@ Rinomina un'opzione. Prototipo: -[source,C] +[source,c] ---- void weechat_config_option_rename (struct t_config_option *option, const char *new_name); @@ -7152,7 +7152,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_config_option_rename (option, "new_name"); ---- @@ -7177,7 +7177,7 @@ Return string value of an option property. Prototipo: -[source,C] +[source,c] ---- const char *weechat_config_option_get_string (struct t_config_option *option, const char *property); @@ -7206,7 +7206,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- const char *type = weechat_config_option_get_string (option, "type"); ---- @@ -7220,7 +7220,7 @@ Restituisce un puntatore alla proprietà di un'opzione. Prototipo: -[source,C] +[source,c] ---- void *weechat_config_option_get_pointer (struct t_config_option *option, const char *property); @@ -7251,7 +7251,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char *description = weechat_config_option_get_pointer (option, "description"); ---- @@ -7265,7 +7265,7 @@ Verifica se un opzione è "null" (valore non definito). Prototipo: -[source,C] +[source,c] ---- int weechat_config_option_is_null (struct t_config_option *option); ---- @@ -7281,7 +7281,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (weechat_config_option_is_null (option)) { @@ -7311,7 +7311,7 @@ Verifica che il valore predefinito di un'opzione sia "null" (valore non definito Prototipo: -[source,C] +[source,c] ---- int weechat_config_option_default_is_null (struct t_config_option *option); ---- @@ -7327,7 +7327,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (weechat_config_option_default_is_null (option)) { @@ -7357,7 +7357,7 @@ Restituisce il valore bool di un'opzione. Prototipo: -[source,C] +[source,c] ---- int weechat_config_boolean (struct t_config_option *option); ---- @@ -7376,7 +7376,7 @@ Return value, depending on the option type: Esempio in C: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); if (weechat_config_boolean (option)) @@ -7408,7 +7408,7 @@ Restituisce il valore bool predefinito di un'opzione. Prototipo: -[source,C] +[source,c] ---- int weechat_config_boolean_default (struct t_config_option *option); ---- @@ -7427,7 +7427,7 @@ Return value, depending on the option type: Esempio in C: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); if (weechat_config_boolean_default (option)) @@ -7459,7 +7459,7 @@ Restituisce il valore intero di un'opzione. Prototipo: -[source,C] +[source,c] ---- int weechat_config_integer (struct t_config_option *option); ---- @@ -7478,7 +7478,7 @@ Return value, depending on the option type: Esempio in C: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); int value = weechat_config_integer (option); @@ -7502,7 +7502,7 @@ Restituisce il valore intero predefinito di un'opzione. Prototipo: -[source,C] +[source,c] ---- int weechat_config_integer_default (struct t_config_option *option); ---- @@ -7521,7 +7521,7 @@ Return value, depending on the option type: Esempio in C: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); int value = weechat_config_integer_default (option); @@ -7545,7 +7545,7 @@ Restituisce il valore stringa di un'opzione. Prototipo: -[source,C] +[source,c] ---- const char *weechat_config_string (struct t_config_option *option); ---- @@ -7565,7 +7565,7 @@ Return value, depending on the option type: Esempio in C: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *value = weechat_config_string (option); @@ -7589,7 +7589,7 @@ Restituisce il valore stringa predefinito di un'opzione. Prototipo: -[source,C] +[source,c] ---- const char *weechat_config_string_default (struct t_config_option *option); ---- @@ -7609,7 +7609,7 @@ Return value, depending on the option type: Esempio in C: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *value = weechat_config_string_default (option); @@ -7633,7 +7633,7 @@ Restituisce il valore colore di un'opzione. Prototipo: -[source,C] +[source,c] ---- const char *weechat_config_color (struct t_config_option *option); ---- @@ -7652,7 +7652,7 @@ Return value, depending on the option type: Esempio in C: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *color = weechat_config_color (option); @@ -7676,7 +7676,7 @@ Restituisce il valore colore predefinito di un'opzione. Prototipo: -[source,C] +[source,c] ---- const char *weechat_config_color_default (struct t_config_option *option); ---- @@ -7695,7 +7695,7 @@ Return value, depending on the option type: Esempio in C: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *color = weechat_config_color_default (option); @@ -7721,7 +7721,7 @@ o "write_default" per una sezione). Prototipo: -[source,C] +[source,c] ---- void weechat_config_write_option (struct t_config_file *config_file, struct t_config_option *option); @@ -7734,7 +7734,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- int my_section_write_cb (const void *pointer, void *data, @@ -7771,7 +7771,7 @@ sezione). Prototipo: -[source,C] +[source,c] ---- void weechat_config_write_line (struct t_config_file *config_file, const char *option_name, @@ -7787,7 +7787,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- int my_section_write_cb (const void *pointer, void *data, @@ -7823,7 +7823,7 @@ Scrive il file di configurazione su disco. Prototipo: -[source,C] +[source,c] ---- int weechat_config_write (struct t_config_file *config_file); ---- @@ -7840,7 +7840,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- switch (weechat_config_write (config_file)) { @@ -7879,7 +7879,7 @@ Legge il file di configurazione da disco. Prototipo: -[source,C] +[source,c] ---- int weechat_config_read (struct t_config_file *config_file); ---- @@ -7896,7 +7896,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- switch (weechat_config_read (config_file)) { @@ -7935,7 +7935,7 @@ Ricarica il file di configurazione da disco. Prototipo: -[source,C] +[source,c] ---- int weechat_config_reload (struct t_config_file *config_file); ---- @@ -7952,7 +7952,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- switch (weechat_config_reload (config_file)) { @@ -7991,7 +7991,7 @@ Libera un'opzione. Prototipo: -[source,C] +[source,c] ---- void weechat_config_option_free (struct t_config_option *option); ---- @@ -8002,7 +8002,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_config_option_free (option); ---- @@ -8024,7 +8024,7 @@ Libera tutte le opzioni in una sessione. Prototipo: -[source,C] +[source,c] ---- void weechat_config_section_free_options (struct t_config_section *section); ---- @@ -8035,7 +8035,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_config_section_free_options (section); ---- @@ -8057,7 +8057,7 @@ Libera una sezione. Prototipo: -[source,C] +[source,c] ---- void weechat_config_section_free (struct t_config_section *section); ---- @@ -8068,7 +8068,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_config_section_free (section); ---- @@ -8090,7 +8090,7 @@ Libera un file di configurazione. Prototipo: -[source,C] +[source,c] ---- void weechat_config_free (struct t_config_file *config_file); ---- @@ -8101,7 +8101,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_config_free (config_file); ---- @@ -8123,7 +8123,7 @@ Cerca un'opzione con il nome completo. Prototipo: -[source,C] +[source,c] ---- struct t_config_option *weechat_config_get (const char *option_name); ---- @@ -8138,7 +8138,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("weechat.look.item_time_format"); ---- @@ -8160,7 +8160,7 @@ Cerca un'opzione nei file di configurazione dei plugin (plugins.conf). Prototipo: -[source,C] +[source,c] ---- const char *weechat_config_get_plugin (const char *option_name); ---- @@ -8176,7 +8176,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- /* se il plugin corrente è "test", allora cerca il valore dell'opzione "plugins.var.test.option" nel file plugins.conf */ @@ -8201,7 +8201,7 @@ plugin (plugins.conf). Prototipo: -[source,C] +[source,c] ---- int weechat_config_is_set_plugin (const char *option_name); ---- @@ -8217,7 +8217,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (weechat_config_is_set_plugin ("option")) { @@ -8251,7 +8251,7 @@ Imposta il nuovo valore per l'opzione nel file di configurazione dei plugin (plu Prototipo: -[source,C] +[source,c] ---- int weechat_config_set_plugin (const char *option_name, const char *value); ---- @@ -8271,7 +8271,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- switch (weechat_config_set_plugin ("option", "test_value")) { @@ -8318,7 +8318,7 @@ Imposta la descrizione per l'opzione nel file di configurazione dei plugin Prototipo: -[source,C] +[source,c] ---- void weechat_config_set_desc_plugin (const char *option_name, const char *description); @@ -8336,7 +8336,7 @@ Una futura creazione dell'opzione con questo nome userà questa descrizione. Esempio in C: -[source,C] +[source,c] ---- weechat_config_set_desc_plugin ("option", "description of option"); ---- @@ -8360,7 +8360,7 @@ Disattiva l'opzione nel file di configurazione dei plugin (plugins.conf). Prototipo: -[source,C] +[source,c] ---- int weechat_config_unset_plugin (const char *option_name); ---- @@ -8381,7 +8381,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- switch (weechat_config_unset_plugin ("option")) { @@ -8438,7 +8438,7 @@ una combinazione tasti, usare <<_key_unbind,key_unbind>>. Prototipo: -[source,C] +[source,c] ---- int weechat_key_bind (const char *context, struct t_hashtable *keys); ---- @@ -8463,7 +8463,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hashtable *keys = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, @@ -8506,7 +8506,7 @@ combinazione tasti definita dall'utente. Prototipo: -[source,C] +[source,c] ---- int weechat_key_unbind (const char *context, const char *key); ---- @@ -8525,7 +8525,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- /* rimuove un singolo tasto */ weechat_key_unbind ("mouse", "@chat(plugin.buffer):button1"); @@ -8561,7 +8561,7 @@ Restituisce un prefisso. Prototipo: -[source,C] +[source,c] ---- const char *weechat_prefix (const char *prefix); ---- @@ -8594,7 +8594,7 @@ Valori e colori possono essere personalizzati con il comando `/set`. Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "%sQuesto è un errore...", weechat_prefix ("error")); ---- @@ -8616,7 +8616,7 @@ Restituisce una codice colore stringa da visualizzare. Prototipo: -[source,C] +[source,c] ---- const char *weechat_color (const char *color_name); ---- @@ -8676,7 +8676,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "Color: %sblue %sdefault color %syellow on red", weechat_color ("blue"), @@ -8702,7 +8702,7 @@ Visualizza un messaggio su un buffer. Prototipo: -[source,C] +[source,c] ---- void weechat_printf (struct t_gui_buffer *buffer, const char *message, ...); ---- @@ -8711,7 +8711,7 @@ void weechat_printf (struct t_gui_buffer *buffer, const char *message, ...); This function is a shortcut for function printf_date_tags. These two calls give exactly same result: -[source,C] +[source,c] ---- weechat_printf (buffer, "message"); weechat_printf_date_tags (buffer, 0, NULL, "message"); @@ -8738,7 +8738,7 @@ set to 0. Esempio in C: // TRANSLATION MISSING -[source,C] +[source,c] ---- weechat_printf (NULL, "Benvenuto sul buffer di WeeChat"); weechat_printf (buffer, "Benvenuto su questo buffer"); @@ -8774,7 +8774,7 @@ Visualizza un messaggio sul buffer, usando tag e data personalizzati. Prototipo: -[source,C] +[source,c] ---- void weechat_printf_date_tags (struct t_gui_buffer *buffer, time_t date, const char *tags, const char *message, ...); @@ -8795,7 +8795,7 @@ for a list of commonly used tags in WeeChat. Esempio in C: -[source,C] +[source,c] ---- weechat_printf_date_tags (NULL, time (NULL) - 120, "notify_message", "Messaggio 2 minuti fa, con tag 'notify_message'"); @@ -8823,7 +8823,7 @@ Visualizza un messaggio sulla riga di un buffer con contenuto libero. Prototipo: -[source,C] +[source,c] ---- void weechat_printf_y (struct t_gui_buffer *buffer, int y, const char *message, ...); @@ -8841,7 +8841,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_printf_y (buffer, 2, "Mio messaggio sulla terza riga"); ---- @@ -8866,7 +8866,7 @@ Scrive un messaggio nel file di log di WeeChat (weechat.log). Prototipo: -[source,C] +[source,c] ---- void weechat_log_printf (const char *message, ...); ---- @@ -8877,7 +8877,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_log_printf ("Mio messaggio nel file di log"); ---- @@ -8919,7 +8919,7 @@ La priorità predefinita è 1000. Esempio in C: -[source,C] +[source,c] ---- /* hook per il modificatore con priorità = 2000 */ weechat_hook_modifier ("2000|input_text_display", &modifier_cb, NULL, NULL); @@ -8938,7 +8938,7 @@ Hook su un comando. Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_command (const char *command, const char *description, @@ -9000,7 +9000,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int my_command_cb (const void *pointer, void *data, struct t_gui_buffer *buffer, @@ -9079,7 +9079,7 @@ Hook su un completamento. Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_completion (const char *completion_item, const char *description, @@ -9136,7 +9136,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int my_completion_cb (const void *pointer, void *data, const char *completion_item, @@ -9193,7 +9193,7 @@ Hook su un comando quando eseguito da WeeChat. Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_command_run (const char *command, int (*callback)(const void *pointer, @@ -9232,7 +9232,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int my_command_run_cb (const void *pointer, void *data, struct t_gui_buffer *buffer, @@ -9271,7 +9271,7 @@ Hook sul timer. Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_timer (long interval, int align_second, @@ -9313,7 +9313,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int my_timer_cb (const void *pointer, void *data, int remaining_calls) @@ -9352,7 +9352,7 @@ Hook su un descrittore file (file oppure socket). Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_fd (int fd, int flag_read, @@ -9400,7 +9400,7 @@ to integer before using it, for example in Python: `int(fd)`. Esempio in C: -[source,C] +[source,c] ---- int my_fd_cb (const void *pointer, void *data, int fd) @@ -9449,7 +9449,7 @@ arguments in the hashtable _options_ _(WeeChat ≥ 0.4.0)_. Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_process (const char *command, int timeout, @@ -9544,7 +9544,7 @@ codice restituito è non-negativo. Esempio in C: -[source,C] +[source,c] ---- /* example with an external command */ int @@ -9678,7 +9678,7 @@ e cattura dell'output. Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_process_hashtable (const char *command, struct t_hashtable *options, @@ -9757,7 +9757,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int my_process_cb (const void *pointer, void *data, const char *command, @@ -9918,7 +9918,7 @@ Hook su una connessione (connessione in secondo piano ad un host remoto). Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_connect (const char *proxy, const char *address, @@ -10009,7 +10009,7 @@ to integer before using it, for example in Python: `int(sock)`. Esempio in C: -[source,C] +[source,c] ---- int my_connect_cb (const void *pointer, void *data, int status, int gnutls_rc, @@ -10122,7 +10122,7 @@ buffers with free content. Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_line (const char *buffer_type, const char *buffer_name, @@ -10336,7 +10336,7 @@ in this hashtable): Esempio in C: -[source,C] +[source,c] ---- int my_line_cb (const void *pointer, void *data, struct t_hasbtable *line) @@ -10389,7 +10389,7 @@ For more information on the hooks called when a line is printed, see Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_print (struct t_gui_buffer *buffer, const char *tags, @@ -10460,7 +10460,7 @@ to integer before testing it, for example in Python: `if int(highlight):`. Esempio in C: -[source,C] +[source,c] ---- int my_print_cb (const void *pointer, void *data, struct t_gui_buffer *buffer, @@ -10503,7 +10503,7 @@ Hook su un segnale. Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_signal (const char *signal, int (*callback)(const void *pointer, @@ -11289,7 +11289,7 @@ List of signals sent by WeeChat and plugins: Esempio in C: -[source,C] +[source,c] ---- int my_signal_cb (const void *pointer, void *data, const char *signal, @@ -11329,7 +11329,7 @@ Invia un segnale. Prototipo: -[source,C] +[source,c] ---- int weechat_hook_signal_send (const char *signal, const char *type_data, void *signal_data); @@ -11353,7 +11353,7 @@ Return value _(WeeChat ≥ 1.0)_: Esempio in C: -[source,C] +[source,c] ---- int rc = weechat_hook_signal_send ("my_signal", WEECHAT_HOOK_SIGNAL_STRING, my_string); ---- @@ -11380,7 +11380,7 @@ L'argomento è un puntatore al buffer. Esempio in C: -[source,C] +[source,c] ---- weechat_hook_signal_send ("logger_backlog", WEECHAT_HOOK_SIGNAL_POINTER, buffer); ---- @@ -11426,7 +11426,7 @@ L'argomento è una stringa con il percorso dello script da installare. Esempio in C: -[source,C] +[source,c] ---- weechat_hook_signal_send ("python_script_install", WEECHAT_HOOK_SIGNAL_STRING, "/path/to/test.py"); ---- @@ -11463,7 +11463,7 @@ rimuovere (script è il nome senza percorso, ad esempio _script.py_). Esempio in C: -[source,C] +[source,c] ---- /* scarica e rimuove gli script test.py e script.py */ weechat_hook_signal_send ("python_script_remove", WEECHAT_HOOK_SIGNAL_STRING, @@ -11509,7 +11509,7 @@ L'argomento è una stringa con il seguente formato: Esempi in C: -[source,C] +[source,c] ---- /* dice "Hello!" sul server libera, canale #weechat */ weechat_hook_signal_send ("irc_input_send", WEECHAT_HOOK_SIGNAL_STRING, @@ -11541,7 +11541,7 @@ Hook su hsignal (segnale con tabella hash). Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_hsignal (const char *signal, int (*callback)(const void *pointer, @@ -11641,7 +11641,7 @@ di redirezione. Esempio in C: -[source,C] +[source,c] ---- int my_hsignal_cb (const void *pointer, void *data, const char *signal, @@ -11679,7 +11679,7 @@ Invia un hsignal (segnale con tabella hash). Prototipo: -[source,C] +[source,c] ---- int weechat_hook_hsignal_send (const char *signal, struct t_hashtable *hashtable); ---- @@ -11701,7 +11701,7 @@ Return value _(WeeChat ≥ 1.0)_: Esempio in C: -[source,C] +[source,c] ---- int rc; struct t_hashtable *hashtable = weechat_hashtable_new (8, @@ -11788,7 +11788,7 @@ sono stringhe): Esempio in C: -[source,C] +[source,c] ---- int test_whois_cb (const void *pointer, void *data, const char *signal, @@ -11870,7 +11870,7 @@ di ogni redirezione. Esempio in C: -[source,C] +[source,c] ---- struct t_hashtable *hashtable = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, @@ -11917,7 +11917,7 @@ Hook su un'opzione di configurazione. Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_config (const char *option, int (*callback)(const void *pointer, @@ -11956,7 +11956,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int my_config_cb (const void *pointer, void *data, const char *option, @@ -11996,7 +11996,7 @@ Hook su un modificatore. Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_modifier (const char *modifier, char *(*callback)(const void *pointer, @@ -12120,7 +12120,7 @@ List of modifiers used by WeeChat and plugins: Esempio in C: -[source,C] +[source,c] ---- char * my_modifier_cb (const void *pointer, void *data, const char *modifier, @@ -12168,7 +12168,7 @@ Esegue modificatore(i). Prototipo: -[source,C] +[source,c] ---- char *weechat_hook_modifier_exec (const char *modifier, const char *modifier_data, @@ -12269,7 +12269,7 @@ List of modifiers defined by WeeChat and plugins that can be used: Esempio in C: -[source,C] +[source,c] ---- char *new_string = weechat_hook_modifier_exec ("my_modifier", my_data, my_string); @@ -12295,7 +12295,7 @@ Hook su una informazione (la callback prende e restituisce una stringa). Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_info (const char *info_name, const char *description, @@ -12339,7 +12339,7 @@ With WeeChat ≥ 2.5, the callback returns an allocated string Esempio in C: -[source,C] +[source,c] ---- char * my_info_cb (const void *pointer, void *data, const char *info_name, @@ -12381,7 +12381,7 @@ Hook su una informazione (la callback prende e restituisce una tabella hash). Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_info_hashtable (const char *info_name, const char *description, @@ -12424,7 +12424,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hashtable * my_info_hashtable_cb (const void *pointer, void *data, const char *info_name, @@ -12470,7 +12470,7 @@ richiesta. Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_infolist (const char *infolist_name, const char *description, @@ -12514,7 +12514,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_infolist * my_infolist_cb (const void *pointer, void *data, const char *infolist_name, @@ -12564,7 +12564,7 @@ Hook di un hdata: la callback restituisce il puntatore all'hdata richiesto. Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_hdata (const char *hdata_name, const char *description, @@ -12597,7 +12597,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hdata * my_hdata_cb (const void *pointer, void *data, const char *hdata_name) @@ -12629,7 +12629,7 @@ Hook sul foucus: evento del mouse o tasto premuto nella modalità cursore Prototipo: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_focus (const char *area, struct t_hashtable *(*callback)(const void *pointer, @@ -12804,7 +12804,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hashtable * my_focus_nicklist_cb (const void *pointer, void *data, struct t_hashtable *info) @@ -12845,7 +12845,7 @@ Set string value of a hook property. Prototipo: -[source,C] +[source,c] ---- void weechat_hook_set (struct t_hook *hook, const char *property, const char *value); @@ -12894,7 +12894,7 @@ Properties: Esempio in C: -[source,C] +[source,c] ---- struct t_hook *my_command_hook = weechat_hook_command ("abcd", "description", @@ -12927,7 +12927,7 @@ Rimuove un hook. Prototipo: -[source,C] +[source,c] ---- void weechat_unhook (struct t_hook *hook); ---- @@ -12938,7 +12938,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- struct t_hook *my_hook = weechat_hook_command ( /* ... */ ); /* ... */ @@ -12966,7 +12966,7 @@ plugin corrente. Prototipo: -[source,C] +[source,c] ---- void weechat_unhook_all (const char *subplugin); ---- @@ -12979,7 +12979,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_unhook_all (NULL); ---- @@ -13009,7 +13009,7 @@ Apre un nuovo buffer. Prototipo: -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer_new (const char *name, int (*input_callback)(const void *pointer, @@ -13064,7 +13064,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int my_input_cb (const void *pointer, void *data, @@ -13114,7 +13114,7 @@ finestra corrente). Prototipo: -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_current_buffer (); ---- @@ -13125,7 +13125,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (weechat_current_buffer (), "Testo sul buffer corrente"); ---- @@ -13150,7 +13150,7 @@ Cerca un buffer tramite plugin e/o nome. Prototipo: -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer_search (const char *plugin, const char *name); @@ -13174,7 +13174,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_buffer *buffer1 = weechat_buffer_search ("irc", "libera.#weechat"); struct t_gui_buffer *buffer2 = weechat_buffer_search ("==", "irc.libera.#test"); /* WeeChat ≥ 1.0 */ @@ -13198,7 +13198,7 @@ visualizzato all'avvio di WeeChat). Prototipo: -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer_search_main (); ---- @@ -13209,7 +13209,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer = weechat_buffer_search_main (); ---- @@ -13231,7 +13231,7 @@ Pulisce il contenuto del buffer. Prototipo: -[source,C] +[source,c] ---- void weechat_buffer_clear (struct t_gui_buffer *buffer); ---- @@ -13242,7 +13242,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_buffer *my_buffer = weechat_buffer_search ("my_plugin", "my_buffer"); @@ -13271,7 +13271,7 @@ Chiude un buffer. Prototipo: -[source,C] +[source,c] ---- void weechat_buffer_close (struct t_gui_buffer *buffer); ---- @@ -13282,7 +13282,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_buffer *my_buffer = weechat_buffer_new ("my_buffer", &my_input_cb, NULL, @@ -13312,7 +13312,7 @@ buffer (righe mischiate). Prototipo: -[source,C] +[source,c] ---- void weechat_buffer_merge (struct t_gui_buffer *buffer, struct t_gui_buffer *target_buffer); @@ -13325,7 +13325,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- /* merge current buffer with weechat "core" buffer */ weechat_buffer_merge (weechat_current_buffer (), @@ -13350,7 +13350,7 @@ Stacca un buffer da un gruppo di buffer uniti. Prototipo: -[source,C] +[source,c] ---- void weechat_buffer_unmerge (struct t_gui_buffer *buffer, int number); @@ -13365,7 +13365,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_buffer_unmerge (weechat_current_buffer (), 1); ---- @@ -13388,7 +13388,7 @@ un buffer. Prototipo: -[source,C] +[source,c] ---- int weechat_buffer_get_integer (struct t_gui_buffer *buffer, const char *property); @@ -13468,7 +13468,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "my buffer number is: %d", weechat_buffer_get_integer (my_buffer, "number")); @@ -13491,7 +13491,7 @@ Restituisce il valore stringa di una proprietà del buffer. Prototipo: -[source,C] +[source,c] ---- const char *weechat_buffer_get_string (struct t_gui_buffer *buffer, const char *property); @@ -13528,7 +13528,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "name / short name of buffer are: %s / %s", weechat_buffer_get_string (my_buffer, "name"), @@ -13554,7 +13554,7 @@ Restituisce il valore puntatore della proprietà di un buffer. Prototipo: -[source,C] +[source,c] ---- void *weechat_buffer_pointer (struct t_gui_buffer *buffer, const char *property); @@ -13574,7 +13574,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "plugin pointer of my buffer: %lx", weechat_buffer_get_pointer (my_buffer, "plugin")); @@ -13597,7 +13597,7 @@ Imposta il valore stringa della proprietà di un buffer. Prototipo: -[source,C] +[source,c] ---- void weechat_buffer_set (struct t_gui_buffer *buffer, const char *property, const char *value); @@ -13791,7 +13791,7 @@ Properties: Esempio in C: -[source,C] +[source,c] ---- /* disabilita hotlist (per tutti i buffer) */ weechat_buffer_set (NULL, "hotlist", "-"); @@ -13840,7 +13840,7 @@ Imposta il valore puntatore per la proprietà di un buffer. Prototipo: -[source,C] +[source,c] ---- void weechat_buffer_set_pointer (struct t_gui_buffer *buffer, const char *property, void *pointer); @@ -13866,7 +13866,7 @@ Argomenti: // TRANSLATION MISSING Prototypes for callbacks: -[source,C] +[source,c] ---- int close_callback (const void *pointer, void *data, struct t_gui_buffer *buffer); @@ -13881,7 +13881,7 @@ int nickcmp_callback (const void *pointer, void *data, Esempio in C: -[source,C] +[source,c] ---- int my_close_cb (const void *pointer, void *data, struct t_gui_buffer *buffer) @@ -13903,7 +13903,7 @@ le variabili del buffer locale. Prototipo: -[source,C] +[source,c] ---- char *weechat_buffer_string_replace_local_var (struct t_gui_buffer *buffer, const char *string); @@ -13920,7 +13920,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_buffer_set (my_buffer, "localvar_set_toto", "abc"); @@ -13950,7 +13950,7 @@ Verifica se il buffer corrisponde ad una lista di buffer. Prototipo: -[source,C] +[source,c] ---- int weechat_buffer_match_list (struct t_gui_buffer *buffer, const char *string); ---- @@ -13970,7 +13970,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_buffer *buffer = weechat_buffer_search ("irc", "libera.#weechat"); if (buffer) @@ -14009,7 +14009,7 @@ Restituisce il puntatore alla finestra corrente Prototipo: -[source,C] +[source,c] ---- struct t_gui_window *weechat_current_window (); ---- @@ -14020,7 +14020,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_window *current_window = weechat_current_window (); ---- @@ -14044,7 +14044,7 @@ Restituisce il puntatore alla finestra che mostra il buffer. Prototipo: -[source,C] +[source,c] ---- struct t_gui_window *weechat_window_search_with_buffer (struct t_gui_buffer *buffer); ---- @@ -14060,7 +14060,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "window displaying core buffer: %lx", @@ -14085,7 +14085,7 @@ Restituisce il valore intero della proprietà di una finestra. Prototipo: -[source,C] +[source,c] ---- int weechat_window_get_integer (struct t_gui_window *window, const char *property); @@ -14123,7 +14123,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "current window is at position (x,y): (%d,%d)", weechat_window_get_integer (weechat_current_window (), "win_x"), @@ -14152,7 +14152,7 @@ La funzione non è utilizzata oggi, è riservata per una versione futura. Prototipo: -[source,C] +[source,c] ---- const char *weechat_window_get_string (struct t_gui_window *window, const char *property); @@ -14181,7 +14181,7 @@ Restituisce il valore puntatore della proprietà di una finestra. Prototipo: -[source,C] +[source,c] ---- void *weechat_window_get_pointer (struct t_gui_window *window, const char *property); @@ -14200,7 +14200,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "buffer displayed in current window: %lx", @@ -14225,7 +14225,7 @@ Imposta il titolo per il terminale. Prototipo: -[source,C] +[source,c] ---- void weechat_window_set_title (const char *title); ---- @@ -14239,7 +14239,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_window_set_title ("nuovo titolo qui"); ---- @@ -14266,7 +14266,7 @@ Aggiunge un gruppo in una lista nick. Prototipo: -[source,C] +[source,c] ---- struct t_gui_nick_group *weechat_nicklist_add_group (struct t_gui_buffer *buffer, struct t_gui_nick_group *parent_group, @@ -14304,7 +14304,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_nick_group *my_group = weechat_nicklist_add_group (my_buffer, @@ -14332,7 +14332,7 @@ Cerca un gruppo in una lista nick. Prototipo: -[source,C] +[source,c] ---- struct t_gui_nick_group *weechat_nicklist_search_group (struct t_gui_buffer *buffer, struct t_gui_nick_group *from_group, @@ -14352,7 +14352,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_nick_group *ptr_group = weechat_nicklist_search_group (my_buffer, NULL, "test_group"); @@ -14375,7 +14375,7 @@ Aggiunge un nick in un gruppo. Prototipo: -[source,C] +[source,c] ---- struct t_gui_nick_group *weechat_nicklist_add_nick (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14416,7 +14416,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_nick *my_nick = weechat_nicklist_add_nick (my_buffer, my_group, @@ -14447,7 +14447,7 @@ Cerca un nick nella lista nick. Prototipo: -[source,C] +[source,c] ---- struct t_gui_nick *weechat_nicklist_search_nick (struct t_gui_buffer *buffer, struct t_gui_nick_group *from_group, @@ -14467,7 +14467,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_nick *ptr_nick = weechat_nicklist_search_nick (my_buffer, NULL, "test_nick"); @@ -14490,7 +14490,7 @@ Rimuove un gruppo da una lista nick. Prototipo: -[source,C] +[source,c] ---- void weechat_nicklist_remove_group (struct t_gui_buffer *buffer, struct t_gui_nick_group *group); @@ -14504,7 +14504,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_nicklist_remove_group (my_buffer, my_group); ---- @@ -14526,7 +14526,7 @@ Rimuove un nick dalla lista nick. Prototipo: -[source,C] +[source,c] ---- void weechat_nicklist_remove_nick (struct t_gui_buffer *buffer, struct t_gui_nick *nick); @@ -14539,7 +14539,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_nicklist_remove_nick (my_buffer, my_nick); ---- @@ -14561,7 +14561,7 @@ Rimuove tutti i gruppi/nick da una lista nick. Prototipo: -[source,C] +[source,c] ---- void weechat_nicklist_remove_all (struct t_gui_buffer *buffer); ---- @@ -14572,7 +14572,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_nicklist_remove_all (my_buffer); ---- @@ -14597,7 +14597,7 @@ per mostrare la lista nick). Prototipo: -[source,C] +[source,c] ---- void weechat_nicklist_get_next_item (struct t_gui_buffer *buffer, struct t_gui_nick_group **group, @@ -14612,7 +14612,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_nick_group *ptr_group; struct t_gui_nick *ptr_nick; @@ -14647,7 +14647,7 @@ Restituisce un valore intero della proprietà di un gruppo. Prototipo: -[source,C] +[source,c] ---- int weechat_nicklist_group_get_integer (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14668,7 +14668,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int visible = weechat_nicklist_group_get_integer (buffer, group, "visible"); ---- @@ -14692,7 +14692,7 @@ Restituisce il valore stringa della proprietà di un gruppo. Prototipo: -[source,C] +[source,c] ---- const char *weechat_nicklist_group_get_string (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14713,7 +14713,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- const char *color = weechat_nicklist_group_get_string (buffer, group, "color"); ---- @@ -14737,7 +14737,7 @@ Restituisce il valore puntatore della proprietà di un gruppo. Prototipo: -[source,C] +[source,c] ---- void *weechat_nicklist_group_get_pointer (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14757,7 +14757,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_nick_group *parent = weechat_nicklist_group_get_pointer (buffer, group, "parent"); ---- @@ -14781,7 +14781,7 @@ Imposta il valore stringa della proprietà di un gruppo. Prototipo: -[source,C] +[source,c] ---- void weechat_nicklist_group_set (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14815,7 +14815,7 @@ Properties: Esempio in C: -[source,C] +[source,c] ---- /* cambia colore del gruppo a "bar_fg" */ weechat_nicklist_group_set (buffer, group, "color", "bar_fg"); @@ -14854,7 +14854,7 @@ Restituisce il valore intero della proprietà di un nick. Prototipo: -[source,C] +[source,c] ---- int weechat_nicklist_nick_get_integer (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -14874,7 +14874,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int visible = weechat_nicklist_nick_get_integer (buffer, nick, "visible"); ---- @@ -14898,7 +14898,7 @@ Restituisce il valore stringa della proprietà di un nick. Prototipo: -[source,C] +[source,c] ---- const char *weechat_nicklist_nick_get_string (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -14921,7 +14921,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- const char *color = weechat_nicklist_nick_get_string (buffer, nick, "color"); ---- @@ -14945,7 +14945,7 @@ Restituisce il valore puntatore della proprietà di un nick. Prototipo: -[source,C] +[source,c] ---- void *weechat_nicklist_nick_get_pointer (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -14965,7 +14965,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_nick_group *group = weechat_nicklist_nick_get_pointer (buffer, nick, "group"); ---- @@ -14989,7 +14989,7 @@ Imposta il valore stringa della proprietà di un nick. Prototipo: -[source,C] +[source,c] ---- void weechat_nicklist_nick_set (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -15030,7 +15030,7 @@ Properties: Esempi in C: -[source,C] +[source,c] ---- /* cambia colore del nick in azzurro */ weechat_nicklist_nick_set (buffer, nick, "color", "cyan"); @@ -15078,7 +15078,7 @@ Cerca un elemento barra. Prototipo: -[source,C] +[source,c] ---- struct t_gui_bar_item *weechat_bar_item_search (const char *name); ---- @@ -15093,7 +15093,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_bar_item *bar_item = weechat_bar_item_search ("myitem"); ---- @@ -15118,7 +15118,7 @@ Crea un nuovo elemento barra. Prototipo: -[source,C] +[source,c] ---- struct t_gui_bar_item *weechat_bar_item_new (const char *name, char *(*build_callback)(const void *pointer, @@ -15163,7 +15163,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char * my_build_callback (const void *pointer, void *data, @@ -15215,7 +15215,7 @@ che lo ha compilato. Prototipo: -[source,C] +[source,c] ---- void weechat_bar_item_update (const char *name); ---- @@ -15226,7 +15226,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_bar_item_update ("myitem"); ---- @@ -15248,7 +15248,7 @@ Rimuove un elemento barra. Prototipo: -[source,C] +[source,c] ---- void weechat_bar_item_remove (struct t_gui_bar_item *item); ---- @@ -15259,7 +15259,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_bar_item_remove (&my_item); ---- @@ -15281,7 +15281,7 @@ Cerca una barra. Prototipo: -[source,C] +[source,c] ---- struct t_gui_bar *weechat_bar_search (const char *name); ---- @@ -15296,7 +15296,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_bar *bar = weechat_bar_search ("mybar"); ---- @@ -15321,7 +15321,7 @@ Crea una nuova barra. Prototipo: -[source,C] +[source,c] ---- struct t_gui_bar *weechat_bar_new (const char *name, const char *hidden, @@ -15399,7 +15399,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_bar *my_bar = weechat_bar_new ("mybar", "off", @@ -15447,7 +15447,7 @@ Imposta un nuovo valore per la proprietà di una barra. Prototipo: -[source,C] +[source,c] ---- int weechat_bar_set (struct t_gui_bar *bar, const char *property, const char *value); @@ -15467,7 +15467,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_bar_set (mybar, "position", "bottom"); ---- @@ -15489,7 +15489,7 @@ Aggiorna il contenuto di una barra su schermo. Prototipo: -[source,C] +[source,c] ---- void weechat_bar_update (const char *name); ---- @@ -15500,7 +15500,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_bar_update ("mybar"); ---- @@ -15522,7 +15522,7 @@ Rimuove una barra. Prototipo: -[source,C] +[source,c] ---- void weechat_bar_remove (struct t_gui_bar *bar); ---- @@ -15533,7 +15533,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_bar_remove (mybar); ---- @@ -15564,7 +15564,7 @@ Execute a command or send text to buffer. Prototipo: -[source,C] +[source,c] ---- int weechat_command (struct t_gui_buffer *buffer, const char *command); ---- @@ -15583,7 +15583,7 @@ Valori restituiti _(WeeChat ≥ 1.1)_: Esempio in C: -[source,C] +[source,c] ---- int rc; rc = weechat_command (weechat_buffer_search ("irc", "libera.#weechat"), @@ -15610,7 +15610,7 @@ Execute a command or send text to buffer with options. Prototipo: -[source,C] +[source,c] ---- int weechat_command_options (struct t_gui_buffer *buffer, const char *command, struct t_hashtable *options); @@ -15638,7 +15638,7 @@ Valori restituiti: Esempio in C: // TRANSLATION MISSING -[source,C] +[source,c] ---- /* allow any command except /exec, run command in 2 seconds */ int rc; @@ -15679,7 +15679,7 @@ Create a new completion. Prototipo: -[source,C] +[source,c] ---- struct t_gui_completion *weechat_completion_new (struct t_gui_buffer *buffer); ---- @@ -15694,7 +15694,7 @@ Valori restituiti: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_completion *completion = weechat_completion_new (weechat_buffer_search_main ()); ---- @@ -15720,7 +15720,7 @@ context. Prototipo: -[source,C] +[source,c] ---- int weechat_completion_search (struct t_gui_completion *completion, const char *data, int position, int direction); @@ -15740,7 +15740,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_gui_completion *completion = weechat_completion_new (weechat_buffer_search_main ()); if (weechat_completion_search (completion, "/help filt", 10, 1)) @@ -15770,7 +15770,7 @@ Ottiene il completamento di una proprietà come stringa. Prototipo: -[source,C] +[source,c] ---- const char *weechat_completion_get_string (struct t_gui_completion *completion, const char *property); @@ -15786,7 +15786,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- int my_completion_cb (const void *pointer, void *data, const char *completion_item, @@ -15827,7 +15827,7 @@ Aggiunge una parola per il completamento. Prototipo: -[source,C] +[source,c] ---- void weechat_completion_list_add (struct t_gui_completion *completion, const char *word, @@ -15867,7 +15867,7 @@ Free a completion. Prototipo: -[source,C] +[source,c] ---- void weechat_completion_free (struct t_gui_completion *completion); ---- @@ -15878,7 +15878,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_completion_free (completion); ---- @@ -15910,7 +15910,7 @@ process only, to not block WeeChat. Prototipo: -[source,C] +[source,c] ---- int weechat_network_pass_proxy (const char *proxy, int sock, @@ -15932,7 +15932,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (weechat_network_pass_proxy ("my_proxy", sock, "irc.libera.chat", 6667)) { @@ -15961,7 +15961,7 @@ process only, to not block WeeChat. Prototipo: -[source,C] +[source,c] ---- int weechat_network_connect_to (const char *proxy, struct sockaddr *address, @@ -15984,7 +15984,7 @@ Valore restituito: Esempio in C: // TRANSLATION MISSING -[source,C] +[source,c] ---- struct sockaddr *addr; socklen_t length; @@ -16021,7 +16021,7 @@ Restituisce la info, come stringa, da WeeChat o da un plugin. Prototipo: -[source,C] +[source,c] ---- char *weechat_info_get (const char *info_name, const char *arguments); ---- @@ -16050,7 +16050,7 @@ include::includes/autogen_api_infos.it.adoc[tag=infos] Esempio in C: -[source,C] +[source,c] ---- char *version = weechat_info_get ("version", NULL); char *date = weechat_info_get ("date", NULL); @@ -16088,7 +16088,7 @@ Restituisce una info, come tabella hash, da WeeChat o da un plugin. Prototipo: -[source,C] +[source,c] ---- struct t_hashtable *weechat_info_get_hashtable (const char *info_name, struct t_hashtable *hashtable); @@ -16112,7 +16112,7 @@ include::includes/autogen_api_infos_hashtable.it.adoc[tag=infos_hashtable] Esempio in C: -[source,C] +[source,c] ---- struct t_hashtable *hashtable_in, *hashtable_out; @@ -16197,7 +16197,7 @@ Crea una nuova lista info. Prototipo: -[source,C] +[source,c] ---- struct t_infolist *weechat_infolist_new (); ---- @@ -16208,7 +16208,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_infolist *infolist = weechat_infolist_new (); ---- @@ -16230,7 +16230,7 @@ Aggiunge un elemento alla lista info. Prototipo: -[source,C] +[source,c] ---- struct t_infolist_item *weechat_infolist_new_item (struct t_infolist *infolist); ---- @@ -16245,7 +16245,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_infolist_item *item = weechat_infolist_new_item (infolist); ---- @@ -16268,7 +16268,7 @@ lista info. Prototipo: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_integer (struct t_infolist_item *item, const char *name, @@ -16287,7 +16287,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_integer (item, "my_integer", @@ -16312,7 +16312,7 @@ della lista info. Prototipo: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_string (struct t_infolist_item *item, const char *name, @@ -16331,7 +16331,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_string (item, "my_string", @@ -16356,7 +16356,7 @@ della lista info. Prototipo: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_pointer (struct t_infolist_item *item, const char *name, @@ -16375,7 +16375,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_pointer (item, "my_pointer", @@ -16399,7 +16399,7 @@ Aggiunge una variabile puntatore ad un elemento della lista info. Prototipo: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_buffer (struct t_infolist_item *item, const char *name, @@ -16420,7 +16420,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- char buffer[256]; /* ... */ @@ -16439,7 +16439,7 @@ Aggiunge una variabile tempo ad un elemento della lista info. Prototipo: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_time (struct t_infolist_item *item, const char *name, @@ -16458,7 +16458,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_time (item, "my_time", @@ -16490,7 +16490,7 @@ info potrebbero avere più info di hdata, che sono dati raw), consultare <<hdata Prototipo: -[source,C] +[source,c] ---- struct t_infolist *weechat_infolist_get (const char *infolist_name, void *pointer, @@ -16517,7 +16517,7 @@ include::includes/autogen_api_infolists.it.adoc[tag=infolists] Esempio in C: -[source,C] +[source,c] ---- struct t_infolist *infolist = weechat_infolist_get ("irc_server", NULL, NULL); ---- @@ -16541,7 +16541,7 @@ nella lista info. Prototipo: -[source,C] +[source,c] ---- int weechat_infolist_next (struct t_infolist *infolist); ---- @@ -16557,7 +16557,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (weechat_infolist_next (infolist)) { @@ -16592,7 +16592,7 @@ all'ultimo elemento. Prototipo: -[source,C] +[source,c] ---- int weechat_infolist_prev (struct t_infolist *infolist); ---- @@ -16608,7 +16608,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (weechat_infolist_prev (infolist)) { @@ -16641,7 +16641,7 @@ Ripristina "cursor" per la lista info. Prototipo: -[source,C] +[source,c] ---- void weechat_infolist_reset_item_cursor (struct t_infolist *infolist); ---- @@ -16652,7 +16652,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_infolist_reset_item_cursor (infolist); ---- @@ -16677,7 +16677,7 @@ Search a variable in the current infolist item. Prototipo: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_search_var (struct t_infolist *infolist, const char *name); @@ -16696,7 +16696,7 @@ Valore restituito: Esempio in C: // TRANSLATION MISSING -[source,C] +[source,c] ---- if (weechat_infolist_search_var (infolist, "name")) { @@ -16726,7 +16726,7 @@ lista info corrente. Prototipo: -[source,C] +[source,c] ---- const char *weechat_infolist_fields (struct t_infolist *infolist); ---- @@ -16744,7 +16744,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- const char *fields = weechat_infolist_fields (infolist); /* i campi contengono qualcosa come: @@ -16771,7 +16771,7 @@ corrente della lista info. Prototipo: -[source,C] +[source,c] ---- int weechat_infolist_integer (struct t_infolist *infolist, const char *var); ---- @@ -16787,7 +16787,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "integer = %d", weechat_infolist_integer (infolist, "my_integer")); @@ -16811,7 +16811,7 @@ della lista info corrente. Prototipo: -[source,C] +[source,c] ---- const char *weechat_infolist_string (struct t_infolist *infolist, const char *var); ---- @@ -16827,7 +16827,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "string = %s", weechat_infolist_string (infolist, "my_string")); @@ -16851,7 +16851,7 @@ della lista info corrente. Prototipo: -[source,C] +[source,c] ---- void *weechat_infolist_pointer (struct t_infolist *infolist, const char *var); ---- @@ -16867,7 +16867,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "pointer = 0x%lx", weechat_infolist_pointer (infolist, "my_pointer")); @@ -16891,7 +16891,7 @@ della lista info. Prototipo: -[source,C] +[source,c] ---- void *weechat_infolist_buffer (struct t_infolist *infolist, const char *var, int *size); @@ -16910,7 +16910,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int size; void *pointer = weechat_infolist_buffer (infolist, "my_buffer", &size); @@ -16928,7 +16928,7 @@ attivo della lista info. Prototipo: -[source,C] +[source,c] ---- time_t weechat_infolist_time (struct t_infolist *infolist, const char *var); ---- @@ -16944,7 +16944,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "time = %ld", weechat_infolist_time (infolist, "my_time")); @@ -16967,7 +16967,7 @@ Libera una lista info. Prototipo: -[source,C] +[source,c] ---- void weechat_infolist_free (struct t_infolist *infolist); ---- @@ -16978,7 +16978,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_infolist_free (infolist); ---- @@ -17026,7 +17026,7 @@ alle liste info, ma ci sono alcune differenze: Prototipo: -[source,C] +[source,c] ---- struct t_hdata *weechat_hdata_new (const char *hdata_name, const char *var_prev, const char *var_next, int create_allowed, int delete_allowed, @@ -17067,7 +17067,7 @@ Valore restituito: * puntatore al nuovo hdata Esempio in C: -source,C] +source,c] ---- struct t_hdata *hdata = weechat_hdata_new ("myplugin_list", "prev", "next", 0, 0, &callback_update, NULL); ---- @@ -17084,7 +17084,7 @@ Crea una nuova variabile in hdata. Prototipo: -[source,C] +[source,c] ---- void weechat_hdata_new_var (struct t_hdata *hdata, const char *name, int offset, int type, int update_allowed, const char *array_size, const char *hdata_name); @@ -17152,7 +17152,7 @@ Examples of variables and the corresponding array size (_WeeChat ≥ 3.4_): Esempio in C: -[source,C] +[source,c] ---- struct t_myplugin_list { @@ -17181,7 +17181,7 @@ weechat_hdata_new_var (hdata, "next", offsetof (struct t_myplugin_list, next), W La macro "WEECHAT_HDATA_VAR" può essere usata per accorciare il codice: -[source,C] +[source,c] ---- WEECHAT_HDATA_VAR(struct t_myplugin_list, name, STRING, 0, NULL, NULL); WEECHAT_HDATA_VAR(struct t_myplugin_list, buffer, POINTER, 0, NULL, NULL); @@ -17205,7 +17205,7 @@ Crea una nuovo puntatore alla lista in hdata. Prototipo: -[source,C] +[source,c] ---- void weechat_hdata_new_list (struct t_hdata *hdata, const char *name, void *pointer, int flags); ---- @@ -17221,7 +17221,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- struct t_myplugin_list { @@ -17251,7 +17251,7 @@ weechat_hdata_new_list (hdata, "last_buffer", &last_buffer, 0); La macro "WEECHAT_HDATA_LIST" può essere usata per accorciare il codice: -[source,C] +[source,c] ---- WEECHAT_HDATA_LIST(buffers, WEECHAT_HDATA_LIST_CHECK_POINTERS); WEECHAT_HDATA_LIST(last_buffer, 0); @@ -17273,7 +17273,7 @@ un oggetto di WeeChat/plugin per leggere dei dati. Prototipo: -[source,C] +[source,c] ---- struct t_hdata *weechat_hdata_get (const char *hdata_name); ---- @@ -17294,7 +17294,7 @@ include::includes/autogen_api_hdata.it.adoc[tag=hdata] Esempio in C: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("irc_server"); ---- @@ -17318,7 +17318,7 @@ Restituisce l'offset della variabile in hdata. Prototipo: -[source,C] +[source,c] ---- int weechat_hdata_get_var_offset (struct t_hdata *hdata, const char *name); ---- @@ -17334,7 +17334,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int offset = weechat_hdata_get_var_offset (hdata, "name"); ---- @@ -17358,7 +17358,7 @@ Restituisce il tipo di variabile in hdata (come intero). Prototipo: -[source,C] +[source,c] ---- int weechat_hdata_get_var_type (struct t_hdata *hdata, const char *name); ---- @@ -17374,7 +17374,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int type = weechat_hdata_get_var_type (hdata, "name"); switch (type) @@ -17423,7 +17423,7 @@ Restituisce il tipo di variabile in hdata (come stringa). Prototipo: -[source,C] +[source,c] ---- const char *weechat_hdata_get_var_type_string (struct t_hdata *hdata, const char *name); ---- @@ -17439,7 +17439,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "type = %s", weechat_hdata_get_var_type_string (hdata, "name")); @@ -17465,7 +17465,7 @@ Return array size for variable in hdata. Prototipo: -[source,C] +[source,c] ---- int weechat_hdata_get_var_array_size (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17483,7 +17483,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- int array_size = weechat_hdata_get_var_array_size (hdata, pointer, "name"); ---- @@ -17508,7 +17508,7 @@ Return array size for variable in hdata (as string). Prototipo: -[source,C] +[source,c] ---- const char *weechat_hdata_get_var_array_size_string (struct t_hdata *hdata, void *pointer, const char *name); @@ -17528,7 +17528,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- const char *array_size = weechat_hdata_get_var_array_size_string (hdata, pointer, "name"); ---- @@ -17552,7 +17552,7 @@ Restituisce hdata per la variabile in hdata. Prototipo: -[source,C] +[source,c] ---- const char *weechat_hdata_get_var_hdata (struct t_hdata *hdata, const char *name); ---- @@ -17568,7 +17568,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "hdata = %s", weechat_hdata_get_var_hdata (hdata, "name")); ---- @@ -17592,7 +17592,7 @@ Restituisce il puntatore al contenuto della variabile in hdata. Prototipo: -[source,C] +[source,c] ---- void *weechat_hdata_get_var (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17609,7 +17609,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17627,7 +17627,7 @@ Restituisce il puntatore al contenuto della variabile in hdata, usando un offset Prototipo: -[source,C] +[source,c] ---- void *weechat_hdata_get_var_at_offset (struct t_hdata *hdata, void *pointer, int offset); ---- @@ -17644,7 +17644,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17663,7 +17663,7 @@ Restituisce il puntatore alla lista da hdata. Prototipo: -[source,C] +[source,c] ---- void *weechat_hdata_get_list (struct t_hdata *hdata, const char *name); ---- @@ -17679,7 +17679,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffers = weechat_hdata_get_list (hdata, "gui_buffers"); @@ -17706,7 +17706,7 @@ Verifica se un puntatore è valido per un hdata e un puntatore della lista. Prototipo: -[source,C] +[source,c] ---- int weechat_hdata_check_pointer (struct t_hdata *hdata, void *list, void *pointer); ---- @@ -17727,7 +17727,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- /* check if a buffer pointer is valid */ struct t_hdata *hdata = weechat_hdata_get ("buffer"); @@ -17768,7 +17768,7 @@ Sposta il puntatore ad un altro elemento nella lista. Prototipo: -[source,C] +[source,c] ---- void *weechat_hdata_move (struct t_hdata *hdata, void *pointer, int count); ---- @@ -17788,7 +17788,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17831,7 +17831,7 @@ in list, until element is found (or end of list). Prototipo: -[source,C] +[source,c] ---- void *weechat_hdata_search (struct t_hdata *hdata, void *pointer, const char *search, struct t_hashtable *pointers, struct t_hashtable *extra_vars, @@ -17873,7 +17873,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("irc_server"); void *servers = weechat_hdata_get_list (hdata, "irc_servers"); @@ -17923,7 +17923,7 @@ Restituisce il valore di una variabile char in una struttura dati usando hdata. Prototipo: -[source,C] +[source,c] ---- char weechat_hdata_char (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17943,7 +17943,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "letter = %c", weechat_hdata_char (hdata, pointer, "letter")); ---- @@ -17967,7 +17967,7 @@ Restituisce il valore di una variabile integer in una struttura dati usando hdat Prototipo: -[source,C] +[source,c] ---- int weechat_hdata_integer (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17987,7 +17987,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -18015,7 +18015,7 @@ Restituisce il valore della variabile long della struttura usando hdata. Prototipo: -[source,C] +[source,c] ---- long weechat_hdata_long (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -18035,7 +18035,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "longvar = %ld", weechat_hdata_long (hdata, pointer, "longvar")); ---- @@ -18059,7 +18059,7 @@ Restituisce il valore della variabile string nella struttura usando hdata. Prototipo: -[source,C] +[source,c] ---- const char *weechat_hdata_string (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -18079,7 +18079,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -18107,7 +18107,7 @@ Restituisce il valore della variabile puntatore nella struttura usando hdata. Prototipo: -[source,C] +[source,c] ---- void *weechat_hdata_pointer (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -18127,7 +18127,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -18155,7 +18155,7 @@ Restituisce il valore della variabile time nella struttura usando hdata. Prototipo: -[source,C] +[source,c] ---- time_t weechat_hdata_time (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -18175,7 +18175,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *ptr = weechat_buffer_search_main (); @@ -18226,7 +18226,7 @@ hdata. Prototipo: -[source,C] +[source,c] ---- struct t_hashtable *weechat_hdata_hashtable (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -18246,7 +18246,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -18280,7 +18280,7 @@ Compare a hdata variable of two objects. Prototipo: -[source,C] +[source,c] ---- int weechat_hdata_compare (struct t_hdata *hdata, void *pointer1, void *pointer2, const char *name, int case_sensitive); ---- @@ -18302,7 +18302,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer1 = weechat_buffer_search ("irc", "libera.#weechat"); @@ -18339,7 +18339,7 @@ if the variable can be updated. Prototipo: -[source,C] +[source,c] ---- int weechat_hdata_set (struct t_hdata *hdata, void *pointer, const char *name, const char *value); ---- @@ -18358,7 +18358,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_hdata_set (hdata, pointer, "message", "test"); ---- @@ -18375,7 +18375,7 @@ Update data in a hdata. Prototipo: -[source,C] +[source,c] ---- int weechat_hdata_update (struct t_hdata *hdata, void *pointer, struct t_hashtable *hashtable); ---- @@ -18402,7 +18402,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- /* subtract one hour on last message displayed in current buffer */ @@ -18462,7 +18462,7 @@ Restituisce il valore stringa di una proprietà di hdata. Prototipo: -[source,C] +[source,c] ---- const char *weechat_hdata_get_string (struct t_hdata *hdata, const char *property); ---- @@ -18494,7 +18494,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_printf (NULL, "variables in hdata: %s", weechat_hdata_get_string (hdata, "var_keys")); weechat_printf (NULL, "lists in hdata: %s", weechat_hdata_get_string (hdata, "list_keys")); @@ -18526,7 +18526,7 @@ Crea o legge un file per l'aggiornamento. Prototipo: -[source,C] +[source,c] ---- struct t_upgrade_file *upgrade_file_new (const char *filename, int (*callback_read)(const void *pointer, @@ -18565,7 +18565,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- struct t_upgrade_file *upgrade_file = weechat_upgrade_new ("my_file", NULL, NULL, NULL); @@ -18588,7 +18588,7 @@ Scrive un oggetto nel file di aggiornamento. Prototipo: -[source,C] +[source,c] ---- int weechat_upgrade_write_object (struct t_upgrade_file *upgrade_file, int object_id, @@ -18607,7 +18607,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- if (weechat_upgrade_write_object (upgrade_file, 1, &infolist)) { @@ -18639,7 +18639,7 @@ Legge un file di aggiornamento. Prototipo: -[source,C] +[source,c] ---- int weechat_upgrade_read (struct t_upgrade_file *upgrade_file); ---- @@ -18654,7 +18654,7 @@ Valore restituito: Esempio in C: -[source,C] +[source,c] ---- weechat_upgrade_read (upgrade_file); ---- @@ -18676,7 +18676,7 @@ Chiude un file di aggiornamento. Prototipo: -[source,C] +[source,c] ---- void weechat_upgrade_close (struct t_upgrade_file *upgrade_file); ---- @@ -18687,7 +18687,7 @@ Argomenti: Esempio in C: -[source,C] +[source,c] ---- weechat_upgrade_close (upgrade_file); ---- diff --git a/doc/it/weechat_user.it.adoc b/doc/it/weechat_user.it.adoc index afaf6d727..aceb0e2da 100644 --- a/doc/it/weechat_user.it.adoc +++ b/doc/it/weechat_user.it.adoc @@ -4143,7 +4143,7 @@ WebSocket if required headers are found in handshake and if origin is allowed A WebSocket can be opened in a HTML5 with a single line of JavaScript: -[source,js] +[source,javascript] ---- websocket = new WebSocket("ws://server.com:9000/weechat"); ---- diff --git a/doc/ja/weechat_dev.ja.adoc b/doc/ja/weechat_dev.ja.adoc index 5abdad3d9..3b3986999 100644 --- a/doc/ja/weechat_dev.ja.adoc +++ b/doc/ja/weechat_dev.ja.adoc @@ -555,7 +555,7 @@ WeeChat とプラグインの翻訳は gettext で行います、ファイルは ** 電子メールアドレス、 ** ライセンス。 -[source,C] +[source,c] ---- /* * weechat.c - core functions for WeeChat @@ -593,7 +593,7 @@ C 言語のコードを書く際には以下の基本的なルールを *必ず* 例: -[source,C] +[source,c] ---- /* * Checks if a string with boolean value is valid. @@ -624,7 +624,7 @@ foo () 例外: `for` ループのカウンタ変数に "i" や "n" を使うのは問題ありません。 * 関数内で行うローカル変数の初期化は宣言の後に行ってください、例: -[source,C] +[source,c] ---- void foo () @@ -642,7 +642,7 @@ foo () * 中括弧 `+{ }+` は制御文の次の行に単独で置き、制御文 (以下の `if` です) と同じ空白文字の数だけインデントしてください: -[source,C] +[source,c] ---- if (nicks_count == 1) { @@ -652,7 +652,7 @@ if (nicks_count == 1) * 関数内部でブロックを分けるには空行を使ってください、可能であればそれぞれのブロックにコメントを付けてください: -[source,C] +[source,c] ---- /* * Sends a message from out queue. @@ -695,7 +695,7 @@ irc_server_outqueue_send (struct t_irc_server *server) * `if` 条件はインデントし、演算子を含む条件は丸括弧で括ってください (単独のブール値を評価する場合は不要)、例: -[source,C] +[source,c] ---- if (something) { @@ -719,7 +719,7 @@ else * `switch` 文は以下の様にインデントしてください: -[source,C] +[source,c] ---- switch (string[0]) { @@ -737,7 +737,7 @@ switch (string[0]) * 関数プロトタイプには `typedef` を使い、構造体を使わないでください: -[source,C] +[source,c] ---- typedef int (t_hook_callback_fd)(void *data, int fd); @@ -819,7 +819,7 @@ _wee-command.c_ のヘッダファイルは _wee-command.h_ です 例: IRC のニックネーム (_src/plugins/irc/irc-nick.h_ より): -[source,C] +[source,c] ---- struct t_irc_nick { @@ -849,7 +849,7 @@ struct t_irc_nick 例: ウィンドウ (_src/gui/gui-window.c_ より): -[source,C] +[source,c] ---- struct t_gui_window *gui_windows = NULL; /* first window */ struct t_gui_window *last_gui_window = NULL; /* last window */ @@ -868,7 +868,7 @@ struct t_gui_window *gui_current_window = NULL; /* current window */ 例: 新しいウィンドウの作成 (_src/gui/gui-window.c_ より): -[source,C] +[source,c] ---- /* * Creates a new window. @@ -904,7 +904,7 @@ WeeChat のほとんどの連結リストは双方向連結リストです: 各 例: バッファのリスト (_src/gui/gui-buffer.h_ より): -[source,C] +[source,c] ---- struct t_gui_buffer { @@ -919,7 +919,7 @@ struct t_gui_buffer さらにリストの最初と最後を示す 2 つのポインタがあります: -[source,C] +[source,c] ---- struct t_gui_buffer *gui_buffers = NULL; /* first buffer */ struct t_gui_buffer *last_gui_buffer = NULL; /* last buffer */ @@ -1110,7 +1110,7 @@ API 関数を簡単に呼び出すためのマクロが定義されています 例えば、関数 _hook_timer_ は以下のように構造体 _t_weechat_plugin_ で定義されています: -[source,C] +[source,c] ---- struct t_hook *(*hook_timer) (struct t_weechat_plugin *plugin, long interval, @@ -1123,7 +1123,7 @@ struct t_hook *(*hook_timer) (struct t_weechat_plugin *plugin, この関数を呼び出すマクロは: -[source,C] +[source,c] ---- #define weechat_hook_timer(__interval, __align_second, __max_calls, \ __callback, __data) \ @@ -1134,7 +1134,7 @@ struct t_hook *(*hook_timer) (struct t_weechat_plugin *plugin, このため、プラグイン内での関数の呼び出しは以下の例の様に行います: -[source,C] +[source,c] ---- server->hook_timer_sasl = weechat_hook_timer (timeout * 1000, 0, 1, diff --git a/doc/ja/weechat_plugin_api.ja.adoc b/doc/ja/weechat_plugin_api.ja.adoc index 93ba54fe1..c12ecd7c4 100644 --- a/doc/ja/weechat_plugin_api.ja.adoc +++ b/doc/ja/weechat_plugin_api.ja.adoc @@ -51,7 +51,7 @@ WeeChat 関数を <<plugin_api>> に表示された書式で呼び出すには、以下のグローバルポインタを定義して <<_weechat_plugin_init,weechat_plugin_init>> 関数の中でそれを初期化しなければいけません: -[source,C] +[source,c] ---- struct t_weechat_plugin *weechat_plugin; ---- @@ -90,7 +90,7 @@ WeeChat はプラグインを読み込む際にこの関数を呼び出します プロトタイプ: -[source,C] +[source,c] ---- int weechat_plugin_init (struct t_weechat_plugin *plugin, int argc, char *argv[]); @@ -155,7 +155,7 @@ WeeChat プラグインをリロードする際にこの関数を呼び出しま プロトタイプ: -[source,C] +[source,c] ---- int weechat_plugin_end (struct t_weechat_plugin *plugin); ---- @@ -202,7 +202,7 @@ WeeChat の中で: 倍して現在のバッファに表示するか、コマンドを 2 回実行する (これは実用的なコマンドというよりも、ただの例です!): -[source,C] +[source,c] ---- #include <stdlib.h> @@ -316,7 +316,7 @@ This function is not available in the C API. プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_plugin_get_name (struct t_weechat_plugin *plugin); ---- @@ -331,7 +331,7 @@ const char *weechat_plugin_get_name (struct t_weechat_plugin *plugin); C 言語での使用例: -[source,C] +[source,c] ---- const char *name = weechat_plugin_get_name (plugin); ---- @@ -362,7 +362,7 @@ UTF-8 とロケールに準じて取り扱うようになっているからで プロトタイプ: -[source,C] +[source,c] ---- void weechat_charset_set (const char *charset); ---- @@ -373,7 +373,7 @@ void weechat_charset_set (const char *charset); C 言語での使用例: -[source,C] +[source,c] ---- weechat_charset_set ("iso-8859-1"); ---- @@ -395,7 +395,7 @@ weechat.charset_set("iso-8859-1") プロトタイプ: -[source,C] +[source,c] ---- char *weechat_iconv_to_internal (const char *charset, const char *string); ---- @@ -411,7 +411,7 @@ char *weechat_iconv_to_internal (const char *charset, const char *string); C 言語での使用例: -[source,C] +[source,c] ---- char *str = weechat_iconv_to_internal ("iso-8859-1", "iso string: é à"); /* ... */ @@ -435,7 +435,7 @@ str = weechat.iconv_to_internal("iso-8859-1", "iso string: é à") プロトタイプ: -[source,C] +[source,c] ---- char *weechat_iconv_from_internal (const char *charset, const char *string); ---- @@ -451,7 +451,7 @@ char *weechat_iconv_from_internal (const char *charset, const char *string); C 言語での使用例: -[source,C] +[source,c] ---- char *str = weechat_iconv_from_internal ("iso-8859-1", "utf-8 string: é à"); /* ... */ @@ -475,7 +475,7 @@ str = weechat.iconv_from_internal("iso-8859-1", "utf-8 string: é à") プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_gettext (const char *string); ---- @@ -490,7 +490,7 @@ const char *weechat_gettext (const char *string); C 言語での使用例: -[source,C] +[source,c] ---- char *str = weechat_gettext ("hello"); ---- @@ -513,7 +513,7 @@ _count_ プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_ngettext (const char *string, const char *plural, int count); @@ -533,7 +533,7 @@ const char *weechat_ngettext (const char *string, const char *plural, C 言語での使用例: -[source,C] +[source,c] ---- char *str = weechat_ngettext ("file", "files", num_files); ---- @@ -556,7 +556,7 @@ str = weechat.ngettext("file", "files", num_files) プロトタイプ: -[source,C] +[source,c] ---- char *weechat_strndup (const char *string, int length); ---- @@ -572,7 +572,7 @@ char *weechat_strndup (const char *string, int length); C 言語での使用例: -[source,C] +[source,c] ---- char *str = weechat_strndup ("abcdef", 3); /* result: "abc" */ /* ... */ @@ -592,7 +592,7 @@ string if it is cut. プロトタイプ: -[source,C] +[source,c] ---- char *weechat_string_cut (const char *string, int length, int count_suffix, int screen, const char *cut_suffix); ---- @@ -611,7 +611,7 @@ char *weechat_string_cut (const char *string, int length, int count_suffix, int C 言語での使用例: -[source,C] +[source,c] ---- char *str = weechat_string_cut ("this is a test", 5, 1, 1, "…"); /* result: "this…" */ /* ... */ @@ -627,7 +627,7 @@ UTF-8 文字列を小文字に変換。 プロトタイプ: -[source,C] +[source,c] ---- void weechat_string_tolower (char *string); ---- @@ -638,7 +638,7 @@ void weechat_string_tolower (char *string); C 言語での使用例: -[source,C] +[source,c] ---- char str[] = "AbCdé"; weechat_string_tolower (str); /* str is now: "abcdé" */ @@ -653,7 +653,7 @@ UTF-8 文字列を大文字に変換。 プロトタイプ: -[source,C] +[source,c] ---- void weechat_string_toupper (char *string); ---- @@ -664,7 +664,7 @@ void weechat_string_toupper (char *string); C 言語での使用例: -[source,C] +[source,c] ---- char str[] = "AbCdé"; weechat_string_toupper (str); /* str is now: "ABCDé" */ @@ -681,7 +681,7 @@ _WeeChat バージョン 1.0 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_strcasecmp (const char *string1, const char *string2); ---- @@ -699,7 +699,7 @@ int weechat_strcasecmp (const char *string1, const char *string2); C 言語での使用例: -[source,C] +[source,c] ---- int diff = weechat_strcasecmp ("aaa", "CCC"); /* == -2 */ ---- @@ -715,7 +715,7 @@ _WeeChat バージョン 0.3.7 以上で利用可、バージョン 1.0 で更 プロトタイプ: -[source,C] +[source,c] ---- int weechat_strcasecmp_range (const char *string1, const char *string2, int range); ---- @@ -740,7 +740,7 @@ int weechat_strcasecmp_range (const char *string1, const char *string2, int rang C 言語での使用例: -[source,C] +[source,c] ---- int diff = weechat_strcasecmp_range ("nick{away}", "NICK[away]", 29); /* == 0 */ ---- @@ -756,7 +756,7 @@ _WeeChat バージョン 1.0 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_strncasecmp (const char *string1, const char *string2, int max); ---- @@ -775,7 +775,7 @@ int weechat_strncasecmp (const char *string1, const char *string2, int max); C 言語での使用例: -[source,C] +[source,c] ---- int diff = weechat_strncasecmp ("aabb", "aacc", 2); /* == 0 */ ---- @@ -792,7 +792,7 @@ _max_ 文字だけ文字列を比較。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_strncasecmp_range (const char *string1, const char *string2, int max, int range); ---- @@ -818,7 +818,7 @@ int weechat_strncasecmp_range (const char *string1, const char *string2, int max C 言語での使用例: -[source,C] +[source,c] ---- int diff = weechat_strncasecmp_range ("nick{away}", "NICK[away]", 6, 29); /* == 0 */ ---- @@ -835,7 +835,7 @@ _WeeChat バージョン 1.0 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_strcmp_ignore_chars (const char *string1, const char *string2, const char *chars_ignored, @@ -857,7 +857,7 @@ int weechat_strcmp_ignore_chars (const char *string1, const char *string2, C 言語での使用例: -[source,C] +[source,c] ---- int diff = weechat_strcmp_ignore_chars ("a-b", "--a-e", "-", 1); /* == -3 */ ---- @@ -873,7 +873,7 @@ _WeeChat バージョン 1.3 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_strcasestr (const char *string, const char *search); ---- @@ -890,7 +890,7 @@ const char *weechat_strcasestr (const char *string, const char *search); C 言語での使用例: -[source,C] +[source,c] ---- const char *pos = weechat_strcasestr ("aBcDeF", "de"); /* result: pointer to "DeF" */ ---- @@ -908,7 +908,7 @@ UTF-8 文字列を画面上に表示するために必要な画面幅を返す プロトタイプ: -[source,C] +[source,c] ---- int weechat_strlen_screen (const char *string); ---- @@ -923,7 +923,7 @@ int weechat_strlen_screen (const char *string); C 言語での使用例: -[source,C] +[source,c] ---- int length_on_screen = weechat_strlen_screen ("é"); /* == 1 */ ---- @@ -947,7 +947,7 @@ _WeeChat バージョン 1.0 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_string_match (const char *string, const char *mask, int case_sensitive); @@ -970,7 +970,7 @@ WeeChat バージョン 1.0 以上の場合、ワイルドカードをマスク C 言語での使用例: -[source,C] +[source,c] ---- int match1 = weechat_string_match ("abcdef", "abc*", 0); /* == 1 */ int match2 = weechat_string_match ("abcdef", "*dd*", 0); /* == 0 */ @@ -1004,7 +1004,7 @@ _WeeChat バージョン 2.5 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_string_match_list (const char *string, const char **masks, int case_sensitive); @@ -1026,7 +1026,7 @@ int weechat_string_match_list (const char *string, const char **masks, C 言語での使用例: -[source,C] +[source,c] ---- const char *masks[3] = { "*", "!abc*", NULL }; int match1 = weechat_string_match_list ("abc", masks, 0); /* == 0 */ @@ -1056,7 +1056,7 @@ _WeeChat バージョン 0.3.3 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- char *weechat_string_expand_home (const char *path); ---- @@ -1072,7 +1072,7 @@ char *weechat_string_expand_home (const char *path); C 言語での使用例: -[source,C] +[source,c] ---- char *str = weechat_string_expand_home ("~/file.txt"); /* result: "/home/user/file.txt" */ @@ -1099,7 +1099,7 @@ _WeeChat ≥ 1.3, updated in 3.2._ プロトタイプ: -[source,C] +[source,c] ---- char *weechat_string_eval_path_home (const char *path, struct t_hashtable *pointers, @@ -1130,7 +1130,7 @@ char *weechat_string_eval_path_home (const char *path, C 言語での使用例: -[source,C] +[source,c] ---- char *str = weechat_string_eval_path_home ("${weechat_config_dir}/test.conf", NULL, NULL, NULL); /* result: "/home/user/.config/weechat/test.conf" */ @@ -1157,7 +1157,7 @@ path = weechat.string_eval_path_home("${weechat_config_dir}/test.conf", {}, {}, プロトタイプ: -[source,C] +[source,c] ---- char *weechat_string_remove_quotes (const char *string, const char *quotes); ---- @@ -1174,7 +1174,7 @@ char *weechat_string_remove_quotes (const char *string, const char *quotes); C 言語での使用例: -[source,C] +[source,c] ---- char *str = weechat_string_remove_quotes (string, " 'I can't' ", "'"); /* result: "I can't" */ @@ -1191,7 +1191,7 @@ free (str); プロトタイプ: -[source,C] +[source,c] ---- char *weechat_string_strip (const char *string, int left, int right, const char *chars); @@ -1210,7 +1210,7 @@ char *weechat_string_strip (const char *string, int left, int right, C 言語での使用例: -[source,C] +[source,c] ---- char *str = weechat_string_strip (".abc -", 0, 1, "- ."); /* result: ".abc" */ /* ... */ @@ -1243,7 +1243,7 @@ _WeeChat バージョン 1.0 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- char *weechat_string_convert_escaped_chars (const char *string); ---- @@ -1259,7 +1259,7 @@ char *weechat_string_convert_escaped_chars (const char *string); C 言語での使用例: -[source,C] +[source,c] ---- char *str = weechat_string_convert_escaped_chars ("snowman: \\u2603"); /* str == "snowman: ☃" */ @@ -1277,7 +1277,7 @@ free (str); プロトタイプ: -[source,C] +[source,c] ---- char *weechat_string_mask_to_regex (const char *mask); ---- @@ -1292,7 +1292,7 @@ char *weechat_string_mask_to_regex (const char *mask); C 言語での使用例: -[source,C] +[source,c] ---- char *str_regex = weechat_string_mask_to_regex ("test*mask"); /* result: "test.*mask" */ @@ -1319,7 +1319,7 @@ _WeeChat バージョン 0.3.7 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_string_regex_flags (const char *regex, int default_flags, int *flags) ---- @@ -1351,7 +1351,7 @@ const char *weechat_string_regex_flags (const char *regex, int default_flags, in C 言語での使用例: -[source,C] +[source,c] ---- const char *regex = "(?i)test"; int flags; @@ -1372,7 +1372,7 @@ _WeeChat バージョン 0.3.7 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_string_regcomp (void *preg, const char *regex, int default_flags) ---- @@ -1399,7 +1399,7 @@ if the function returned 0 (OK). C 言語での使用例: -[source,C] +[source,c] ---- regex_t my_regex; if (weechat_string_regcomp (&my_regex, "(?i)test", REG_EXTENDED) == 0) @@ -1424,7 +1424,7 @@ else プロトタイプ: -[source,C] +[source,c] ---- int weechat_string_has_highlight (const char *string, const char highlight_words); @@ -1441,7 +1441,7 @@ int weechat_string_has_highlight (const char *string, C 言語での使用例: -[source,C] +[source,c] ---- int hl = weechat_string_has_highlight ("my test string", "test,word2"); /* == 1 */ ---- @@ -1468,7 +1468,7 @@ POSIX 拡張正規表現を使って、文字列中から正規表現にマッ プロトタイプ: -[source,C] +[source,c] ---- int weechat_string_has_highlight_regex (const char *string, const char *regex); ---- @@ -1484,7 +1484,7 @@ int weechat_string_has_highlight_regex (const char *string, const char *regex); C 言語での使用例: -[source,C] +[source,c] ---- int hl = weechat_string_has_highlight_regex ("my test string", "test|word2"); /* == 1 */ ---- @@ -1506,7 +1506,7 @@ highlight = weechat.string_has_highlight_regex("my test string", "test|word2") プロトタイプ: -[source,C] +[source,c] ---- char *weechat_string_replace (const char *string, const char *search, const char *replace); @@ -1525,7 +1525,7 @@ char *weechat_string_replace (const char *string, const char *search, C 言語での使用例: -[source,C] +[source,c] ---- char *str = weechat_string_replace ("test", "s", "x"); /* result: "text" */ /* ... */ @@ -1543,7 +1543,7 @@ _WeeChat バージョン 1.0 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- char *weechat_string_replace_regex (const char *string, void *regex, const char *replace, const char reference_char, @@ -1579,7 +1579,7 @@ char *weechat_string_replace_regex (const char *string, void *regex, C 言語での使用例: -[source,C] +[source,c] ---- regex_t my_regex; char *string; @@ -1606,7 +1606,7 @@ _WeeChat バージョン 2.5、2.6 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- char **weechat_string_split (const char *string, const char *separators, const char *strip_items, int flags, @@ -1652,7 +1652,7 @@ WeeChat バージョン 2.4 以下で _keep_eol_ とされていた引数は現 C 言語での使用例: -[source,C] +[source,c] ---- char **argv; int argc; @@ -1736,7 +1736,7 @@ Lib/shlex.py)、参照: https://docs.python.org/3/library/shlex.html 。 プロトタイプ: -[source,C] +[source,c] ---- char **weechat_string_split_shell (const char *string, int *num_items); ---- @@ -1753,7 +1753,7 @@ char **weechat_string_split_shell (const char *string, int *num_items); C 言語での使用例: -[source,C] +[source,c] ---- char **argv; int argc; @@ -1776,7 +1776,7 @@ weechat_string_free_split (argv); プロトタイプ: -[source,C] +[source,c] ---- void weechat_string_free_split (char **split_string); ---- @@ -1788,7 +1788,7 @@ void weechat_string_free_split (char **split_string); C 言語での使用例: -[source,C] +[source,c] ---- char *argv; int argc; @@ -1806,7 +1806,7 @@ weechat_string_free_split (argv); プロトタイプ: -[source,C] +[source,c] ---- char *weechat_string_build_with_split_string (char **split_string, const char *separator); @@ -1824,7 +1824,7 @@ char *weechat_string_build_with_split_string (char **split_string, C 言語での使用例: -[source,C] +[source,c] ---- char **argv; int argc; @@ -1845,7 +1845,7 @@ _separator_ でコマンドのリストを分割 プロトタイプ: -[source,C] +[source,c] ---- char **weechat_string_split_command (const char *command, char separator); ---- @@ -1862,7 +1862,7 @@ char **weechat_string_split_command (const char *command, char separator); C 言語での使用例: -[source,C] +[source,c] ---- char **argv = weechat_string_split_command ("/command1 arg;/command2", ';'); /* result: argv[0] == "/command1 arg" @@ -1881,7 +1881,7 @@ weechat_free_split_command (argv); プロトタイプ: -[source,C] +[source,c] ---- void weechat_string_free_split_command (char **split_command); ---- @@ -1893,7 +1893,7 @@ void weechat_string_free_split_command (char **split_command); C 言語での使用例: -[source,C] +[source,c] ---- char **argv = weechat_string_split_command ("/command1 arg;/command2", ';'); /* ... */ @@ -1909,7 +1909,7 @@ weechat_free_split_command (argv); プロトタイプ: -[source,C] +[source,c] ---- char *weechat_string_format_size (unsigned long long size); ---- @@ -1924,7 +1924,7 @@ char *weechat_string_format_size (unsigned long long size); C 言語での使用例: -[source,C] +[source,c] ---- /* examples with English locale */ @@ -1970,7 +1970,7 @@ the string. プロトタイプ: -[source,C] +[source,c] ---- int weechat_string_color_code_size (const char *string); ---- @@ -1989,7 +1989,7 @@ int weechat_string_color_code_size (const char *string); C 言語での使用例: -[source,C] +[source,c] ---- int size; @@ -2017,7 +2017,7 @@ size = weechat.string_color_code_size(weechat.color("yellow,red")) # size == 7 プロトタイプ: -[source,C] +[source,c] ---- char *weechat_string_remove_color (const char *string, const char *replacement); @@ -2036,7 +2036,7 @@ char *weechat_string_remove_color (const char *string, C 言語での使用例: -[source,C] +[source,c] ---- /* remove color codes */ char *str = weechat_string_remove_color (my_string1, NULL); @@ -2069,7 +2069,7 @@ base 16、32、64 で文字列をエンコード。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_string_base_encode (int base, const char *from, int length, char *to); ---- @@ -2088,7 +2088,7 @@ int weechat_string_base_encode (int base, const char *from, int length, char *to C 言語での使用例: -[source,C] +[source,c] ---- char *string = "abcdefgh", result[128]; int length; @@ -2111,7 +2111,7 @@ base 16、32、64 でエンコードされた文字列をデコード。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_string_base_decode (int base, const char *from, char *to); ---- @@ -2129,7 +2129,7 @@ int weechat_string_base_decode (int base, const char *from, char *to); C 言語での使用例: -[source,C] +[source,c] ---- char result[128]; int length; @@ -2152,7 +2152,7 @@ _WeeChat バージョン 1.4 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- char *string_hex_dump (const char *data, int data_size, int bytes_per_line, const char *prefix, const char *suffix); @@ -2174,7 +2174,7 @@ char *string_hex_dump (const char *data, int data_size, int bytes_per_line, C 言語での使用例: -[source,C] +[source,c] ---- char *string = "abc def-ghi"; char *dump = weechat_string_hex_dump (string, strlen (string), 8, " >> ", NULL); @@ -2193,7 +2193,7 @@ _WeeChat バージョン 0.3.2 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_string_is_command_char (const char *string); ---- @@ -2208,7 +2208,7 @@ int weechat_string_is_command_char (const char *string); C 言語での使用例: -[source,C] +[source,c] ---- int command_char1 = weechat_string_is_command_char ("/test"); /* == 1 */ int command_char2 = weechat_string_is_command_char ("test"); /* == 0 */ @@ -2235,7 +2235,7 @@ _WeeChat バージョン 0.3.2 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_string_input_for_buffer (const char *string); ---- @@ -2250,7 +2250,7 @@ const char *weechat_string_input_for_buffer (const char *string); C 言語での使用例: -[source,C] +[source,c] ---- const char *str1 = weechat_string_input_for_buffer ("test"); /* "test" */ const char *str2 = weechat_string_input_for_buffer ("/test"); /* NULL */ @@ -2285,7 +2285,7 @@ WeeChat バージョン 1.0 以上の場合、入れ子変数を使えるよう プロトタイプ: -[source,C] +[source,c] ---- char *weechat_string_eval_expression (const char *expr, struct t_hashtable *pointers, @@ -2335,7 +2335,7 @@ char *weechat_string_eval_expression (const char *expr, C 言語での使用例: -[source,C] +[source,c] ---- /* 条件式の評価 */ struct t_hashtable *options1 = weechat_hashtable_new (8, @@ -2968,7 +2968,7 @@ _WeeChat バージョン 1.8 以上で利用可_ プロトタイプ: -[source,C] +[source,c] ---- char **weechat_string_dyn_alloc (int size_alloc); ---- @@ -2983,7 +2983,7 @@ char **weechat_string_dyn_alloc (int size_alloc); C 言語での使用例: -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); ---- @@ -3002,7 +3002,7 @@ _WeeChat バージョン 1.8 以上で利用可_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_string_dyn_copy (char **string, const char *new_string); ---- @@ -3018,7 +3018,7 @@ int weechat_string_dyn_copy (char **string, const char *new_string); C 言語での使用例: -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); if (weechat_string_dyn_copy (string, "test")) @@ -3046,7 +3046,7 @@ _WeeChat バージョン 1.8 以上で利用可, updated in 3.0_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_string_dyn_concat (char **string, const char *add, int bytes); ---- @@ -3066,7 +3066,7 @@ int weechat_string_dyn_concat (char **string, const char *add, int bytes); C 言語での使用例: -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); if (weechat_string_dyn_copy (string, "test")) @@ -3089,7 +3089,7 @@ _WeeChat バージョン 1.8 以上で利用可_ プロトタイプ: -[source,C] +[source,c] ---- char *weechat_string_dyn_free (char **string, int free_string); ---- @@ -3106,7 +3106,7 @@ char *weechat_string_dyn_free (char **string, int free_string); C 言語での使用例: -[source,C] +[source,c] ---- char **string = weechat_string_dyn_alloc (256); if (weechat_string_dyn_concat (string, "test")) @@ -3135,7 +3135,7 @@ UTF-8 文字列関数。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_utf8_has_8bits (const char *string); ---- @@ -3150,7 +3150,7 @@ int weechat_utf8_has_8bits (const char *string); C 言語での使用例: -[source,C] +[source,c] ---- if (weechat_utf8_has_8bits (string)) { @@ -3169,7 +3169,7 @@ _WeeChat バージョン 1.4 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_utf8_is_valid (const char *string, int length, char **error); ---- @@ -3188,7 +3188,7 @@ int weechat_utf8_is_valid (const char *string, int length, char **error); C 言語での使用例: -[source,C] +[source,c] ---- char *error; if (weechat_utf8_is_valid (string, -1, &error)) @@ -3210,7 +3210,7 @@ UTF-8 文字列を正規化: 非 UTF-8 文字を削除し、これらを文字 プロトタイプ: -[source,C] +[source,c] ---- void weechat_utf8_normalize (char *string, char replacement); ---- @@ -3222,7 +3222,7 @@ void weechat_utf8_normalize (char *string, char replacement); C 言語での使用例: -[source,C] +[source,c] ---- weechat_utf8_normalize (string, '?'); ---- @@ -3238,7 +3238,7 @@ _WeeChat バージョン 1.3 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_utf8_prev_char (const char *string_start, const char *string); @@ -3257,7 +3257,7 @@ const char *weechat_utf8_prev_char (const char *string_start, C 言語での使用例: -[source,C] +[source,c] ---- const char *prev_char = weechat_utf8_prev_char (string, ptr_in_string); ---- @@ -3273,7 +3273,7 @@ _WeeChat バージョン 1.3 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_utf8_next_char (const char *string); ---- @@ -3289,7 +3289,7 @@ const char *weechat_utf8_next_char (const char *string); C 言語での使用例: -[source,C] +[source,c] ---- const char *next_char = weechat_utf8_next_char (string); ---- @@ -3303,7 +3303,7 @@ UTF-8 文字を整数で返す。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_utf8_char_int (const char *string); ---- @@ -3318,7 +3318,7 @@ int weechat_utf8_char_int (const char *string); C 言語での使用例: -[source,C] +[source,c] ---- int char_int = weechat_utf8_char_int ("être"); /* "ê" as integer */ ---- @@ -3332,7 +3332,7 @@ UTF-8 文字のサイズを返す (バイト単位)。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_utf8_char_size (const char *string); ---- @@ -3347,7 +3347,7 @@ int weechat_utf8_char_size (const char *string); C 言語での使用例: -[source,C] +[source,c] ---- int char_size = weechat_utf8_char_size ("être"); /* == 2 */ ---- @@ -3361,7 +3361,7 @@ UTF-8 文字の長さを返す (UTF-8 文字の個数)。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_utf8_strlen (const char *string); ---- @@ -3376,7 +3376,7 @@ int weechat_utf8_strlen (const char *string); C 言語での使用例: -[source,C] +[source,c] ---- int length = weechat_utf8_strlen ("chêne"); /* == 5 */ ---- @@ -3390,7 +3390,7 @@ int length = weechat_utf8_strlen ("chêne"); /* == 5 */ プロトタイプ: -[source,C] +[source,c] ---- int weechat_utf8_strnlen (const char *string, int bytes); ---- @@ -3406,7 +3406,7 @@ int weechat_utf8_strnlen (const char *string, int bytes); C 言語での使用例: -[source,C] +[source,c] ---- int length = weechat_utf8_strnlen ("chêne", 4); /* == 3 */ ---- @@ -3420,7 +3420,7 @@ UTF-8 文字列を画面上に表示するために必要な画面幅を返す プロトタイプ: -[source,C] +[source,c] ---- int weechat_utf8_strlen_screen (const char *string); ---- @@ -3435,7 +3435,7 @@ int weechat_utf8_strlen_screen (const char *string); C 言語での使用例: -[source,C] +[source,c] ---- int length_on_screen = weechat_utf8_strlen_screen ("é"); /* == 1 */ ---- @@ -3451,7 +3451,7 @@ _WeeChat バージョン 1.0 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_utf8_charcmp (const char *string1, const char *string2); ---- @@ -3469,7 +3469,7 @@ int weechat_utf8_charcmp (const char *string1, const char *string2); C 言語での使用例: -[source,C] +[source,c] ---- int diff = weechat_utf8_charcmp ("aaa", "ccc"); /* == -2 */ ---- @@ -3485,7 +3485,7 @@ _WeeChat バージョン 1.0 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_utf8_charcasecmp (const char *string1, const char *string2); ---- @@ -3503,7 +3503,7 @@ int weechat_utf8_charcasecmp (const char *string1, const char *string2); C 言語での使用例: -[source,C] +[source,c] ---- int diff = weechat_utf8_charcasecmp ("aaa", "CCC"); /* == -2 */ ---- @@ -3517,7 +3517,7 @@ UTF-8 文字を画面上に表示するために必要な画面幅を返す。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_utf8_char_size_screen (const char *string); ---- @@ -3532,7 +3532,7 @@ int weechat_utf8_char_size_screen (const char *string); C 言語での使用例: -[source,C] +[source,c] ---- int length_on_screen = weechat_utf8_char_size_screen ("é"); /* == 1 */ ---- @@ -3548,7 +3548,7 @@ UTF-8 文字列で N 文字前に進む。 プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_utf8_add_offset (const char *string, int offset); ---- @@ -3565,7 +3565,7 @@ const char *weechat_utf8_add_offset (const char *string, int offset); C 言語での使用例: -[source,C] +[source,c] ---- const char *str = "chêne"; const char *str2 = weechat_utf8_add_offset (str, 3); /* points to "ne" */ @@ -3580,7 +3580,7 @@ UTF-8 文字列中の真の位置を返す。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_utf8_real_pos (const char *string, int pos); ---- @@ -3596,7 +3596,7 @@ int weechat_utf8_real_pos (const char *string, int pos); C 言語での使用例: -[source,C] +[source,c] ---- int pos = weechat_utf8_real_pos ("chêne", 3); /* == 4 */ ---- @@ -3610,7 +3610,7 @@ UTF-8 文字列中の位置を返す。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_utf8_pos (const char *string, int real_pos); ---- @@ -3626,7 +3626,7 @@ int weechat_utf8_pos (const char *string, int real_pos); C 言語での使用例: -[source,C] +[source,c] ---- int pos = weechat_utf8_pos ("chêne", 4); /* == 3 */ ---- @@ -3640,7 +3640,7 @@ int pos = weechat_utf8_pos ("chêne", 4); /* == 3 */ プロトタイプ: -[source,C] +[source,c] ---- char *weechat_utf8_strndup (const char *string, int length); ---- @@ -3656,7 +3656,7 @@ char *weechat_utf8_strndup (const char *string, int length); C 言語での使用例: -[source,C] +[source,c] ---- char *string = weechat_utf8_strndup ("chêne", 3); /* returns "chê" */ /* ... */ @@ -3681,7 +3681,7 @@ Compute hash of data. プロトタイプ: -[source,C] +[source,c] ---- int weechat_crypto_hash (const void *data, int data_size, const char *hash_algo, void *hash, int *hash_size); @@ -3722,7 +3722,7 @@ Supported hash algorithms: C 言語での使用例: -[source,C] +[source,c] ---- const char *data = "abcdefghijklmnopqrstuvwxyz"; char hash[256 / 8]; @@ -3744,7 +3744,7 @@ of data. プロトタイプ: -[source,C] +[source,c] ---- int weechat_crypto_hash_pbkdf2 (const void *data, int data_size, const char *hash_algo, @@ -3774,7 +3774,7 @@ int weechat_crypto_hash_pbkdf2 (const void *data, int data_size, C 言語での使用例: -[source,C] +[source,c] ---- const char *data = "abcdefghijklmnopqrstuvwxyz"; const char *salt = "12345678901234567890123456789012"; /* 32 bytes */ @@ -3798,7 +3798,7 @@ Compute keyed-hash message authentication code (HMAC). プロトタイプ: -[source,C] +[source,c] ---- int weechat_crypto_hmac (const void *key, int key_size, const void *message, int message_size, int hash_algo, void *hash, int *hash_size); @@ -3824,7 +3824,7 @@ int weechat_crypto_hmac (const void *key, int key_size, const void *message, int C 言語での使用例: -[source,C] +[source,c] ---- const char *key = "the key"; const char *message = "the message"; @@ -3851,7 +3851,7 @@ WeeChat ホームディレクトリの下にディレクトリを作成。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_mkdir_home (char *directory, int mode); ---- @@ -3873,7 +3873,7 @@ int weechat_mkdir_home (char *directory, int mode); C 言語での使用例: -[source,C] +[source,c] ---- if (!weechat_mkdir_home ("${weechat_cache_dir}/temp", 0755)) { @@ -3898,7 +3898,7 @@ weechat.mkdir_home("${weechat_cache_dir}/temp", 0755) プロトタイプ: -[source,C] +[source,c] ---- int weechat_mkdir (char *directory, int mode); ---- @@ -3914,7 +3914,7 @@ int weechat_mkdir (char *directory, int mode); C 言語での使用例: -[source,C] +[source,c] ---- if (!weechat_mkdir ("/tmp/mydir", 0755)) { @@ -3939,7 +3939,7 @@ weechat.mkdir("/tmp/mydir", 0755) プロトタイプ: -[source,C] +[source,c] ---- int weechat_mkdir_parents (char *directory, int mode); ---- @@ -3955,7 +3955,7 @@ int weechat_mkdir_parents (char *directory, int mode); C 言語での使用例: -[source,C] +[source,c] ---- if (!weechat_mkdir_parents ("/tmp/my/dir", 0755)) { @@ -3982,7 +3982,7 @@ _WeeChat バージョン 1.5 と 2.0 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- void weechat_exec_on_files (const char *directory, int recurse_subdirs, @@ -4004,7 +4004,7 @@ void weechat_exec_on_files (const char *directory, C 言語での使用例: -[source,C] +[source,c] ---- void callback (void *data, const char *filename) { @@ -4025,7 +4025,7 @@ _WeeChat バージョン 0.3.1 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- char *weechat_file_get_content (const char *filename); ---- @@ -4040,7 +4040,7 @@ char *weechat_file_get_content (const char *filename); C 言語での使用例: -[source,C] +[source,c] ---- char *content; @@ -4061,7 +4061,7 @@ Copy a file to another location. プロトタイプ: -[source,C] +[source,c] ---- int weechat_file_copy (const char *from, const char *to); ---- @@ -4077,7 +4077,7 @@ int weechat_file_copy (const char *from, const char *to); C 言語での使用例: -[source,C] +[source,c] ---- if (weechat_file_copy ("/tmp/test.txt", "/path/to/test2.txt")) { @@ -4099,7 +4099,7 @@ if (weechat_file_copy ("/tmp/test.txt", "/path/to/test2.txt")) プロトタイプ: -[source,C] +[source,c] ---- int weechat_util_timeval_cmp (struct timeval *tv1, struct timeval *tv2); ---- @@ -4117,7 +4117,7 @@ int weechat_util_timeval_cmp (struct timeval *tv1, struct timeval *tv2); C 言語での使用例: -[source,C] +[source,c] ---- if (weechat_util_timeval_cmp (&tv1, &tv2) > 0) { @@ -4136,7 +4136,7 @@ _WeeChat バージョン 1.1 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- long long weechat_util_timeval_diff (struct timeval *tv1, struct timeval *tv2); ---- @@ -4155,7 +4155,7 @@ WeeChat バージョン 1.0 以前の場合、戻り値の単位はミリ秒で C 言語での使用例: -[source,C] +[source,c] ---- long long diff = weechat_util_timeval_diff (&tv1, &tv2); ---- @@ -4171,7 +4171,7 @@ timeval 構造体に時間間隔を追加 (マイクロ秒単位)。 プロトタイプ: -[source,C] +[source,c] ---- void weechat_util_timeval_add (struct timeval *tv, long long interval); ---- @@ -4186,7 +4186,7 @@ WeeChat バージョン 1.0 以前の場合、時間間隔の単位はミリ秒 C 言語での使用例: -[source,C] +[source,c] ---- weechat_util_timeval_add (&tv, 2000000); /* add 2 seconds */ ---- @@ -4203,7 +4203,7 @@ _weechat.look.time_format_ で定義されています。 プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_util_get_time_string (const time_t *date); ---- @@ -4218,7 +4218,7 @@ const char *weechat_util_get_time_string (const time_t *date); C 言語での使用例: -[source,C] +[source,c] ---- time_t date = time (NULL); weechat_printf (NULL, "date: %s", @@ -4236,7 +4236,7 @@ WeeChat バージョンの文字列を番号に変換。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_util_version_number (const char *version); ---- @@ -4247,7 +4247,7 @@ int weechat_util_version_number (const char *version); C 言語での使用例: -[source,C] +[source,c] ---- version_number = weechat_util_version_number ("0.3.8"); /* == 0x00030800 */ version_number = weechat_util_version_number ("0.3.9-dev"); /* == 0x00030900 */ @@ -4269,7 +4269,7 @@ version_number = weechat_util_version_number ("0.3.9"); /* == 0x00030900 */ プロトタイプ: -[source,C] +[source,c] ---- struct t_weelist *weechat_list_new (); ---- @@ -4280,7 +4280,7 @@ struct t_weelist *weechat_list_new (); C 言語での使用例: -[source,C] +[source,c] ---- struct t_weelist *list = weechat_list_new (); ---- @@ -4302,7 +4302,7 @@ list = weechat.list_new() プロトタイプ: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_add (struct t_weelist *weelist, const char *data, @@ -4326,7 +4326,7 @@ struct t_weelist_item *weechat_list_add (struct t_weelist *weelist, C 言語での使用例: -[source,C] +[source,c] ---- struct t_weelist_item *my_item = weechat_list_add (list, "my data", WEECHAT_LIST_POS_SORT, NULL); @@ -4349,7 +4349,7 @@ item = weechat.list_add(list, "my data", weechat.WEECHAT_LIST_POS_SORT, "") プロトタイプ: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_search (struct t_weelist *weelist, const char *data); @@ -4366,7 +4366,7 @@ struct t_weelist_item *weechat_list_search (struct t_weelist *weelist, C 言語での使用例: -[source,C] +[source,c] ---- struct t_weelist_item *item = weechat_list_search (list, "my data"); ---- @@ -4390,7 +4390,7 @@ _WeeChat バージョン 0.3.4 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_list_search_pos (struct t_weelist *weelist, const char *data); @@ -4407,7 +4407,7 @@ int weechat_list_search_pos (struct t_weelist *weelist, C 言語での使用例: -[source,C] +[source,c] ---- int pos_item = weechat_list_search_pos (list, "my data"); ---- @@ -4429,7 +4429,7 @@ pos_item = weechat.list_search_pos(list, "my data") プロトタイプ: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_casesearch (struct t_weelist *weelist, const char *data); @@ -4446,7 +4446,7 @@ struct t_weelist_item *weechat_list_casesearch (struct t_weelist *weelist, C 言語での使用例: -[source,C] +[source,c] ---- struct t_weelist_item *item = weechat_list_casesearch (list, "my data"); ---- @@ -4470,7 +4470,7 @@ _WeeChat バージョン 0.3.4 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_list_casesearch_pos (struct t_weelist *weelist, const char *data); @@ -4487,7 +4487,7 @@ int weechat_list_casesearch_pos (struct t_weelist *weelist, C 言語での使用例: -[source,C] +[source,c] ---- int pos_item = weechat_list_casesearch_pos (list, "my data"); ---- @@ -4509,7 +4509,7 @@ pos_item = weechat.list_casesearch_pos(list, "my data") プロトタイプ: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_get (struct t_weelist *weelist, int position); @@ -4526,7 +4526,7 @@ struct t_weelist_item *weechat_list_get (struct t_weelist *weelist, C 言語での使用例: -[source,C] +[source,c] ---- struct t_weelist_item *item = weechat_list_get (list, 0); /* first item */ ---- @@ -4548,7 +4548,7 @@ item = weechat.list_get(list, 0) プロトタイプ: -[source,C] +[source,c] ---- void weechat_list_set (struct t_weelist_item *item, const char *value); ---- @@ -4560,7 +4560,7 @@ void weechat_list_set (struct t_weelist_item *item, const char *value); C 言語での使用例: -[source,C] +[source,c] ---- weechat_list_set (item, "new data"); ---- @@ -4582,7 +4582,7 @@ weechat.list_set(item, "new data") プロトタイプ: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_next (struct t_weelist_item *item); ---- @@ -4597,7 +4597,7 @@ struct t_weelist_item *weechat_list_next (struct t_weelist_item *item); C 言語での使用例: -[source,C] +[source,c] ---- struct t_weelist_item *next_item = weechat_list_next (item); ---- @@ -4619,7 +4619,7 @@ item = weechat.list_next(item) プロトタイプ: -[source,C] +[source,c] ---- struct t_weelist_item *weechat_list_prev (struct t_weelist_item *item); ---- @@ -4634,7 +4634,7 @@ struct t_weelist_item *weechat_list_prev (struct t_weelist_item *item); C 言語での使用例: -[source,C] +[source,c] ---- struct t_weelist_item *prev_item = weechat_list_prev (item); ---- @@ -4656,7 +4656,7 @@ item = weechat.list_prev(item) プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_list_string (struct t_weelist_item *item); ---- @@ -4671,7 +4671,7 @@ const char *weechat_list_string (struct t_weelist_item *item); C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "value of item: %s", weechat_list_string (item)); ---- @@ -4696,7 +4696,7 @@ Return pointer to the user data of an item. プロトタイプ: -[source,C] +[source,c] ---- void *weechat_list_user_data (struct t_weelist_item *item); ---- @@ -4713,7 +4713,7 @@ void *weechat_list_user_data (struct t_weelist_item *item); C 言語での使用例: // TRANSLATION MISSING -[source,C] +[source,c] ---- weechat_printf (NULL, "user data of item: 0x%lx", weechat_list_user_data (item)); ---- @@ -4727,7 +4727,7 @@ weechat_printf (NULL, "user data of item: 0x%lx", weechat_list_user_data (item)) プロトタイプ: -[source,C] +[source,c] ---- char *weechat_list_size (struct t_weelist *weelist); ---- @@ -4742,7 +4742,7 @@ char *weechat_list_size (struct t_weelist *weelist); C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "size of list: %d", weechat_list_size (list)); ---- @@ -4764,7 +4764,7 @@ weechat.prnt("", "size of list: %d" % weechat.list_size(list)) プロトタイプ: -[source,C] +[source,c] ---- void weechat_list_remove (struct t_weelist *weelist, struct t_weelist_item *item); @@ -4777,7 +4777,7 @@ void weechat_list_remove (struct t_weelist *weelist, C 言語での使用例: -[source,C] +[source,c] ---- weechat_list_remove (list, item); ---- @@ -4799,7 +4799,7 @@ weechat.list_remove(list, item) プロトタイプ: -[source,C] +[source,c] ---- void weechat_list_remove_all (struct t_weelist *weelist); ---- @@ -4810,7 +4810,7 @@ void weechat_list_remove_all (struct t_weelist *weelist); C 言語での使用例: -[source,C] +[source,c] ---- weechat_list_remove_all (list); ---- @@ -4832,7 +4832,7 @@ weechat.list_remove_all(list) プロトタイプ: -[source,C] +[source,c] ---- void weechat_list_free (struct t_weelist *weelist); ---- @@ -4843,7 +4843,7 @@ void weechat_list_free (struct t_weelist *weelist); C 言語での使用例: -[source,C] +[source,c] ---- weechat_list_free (list); ---- @@ -4874,7 +4874,7 @@ _WeeChat バージョン 1.8 以上で利用可_ プロトタイプ: -[source,C] +[source,c] ---- struct t_arraylist *weechat_arraylist_new (int initial_size, int sorted, @@ -4919,7 +4919,7 @@ struct t_arraylist *weechat_arraylist_new (int initial_size, C 言語での使用例: -[source,C] +[source,c] ---- int cmp_cb (void *data, struct t_arraylist *arraylist, @@ -4948,7 +4948,7 @@ _WeeChat バージョン 1.8 以上で利用可_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_list_size (struct t_arraylist *arraylist); ---- @@ -4963,7 +4963,7 @@ int weechat_list_size (struct t_arraylist *arraylist); C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "size of array list: %d", weechat_arraylist_size (arraylist)); ---- @@ -4979,7 +4979,7 @@ _WeeChat バージョン 1.8 以上で利用可_ プロトタイプ: -[source,C] +[source,c] ---- void *weechat_arraylist_get (struct t_arraylist *arraylist, int index); ---- @@ -4995,7 +4995,7 @@ void *weechat_arraylist_get (struct t_arraylist *arraylist, int index); C 言語での使用例: -[source,C] +[source,c] ---- void *pointer = weechat_arraylist_get (arraylist, 0); /* first item */ ---- @@ -5011,7 +5011,7 @@ _WeeChat バージョン 1.8 以上で利用可_ プロトタイプ: -[source,C] +[source,c] ---- void *weechat_arraylist_search (struct t_arraylist *arraylist, void *pointer, int *index, int *index_insert); @@ -5032,7 +5032,7 @@ void *weechat_arraylist_search (struct t_arraylist *arraylist, void *pointer, C 言語での使用例: -[source,C] +[source,c] ---- int index, index_insert; void *item = weechat_arraylist_search (arraylist, pointer, &index, &index_insert); @@ -5049,7 +5049,7 @@ _WeeChat バージョン 1.8 以上で利用可_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_arraylist_insert (struct t_arraylist *arraylist, int index, void *pointer); ---- @@ -5068,7 +5068,7 @@ int weechat_arraylist_insert (struct t_arraylist *arraylist, int index, void *po C 言語での使用例: -[source,C] +[source,c] ---- int index = weechat_arraylist_insert (arraylist, -1, pointer); /* 未ソートの配列リストに対しては要素を末尾に挿入します */ ---- @@ -5084,7 +5084,7 @@ _WeeChat バージョン 1.8 以上で利用可_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_arraylist_add (struct t_arraylist *arraylist, void *pointer); ---- @@ -5100,7 +5100,7 @@ int weechat_arraylist_add (struct t_arraylist *arraylist, void *pointer); C 言語での使用例: -[source,C] +[source,c] ---- int index = weechat_arraylist_add (arraylist, pointer); ---- @@ -5116,7 +5116,7 @@ _WeeChat バージョン 1.8 以上で利用可_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_arraylist_remove (struct t_arraylist *arraylist, int index); ---- @@ -5132,7 +5132,7 @@ int weechat_arraylist_remove (struct t_arraylist *arraylist, int index); C 言語での使用例: -[source,C] +[source,c] ---- int index_removed = weechat_arraylist_remove (arraylist, index); ---- @@ -5148,7 +5148,7 @@ _WeeChat バージョン 1.8 以上で利用可_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_arraylist_clear (struct t_arraylist *arraylist); ---- @@ -5163,7 +5163,7 @@ int weechat_arraylist_clear (struct t_arraylist *arraylist); C 言語での使用例: -[source,C] +[source,c] ---- if (weechat_arraylist_clear (arraylist)) { @@ -5182,7 +5182,7 @@ _WeeChat バージョン 1.8 以上で利用可_ プロトタイプ: -[source,C] +[source,c] ---- void weechat_arraylist_free (struct t_arraylist *arraylist); ---- @@ -5193,7 +5193,7 @@ void weechat_arraylist_free (struct t_arraylist *arraylist); C 言語での使用例: -[source,C] +[source,c] ---- weechat_arraylist_free (arraylist); ---- @@ -5214,7 +5214,7 @@ _WeeChat バージョン 0.3.3 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hashtable *weechat_hashtable_new (int size, const char *type_keys, @@ -5266,7 +5266,7 @@ struct t_hashtable *weechat_hashtable_new (int size, C 言語での使用例: -[source,C] +[source,c] ---- struct t_hashtable *hashtable = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, @@ -5286,7 +5286,7 @@ _WeeChat バージョン 0.3.3 以上で利用可、バージョン 0.4.2 で更 プロトタイプ: -[source,C] +[source,c] ---- struct t_hashtable_item *weechat_hashtable_set_with_size (struct t_hashtable *hashtable, const void *key, int key_size, @@ -5309,7 +5309,7 @@ struct t_hashtable_item *weechat_hashtable_set_with_size (struct t_hashtable *ha C 言語での使用例: -[source,C] +[source,c] ---- weechat_hashtable_set_with_size (hashtable, "my_key", 0, my_buffer, sizeof (my_buffer_struct)); @@ -5326,7 +5326,7 @@ _WeeChat バージョン 0.3.3 以上で利用可、バージョン 0.4.2 で更 プロトタイプ: -[source,C] +[source,c] ---- struct t_hashtable_item *weechat_hashtable_set (struct t_hashtable *hashtable, const void *key, const void *value); @@ -5344,7 +5344,7 @@ struct t_hashtable_item *weechat_hashtable_set (struct t_hashtable *hashtable, C 言語での使用例: -[source,C] +[source,c] ---- weechat_hashtable_set (hashtable, "my_key", "my_value"); ---- @@ -5360,7 +5360,7 @@ _WeeChat バージョン 0.3.3 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- void *weechat_hashtable_get (struct t_hashtable *hashtable, void *key); ---- @@ -5376,7 +5376,7 @@ void *weechat_hashtable_get (struct t_hashtable *hashtable, void *key); C 言語での使用例: -[source,C] +[source,c] ---- void *value = weechat_hashtable_get (hashtable, "my_key"); ---- @@ -5392,7 +5392,7 @@ _WeeChat バージョン 0.3.4 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_hashtable_has_key (struct t_hashtable *hashtable, void *key); ---- @@ -5408,7 +5408,7 @@ int weechat_hashtable_has_key (struct t_hashtable *hashtable, void *key); C 言語での使用例: -[source,C] +[source,c] ---- if (weechat_hashtable_has_key (hashtable, "my_key")) { @@ -5430,7 +5430,7 @@ by insertion order in the hashtable (from oldest to newest one). プロトタイプ: -[source,C] +[source,c] ---- void weechat_hashtable_map (struct t_hashtable *hashtable, void (*callback_map)(void *data, @@ -5448,7 +5448,7 @@ void weechat_hashtable_map (struct t_hashtable *hashtable, C 言語での使用例: -[source,C] +[source,c] ---- void map_cb (void *data, struct t_hashtable *hashtable, @@ -5476,7 +5476,7 @@ Call a function on all hashtable entries, by insertion order in the hashtable プロトタイプ: -[source,C] +[source,c] ---- void weechat_hashtable_map_string (struct t_hashtable *hashtable, void (*callback_map)(void *data, @@ -5498,7 +5498,7 @@ void weechat_hashtable_map_string (struct t_hashtable *hashtable, C 言語での使用例: -[source,C] +[source,c] ---- void map_cb (void *data, struct t_hashtable *hashtable, @@ -5523,7 +5523,7 @@ _WeeChat バージョン 1.0 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hashtable *weechat_hashtable_dup (struct t_hashtable *hashtable); ---- @@ -5538,7 +5538,7 @@ struct t_hashtable *weechat_hashtable_dup (struct t_hashtable *hashtable); C 言語での使用例: -[source,C] +[source,c] ---- struct t_hashtable *new_hashtable = weechat_hashtable_dup (hashtable); ---- @@ -5554,7 +5554,7 @@ _WeeChat バージョン 0.3.3 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_hashtable_get_integer (struct t_hashtable *hashtable, void *property); @@ -5573,7 +5573,7 @@ int weechat_hashtable_get_integer (struct t_hashtable *hashtable, C 言語での使用例: -[source,C] +[source,c] ---- int items_count = weechat_hashtable_get_integer (hashtable, "items_count"); ---- @@ -5589,7 +5589,7 @@ _WeeChat バージョン 0.3.4 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_hashtable_get_string (struct t_hashtable *hashtable, const char *property); @@ -5625,7 +5625,7 @@ const char *weechat_hashtable_get_string (struct t_hashtable *hashtable, C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "keys are type: %s", weechat_hashtable_get_string (hashtable, "type_keys")); @@ -5644,7 +5644,7 @@ _WeeChat バージョン 0.3.4 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- void weechat_hashtable_set_pointer (struct t_hashtable *hashtable, const char *property, void *pointer); @@ -5661,7 +5661,7 @@ void weechat_hashtable_set_pointer (struct t_hashtable *hashtable, C 言語での使用例: -[source,C] +[source,c] ---- void my_free_value_cb (struct t_hashtable *hashtable, const void *key, void *value) @@ -5692,7 +5692,7 @@ _WeeChat バージョン 0.3.3 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_hashtable_add_to_infolist (struct t_hashtable *hashtable, struct t_infolist_item *infolist_item, @@ -5711,7 +5711,7 @@ int weechat_hashtable_add_to_infolist (struct t_hashtable *hashtable, C 言語での使用例: -[source,C] +[source,c] ---- weechat_hashtable_add_to_infolist (hashtable, infolist_item, "testhash"); @@ -5737,7 +5737,7 @@ _WeeChat バージョン 0.3.3 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- void weechat_hashtable_remove (struct t_hashtable *hashtable, const void *key); ---- @@ -5749,7 +5749,7 @@ void weechat_hashtable_remove (struct t_hashtable *hashtable, const void *key); C 言語での使用例: -[source,C] +[source,c] ---- weechat_hashtable_remove (hashtable, "my_key"); ---- @@ -5765,7 +5765,7 @@ _WeeChat バージョン 0.3.3 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- void weechat_hashtable_remove_all (struct t_hashtable *hashtable); ---- @@ -5776,7 +5776,7 @@ void weechat_hashtable_remove_all (struct t_hashtable *hashtable); C 言語での使用例: -[source,C] +[source,c] ---- weechat_hashtable_remove_all (hashtable); ---- @@ -5792,7 +5792,7 @@ _WeeChat バージョン 0.3.3 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- void weechat_hashtable_free (struct t_hashtable *hashtable); ---- @@ -5803,7 +5803,7 @@ void weechat_hashtable_free (struct t_hashtable *hashtable); C 言語での使用例: -[source,C] +[source,c] ---- weechat_hashtable_free (hashtable); ---- @@ -5824,7 +5824,7 @@ _WeeChat バージョン 1.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_config_file *weechat_config_new (const char *name, int (*callback_reload)(const void *pointer, @@ -5874,7 +5874,7 @@ struct t_config_file *weechat_config_new (const char *name, C 言語での使用例: -[source,C] +[source,c] ---- int my_config_reload_cb (const void *pointer, void *data, @@ -5913,7 +5913,7 @@ _WeeChat バージョン 1.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_config_section *weechat_config_new_section ( struct t_config_file *config_file, @@ -6058,7 +6058,7 @@ struct t_config_section *weechat_config_new_section ( C 言語での使用例: -[source,C] +[source,c] ---- int my_section_read_cb (const void *pointer, void *data, @@ -6197,7 +6197,7 @@ section = weechat.config_new_section(config_file, "section1", 1, 1, プロトタイプ: -[source,C] +[source,c] ---- struct t_config_section *weechat_config_search_section ( struct t_config_file *config_file, @@ -6215,7 +6215,7 @@ struct t_config_section *weechat_config_search_section ( C 言語での使用例: -[source,C] +[source,c] ---- struct t_config_section *section = weechat_config_search_section (config_file, "section"); @@ -6240,7 +6240,7 @@ _WeeChat バージョン 1.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_config_option *weechat_config_new_option ( struct t_config_file *config_file, @@ -6335,7 +6335,7 @@ struct t_config_option *weechat_config_new_option ( C 言語での使用例: -[source,C] +[source,c] ---- /* boolean */ struct t_config_option *option1 = @@ -6477,7 +6477,7 @@ _(WeeChat バージョン 0.4.1 で修正済み)_。 プロトタイプ: -[source,C] +[source,c] ---- struct t_config_option *weechat_config_search_option ( struct t_config_file *config_file, @@ -6497,7 +6497,7 @@ struct t_config_option *weechat_config_search_option ( C 言語での使用例: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_search_option (config_file, section, "option"); @@ -6520,7 +6520,7 @@ option = weechat.config_search_option(config_file, section, "option") プロトタイプ: -[source,C] +[source,c] ---- void weechat_config_search_section_option (struct t_config_file *config_file, struct t_config_section *section, @@ -6541,7 +6541,7 @@ void weechat_config_search_section_option (struct t_config_file *config_file, C 言語での使用例: -[source,C] +[source,c] ---- struct t_config_section *ptr_section; struct t_config_option *ptr_option; @@ -6570,7 +6570,7 @@ else プロトタイプ: -[source,C] +[source,c] ---- void weechat_config_search_with_string (const char *option_name, struct t_config_file **config_file, @@ -6593,7 +6593,7 @@ void weechat_config_search_with_string (const char *option_name, C 言語での使用例: -[source,C] +[source,c] ---- struct t_config_file *ptr_config_file; struct t_config_section *ptr_section; @@ -6624,7 +6624,7 @@ else プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_string_to_boolean (const char *text); ---- @@ -6640,7 +6640,7 @@ int weechat_config_string_to_boolean (const char *text); C 言語での使用例: -[source,C] +[source,c] ---- if (weechat_config_string_to_boolean (option_value)) { @@ -6670,7 +6670,7 @@ if weechat.config_string_to_boolean(text): プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_option_reset (struct t_config_option *option, int run_callback); @@ -6690,7 +6690,7 @@ int weechat_config_option_reset (struct t_config_option *option, C 言語での使用例: -[source,C] +[source,c] ---- switch (weechat_config_option_reset (option, 1)) { @@ -6729,7 +6729,7 @@ elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_ERROR: プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_option_set (struct t_config_option *option, const char *value, int run_callback); @@ -6756,7 +6756,7 @@ int weechat_config_option_set (struct t_config_option *option, C 言語での使用例: -[source,C] +[source,c] ---- switch (weechat_config_option_set (option, "new_value", 1)) { @@ -6795,7 +6795,7 @@ elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_ERROR: プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_option_set_null (struct t_config_option *option, int run_callback); @@ -6819,7 +6819,7 @@ int weechat_config_option_set_null (struct t_config_option *option, C 言語での使用例: -[source,C] +[source,c] ---- switch (weechat_config_option_set_null (option, 1)) { @@ -6858,7 +6858,7 @@ elif rc == weechat.WEECHAT_CONFIG_OPTION_SET_ERROR: プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_option_unset (struct t_config_option *option); ---- @@ -6876,7 +6876,7 @@ int weechat_config_option_unset (struct t_config_option *option); C 言語での使用例: -[source,C] +[source,c] ---- switch (weechat_config_option_unset (option)) { @@ -6920,7 +6920,7 @@ elif rc == weechat.WEECHAT_CONFIG_OPTION_UNSET_ERROR: プロトタイプ: -[source,C] +[source,c] ---- void weechat_config_option_rename (struct t_config_option *option, const char *new_name); @@ -6933,7 +6933,7 @@ void weechat_config_option_rename (struct t_config_option *option, C 言語での使用例: -[source,C] +[source,c] ---- weechat_config_option_rename (option, "new_name"); ---- @@ -6957,7 +6957,7 @@ _WeeChat バージョン 1.9 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_config_option_get_string (struct t_config_option *option, const char *property); @@ -6984,7 +6984,7 @@ const char *weechat_config_option_get_string (struct t_config_option *option, C 言語での使用例: -[source,C] +[source,c] ---- const char *type = weechat_config_option_get_string (option, "type"); ---- @@ -6998,7 +6998,7 @@ const char *type = weechat_config_option_get_string (option, "type"); プロトタイプ: -[source,C] +[source,c] ---- void *weechat_config_option_get_pointer (struct t_config_option *option, const char *property); @@ -7028,7 +7028,7 @@ void *weechat_config_option_get_pointer (struct t_config_option *option, C 言語での使用例: -[source,C] +[source,c] ---- char *description = weechat_config_option_get_pointer (option, "description"); ---- @@ -7042,7 +7042,7 @@ char *description = weechat_config_option_get_pointer (option, "description"); プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_option_is_null (struct t_config_option *option); ---- @@ -7058,7 +7058,7 @@ int weechat_config_option_is_null (struct t_config_option *option); C 言語での使用例: -[source,C] +[source,c] ---- if (weechat_config_option_is_null (option)) { @@ -7088,7 +7088,7 @@ if weechat.config_option_is_null(option): プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_option_default_is_null (struct t_config_option *option); ---- @@ -7104,7 +7104,7 @@ int weechat_config_option_default_is_null (struct t_config_option *option); C 言語での使用例: -[source,C] +[source,c] ---- if (weechat_config_option_default_is_null (option)) { @@ -7134,7 +7134,7 @@ if weechat.config_option_default_is_null(option): プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_boolean (struct t_config_option *option); ---- @@ -7152,7 +7152,7 @@ int weechat_config_boolean (struct t_config_option *option); C 言語での使用例: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); if (weechat_config_boolean (option)) @@ -7184,7 +7184,7 @@ if weechat.config_boolean(option): プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_boolean_default (struct t_config_option *option); ---- @@ -7202,7 +7202,7 @@ int weechat_config_boolean_default (struct t_config_option *option); C 言語での使用例: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); if (weechat_config_boolean_default (option)) @@ -7234,7 +7234,7 @@ if weechat.config_boolean_default(option): プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_integer (struct t_config_option *option); ---- @@ -7252,7 +7252,7 @@ int weechat_config_integer (struct t_config_option *option); C 言語での使用例: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); int value = weechat_config_integer (option); @@ -7276,7 +7276,7 @@ value = weechat.config_integer(option) プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_integer_default (struct t_config_option *option); ---- @@ -7294,7 +7294,7 @@ int weechat_config_integer_default (struct t_config_option *option); C 言語での使用例: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); int value = weechat_config_integer_default (option); @@ -7318,7 +7318,7 @@ value = weechat.config_integer_default(option) プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_config_string (struct t_config_option *option); ---- @@ -7337,7 +7337,7 @@ const char *weechat_config_string (struct t_config_option *option); C 言語での使用例: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *value = weechat_config_string (option); @@ -7361,7 +7361,7 @@ value = weechat.config_string(option) プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_config_string_default (struct t_config_option *option); ---- @@ -7380,7 +7380,7 @@ const char *weechat_config_string_default (struct t_config_option *option); C 言語での使用例: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *value = weechat_config_string_default (option); @@ -7404,7 +7404,7 @@ value = weechat.config_string_default(option) プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_config_color (struct t_config_option *option); ---- @@ -7422,7 +7422,7 @@ const char *weechat_config_color (struct t_config_option *option); C 言語での使用例: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *color = weechat_config_color (option); @@ -7446,7 +7446,7 @@ value = weechat.config_color(option) プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_config_color_default (struct t_config_option *option); ---- @@ -7464,7 +7464,7 @@ const char *weechat_config_color_default (struct t_config_option *option); C 言語での使用例: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("plugin.section.option"); const char *color = weechat_config_color_default (option); @@ -7489,7 +7489,7 @@ value = weechat.config_color_default(option) プロトタイプ: -[source,C] +[source,c] ---- void weechat_config_write_option (struct t_config_file *config_file, struct t_config_option *option); @@ -7502,7 +7502,7 @@ void weechat_config_write_option (struct t_config_file *config_file, C 言語での使用例: -[source,C] +[source,c] ---- int my_section_write_cb (const void *pointer, void *data, @@ -7538,7 +7538,7 @@ def my_section_write_cb(data, config_file, section_name): プロトタイプ: -[source,C] +[source,c] ---- void weechat_config_write_line (struct t_config_file *config_file, const char *option_name, @@ -7554,7 +7554,7 @@ void weechat_config_write_line (struct t_config_file *config_file, C 言語での使用例: -[source,C] +[source,c] ---- int my_section_write_cb (const void *pointer, void *data, @@ -7590,7 +7590,7 @@ def my_section_write_cb(data, config_file, section_name): プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_write (struct t_config_file *config_file); ---- @@ -7607,7 +7607,7 @@ int weechat_config_write (struct t_config_file *config_file); C 言語での使用例: -[source,C] +[source,c] ---- switch (weechat_config_write (config_file)) { @@ -7646,7 +7646,7 @@ elif rc == weechat.WEECHAT_CONFIG_WRITE_ERROR: プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_read (struct t_config_file *config_file); ---- @@ -7663,7 +7663,7 @@ int weechat_config_read (struct t_config_file *config_file); C 言語での使用例: -[source,C] +[source,c] ---- switch (weechat_config_read (config_file)) { @@ -7702,7 +7702,7 @@ elif rc == weechat.WEECHAT_CONFIG_READ_FILE_NOT_FOUND: プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_reload (struct t_config_file *config_file); ---- @@ -7719,7 +7719,7 @@ int weechat_config_reload (struct t_config_file *config_file); C 言語での使用例: -[source,C] +[source,c] ---- switch (weechat_config_reload (config_file)) { @@ -7758,7 +7758,7 @@ elif rc == weechat.WEECHAT_CONFIG_READ_FILE_NOT_FOUND: プロトタイプ: -[source,C] +[source,c] ---- void weechat_config_option_free (struct t_config_option *option); ---- @@ -7769,7 +7769,7 @@ void weechat_config_option_free (struct t_config_option *option); C 言語での使用例: -[source,C] +[source,c] ---- weechat_config_option_free (option); ---- @@ -7791,7 +7791,7 @@ weechat.config_option_free(option) プロトタイプ: -[source,C] +[source,c] ---- void weechat_config_section_free_options (struct t_config_section *section); ---- @@ -7802,7 +7802,7 @@ void weechat_config_section_free_options (struct t_config_section *section); C 言語での使用例: -[source,C] +[source,c] ---- weechat_config_section_free_options (section); ---- @@ -7824,7 +7824,7 @@ weechat.config_section_free_options(section) プロトタイプ: -[source,C] +[source,c] ---- void weechat_config_section_free (struct t_config_section *section); ---- @@ -7835,7 +7835,7 @@ void weechat_config_section_free (struct t_config_section *section); C 言語での使用例: -[source,C] +[source,c] ---- weechat_config_section_free (section); ---- @@ -7857,7 +7857,7 @@ weechat.config_section_free(section) プロトタイプ: -[source,C] +[source,c] ---- void weechat_config_free (struct t_config_file *config_file); ---- @@ -7868,7 +7868,7 @@ void weechat_config_free (struct t_config_file *config_file); C 言語での使用例: -[source,C] +[source,c] ---- weechat_config_free (config_file); ---- @@ -7890,7 +7890,7 @@ weechat.config_free(config_file) プロトタイプ: -[source,C] +[source,c] ---- struct t_config_option *weechat_config_get (const char *option_name); ---- @@ -7905,7 +7905,7 @@ struct t_config_option *weechat_config_get (const char *option_name); C 言語での使用例: -[source,C] +[source,c] ---- struct t_config_option *option = weechat_config_get ("weechat.look.item_time_format"); ---- @@ -7927,7 +7927,7 @@ option = weechat.config_get("weechat.look.item_time_format") プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_config_get_plugin (const char *option_name); ---- @@ -7943,7 +7943,7 @@ const char *weechat_config_get_plugin (const char *option_name); C 言語での使用例: -[source,C] +[source,c] ---- /* if current plugin is "test", then look for value of option "plugins.var.test.option" in file plugins.conf */ @@ -7967,7 +7967,7 @@ value = weechat.config_get_plugin("option") プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_is_set_plugin (const char *option_name); ---- @@ -7983,7 +7983,7 @@ int weechat_config_is_set_plugin (const char *option_name); C 言語での使用例: -[source,C] +[source,c] ---- if (weechat_config_is_set_plugin ("option")) { @@ -8017,7 +8017,7 @@ else: プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_set_plugin (const char *option_name, const char *value); ---- @@ -8037,7 +8037,7 @@ int weechat_config_set_plugin (const char *option_name, const char *value); C 言語での使用例: -[source,C] +[source,c] ---- switch (weechat_config_set_plugin ("option", "test_value")) { @@ -8083,7 +8083,7 @@ _WeeChat バージョン 0.3.5 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- void weechat_config_set_desc_plugin (const char *option_name, const char *description); @@ -8101,7 +8101,7 @@ void weechat_config_set_desc_plugin (const char *option_name, C 言語での使用例: -[source,C] +[source,c] ---- weechat_config_set_desc_plugin ("option", "description of option"); ---- @@ -8125,7 +8125,7 @@ if int(version) >= 0x00030500: プロトタイプ: -[source,C] +[source,c] ---- int weechat_config_unset_plugin (const char *option_name); ---- @@ -8144,7 +8144,7 @@ int weechat_config_unset_plugin (const char *option_name); C 言語での使用例: -[source,C] +[source,c] ---- switch (weechat_config_unset_plugin ("option")) { @@ -8200,7 +8200,7 @@ _WeeChat バージョン 0.3.6 以上で利用可、バージョン 1.8 で更 プロトタイプ: -[source,C] +[source,c] ---- int weechat_key_bind (const char *context, struct t_hashtable *keys); ---- @@ -8224,7 +8224,7 @@ int weechat_key_bind (const char *context, struct t_hashtable *keys); C 言語での使用例: -[source,C] +[source,c] ---- struct t_hashtable *keys = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, @@ -8266,7 +8266,7 @@ _WeeChat バージョン 0.3.6 以上で利用可、バージョン 2.0 で更 プロトタイプ: -[source,C] +[source,c] ---- int weechat_key_unbind (const char *context, const char *key); ---- @@ -8285,7 +8285,7 @@ int weechat_key_unbind (const char *context, const char *key); C 言語での使用例: -[source,C] +[source,c] ---- /* remove a single key */ weechat_key_unbind ("mouse", "@chat(plugin.buffer):button1"); @@ -8321,7 +8321,7 @@ weechat.key_unbind("mouse", "area:chat(python.test)") プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_prefix (const char *prefix); ---- @@ -8352,7 +8352,7 @@ List of prefixes: C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "%sThis is an error...", weechat_prefix ("error")); ---- @@ -8374,7 +8374,7 @@ weechat.prnt("", "%sThis is an error..." % weechat.prefix("error")) プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_color (const char *color_name); ---- @@ -8431,7 +8431,7 @@ const char *weechat_color (const char *color_name); C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "Color: %sblue %sdefault color %syellow on red", weechat_color ("blue"), @@ -8457,7 +8457,7 @@ weechat.prnt("", "Color: %sblue %sdefault color %syellow on red" プロトタイプ: -[source,C] +[source,c] ---- void weechat_printf (struct t_gui_buffer *buffer, const char *message, ...); ---- @@ -8465,7 +8465,7 @@ void weechat_printf (struct t_gui_buffer *buffer, const char *message, ...); この関数は printf_date_tags 関数の別名です。以下に示す通り、どちらの関数も同じ結果を返します: -[source,C] +[source,c] ---- weechat_printf (buffer, "message"); weechat_printf_date_tags (buffer, 0, NULL, "message"); @@ -8489,7 +8489,7 @@ weechat_printf_date_tags (buffer, 0, NULL, "message"); C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "Hello on WeeChat buffer"); weechat_printf (buffer, "Hello on this buffer"); @@ -8524,7 +8524,7 @@ weechat.prnt(buffer, "\t\t") # empty line (without time) プロトタイプ: -[source,C] +[source,c] ---- void weechat_printf_date_tags (struct t_gui_buffer *buffer, time_t date, const char *tags, const char *message, ...); @@ -8542,7 +8542,7 @@ link:weechat_user.ja.html#lines_tags[WeeChat ユーザーズガイド / 行の C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf_date_tags (NULL, time (NULL) - 120, "notify_message", "Message 2 minutes ago, with a tag 'notify_message'"); @@ -8570,7 +8570,7 @@ weechat.prnt_date_tags("", time - 120, "notify_message", プロトタイプ: -[source,C] +[source,c] ---- void weechat_printf_y (struct t_gui_buffer *buffer, int y, const char *message, ...); @@ -8587,7 +8587,7 @@ void weechat_printf_y (struct t_gui_buffer *buffer, int y, C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf_y (buffer, 2, "My message on third line"); ---- @@ -8612,7 +8612,7 @@ WeeChat ログファイル (weechat.log) にメッセージを書き込む。 プロトタイプ: -[source,C] +[source,c] ---- void weechat_log_printf (const char *message, ...); ---- @@ -8623,7 +8623,7 @@ void weechat_log_printf (const char *message, ...); C 言語での使用例: -[source,C] +[source,c] ---- weechat_log_printf ("My message in log file"); ---- @@ -8662,7 +8662,7 @@ _WeeChat バージョン 0.3.4 以上で利用可。_ C 言語での使用例: -[source,C] +[source,c] ---- /* hook modifier with priority = 2000 */ weechat_hook_modifier ("2000|input_text_display", &modifier_cb, NULL, NULL); @@ -8679,7 +8679,7 @@ _WeeChat バージョン 1.5 と 1.7 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_command (const char *command, const char *description, @@ -8756,7 +8756,7 @@ include::includes/autogen_api_completions.ja.adoc[tag=completions] C 言語での使用例: -[source,C] +[source,c] ---- int my_command_cb (const void *pointer, void *data, struct t_gui_buffer *buffer, @@ -8832,7 +8832,7 @@ _WeeChat バージョン 1.5 と 1.7 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_completion (const char *completion_item, const char *description, @@ -8890,7 +8890,7 @@ _WEECHAT_RC_OK_EAT_ を返してください。そうすれば WeeChat は補完 C 言語での使用例: -[source,C] +[source,c] ---- int my_completion_cb (const void *pointer, void *data, const char *completion_item, @@ -8946,7 +8946,7 @@ WeeChat がコマンドを実行する際にこれをフック。 プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_command_run (const char *command, int (*callback)(const void *pointer, @@ -8981,7 +8981,7 @@ struct t_hook *weechat_hook_command_run (const char *command, C 言語での使用例: -[source,C] +[source,c] ---- int my_command_run_cb (const void *pointer, void *data, @@ -9019,7 +9019,7 @@ _WeeChat バージョン 1.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_timer (long interval, int align_second, @@ -9056,7 +9056,7 @@ struct t_hook *weechat_hook_timer (long interval, C 言語での使用例: -[source,C] +[source,c] ---- int my_timer_cb (const void *pointer, void *data, int remaining_calls) @@ -9094,7 +9094,7 @@ _WeeChat バージョン 1.3、1.5、2.0 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_fd (int fd, int flag_read, @@ -9139,7 +9139,7 @@ WeeChat バージョン 2.0 以上では整数、バージョン 1.9 以下で C 言語での使用例: -[source,C] +[source,c] ---- int my_fd_cb (const void *pointer, void *data, int fd) @@ -9187,7 +9187,7 @@ WeeChat バージョン 0.3.9.2 プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_process (const char *command, int timeout, @@ -9272,7 +9272,7 @@ WeeChat に関する情報 (例えば現在の安定版、最新の git コミ C 言語での使用例: -[source,C] +[source,c] ---- /* 外部コマンドを実行する例 */ int @@ -9405,7 +9405,7 @@ _WeeChat バージョン 0.3.7 以上で利用可、バージョン 1.5 で更 プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_process_hashtable (const char *command, struct t_hashtable *options, @@ -9476,7 +9476,7 @@ URL では、入力/出力ファイル用に 2 つのオプション (文字列) C 言語での使用例: -[source,C] +[source,c] ---- int my_process_cb (const void *pointer, void *data, const char *command, @@ -9636,7 +9636,7 @@ _WeeChat バージョン 1.5 と 2.0 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_connect (const char *proxy, const char *address, @@ -9721,7 +9721,7 @@ WeeChat バージョン 2.0 以上では整数、バージョン 1.9 以下で C 言語での使用例: -[source,C] +[source,c] ---- int my_connect_cb (const void *pointer, void *data, int status, int gnutls_rc, @@ -9833,7 +9833,7 @@ _WeeChat バージョン 2.3 以上で利用可_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_line (const char *buffer_type, const char *buffer_name, @@ -10048,7 +10048,7 @@ WeeChat はそれらを無視します。 C 言語での使用例: -[source,C] +[source,c] ---- int my_line_cb (const void *pointer, void *data, struct t_hasbtable *line) @@ -10097,7 +10097,7 @@ _WeeChat バージョン 0.4.3、1.0、1.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_print (struct t_gui_buffer *buffer, const char *tags, @@ -10162,7 +10162,7 @@ WeeChat バージョン 1.0 以上では整数、バージョン 0.4.3 以下で C 言語での使用例: -[source,C] +[source,c] ---- int my_print_cb (const void *pointer, void *data, struct t_gui_buffer *buffer, @@ -10204,7 +10204,7 @@ _WeeChat バージョン 1.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_signal (const char *signal, int (*callback)(const void *pointer, @@ -10901,7 +10901,7 @@ WeeChat とプラグインが送信するシグナルのリスト: C 言語での使用例: -[source,C] +[source,c] ---- int my_signal_cb (const void *pointer, void *data, const char *signal, @@ -10940,7 +10940,7 @@ _WeeChat バージョン 1.0 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_hook_signal_send (const char *signal, const char *type_data, void *signal_data); @@ -10963,7 +10963,7 @@ int weechat_hook_signal_send (const char *signal, const char *type_data, C 言語での使用例: -[source,C] +[source,c] ---- int rc = weechat_hook_signal_send ("my_signal", WEECHAT_HOOK_SIGNAL_STRING, my_string); ---- @@ -10989,7 +10989,7 @@ rc = weechat.hook_signal_send("my_signal", weechat.WEECHAT_HOOK_SIGNAL_STRING, m C 言語での使用例: -[source,C] +[source,c] ---- weechat_hook_signal_send ("logger_backlog", WEECHAT_HOOK_SIGNAL_POINTER, buffer); ---- @@ -11030,7 +11030,7 @@ _script_ プラグインはスクリプトをインストールする際にこ C 言語での使用例: -[source,C] +[source,c] ---- weechat_hook_signal_send ("python_script_install", WEECHAT_HOOK_SIGNAL_STRING, "/path/to/test.py"); ---- @@ -11065,7 +11065,7 @@ _script_ プラグインはスクリプトを削除する際にこれらのシ C 言語での使用例: -[source,C] +[source,c] ---- /* unload and remove scripts test.py and script.py */ weechat_hook_signal_send ("python_script_remove", WEECHAT_HOOK_SIGNAL_STRING, @@ -11108,7 +11108,7 @@ irc バッファ(サーバ、チャンネル、プライベート) C 言語での使用例: -[source,C] +[source,c] ---- /* say "Hello!" on libera server, #weechat channel */ weechat_hook_signal_send ("irc_input_send", WEECHAT_HOOK_SIGNAL_STRING, @@ -11140,7 +11140,7 @@ hsignal (ハッシュテーブルを持つシグナル) をフック。 プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_hsignal (const char *signal, int (*callback)(const void *pointer, @@ -11230,7 +11230,7 @@ hsignal のリスト: C 言語での使用例: -[source,C] +[source,c] ---- int my_hsignal_cb (const void *pointer, void *data, const char *signal, @@ -11267,7 +11267,7 @@ hsignal (ハッシュテーブルを持つシグナル) を送信。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_hook_hsignal_send (const char *signal, struct t_hashtable *hashtable); ---- @@ -11287,7 +11287,7 @@ int weechat_hook_hsignal_send (const char *signal, struct t_hashtable *hashtable C 言語での使用例: -[source,C] +[source,c] ---- int rc; struct t_hashtable *hashtable = weechat_hashtable_new (8, @@ -11372,7 +11372,7 @@ _signal_、_yyy_ は _pattern_ で指定したものになります。 C 言語での使用例: -[source,C] +[source,c] ---- int test_whois_cb (const void *pointer, void *data, const char *signal, @@ -11452,7 +11452,7 @@ _cmd_start_、_cmd_stop_、_cmd_extra_ C 言語での使用例: -[source,C] +[source,c] ---- struct t_hashtable *hashtable = weechat_hashtable_new (8, WEECHAT_HASHTABLE_STRING, @@ -11498,7 +11498,7 @@ _WeeChat バージョン 1.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_config (const char *option, int (*callback)(const void *pointer, @@ -11534,7 +11534,7 @@ struct t_hook *weechat_hook_config (const char *option, C 言語での使用例: -[source,C] +[source,c] ---- int my_config_cb (const void *pointer, void *data, const char *option, @@ -11573,7 +11573,7 @@ _WeeChat バージョン 1.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_modifier (const char *modifier, char *(*callback)(const void *pointer, @@ -11692,7 +11692,7 @@ WeeChat とプラグインが使う修飾子のリスト: C 言語での使用例: -[source,C] +[source,c] ---- char * my_modifier_cb (const void *pointer, void *data, const char *modifier, @@ -11740,7 +11740,7 @@ hook = weechat.hook_modifier("weechat_print", "my_modifier_cb", "") プロトタイプ: -[source,C] +[source,c] ---- char *weechat_hook_modifier_exec (const char *modifier, const char *modifier_data, @@ -11834,7 +11834,7 @@ WeeChat とプラグインが定義する修飾子のリスト: C 言語での使用例: -[source,C] +[source,c] ---- char *new_string = weechat_hook_modifier_exec ("my_modifier", my_data, my_string); @@ -11859,7 +11859,7 @@ _WeeChat バージョン 1.5, 2.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_info (const char *info_name, const char *description, @@ -11899,7 +11899,7 @@ WeeChat バージョン 2.5 以上の場合、コールバックは確保され C 言語での使用例: -[source,C] +[source,c] ---- char * my_info_cb (const void *pointer, void *data, const char *info_name, @@ -11940,7 +11940,7 @@ _WeeChat バージョン 0.3.4 以上で利用可、バージョン 1.5 で更 プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_info_hashtable (const char *info_name, const char *description, @@ -11979,7 +11979,7 @@ struct t_hook *weechat_hook_info_hashtable (const char *info_name, C 言語での使用例: -[source,C] +[source,c] ---- struct t_hashtable * my_info_hashtable_cb (const void *pointer, void *data, const char *info_name, @@ -12023,7 +12023,7 @@ _WeeChat バージョン 1.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_infolist (const char *infolist_name, const char *description, @@ -12065,7 +12065,7 @@ struct t_hook *weechat_hook_infolist (const char *infolist_name, C 言語での使用例: -[source,C] +[source,c] ---- struct t_infolist * my_infolist_cb (const void *pointer, void *data, const char *infolist_name, @@ -12114,7 +12114,7 @@ hdata をフック: コールバックは要求した hdata へのポインタ プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_hdata (const char *hdata_name, const char *description, @@ -12147,7 +12147,7 @@ struct t_hook *weechat_hook_hdata (const char *hdata_name, C 言語での使用例: -[source,C] +[source,c] ---- struct t_hdata * my_hdata_cb (const void *pointer, void *data, const char *hdata_name) @@ -12178,7 +12178,7 @@ _WeeChat バージョン 1.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hook *weechat_hook_focus (const char *area, struct t_hashtable *(*callback)(const void *pointer, @@ -12350,7 +12350,7 @@ info を使う前にエリアが一致していることを確認して下さい C 言語での使用例: -[source,C] +[source,c] ---- struct t_hashtable * my_focus_nicklist_cb (const void *pointer, void *data, struct t_hashtable *info) @@ -12390,7 +12390,7 @@ _WeeChat バージョン 0.3.9 以上で利用可 (スクリプト: WeeChat バ プロトタイプ: -[source,C] +[source,c] ---- void weechat_hook_set (struct t_hook *hook, const char *property, const char *value); @@ -12428,7 +12428,7 @@ void weechat_hook_set (struct t_hook *hook, const char *property, C 言語での使用例: -[source,C] +[source,c] ---- struct t_hook *my_command_hook = weechat_hook_command ("abcd", "description", @@ -12461,7 +12461,7 @@ weechat.hook_set(hook, "stdin_close", "") # optional プロトタイプ: -[source,C] +[source,c] ---- void weechat_unhook (struct t_hook *hook); ---- @@ -12472,7 +12472,7 @@ void weechat_unhook (struct t_hook *hook); C 言語での使用例: -[source,C] +[source,c] ---- struct t_hook *my_hook = weechat_hook_command ( /* ... */ ); /* ... */ @@ -12498,7 +12498,7 @@ _WeeChat バージョン 1.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- void weechat_unhook_all (const char *subplugin); ---- @@ -12510,7 +12510,7 @@ void weechat_unhook_all (const char *subplugin); C 言語での使用例: -[source,C] +[source,c] ---- weechat_unhook_all (NULL); ---- @@ -12539,7 +12539,7 @@ _WeeChat バージョン 1.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer_new (const char *name, int (*input_callback)(const void *pointer, @@ -12591,7 +12591,7 @@ struct t_gui_buffer *weechat_buffer_new (const char *name, C 言語での使用例: -[source,C] +[source,c] ---- int my_input_cb (const void *pointer, void *data, @@ -12640,7 +12640,7 @@ buffer = weechat.buffer_new("my_buffer", "my_input_cb", "", "my_close_cb", "") プロトタイプ: -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_current_buffer (); ---- @@ -12651,7 +12651,7 @@ struct t_gui_buffer *weechat_current_buffer (); C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (weechat_current_buffer (), "Text on current buffer"); ---- @@ -12675,7 +12675,7 @@ _WeeChat バージョン 1.0 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer_search (const char *plugin, const char *name); @@ -12697,7 +12697,7 @@ struct t_gui_buffer *weechat_buffer_search (const char *plugin, C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_buffer *buffer1 = weechat_buffer_search ("irc", "libera.#weechat"); struct t_gui_buffer *buffer2 = weechat_buffer_search ("==", "irc.libera.#test"); /* WeeChat バージョン 1.0 以上で利用可 */ @@ -12721,7 +12721,7 @@ WeeChat メインバッファ (_core_ バッファ、WeeChat プロトタイプ: -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer_search_main (); ---- @@ -12732,7 +12732,7 @@ struct t_gui_buffer *weechat_buffer_search_main (); C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_buffer *weechat_buffer = weechat_buffer_search_main (); ---- @@ -12754,7 +12754,7 @@ buffer = weechat.buffer_search_main() プロトタイプ: -[source,C] +[source,c] ---- void weechat_buffer_clear (struct t_gui_buffer *buffer); ---- @@ -12765,7 +12765,7 @@ void weechat_buffer_clear (struct t_gui_buffer *buffer); C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_buffer *my_buffer = weechat_buffer_search ("my_plugin", "my_buffer"); @@ -12794,7 +12794,7 @@ if buffer != "": プロトタイプ: -[source,C] +[source,c] ---- void weechat_buffer_close (struct t_gui_buffer *buffer); ---- @@ -12805,7 +12805,7 @@ void weechat_buffer_close (struct t_gui_buffer *buffer); C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_buffer *my_buffer = weechat_buffer_new ("my_buffer", &my_input_cb, NULL, @@ -12835,7 +12835,7 @@ weechat.buffer_close(buffer) プロトタイプ: -[source,C] +[source,c] ---- void weechat_buffer_merge (struct t_gui_buffer *buffer, struct t_gui_buffer *target_buffer); @@ -12848,7 +12848,7 @@ void weechat_buffer_merge (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- /* merge current buffer with weechat "core" buffer */ weechat_buffer_merge (weechat_current_buffer (), @@ -12873,7 +12873,7 @@ weechat.buffer_merge(weechat.current_buffer(), weechat.buffer_search_main()) プロトタイプ: -[source,C] +[source,c] ---- void weechat_buffer_unmerge (struct t_gui_buffer *buffer, int number); @@ -12887,7 +12887,7 @@ void weechat_buffer_unmerge (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- weechat_buffer_unmerge (weechat_current_buffer (), 1); ---- @@ -12909,7 +12909,7 @@ weechat.buffer_unmerge(weechat.current_buffer(), 1) プロトタイプ: -[source,C] +[source,c] ---- int weechat_buffer_get_integer (struct t_gui_buffer *buffer, const char *property); @@ -12977,7 +12977,7 @@ int weechat_buffer_get_integer (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "my buffer number is: %d", weechat_buffer_get_integer (my_buffer, "number")); @@ -13000,7 +13000,7 @@ weechat.prnt("", "my buffer number is: %d" % weechat.buffer_get_integer(my_buffe プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_buffer_get_string (struct t_gui_buffer *buffer, const char *property); @@ -13034,7 +13034,7 @@ const char *weechat_buffer_get_string (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "name / short name of buffer are: %s / %s", weechat_buffer_get_string (my_buffer, "name"), @@ -13060,7 +13060,7 @@ weechat.prnt("", "name / short name of buffer are: %s / %s" プロトタイプ: -[source,C] +[source,c] ---- void *weechat_buffer_pointer (struct t_gui_buffer *buffer, const char *property); @@ -13080,7 +13080,7 @@ void *weechat_buffer_pointer (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "plugin pointer of my buffer: %lx", weechat_buffer_get_pointer (my_buffer, "plugin")); @@ -13103,7 +13103,7 @@ weechat.prnt("", "plugin pointer of my buffer: %s" % weechat.buffer_get_pointer( プロトタイプ: -[source,C] +[source,c] ---- void weechat_buffer_set (struct t_gui_buffer *buffer, const char *property, const char *value); @@ -13270,7 +13270,7 @@ void weechat_buffer_set (struct t_gui_buffer *buffer, const char *property, C 言語での使用例: -[source,C] +[source,c] ---- /* disable hotlist (for all buffers) */ weechat_buffer_set (NULL, "hotlist", "-"); @@ -13319,7 +13319,7 @@ weechat.buffer_set(my_buffer, "localvar_del_toto", "") プロトタイプ: -[source,C] +[source,c] ---- void weechat_buffer_set_pointer (struct t_gui_buffer *buffer, const char *property, void *pointer); @@ -13341,7 +13341,7 @@ void weechat_buffer_set_pointer (struct t_gui_buffer *buffer, const char *proper コールバックのプロトタイプ: -[source,C] +[source,c] ---- int close_callback (const void *pointer, void *data, struct t_gui_buffer *buffer); @@ -13356,7 +13356,7 @@ int nickcmp_callback (const void *pointer, void *data, C 言語での使用例: -[source,C] +[source,c] ---- int my_close_cb (const void *pointer, void *data, struct t_gui_buffer *buffer) @@ -13377,7 +13377,7 @@ weechat_buffer_set_pointer (my_buffer, "close_callback", &my_close_cb); プロトタイプ: -[source,C] +[source,c] ---- char *weechat_buffer_string_replace_local_var (struct t_gui_buffer *buffer, const char *string); @@ -13394,7 +13394,7 @@ char *weechat_buffer_string_replace_local_var (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- weechat_buffer_set (my_buffer, "localvar_set_toto", "abc"); @@ -13424,7 +13424,7 @@ _WeeChat バージョン 0.3.5 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_buffer_match_list (struct t_gui_buffer *buffer, const char *string); ---- @@ -13443,7 +13443,7 @@ int weechat_buffer_match_list (struct t_gui_buffer *buffer, const char *string); C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_buffer *buffer = weechat_buffer_search ("irc", "libera.#weechat"); if (buffer) @@ -13482,7 +13482,7 @@ if buffer: プロトタイプ: -[source,C] +[source,c] ---- struct t_gui_window *weechat_current_window (); ---- @@ -13493,7 +13493,7 @@ struct t_gui_window *weechat_current_window (); C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_window *current_window = weechat_current_window (); ---- @@ -13517,7 +13517,7 @@ _WeeChat バージョン 0.3.5 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_gui_window *weechat_window_search_with_buffer (struct t_gui_buffer *buffer); ---- @@ -13532,7 +13532,7 @@ struct t_gui_window *weechat_window_search_with_buffer (struct t_gui_buffer *buf C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "window displaying core buffer: %lx", @@ -13557,7 +13557,7 @@ weechat.prnt("", "window displaying core buffer: %s" プロトタイプ: -[source,C] +[source,c] ---- int weechat_window_get_integer (struct t_gui_window *window, const char *property); @@ -13592,7 +13592,7 @@ int weechat_window_get_integer (struct t_gui_window *window, C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "current window is at position (x,y): (%d,%d)", weechat_window_get_integer (weechat_current_window (), "win_x"), @@ -13621,7 +13621,7 @@ weechat.prnt("", "current window is at position (x,y): (%d,%d)" プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_window_get_string (struct t_gui_window *window, const char *property); @@ -13650,7 +13650,7 @@ def window_get_string(window: str, property: str) -> str: ... プロトタイプ: -[source,C] +[source,c] ---- void *weechat_window_get_pointer (struct t_gui_window *window, const char *property); @@ -13669,7 +13669,7 @@ void *weechat_window_get_pointer (struct t_gui_window *window, C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "buffer displayed in current window: %lx", @@ -13694,7 +13694,7 @@ weechat.prnt("", "buffer displayed in current window: %s" プロトタイプ: -[source,C] +[source,c] ---- void weechat_window_set_title (const char *title); ---- @@ -13707,7 +13707,7 @@ void weechat_window_set_title (const char *title); C 言語での使用例: -[source,C] +[source,c] ---- weechat_window_set_title ("new title here"); ---- @@ -13734,7 +13734,7 @@ weechat.window_set_title("new title here") プロトタイプ: -[source,C] +[source,c] ---- struct t_gui_nick_group *weechat_nicklist_add_group (struct t_gui_buffer *buffer, struct t_gui_nick_group *parent_group, @@ -13772,7 +13772,7 @@ struct t_gui_nick_group *weechat_nicklist_add_group (struct t_gui_buffer *buffer C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_nick_group *my_group = weechat_nicklist_add_group (my_buffer, @@ -13800,7 +13800,7 @@ group = weechat.nicklist_add_group(my_buffer, my_parent_group, "test_group", プロトタイプ: -[source,C] +[source,c] ---- struct t_gui_nick_group *weechat_nicklist_search_group (struct t_gui_buffer *buffer, struct t_gui_nick_group *from_group, @@ -13820,7 +13820,7 @@ struct t_gui_nick_group *weechat_nicklist_search_group (struct t_gui_buffer *buf C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_nick_group *ptr_group = weechat_nicklist_search_group (my_buffer, NULL, "test_group"); @@ -13843,7 +13843,7 @@ group = weechat.nicklist_search_group(my_buffer, "", "test_group") プロトタイプ: -[source,C] +[source,c] ---- struct t_gui_nick_group *weechat_nicklist_add_nick (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -13884,7 +13884,7 @@ struct t_gui_nick_group *weechat_nicklist_add_nick (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_nick *my_nick = weechat_nicklist_add_nick (my_buffer, my_group, @@ -13915,7 +13915,7 @@ nick = weechat.nicklist_add_nick(my_buffer, my_group, "test_nick", color, "@", " プロトタイプ: -[source,C] +[source,c] ---- struct t_gui_nick *weechat_nicklist_search_nick (struct t_gui_buffer *buffer, struct t_gui_nick_group *from_group, @@ -13935,7 +13935,7 @@ struct t_gui_nick *weechat_nicklist_search_nick (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_nick *ptr_nick = weechat_nicklist_search_nick (my_buffer, NULL, "test_nick"); @@ -13958,7 +13958,7 @@ nick = weechat.nicklist_search_nick(my_buffer, "", "test_nick") プロトタイプ: -[source,C] +[source,c] ---- void weechat_nicklist_remove_group (struct t_gui_buffer *buffer, struct t_gui_nick_group *group); @@ -13971,7 +13971,7 @@ void weechat_nicklist_remove_group (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- weechat_nicklist_remove_group (my_buffer, my_group); ---- @@ -13993,7 +13993,7 @@ weechat.nicklist_remove_group(my_buffer, my_group) プロトタイプ: -[source,C] +[source,c] ---- void weechat_nicklist_remove_nick (struct t_gui_buffer *buffer, struct t_gui_nick *nick); @@ -14006,7 +14006,7 @@ void weechat_nicklist_remove_nick (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- weechat_nicklist_remove_nick (my_buffer, my_nick); ---- @@ -14028,7 +14028,7 @@ weechat.nicklist_remove_nick(my_buffer, my_nick) プロトタイプ: -[source,C] +[source,c] ---- void weechat_nicklist_remove_all (struct t_gui_buffer *buffer); ---- @@ -14039,7 +14039,7 @@ void weechat_nicklist_remove_all (struct t_gui_buffer *buffer); C 言語での使用例: -[source,C] +[source,c] ---- weechat_nicklist_remove_all (my_buffer); ---- @@ -14063,7 +14063,7 @@ _WeeChat バージョン 0.3.7 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- void weechat_nicklist_get_next_item (struct t_gui_buffer *buffer, struct t_gui_nick_group **group, @@ -14078,7 +14078,7 @@ void weechat_nicklist_get_next_item (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_nick_group *ptr_group; struct t_gui_nick *ptr_nick; @@ -14113,7 +14113,7 @@ _WeeChat バージョン 0.3.4 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_nicklist_group_get_integer (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14134,7 +14134,7 @@ int weechat_nicklist_group_get_integer (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- int visible = weechat_nicklist_group_get_integer (buffer, group, "visible"); ---- @@ -14158,7 +14158,7 @@ _WeeChat バージョン 0.3.4 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_nicklist_group_get_string (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14179,7 +14179,7 @@ const char *weechat_nicklist_group_get_string (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- const char *color = weechat_nicklist_group_get_string (buffer, group, "color"); ---- @@ -14203,7 +14203,7 @@ _WeeChat バージョン 0.3.4 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- void *weechat_nicklist_group_get_pointer (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14223,7 +14223,7 @@ void *weechat_nicklist_group_get_pointer (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_nick_group *parent = weechat_nicklist_group_get_pointer (buffer, group, "parent"); ---- @@ -14247,7 +14247,7 @@ _WeeChat バージョン 0.3.4 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- void weechat_nicklist_group_set (struct t_gui_buffer *buffer, struct t_gui_nick_group *group, @@ -14278,7 +14278,7 @@ void weechat_nicklist_group_set (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- /* change group color to "bar_fg" */ weechat_nicklist_group_set (buffer, group, "color", "bar_fg"); @@ -14317,7 +14317,7 @@ _WeeChat バージョン 0.3.4 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_nicklist_nick_get_integer (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -14337,7 +14337,7 @@ int weechat_nicklist_nick_get_integer (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- int visible = weechat_nicklist_nick_get_integer (buffer, nick, "visible"); ---- @@ -14361,7 +14361,7 @@ _WeeChat バージョン 0.3.4 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_nicklist_nick_get_string (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -14384,7 +14384,7 @@ const char *weechat_nicklist_nick_get_string (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- const char *color = weechat_nicklist_nick_get_string (buffer, nick, "color"); ---- @@ -14408,7 +14408,7 @@ _WeeChat バージョン 0.3.4 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- void *weechat_nicklist_nick_get_pointer (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -14428,7 +14428,7 @@ void *weechat_nicklist_nick_get_pointer (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_nick_group *group = weechat_nicklist_nick_get_pointer (buffer, nick, "group"); ---- @@ -14452,7 +14452,7 @@ _WeeChat バージョン 0.3.4 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- void weechat_nicklist_nick_set (struct t_gui_buffer *buffer, struct t_gui_nick *nick, @@ -14490,7 +14490,7 @@ void weechat_nicklist_nick_set (struct t_gui_buffer *buffer, C 言語での使用例: -[source,C] +[source,c] ---- /* change nick color to cyan */ weechat_nicklist_nick_set (buffer, nick, "color", "cyan"); @@ -14538,7 +14538,7 @@ weechat.nicklist_nick_set(buffer, nick, "visible", "0") プロトタイプ: -[source,C] +[source,c] ---- struct t_gui_bar_item *weechat_bar_item_search (const char *name); ---- @@ -14553,7 +14553,7 @@ struct t_gui_bar_item *weechat_bar_item_search (const char *name); C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_bar_item *bar_item = weechat_bar_item_search ("myitem"); ---- @@ -14577,7 +14577,7 @@ _WeeChat バージョン 0.4.2 と 1.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_gui_bar_item *weechat_bar_item_new (const char *name, char *(*build_callback)(const void *pointer, @@ -14618,7 +14618,7 @@ struct t_gui_bar_item *weechat_bar_item_new (const char *name, C 言語での使用例: -[source,C] +[source,c] ---- char * my_build_callback (const void *pointer, void *data, @@ -14667,7 +14667,7 @@ _build_callback_ コールバックを呼び出してバー要素の内容を更 プロトタイプ: -[source,C] +[source,c] ---- void weechat_bar_item_update (const char *name); ---- @@ -14678,7 +14678,7 @@ void weechat_bar_item_update (const char *name); C 言語での使用例: -[source,C] +[source,c] ---- weechat_bar_item_update ("myitem"); ---- @@ -14700,7 +14700,7 @@ weechat.bar_item_update("myitem") プロトタイプ: -[source,C] +[source,c] ---- void weechat_bar_item_remove (struct t_gui_bar_item *item); ---- @@ -14711,7 +14711,7 @@ void weechat_bar_item_remove (struct t_gui_bar_item *item); C 言語での使用例: -[source,C] +[source,c] ---- weechat_bar_item_remove (&my_item); ---- @@ -14733,7 +14733,7 @@ weechat.bar_item_remove(myitem) プロトタイプ: -[source,C] +[source,c] ---- struct t_gui_bar *weechat_bar_search (const char *name); ---- @@ -14748,7 +14748,7 @@ struct t_gui_bar *weechat_bar_search (const char *name); C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_bar *bar = weechat_bar_search ("mybar"); ---- @@ -14772,7 +14772,7 @@ _WeeChat バージョン 2.9 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_gui_bar *weechat_bar_new (const char *name, const char *hidden, @@ -14839,7 +14839,7 @@ struct t_gui_bar *weechat_bar_new (const char *name, C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_bar *my_bar = weechat_bar_new ("mybar", "off", @@ -14887,7 +14887,7 @@ link:++weechat_scripting.en.html#_ruby++[WeeChat scripting guide] for more info. プロトタイプ: -[source,C] +[source,c] ---- int weechat_bar_set (struct t_gui_bar *bar, const char *property, const char *value); @@ -14905,7 +14905,7 @@ int weechat_bar_set (struct t_gui_bar *bar, const char *property, C 言語での使用例: -[source,C] +[source,c] ---- weechat_bar_set (mybar, "position", "bottom"); ---- @@ -14927,7 +14927,7 @@ weechat.bar_set(my_bar, "position", "bottom") プロトタイプ: -[source,C] +[source,c] ---- void weechat_bar_update (const char *name); ---- @@ -14938,7 +14938,7 @@ void weechat_bar_update (const char *name); C 言語での使用例: -[source,C] +[source,c] ---- weechat_bar_update ("mybar"); ---- @@ -14960,7 +14960,7 @@ weechat.bar_update("mybar") プロトタイプ: -[source,C] +[source,c] ---- void weechat_bar_remove (struct t_gui_bar *bar); ---- @@ -14971,7 +14971,7 @@ void weechat_bar_remove (struct t_gui_bar *bar); C 言語での使用例: -[source,C] +[source,c] ---- weechat_bar_remove (mybar); ---- @@ -15000,7 +15000,7 @@ _WeeChat バージョン 1.1 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_command (struct t_gui_buffer *buffer, const char *command); ---- @@ -15019,7 +15019,7 @@ int weechat_command (struct t_gui_buffer *buffer, const char *command); C 言語での使用例: -[source,C] +[source,c] ---- int rc; rc = weechat_command (weechat_buffer_search ("irc", "libera.#weechat"), @@ -15045,7 +15045,7 @@ _WeeChat バージョン 2.5 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_command_options (struct t_gui_buffer *buffer, const char *command, struct t_hashtable *options); @@ -15072,7 +15072,7 @@ int weechat_command_options (struct t_gui_buffer *buffer, const char *command, C 言語での使用例: -[source,C] +[source,c] ---- /* /exec 以外のコマンド実行を許可、2 秒後にコマンドを実行 */ int rc; @@ -15112,7 +15112,7 @@ Create a new completion. プロトタイプ: -[source,C] +[source,c] ---- struct t_gui_completion *weechat_completion_new (struct t_gui_buffer *buffer); ---- @@ -15127,7 +15127,7 @@ Return value: C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_completion *completion = weechat_completion_new (weechat_buffer_search_main ()); ---- @@ -15153,7 +15153,7 @@ context. プロトタイプ: -[source,C] +[source,c] ---- int weechat_completion_search (struct t_gui_completion *completion, const char *data, int position, int direction); @@ -15172,7 +15172,7 @@ int weechat_completion_search (struct t_gui_completion *completion, const char * C 言語での使用例: -[source,C] +[source,c] ---- struct t_gui_completion *completion = weechat_completion_new (weechat_buffer_search_main ()); if (weechat_completion_search (completion, "/help filt", 10, 1)) @@ -15202,7 +15202,7 @@ _WeeChat バージョン 2.9 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_completion_get_string (struct t_gui_completion *completion, const char *property); @@ -15218,7 +15218,7 @@ const char *weechat_completion_get_string (struct t_gui_completion *completion, C 言語での使用例: -[source,C] +[source,c] ---- int my_completion_cb (const void *pointer, void *data, const char *completion_item, @@ -15259,7 +15259,7 @@ _WeeChat バージョン 2.9 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- void weechat_completion_list_add (struct t_gui_completion *completion, const char *word, @@ -15299,7 +15299,7 @@ Free a completion. プロトタイプ: -[source,C] +[source,c] ---- void weechat_completion_free (struct t_gui_completion *completion); ---- @@ -15310,7 +15310,7 @@ void weechat_completion_free (struct t_gui_completion *completion); C 言語での使用例: -[source,C] +[source,c] ---- weechat_completion_free (completion); ---- @@ -15341,7 +15341,7 @@ WeeChat がこれを遮断しないように必ずフォークしたプロセス プロトタイプ: -[source,C] +[source,c] ---- int weechat_network_pass_proxy (const char *proxy, int sock, @@ -15362,7 +15362,7 @@ int weechat_network_pass_proxy (const char *proxy, C 言語での使用例: -[source,C] +[source,c] ---- if (weechat_network_pass_proxy ("my_proxy", sock, "irc.libera.chat", 6667)) { @@ -15389,7 +15389,7 @@ WeeChat がこれを遮断しないように必ずフォークしたプロセス プロトタイプ: -[source,C] +[source,c] ---- int weechat_network_connect_to (const char *proxy, struct sockaddr *address, @@ -15408,7 +15408,7 @@ int weechat_network_connect_to (const char *proxy, C 言語での使用例: -[source,C] +[source,c] ---- struct sockaddr *addr; socklen_t length; @@ -15444,7 +15444,7 @@ _WeeChat バージョン 2.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- char *weechat_info_get (const char *info_name, const char *arguments); ---- @@ -15470,7 +15470,7 @@ include::includes/autogen_api_infos.ja.adoc[tag=infos] C 言語での使用例: -[source,C] +[source,c] ---- char *version = weechat_info_get ("version", NULL); char *date = weechat_info_get ("date", NULL); @@ -15508,7 +15508,7 @@ _WeeChat バージョン 0.3.4 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_hashtable *weechat_info_get_hashtable (const char *info_name, struct t_hashtable *hashtable); @@ -15530,7 +15530,7 @@ include::includes/autogen_api_infos_hashtable.ja.adoc[tag=infos_hashtable] C 言語での使用例: -[source,C] +[source,c] ---- struct t_hashtable *hashtable_in, *hashtable_out; @@ -15614,7 +15614,7 @@ weechat.prnt("", "message parsed: %s" プロトタイプ: -[source,C] +[source,c] ---- struct t_infolist *weechat_infolist_new (); ---- @@ -15625,7 +15625,7 @@ struct t_infolist *weechat_infolist_new (); C 言語での使用例: -[source,C] +[source,c] ---- struct t_infolist *infolist = weechat_infolist_new (); ---- @@ -15647,7 +15647,7 @@ infolist = weechat.infolist_new() プロトタイプ: -[source,C] +[source,c] ---- struct t_infolist_item *weechat_infolist_new_item (struct t_infolist *infolist); ---- @@ -15662,7 +15662,7 @@ struct t_infolist_item *weechat_infolist_new_item (struct t_infolist *infolist); C 言語での使用例: -[source,C] +[source,c] ---- struct t_infolist_item *item = weechat_infolist_new_item (infolist); ---- @@ -15684,7 +15684,7 @@ item = weechat.infolist_new_item(infolist) プロトタイプ: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_integer (struct t_infolist_item *item, const char *name, @@ -15703,7 +15703,7 @@ struct t_infolist_var *weechat_infolist_new_var_integer (struct t_infolist_item C 言語での使用例: -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_integer (item, "my_integer", @@ -15727,7 +15727,7 @@ var = weechat.infolist_new_var_integer(item, "my_integer", 123) プロトタイプ: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_string (struct t_infolist_item *item, const char *name, @@ -15746,7 +15746,7 @@ struct t_infolist_var *weechat_infolist_new_var_string (struct t_infolist_item * C 言語での使用例: -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_string (item, "my_string", @@ -15770,7 +15770,7 @@ var = weechat.infolist_new_var_string(item, "my_string", "value") プロトタイプ: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_pointer (struct t_infolist_item *item, const char *name, @@ -15789,7 +15789,7 @@ struct t_infolist_var *weechat_infolist_new_var_pointer (struct t_infolist_item C 言語での使用例: -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_pointer (item, "my_pointer", @@ -15813,7 +15813,7 @@ var = weechat.infolist_new_var_pointer(item, "my_pointer", pointer) プロトタイプ: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_buffer (struct t_infolist_item *item, const char *name, @@ -15834,7 +15834,7 @@ struct t_infolist_var *weechat_infolist_new_var_buffer (struct t_infolist_item * C 言語での使用例: -[source,C] +[source,c] ---- char buffer[256]; /* ... */ @@ -15853,7 +15853,7 @@ struct t_infolist_var *var = weechat_infolist_new_var_buffer (item, プロトタイプ: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_new_var_time (struct t_infolist_item *item, const char *name, @@ -15872,7 +15872,7 @@ struct t_infolist_var *weechat_infolist_new_var_time (struct t_infolist_item *it C 言語での使用例: -[source,C] +[source,c] ---- struct t_infolist_var *var = weechat_infolist_new_var_time (item, "my_time", @@ -15903,7 +15903,7 @@ WeeChat またはプラグインからインフォリストを返す。 プロトタイプ: -[source,C] +[source,c] ---- struct t_infolist *weechat_infolist_get (const char *infolist_name, void *pointer, @@ -15928,7 +15928,7 @@ include::includes/autogen_api_infolists.ja.adoc[tag=infolists] C 言語での使用例: -[source,C] +[source,c] ---- struct t_infolist *infolist = weechat_infolist_get ("irc_server", NULL, NULL); ---- @@ -15951,7 +15951,7 @@ infolist = weechat.infolist_get("irc_server", "", "") プロトタイプ: -[source,C] +[source,c] ---- int weechat_infolist_next (struct t_infolist *infolist); ---- @@ -15966,7 +15966,7 @@ int weechat_infolist_next (struct t_infolist *infolist); C 言語での使用例: -[source,C] +[source,c] ---- if (weechat_infolist_next (infolist)) { @@ -16000,7 +16000,7 @@ else: プロトタイプ: -[source,C] +[source,c] ---- int weechat_infolist_prev (struct t_infolist *infolist); ---- @@ -16016,7 +16016,7 @@ int weechat_infolist_prev (struct t_infolist *infolist); C 言語での使用例: -[source,C] +[source,c] ---- if (weechat_infolist_prev (infolist)) { @@ -16049,7 +16049,7 @@ else: プロトタイプ: -[source,C] +[source,c] ---- void weechat_infolist_reset_item_cursor (struct t_infolist *infolist); ---- @@ -16060,7 +16060,7 @@ void weechat_infolist_reset_item_cursor (struct t_infolist *infolist); C 言語での使用例: -[source,C] +[source,c] ---- weechat_infolist_reset_item_cursor (infolist); ---- @@ -16084,7 +16084,7 @@ _WeeChat バージョン 0.4.3 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_infolist_var *weechat_infolist_search_var (struct t_infolist *infolist, const char *name); @@ -16101,7 +16101,7 @@ struct t_infolist_var *weechat_infolist_search_var (struct t_infolist *infolist, C 言語での使用例: -[source,C] +[source,c] ---- if (weechat_infolist_search_var (infolist, "name")) { @@ -16129,7 +16129,7 @@ if weechat.infolist_search_var(infolist, "name"): プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_infolist_fields (struct t_infolist *infolist); ---- @@ -16146,7 +16146,7 @@ const char *weechat_infolist_fields (struct t_infolist *infolist); C 言語での使用例: -[source,C] +[source,c] ---- const char *fields = weechat_infolist_fields (infolist); /* fields contains something like: @@ -16172,7 +16172,7 @@ fields = weechat.infolist_fields(infolist) プロトタイプ: -[source,C] +[source,c] ---- int weechat_infolist_integer (struct t_infolist *infolist, const char *var); ---- @@ -16188,7 +16188,7 @@ int weechat_infolist_integer (struct t_infolist *infolist, const char *var); C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "integer = %d", weechat_infolist_integer (infolist, "my_integer")); @@ -16211,7 +16211,7 @@ weechat.prnt("", "integer = %d" % weechat.infolist_integer(infolist, "my_integer プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_infolist_string (struct t_infolist *infolist, const char *var); ---- @@ -16227,7 +16227,7 @@ const char *weechat_infolist_string (struct t_infolist *infolist, const char *va C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "string = %s", weechat_infolist_string (infolist, "my_string")); @@ -16250,7 +16250,7 @@ weechat.prnt("", "string = %s" % weechat.infolist_string(infolist, "my_string")) プロトタイプ: -[source,C] +[source,c] ---- void *weechat_infolist_pointer (struct t_infolist *infolist, const char *var); ---- @@ -16266,7 +16266,7 @@ void *weechat_infolist_pointer (struct t_infolist *infolist, const char *var); C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "pointer = 0x%lx", weechat_infolist_pointer (infolist, "my_pointer")); @@ -16289,7 +16289,7 @@ weechat.prnt("", "pointer = 0x%s" % weechat.infolist_pointer(infolist, "my_point プロトタイプ: -[source,C] +[source,c] ---- void *weechat_infolist_buffer (struct t_infolist *infolist, const char *var, int *size); @@ -16307,7 +16307,7 @@ void *weechat_infolist_buffer (struct t_infolist *infolist, const char *var, C 言語での使用例: -[source,C] +[source,c] ---- int size; void *pointer = weechat_infolist_buffer (infolist, "my_buffer", &size); @@ -16324,7 +16324,7 @@ weechat_printf (NULL, "buffer = 0x%lx, size = %d", プロトタイプ: -[source,C] +[source,c] ---- time_t weechat_infolist_time (struct t_infolist *infolist, const char *var); ---- @@ -16340,7 +16340,7 @@ time_t weechat_infolist_time (struct t_infolist *infolist, const char *var); C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "time = %ld", weechat_infolist_time (infolist, "my_time")); @@ -16363,7 +16363,7 @@ weechat.prnt("", "time = %ld" % weechat.infolist_time(infolist, "my_time")) プロトタイプ: -[source,C] +[source,c] ---- void weechat_infolist_free (struct t_infolist *infolist); ---- @@ -16374,7 +16374,7 @@ void weechat_infolist_free (struct t_infolist *infolist); C 言語での使用例: -[source,C] +[source,c] ---- weechat_infolist_free (infolist); ---- @@ -16420,7 +16420,7 @@ Hdata を使うことで高速に WeeChat およびプラグインのデータ プロトタイプ: -[source,C] +[source,c] ---- struct t_hdata *weechat_hdata_new (const char *hdata_name, const char *var_prev, const char *var_next, int create_allowed, int delete_allowed, @@ -16458,7 +16458,7 @@ struct t_hdata *weechat_hdata_new (const char *hdata_name, const char *var_prev, C 言語での使用例: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_new ("myplugin_list", "prev", "next", 0, 0, &callback_update, NULL); ---- @@ -16475,7 +16475,7 @@ hdata に新しい変数を作成。 プロトタイプ: -[source,C] +[source,c] ---- void weechat_hdata_new_var (struct t_hdata *hdata, const char *name, int offset, int type, int update_allowed, const char *array_size, const char *hdata_name); @@ -16541,7 +16541,7 @@ Examples of variables and the corresponding array size (_WeeChat ≥ 3.4_): C 言語での使用例: -[source,C] +[source,c] ---- struct t_myplugin_list { @@ -16570,7 +16570,7 @@ weechat_hdata_new_var (hdata, "next", offsetof (struct t_myplugin_list, next), W コードを短くするためにはマクロ "WEECHAT_HDATA_VAR" を使います。 -[source,C] +[source,c] ---- WEECHAT_HDATA_VAR(struct t_myplugin_list, name, STRING, 0, NULL, NULL); WEECHAT_HDATA_VAR(struct t_myplugin_list, buffer, POINTER, 0, NULL, NULL); @@ -16593,7 +16593,7 @@ hdata に新しいリストへのポインタを作成。 プロトタイプ: -[source,C] +[source,c] ---- void weechat_hdata_new_list (struct t_hdata *hdata, const char *name, void *pointer, int flags); ---- @@ -16608,7 +16608,7 @@ void weechat_hdata_new_list (struct t_hdata *hdata, const char *name, void *poin C 言語での使用例: -[source,C] +[source,c] ---- struct t_myplugin_list { @@ -16638,7 +16638,7 @@ weechat_hdata_new_list (hdata, "last_buffer", &last_buffer, 0); コードを短くするためにはマクロ "WEECHAT_HDATA_LIST" を使います。 -[source,C] +[source,c] ---- WEECHAT_HDATA_LIST(buffers, WEECHAT_HDATA_LIST_CHECK_POINTERS); WEECHAT_HDATA_LIST(last_buffer, 0); @@ -16660,7 +16660,7 @@ hdata と WeeChat およびプラグインへのポインタが必要です。 プロトタイプ: -[source,C] +[source,c] ---- struct t_hdata *weechat_hdata_get (const char *hdata_name); ---- @@ -16679,7 +16679,7 @@ include::includes/autogen_api_hdata.ja.adoc[tag=hdata] C 言語での使用例: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("irc_server"); ---- @@ -16703,7 +16703,7 @@ hdata における変数のオフセットを返す。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_hdata_get_var_offset (struct t_hdata *hdata, const char *name); ---- @@ -16719,7 +16719,7 @@ int weechat_hdata_get_var_offset (struct t_hdata *hdata, const char *name); C 言語での使用例: -[source,C] +[source,c] ---- int offset = weechat_hdata_get_var_offset (hdata, "name"); ---- @@ -16743,7 +16743,7 @@ hdata 内の変数の型を (整数で) 返す。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_hdata_get_var_type (struct t_hdata *hdata, const char *name); ---- @@ -16759,7 +16759,7 @@ int weechat_hdata_get_var_type (struct t_hdata *hdata, const char *name); C 言語での使用例: -[source,C] +[source,c] ---- int type = weechat_hdata_get_var_type (hdata, "name"); switch (type) @@ -16808,7 +16808,7 @@ _WeeChat バージョン 0.3.6 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_hdata_get_var_type_string (struct t_hdata *hdata, const char *name); ---- @@ -16824,7 +16824,7 @@ const char *weechat_hdata_get_var_type_string (struct t_hdata *hdata, const char C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "type = %s", weechat_hdata_get_var_type_string (hdata, "name")); ---- @@ -16848,7 +16848,7 @@ hdata に含まれる配列変数のサイズを返す。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_hdata_get_var_array_size (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -16865,7 +16865,7 @@ int weechat_hdata_get_var_array_size (struct t_hdata *hdata, void *pointer, cons C 言語での使用例: -[source,C] +[source,c] ---- int array_size = weechat_hdata_get_var_array_size (hdata, pointer, "name"); ---- @@ -16889,7 +16889,7 @@ hdata に含まれる配列変数のサイズを (文字列で) 返す。 プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_hdata_get_var_array_size_string (struct t_hdata *hdata, void *pointer, const char *name); @@ -16908,7 +16908,7 @@ const char *weechat_hdata_get_var_array_size_string (struct t_hdata *hdata, void C 言語での使用例: -[source,C] +[source,c] ---- const char *array_size = weechat_hdata_get_var_array_size_string (hdata, pointer, "name"); ---- @@ -16932,7 +16932,7 @@ hdata に含まれる変数に対応する hdata を返す。 プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_hdata_get_var_hdata (struct t_hdata *hdata, const char *name); ---- @@ -16948,7 +16948,7 @@ const char *weechat_hdata_get_var_hdata (struct t_hdata *hdata, const char *name C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "hdata = %s", weechat_hdata_get_var_hdata (hdata, "name")); ---- @@ -16972,7 +16972,7 @@ hdata に含まれる変数の内容へのポインタを返す。 プロトタイプ: -[source,C] +[source,c] ---- void *weechat_hdata_get_var (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -16989,7 +16989,7 @@ void *weechat_hdata_get_var (struct t_hdata *hdata, void *pointer, const char *n C 言語での使用例: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17007,7 +17007,7 @@ _WeeChat バージョン 0.3.6 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- void *weechat_hdata_get_var_at_offset (struct t_hdata *hdata, void *pointer, int offset); ---- @@ -17024,7 +17024,7 @@ void *weechat_hdata_get_var_at_offset (struct t_hdata *hdata, void *pointer, int C 言語での使用例: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17043,7 +17043,7 @@ hdata からリストへのポインタを返す。 プロトタイプ: -[source,C] +[source,c] ---- void *weechat_hdata_get_list (struct t_hdata *hdata, const char *name); ---- @@ -17059,7 +17059,7 @@ void *weechat_hdata_get_list (struct t_hdata *hdata, const char *name); C 言語での使用例: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffers = weechat_hdata_get_list (hdata, "gui_buffers"); @@ -17085,7 +17085,7 @@ hdata とリストへのポインタを使ってポインタの妥当性を確 プロトタイプ: -[source,C] +[source,c] ---- int weechat_hdata_check_pointer (struct t_hdata *hdata, void *list, void *pointer); ---- @@ -17105,7 +17105,7 @@ int weechat_hdata_check_pointer (struct t_hdata *hdata, void *list, void *pointe C 言語での使用例: -[source,C] +[source,c] ---- /* check if a buffer pointer is valid */ struct t_hdata *hdata = weechat_hdata_get ("buffer"); @@ -17146,7 +17146,7 @@ _WeeChat バージョン 0.3.6 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- void *weechat_hdata_move (struct t_hdata *hdata, void *pointer, int count); ---- @@ -17165,7 +17165,7 @@ void *weechat_hdata_move (struct t_hdata *hdata, void *pointer, int count); C 言語での使用例: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17206,7 +17206,7 @@ _WeeChat バージョン 0.4.1 以上で利用可、バージョン 3.4 で更 プロトタイプ: -[source,C] +[source,c] ---- void *weechat_hdata_search (struct t_hdata *hdata, void *pointer, const char *search, struct t_hashtable *pointers, struct t_hashtable *extra_vars, @@ -17241,7 +17241,7 @@ referenced by `${xxx}` in the _search_ expression (see the example below). C 言語での使用例: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("irc_server"); void *servers = weechat_hdata_get_list (hdata, "irc_servers"); @@ -17290,7 +17290,7 @@ hdata を使って構造体に含まれる文字型変数の値を返す。 プロトタイプ: -[source,C] +[source,c] ---- char weechat_hdata_char (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17308,7 +17308,7 @@ char weechat_hdata_char (struct t_hdata *hdata, void *pointer, const char *name) C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "letter = %c", weechat_hdata_char (hdata, pointer, "letter")); ---- @@ -17332,7 +17332,7 @@ hdata を使って構造体に含まれる整数型変数の値を返す。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_hdata_integer (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17350,7 +17350,7 @@ int weechat_hdata_integer (struct t_hdata *hdata, void *pointer, const char *nam C 言語での使用例: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17378,7 +17378,7 @@ hdata を使って構造体に含まれる long 型変数の値を返す。 プロトタイプ: -[source,C] +[source,c] ---- long weechat_hdata_long (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17396,7 +17396,7 @@ long weechat_hdata_long (struct t_hdata *hdata, void *pointer, const char *name) C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "longvar = %ld", weechat_hdata_long (hdata, pointer, "longvar")); ---- @@ -17420,7 +17420,7 @@ hdata を使って構造体に含まれる文字列型変数の値を返す。 プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_hdata_string (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17438,7 +17438,7 @@ const char *weechat_hdata_string (struct t_hdata *hdata, void *pointer, const ch C 言語での使用例: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17466,7 +17466,7 @@ hdata を使って構造体に含まれるポインタ型変数の値を返す プロトタイプ: -[source,C] +[source,c] ---- void *weechat_hdata_pointer (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17484,7 +17484,7 @@ void *weechat_hdata_pointer (struct t_hdata *hdata, void *pointer, const char *n C 言語での使用例: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17512,7 +17512,7 @@ hdata を使って構造体に含まれる時刻型変数の値を返す。 プロトタイプ: -[source,C] +[source,c] ---- time_t weechat_hdata_time (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17530,7 +17530,7 @@ time_t weechat_hdata_time (struct t_hdata *hdata, void *pointer, const char *nam C 言語での使用例: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *ptr = weechat_buffer_search_main (); @@ -17580,7 +17580,7 @@ hdata を使って構造体に含まれるハッシュテーブル型変数の プロトタイプ: -[source,C] +[source,c] ---- struct t_hashtable *weechat_hdata_hashtable (struct t_hdata *hdata, void *pointer, const char *name); ---- @@ -17598,7 +17598,7 @@ struct t_hashtable *weechat_hdata_hashtable (struct t_hdata *hdata, void *pointe C 言語での使用例: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer = weechat_buffer_search_main (); @@ -17631,7 +17631,7 @@ _WeeChat バージョン 1.9 以上で利用可。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_hdata_compare (struct t_hdata *hdata, void *pointer1, void *pointer2, const char *name, int case_sensitive); ---- @@ -17653,7 +17653,7 @@ int weechat_hdata_compare (struct t_hdata *hdata, void *pointer1, void *pointer2 C 言語での使用例: -[source,C] +[source,c] ---- struct t_hdata *hdata = weechat_hdata_get ("buffer"); struct t_gui_buffer *buffer1 = weechat_buffer_search ("irc", "libera.#weechat"); @@ -17689,7 +17689,7 @@ hdata の変数に新しい値を設定。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_hdata_set (struct t_hdata *hdata, void *pointer, const char *name, const char *value); ---- @@ -17708,7 +17708,7 @@ int weechat_hdata_set (struct t_hdata *hdata, void *pointer, const char *name, c C 言語での使用例: -[source,C] +[source,c] ---- weechat_hdata_set (hdata, pointer, "message", "test"); ---- @@ -17724,7 +17724,7 @@ hdata 内のデータを更新。 プロトタイプ: -[source,C] +[source,c] ---- int weechat_hdata_update (struct t_hdata *hdata, void *pointer, struct t_hashtable *hashtable); ---- @@ -17750,7 +17750,7 @@ int weechat_hdata_update (struct t_hdata *hdata, void *pointer, struct t_hashtab C 言語での使用例: -[source,C] +[source,c] ---- /* 現在のバッファに表示されている最後のメッセージの時間を 1 時間前にする */ @@ -17810,7 +17810,7 @@ hdata プロパティの文字列値を返す。 プロトタイプ: -[source,C] +[source,c] ---- const char *weechat_hdata_get_string (struct t_hdata *hdata, const char *property); ---- @@ -17842,7 +17842,7 @@ const char *weechat_hdata_get_string (struct t_hdata *hdata, const char *propert C 言語での使用例: -[source,C] +[source,c] ---- weechat_printf (NULL, "variables in hdata: %s", weechat_hdata_get_string (hdata, "var_keys")); weechat_printf (NULL, "lists in hdata: %s", weechat_hdata_get_string (hdata, "list_keys")); @@ -17873,7 +17873,7 @@ _WeeChat バージョン 1.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- struct t_upgrade_file *upgrade_file_new (const char *filename, int (*callback_read)(const void *pointer, @@ -17911,7 +17911,7 @@ struct t_upgrade_file *upgrade_file_new (const char *filename, C 言語での使用例: -[source,C] +[source,c] ---- struct t_upgrade_file *upgrade_file = weechat_upgrade_new ("my_file", NULL, NULL, NULL); @@ -17934,7 +17934,7 @@ upgrade_file = weechat.upgrade_new("my_file", "", "") プロトタイプ: -[source,C] +[source,c] ---- int weechat_upgrade_write_object (struct t_upgrade_file *upgrade_file, int object_id, @@ -17953,7 +17953,7 @@ int weechat_upgrade_write_object (struct t_upgrade_file *upgrade_file, C 言語での使用例: -[source,C] +[source,c] ---- if (weechat_upgrade_write_object (upgrade_file, 1, &infolist)) { @@ -17984,7 +17984,7 @@ _WeeChat バージョン 1.5 で更新。_ プロトタイプ: -[source,C] +[source,c] ---- int weechat_upgrade_read (struct t_upgrade_file *upgrade_file); ---- @@ -17999,7 +17999,7 @@ int weechat_upgrade_read (struct t_upgrade_file *upgrade_file); C 言語での使用例: -[source,C] +[source,c] ---- weechat_upgrade_read (upgrade_file); ---- @@ -18021,7 +18021,7 @@ weechat.upgrade_read(upgrade_file) プロトタイプ: -[source,C] +[source,c] ---- void weechat_upgrade_close (struct t_upgrade_file *upgrade_file); ---- @@ -18032,7 +18032,7 @@ void weechat_upgrade_close (struct t_upgrade_file *upgrade_file); C 言語での使用例: -[source,C] +[source,c] ---- weechat_upgrade_close (upgrade_file); ---- diff --git a/doc/ja/weechat_user.ja.adoc b/doc/ja/weechat_user.ja.adoc index 3203e67b4..fe4155421 100644 --- a/doc/ja/weechat_user.ja.adoc +++ b/doc/ja/weechat_user.ja.adoc @@ -3961,7 +3961,7 @@ origin が許可されていれば WebSocket 用のソケットが準備され HTML5 を使えばたった 1 行の JavaScript で WebSocket をオープンすることが可能です: -[source,js] +[source,javascript] ---- websocket = new WebSocket("ws://server.com:9000/weechat"); ---- diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc index 224f60b7a..e32a56c25 100644 --- a/doc/pl/weechat_user.pl.adoc +++ b/doc/pl/weechat_user.pl.adoc @@ -3888,7 +3888,7 @@ transmisji WebSocket jeśli wymagane nagłówki znajdują się w żądaniu oraz, WebSocket może zostać otworzony w HTML5 za pomocą jednej linii w JavaScript: -[source,js] +[source,javascript] ---- websocket = new WebSocket("ws://server.com:9000/weechat"); ---- diff --git a/doc/sr/weechat_plugin_api.sr.adoc b/doc/sr/weechat_plugin_api.sr.adoc index 3eeeb8720..575863963 100644 --- a/doc/sr/weechat_plugin_api.sr.adoc +++ b/doc/sr/weechat_plugin_api.sr.adoc @@ -556,7 +556,7 @@ _WeeChat ≥ 3.3._ Прототип: -[source,C] +[source,c] ---- char *weechat_string_cut (const char *string, int length, int count_suffix, int screen, const char *cut_suffix); ---- @@ -575,7 +575,7 @@ char *weechat_string_cut (const char *string, int length, int count_suffix, int C пример: -[source,C] +[source,c] ---- char *str = weechat_string_cut ("this is a test", 5, 1, 1, "…"); /* result: "this…" */ /* ... */ @@ -3867,7 +3867,7 @@ _WeeChat ≥ 3.3._ Прототип: -[source,C] +[source,c] ---- int weechat_file_copy (const char *from, const char *to); ---- @@ -3883,7 +3883,7 @@ int weechat_file_copy (const char *from, const char *to); C пример: -[source,C] +[source,c] ---- if (weechat_file_copy ("/tmp/test.txt", "/path/to/test2.txt")) { |