api: add function string_translate_chars

1 files changed, 42 insertions, 0 deletions

diff --git a/doc/it/weechat_plugin_api.it.adoc b/doc/it/weechat_plugin_api.it.adoc
index 78cf72caa..14c509a51 100644
--- a/doc/it/weechat_plugin_api.it.adoc
+++ b/doc/it/weechat_plugin_api.it.adoc
@@ -1665,6 +1665,48 @@ if (weechat_string_regcomp (&my_regex, "([0-9]{4})-([0-9]{2})-([0-9]{2})",
 [NOTE]
 Questa funzione non è disponibile nelle API per lo scripting.
 
+==== string_translate_chars
+
+_WeeChat ≥ 3.8._
+
+// TRANSLATION MISSING
+Translate chars in a string.
+
+Prototipo:
+
+[source,c]
+----
+char *string_translate_chars (const char *string, const char *chars1, const char *chars2);
+----
+
+Argomenti:
+
+// TRANSLATION MISSING
+* _string_: string
+* _chars1_: string with chars to translate
+* _chars2_: string with replacement chars; it must contain the same number of
+  UTF-8 chars than _chars1_
+
+Valore restituito:
+
+// TRANSLATION MISSING
+* string with translated chars, NULL if problem (must be freed by calling "free"
+  after use)
+
+Esempi in C:
+
+[source,c]
+----
+/* "test" => "tEst" */
+char *str = weechat_string_translate_chars ("test", "abcdef", "ABCDEF");
+
+/* "clean the boat" => "CleAn the BoAt" */
+char *str = weechat_string_translate_chars ("clean the boat", "abc", "ABC");
+----
+
+[NOTE]
+Questa funzione non è disponibile nelle API per lo scripting.
+
 ==== string_split
 
 // TRANSLATION MISSING