diff options
Diffstat (limited to 'doc/it/weechat_plugin_api.it.txt')
-rw-r--r-- | doc/it/weechat_plugin_api.it.txt | 204 |
1 files changed, 204 insertions, 0 deletions
diff --git a/doc/it/weechat_plugin_api.it.txt b/doc/it/weechat_plugin_api.it.txt index 50df831c3..9f0e2b163 100644 --- a/doc/it/weechat_plugin_api.it.txt +++ b/doc/it/weechat_plugin_api.it.txt @@ -601,6 +601,39 @@ Esempio in C: int diff = weechat_strcasecmp ("aaa", "CCC"); /* == -2 */ ---------------------------------------- +weechat_strncasecmp +^^^^^^^^^^^^^^^^^^^ + +Confronta stringa indipendente da caso (maiuscole +o minuscole) e da locale, for 'max' chars. + +Prototipo: + +[source,C] +---------------------------------------- +int weechat_strncasecmp (const char *string1, const char *string2, int max); +---------------------------------------- + +Argomenti: + +* 'string1': prima stringa da comparare +* 'string2': seconda stringa da comparare +* 'max': max chars to compare + +Valore restituito: + +* differenze tra le due stringhe: +** negativa se stringa1 < stringa2 +** zero se stringa1 == stringa1 +** positiva se stringa1 > stringa2 + +Esempio in C: + +[source,C] +---------------------------------------- +int diff = weechat_strncasecmp ("aabb", "aacc", 2); /* == 0 */ +---------------------------------------- + weechat_strcmp_ignore_chars ^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -750,6 +783,8 @@ free (str); weechat_string_expand_home ^^^^^^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.3._ + Sostituisce la `~` iniziale con la stringa con la cartella home. Se la stringa non inizia con `~`, viene restituita la stessa stringa. @@ -1206,6 +1241,8 @@ str = weechat.string_remove_color(my_string, "?") weechat_string_encode_base64 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.2._ + Codifica una stringa in base64. Prototype: @@ -1234,6 +1271,8 @@ weechat_string_encode_base64 (string, strlen (string), result); weechat_string_decode_base64 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.2._ + Decodifca una stringa in base64. Prototype: @@ -1266,6 +1305,8 @@ length = weechat_string_decode_base64 (string, result); weechat_string_is_command_char ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.2._ + Verifica che il primo carattere della stringa sia un carattere comando (il comando carattere predefinito è '/'). @@ -1308,6 +1349,8 @@ command_char2 = weechat.string_is_command_char("test") # == 0 weechat_string_input_for_buffer ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.2._ + Restituisce il puntatore al testo in input per il buffer (puntatore all'interno dell'argomento "string"), oppure NULL se è un comando. @@ -1504,6 +1547,33 @@ Esempio in C: char *next_char = weechat_utf8_next_char (string); ---------------------------------------- +weechat_utf8_char_int +^^^^^^^^^^^^^^^^^^^^^ + +Return UTF-8 char as integer. + +Prototipo: + +[source,C] +---------------------------------------- +int weechat_utf8_char_int (const char *string); +---------------------------------------- + +Argomenti: + +* 'string': stringa + +Valore restituito: + +* UTF-8 char as integer + +Esempio in C: + +[source,C] +---------------------------------------- +int char_int = weechat_utf8_char_int ("être"); /* "ê" as integer */ +---------------------------------------- + weechat_utf8_char_size ^^^^^^^^^^^^^^^^^^^^^^ @@ -1616,6 +1686,37 @@ Esempio in C: int length_on_screen = weechat_utf8_strlen_screen ("é"); /* == 1 */ ---------------------------------------- +weechat_utf8_charcmp +^^^^^^^^^^^^^^^^^^^^ + +Confronta due caratteri UTF-8. + +Prototipo: + +[source,C] +---------------------------------------- +int weechat_utf8_charcmp (const char *string1, const char *string2); +---------------------------------------- + +Argomenti: + +* 'string1': prima stringa da comparare +* 'string2': seconda stringa da comparare + +Valore restituito: + +* differenza tra i primi caratteri di ogni stringa: +** negativa se char1 < char2 +** zero se char1 == char2 +** positivao se char1 > char2 + +Esempio in C: + +[source,C] +---------------------------------------- +int diff = weechat_utf8_charcmp ("aaa", "ccc"); /* == -2 */ +---------------------------------------- + weechat_utf8_charcasecmp ^^^^^^^^^^^^^^^^^^^^^^^^ @@ -1960,6 +2061,39 @@ void callback (void *data, const char *filename) weechat_exec_on_files ("/tmp", 0, NULL, &callback); ---------------------------------------- +weechat_file_get_content +^^^^^^^^^^^^^^^^^^^^^^^^ + +_Nuovo nella versione 0.3.1._ + +Get content of text file in a string. + +Prototipo: + +[source,C] +---------------------------------------- +char *weechat_file_get_content (const char *filename); +---------------------------------------- + +Argomenti: + +* 'filename': path and file name + +Valore restituito: + +* content of file as string (must be freed by calling "free" after use) + +Esempio in C: + +[source,C] +---------------------------------------- +char *content; + +content = weechat_file_get_content ("/tmp/test.txt"); +/* ... */ +free (content); +---------------------------------------- + [[util]] Utilità ~~~~~~~ @@ -2054,6 +2188,8 @@ weechat_util_timeval_add (&tv, 2000); /* aggiunge 2 secondi */ weechat_util_get_time_string ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.2._ + Riceve data/ora come stringa compilata con "strftime". Prototipo: @@ -2588,6 +2724,8 @@ Funzioni per le tabelle hash. weechat_hashtable_new ^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.3._ + Crea una nuova tabella hash. Prototipo: @@ -2647,6 +2785,8 @@ struct t_hashtable *hashtable = weechat_hashtable_new (8, weechat_hashtable_set_with_size ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.3._ + Aggiunge o aggiorna un elemento nella tabella hash con la dimensione per la chiave ed il valore. @@ -2684,6 +2824,8 @@ weechat_hashtable_set_with_size (hashtable, "my_key", 0, weechat_hashtable_set ^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.3._ + Aggiunge o aggiorna un elemento nella tabella hash. Prototipo: @@ -2714,6 +2856,8 @@ weechat_hashtable_set (hashtable, "my_key", "my_value"); weechat_hashtable_get ^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.3._ + Ottiene il valore associato ad una chiave in una tabella hash. Prototipo: @@ -2742,6 +2886,8 @@ void *value = weechat_hashtable_get (hashtable, "my_key"); weechat_hashtable_map ^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.3._ + Chiama una funzione su tutte le voci della tabella hash. Prototipo: @@ -2782,6 +2928,8 @@ weechat_hashtable_map (hashtable, &map_cb, NULL); weechat_hashtable_get_integer ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.3._ + Restituisce un valore intero per la proprietà di una tabella hash. Prototipo: @@ -2813,6 +2961,8 @@ int items_count = weechat_hashtable_get_integer (hashtable, "items_count"); weechat_hashtable_add_to_infolist ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.3._ + Aggiunge elementi della tabella hash ad un elemento della lista info. Prototipo: @@ -2854,6 +3004,8 @@ weechat_hashtable_add_to_infolist (hashtable, infolist_item, "testhash"); weechat_hashtable_remove ^^^^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.3._ + Rimuove un elemento in una tabella hash. Prototipo: @@ -2878,6 +3030,8 @@ weechat_hashtable_remove (hashtable, "my_key"); weechat_hashtable_remove_all ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.3._ + Rimuove tutti gli elementi in una tabella hash. Prototipo: @@ -2901,6 +3055,8 @@ weechat_hashtable_remove_all (hashtable); weechat_hashtable_free ^^^^^^^^^^^^^^^^^^^^^^ +_Nuovo nella versione 0.3.3._ + Libera una tabella hash. Prototipo: @@ -3502,6 +3658,54 @@ option = weechat.config_search_option(config_file, section, option_name) option = weechat.config_search_option(config_file, section, "option") ---------------------------------------- +weechat_config_search_section_option +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Search a section and an option in a configuration file or section. + +Prototipo: + +[source,C] +---------------------------------------- +void weechat_config_search_section_option (struct t_config_file *config_file, + struct t_config_section *section, + const char *option_name, + struct t_config_section **section_found, + struct t_config_option **option_found); +---------------------------------------- + +Arguments: + +* 'config_file': puntatore al file di configurazione +* 'section': puntatore alla sezione +* 'option_name': option name +* 'section_found': puntatore al puntatore della sezione, sarà impostato alla + sezione dell'opzione, se viene trovata +* 'option_found': puntatore al puntatore dell'opzione, sarà impostato al + puntatore di un'opzione, se viene trovata + +Esempio in C: + +[source,C] +---------------------------------------- +struct t_config_section *ptr_section; +struct t_config_option *ptr_option; + +weechat_config_search_section_option(config_file, + section, + "option", + &ptr_section, + &ptr_option); +if (ptr_option) +{ + /* opzione trovata */ +} +else +{ + /* opzione non trovata */ +} +---------------------------------------- + weechat_config_search_with_string ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |