doc: update functions strcasestr, utf8_prev_char, utf8_next_char and utf8_add_offset in plugin API reference

v2.8-utf8proc
Sébastien Helleu 2015-07-04 16:08:15 +02:00
parent 4ecd8a505f
commit e8615c1691
4 changed files with 64 additions and 0 deletions

View File

@ -757,6 +757,8 @@ This function is not available in scripting API.
==== strcasestr
_Updated in 1.3._
Locale and case independent string search.
Prototype:
@ -774,6 +776,7 @@ Arguments:
Return value:
* pointer to string found, or NULL if not found
(_WeeChat ≥ 1.3_: pointer returned is a 'const char *' instead of 'char *')
C example:
@ -2213,6 +2216,8 @@ This function is not available in scripting API.
==== utf8_prev_char
_Updated in 1.3._
Return pointer to previous UTF-8 char in a string.
Prototype:
@ -2232,6 +2237,7 @@ Arguments:
Return value:
* pointer to previous UTF-8 char, NULL if not found (start of string reached)
(_WeeChat ≥ 1.3_: pointer returned is a 'const char *' instead of 'char *')
C example:
@ -2245,6 +2251,8 @@ This function is not available in scripting API.
==== utf8_next_char
_Updated in 1.3._
Return pointer to next UTF-8 char in a string.
Prototype:
@ -2261,6 +2269,7 @@ Arguments:
Return value:
* pointer to next UTF-8 char, NULL if not found (end of string reached)
(_WeeChat ≥ 1.3_: pointer returned is a 'const char *' instead of 'char *')
C example:
@ -2517,6 +2526,8 @@ This function is not available in scripting API.
==== utf8_add_offset
_Updated in 1.3._
Move forward N chars in an UTF-8 string.
Prototype:
@ -2534,6 +2545,7 @@ Arguments:
Return value:
* pointer to string, N chars after (NULL if it's not reachable)
(_WeeChat ≥ 1.3_: pointer returned is a 'const char *' instead of 'char *')
C example:

View File

@ -766,6 +766,8 @@ Cette fonction n'est pas disponible dans l'API script.
==== strcasestr
_Mis à jour dans la 1.3._
Rechercher une chaîne indépendemment de la locale et de la casse.
Prototype :
@ -783,6 +785,8 @@ Paramètres :
Valeur de retour :
* pointeur vers la chaîne trouvée, ou NULL si non trouvée
(_WeeChat ≥ 1.3_ : le pointeur retourné est un 'const char *' au lieu d'un
'char *')
Exemple en C :
@ -2255,6 +2259,8 @@ Cette fonction n'est pas disponible dans l'API script.
==== utf8_prev_char
_Mis à jour dans la 1.3._
Retourner un pointeur vers le caractère UTF-8 précédent dans une chaîne.
Prototype :
@ -2275,6 +2281,8 @@ Valeur de retour :
* pointeur vers le caractère UTF-8 précédent, NULL si non trouvé (début de
chaîne atteint)
(_WeeChat ≥ 1.3_ : le pointeur retourné est un 'const char *' au lieu d'un
'char *')
Exemple en C :
@ -2288,6 +2296,8 @@ Cette fonction n'est pas disponible dans l'API script.
==== utf8_next_char
_Mis à jour dans la 1.3._
Retourner un pointeur vers le caractère UTF-8 suivant dans une chaîne.
Prototype :
@ -2305,6 +2315,8 @@ Valeur de retour :
* pointeur vers le caractère UTF-8 suivant, NULL si non trouvé (fin de la
chaîne atteinte)
(_WeeChat ≥ 1.3_ : le pointeur retourné est un 'const char *' au lieu d'un
'char *')
Exemple en C :
@ -2564,6 +2576,8 @@ Cette fonction n'est pas disponible dans l'API script.
==== utf8_add_offset
_Mis à jour dans la 1.3._
Avancer de N caractères dans une chaîne UTF-8.
Prototype :
@ -2582,6 +2596,8 @@ Valeur de retour :
* pointeur vers la chaîne, N caractères après (NULL s'il est impossible
d'atteindre cette position dans la chaîne)
(_WeeChat ≥ 1.3_ : le pointeur retourné est un 'const char *' au lieu d'un
'char *')
Exemple en C :

View File

@ -788,6 +788,9 @@ Questa funzione non è disponibile nelle API per lo scripting.
==== strcasestr
// TRANSLATION MISSING
_Updated in 1.3._
Cerca una stringa non sensibile alle maiuscole e indipendente dalla
localizzazione.
@ -805,7 +808,9 @@ Argomenti:
Valore restituito:
// TRANSLATION MISSING
* puntatore alla stringa trovata, o NULL se non trovata
(_WeeChat ≥ 1.3_: pointer returned is a 'const char *' instead of 'char *')
Esempio in C:
@ -2287,6 +2292,9 @@ Questa funzione non è disponibile nelle API per lo scripting.
==== utf8_prev_char
// TRANSLATION MISSING
_Updated in 1.3._
Restituisce il puntatore al carattere UTF-8 precedente in una stringa.
Prototipo:
@ -2305,8 +2313,10 @@ Argomenti:
Valore restituito:
// TRANSLATION MISSING
* puntatore al precedente carattere UTF-8, NULL se non trovata (raggiunta
l'inizio della stringa)
(_WeeChat ≥ 1.3_: pointer returned is a 'const char *' instead of 'char *')
Esempio in C:
@ -2320,6 +2330,9 @@ Questa funzione non è disponibile nelle API per lo scripting.
==== utf8_next_char
// TRANSLATION MISSING
_Updated in 1.3._
Restituisce il puntatore al successivo carattere UTF-8 in una stringa.
Prototipo:
@ -2335,8 +2348,10 @@ Argomenti:
Valore restituito:
// TRANSLATION MISSING
* puntatore al carattere UTF-8 successivo, NULL se non trovato
(raggiunta la fine della stringa)
(_WeeChat ≥ 1.3_: pointer returned is a 'const char *' instead of 'char *')
Esempio in C:
@ -2600,6 +2615,9 @@ Questa funzione non è disponibile nelle API per lo scripting.
==== utf8_add_offset
// TRANSLATION MISSING
_Updated in 1.3._
Si sposta in avanti di N caratteri in una stringa UTF-8.
Prototipo:
@ -2616,7 +2634,9 @@ Argomenti:
Valore restituito:
// TRANSLATION MISSING
* puntatore alla stringa, N caratteri dopo (NULL se non raggiungibile)
(_WeeChat ≥ 1.3_: pointer returned is a 'const char *' instead of 'char *')
Esempio in C:

View File

@ -761,6 +761,8 @@ int diff = weechat_strcmp_ignore_chars ("a-b", "--a-e", "-", 1); /* == -3 */
==== strcasestr
_バージョン 1.3 で更新。_
ロケールと大文字小文字を区別して文字列を検索。
プロトタイプ:
@ -777,7 +779,9 @@ const char *weechat_strcasestr (const char *string, const char *search);
戻り値:
// TRANSLATION MISSING
* 見つかった文字列へのポインタ、見つからない場合は NULL
(_WeeChat ≥ 1.3_: pointer returned is a 'const char *' instead of 'char *')
C 言語での使用例:
@ -2220,6 +2224,8 @@ weechat_utf8_normalize (string, '?');
==== utf8_prev_char
_バージョン 1.3 で更新。_
文字列中の 1 つ前の UTF-8 文字へのポインタを返す。
プロトタイプ:
@ -2238,7 +2244,9 @@ const char *weechat_utf8_prev_char (const char *string_start,
戻り値:
// TRANSLATION MISSING
* 1 つ前の UTF-8 文字へのポインタ、見つからなければ (文字列の開始位置に到達した場合は) NULL
(_WeeChat ≥ 1.3_: pointer returned is a 'const char *' instead of 'char *')
C 言語での使用例:
@ -2252,6 +2260,8 @@ const char *prev_char = weechat_utf8_prev_char (string, ptr_in_string);
==== utf8_next_char
_バージョン 1.3 で更新。_
文字列中の 1 つ後の UTF-8 文字へのポインタを返す。
プロトタイプ:
@ -2267,7 +2277,9 @@ const char *weechat_utf8_next_char (const char *string);
戻り値:
// TRANSLATION MISSING
* 1 つ後の UTF-8 文字へのポインタ、見つからなければ (文字列の最後に到達した場合は) NULL
(_WeeChat ≥ 1.3_: pointer returned is a 'const char *' instead of 'char *')
C 言語での使用例:
@ -2524,6 +2536,8 @@ int length_on_screen = weechat_utf8_char_size_screen ("é"); /* == 1 */
==== utf8_add_offset
_バージョン 1.3 で更新。_
UTF-8 文字列で N 文字前に進む。
プロトタイプ:
@ -2540,7 +2554,9 @@ const char *weechat_utf8_add_offset (const char *string, int offset);
戻り値:
// TRANSLATION MISSING
* 文字列の N 文字後に進んだ位置へのポインタ (元文字列の最後より後の位置を指す場合は NULL)
(_WeeChat ≥ 1.3_: pointer returned is a 'const char *' instead of 'char *')
C 言語での使用例: