summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/en/weechat_plugin_api.en.adoc170
-rw-r--r--doc/fr/weechat_plugin_api.fr.adoc170
-rw-r--r--doc/it/weechat_plugin_api.it.adoc170
-rw-r--r--doc/ja/weechat_plugin_api.ja.adoc173
-rw-r--r--doc/sr/weechat_plugin_api.sr.adoc170
5 files changed, 338 insertions, 515 deletions
diff --git a/doc/en/weechat_plugin_api.en.adoc b/doc/en/weechat_plugin_api.en.adoc
index 8869bb504..213bc9561 100644
--- a/doc/en/weechat_plugin_api.en.adoc
+++ b/doc/en/weechat_plugin_api.en.adoc
@@ -2385,18 +2385,18 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
List of logical operators that can be used in conditions (by order of priority,
from first used to last):
-[width="100%",cols="2,8,4,4",options="header"]
+[width="100%",cols="2,1,8,4,4",options="header"]
|===
-| Operator | Description | Examples | Results
+| Operator | Min WeeChat | Description | Examples | Results
-| `+&&+` |
+| `+&&+` | |
Logical "and" |
`+25 && 77+` +
`+25 && 0+` |
`+1+` +
`+0+`
-| `+\|\|+` |
+| `+\|\|+` | |
Logical "or" |
`+25 \|\| 0+` +
`+0 \|\| 0+` |
@@ -2407,103 +2407,95 @@ from first used to last):
List of comparison operators that can be used in conditions (by order of priority,
from first used to last):
-[width="100%",cols="2,8,4,4",options="header"]
+[width="100%",cols="2,1,8,4,4",options="header"]
|===
-| Operator | Description | Examples | Results
+| Operator | Min WeeChat | Description | Examples | Results
-| `+=~+` |
+| `+=~+` | |
Is matching POSIX extended regex (optional flags are allowed, see function <<_string_regcomp,string_regcomp>>) |
`+abc def =~ ab.*ef+` +
`+abc def =~ y.*z+` |
`+1+` +
`+0+`
-| `+!~+` |
+| `+!~+` | |
Is NOT matching POSIX extended regex (optional flags are allowed, see function <<_string_regcomp,string_regcomp>>) |
`+abc def !~ ab.*ef+` +
`+abc def !~ y.*z+` |
`+0+` +
`+1+`
-| `+==*+` |
- Is matching mask where "*" is allowed, case sensitive (see function <<_string_match,string_match>>) +
- _(WeeChat ≥ 2.9)_ |
+| `+==*+` | 2.9 |
+ Is matching mask where "*" is allowed, case sensitive (see function <<_string_match,string_match>>) |
`+abc def ==* a*f+` +
`+abc def ==* y*z+` |
`+1+` +
`+0+`
-| `+!!*+` |
- Is NOT wildcard mask where "*" is allowed, case sensitive (see function <<_string_match,string_match>>) +
- _(WeeChat ≥ 2.9)_ |
+| `+!!*+` | 2.9 |
+ Is NOT wildcard mask where "*" is allowed, case sensitive (see function <<_string_match,string_match>>) |
`+abc def !!* a*f+` +
`+abc def !!* y*z+` |
`+0+` +
`+1+`
-| `+=*+` |
- Is matching mask where "*" is allowed, case insensitive (see function <<_string_match,string_match>>) +
- _(WeeChat ≥ 1.8)_ |
+| `+=*+` | 1.8 |
+ Is matching mask where "*" is allowed, case insensitive (see function <<_string_match,string_match>>) |
`+abc def =* A*F+` +
`+abc def =* Y*Z+` |
`+1+` +
`+0+`
-| `+!*+` |
- Is NOT wildcard mask where "*" is allowed, case insensitive (see function <<_string_match,string_match>>) +
- _(WeeChat ≥ 1.8)_ |
+| `+!*+` | 1.8 |
+ Is NOT wildcard mask where "*" is allowed, case insensitive (see function <<_string_match,string_match>>) |
`+abc def !* A*F+` +
`+abc def !* Y*Z+` |
`+0+` +
`+1+`
-| `+==-+` |
- Is included, case sensitive +
- _(WeeChat ≥ 2.9)_ |
+| `+==-+` | 2.9 |
+ Is included, case sensitive |
`+abc def ==- bc+` +
`+abc def ==- xyz+` |
`+1+` +
`+0+`
-| `+!!-+` |
- Is NOT included, case sensitive +
- _(WeeChat ≥ 2.9)_ |
+| `+!!-+` | 2.9 |
+ Is NOT included, case sensitive |
`+abc def !!- bc+` +
`+abc def !!- xyz+` |
`+0+` +
`+1+`
-| `+=-+` |
- Is included, case insensitive +
- _(WeeChat ≥ 2.9)_ |
+| `+=-+` | 2.9 |
+ Is included, case insensitive |
`+abc def =- BC+` +
`+abc def =- XYZ+` |
`+1+` +
`+0+`
-| `+!-+` |
- Is NOT included, case insensitive +
- _(WeeChat ≥ 2.9)_ |
+| `+!-+` | 2.9 |
+ Is NOT included, case insensitive |
`+abc def !- BC+` +
`+abc def !- XYZ+` |
`+0+` +
`+1+`
-| `+==+` |
+| `+==+` | |
Equal |
`+test == test+` +
`+test == string+` |
`+1+` +
`+0+`
-| `+!=+` |
+| `+!=+` | |
Not equal |
`+test != test+` +
`+test != string+` |
`+0+` +
`+1+`
-| `+<=+` |
+| `+<=+` | |
Less or equal |
`+abc <= defghi+` +
`+abc <= abc+` +
@@ -2514,7 +2506,7 @@ from first used to last):
`+0+` +
`+0+`
-| `+<+` |
+| `+<+` | |
Less |
`+abc < defghi+` +
`+abc < abc+` +
@@ -2525,7 +2517,7 @@ from first used to last):
`+0+` +
`+0+`
-| `+>=+` |
+| `+>=+` | |
Greater or equal |
`+defghi >= abc+` +
`+abc >= abc+` +
@@ -2536,7 +2528,7 @@ from first used to last):
`+0+` +
`+1+`
-| `+>+` |
+| `+>+` | |
Greater |
`+defghi > abc+` +
`+abc > abc+` +
@@ -2567,28 +2559,26 @@ for example:
List of variables expanded in expression (by order of priority, from first
expanded to last):
-[width="100%",cols="2,8,4,4",options="header"]
+[width="100%",cols="2,1,8,4,4",options="header"]
|===
-| Format | Description | Examples | Results
+| Format | Min WeeChat | Description | Examples | Results
-| `+${raw:xxx}+` +
- _(WeeChat ≥ 3.1)_ |
+| `+${raw:xxx}+` | 3.1 |
Raw string (not evaluated). |
`+${raw:${info:version}}+` |
`+${info:version}+`
-| `+${name}+` +
- _(WeeChat ≥ 3.4)_ |
+| `+${name}+` | 3.4 |
User variable (defined with `+${define:name,value}+`). |
`+${name}+` |
`+value+`
-| `+${name}+` |
+| `+${name}+` | |
Variable `name` from hashtable _extra_vars_. |
`+${name}+` |
`+value+`
-| `+${weechat_xxx_dir}+` |
+| `+${weechat_xxx_dir}+` | 3.2 |
A WeeChat directory: `+${weechat_config_dir}+`, `+${weechat_data_dir}+`,
`+${weechat_cache_dir}+` or `+${weechat_runtime_dir}+`. |
`+${weechat_config_dir}+` +
@@ -2600,37 +2590,32 @@ expanded to last):
`+/home/user/.cache/weechat+` +
`+/run/user/1000/weechat+`
-| `+${eval:xxx}+` +
- _(WeeChat ≥ 1.3)_ |
+| `+${eval:xxx}+` | 1.3 |
String to evaluate. |
`+${eval:${date:${weechat.look.buffer_time_format}}}+` |
`+19:02:45+` (with colors if there are color codes in the option
weechat.look.buffer_time_format)
-| `+${eval_cond:xxx}+` +
- _(WeeChat ≥ 3.1)_ |
+| `+${eval_cond:xxx}+` | 3.1 |
String to evaluate as condition. |
`+${eval_cond:${window.win_width} > 100}+` |
`+1+`
| `+${esc:xxx}+` +
- `+${\xxx}+` +
- _(WeeChat ≥ 1.0)_ |
+ `+${\xxx}+` | 1.0 |
String with escaped chars. |
`+${esc:prefix\tmessage}+` +
`+${\ua9}+` |
`+prefix<TAB>message+` +
`+©+`
-| `+${hide:x,string}+` +
- _(WeeChat ≥ 1.1)_ |
+| `+${hide:x,string}+` | 1.1 |
String with hidden chars (all chars in `string` replaced by `x`). |
`+${hide:*,password}+` |
`+********+`
| `+${cut:max,suffix,string}+` +
- `+${cut:+max,suffix,string}+` +
- _(WeeChat ≥ 1.8)_ |
+ `+${cut:+max,suffix,string}+` | 1.8 |
String with `max` chars, and optional `suffix` if string is cut. +
With the format `+max`, the suffix is counted in max length. |
`+${cut:4,…,this is a test}+` +
@@ -2641,8 +2626,7 @@ expanded to last):
`+こん>>+`
| `+${cutscr:max,suffix,string}+` +
- `+${cutscr:+max,suffix,string}+` +
- _(WeeChat ≥ 1.8)_ |
+ `+${cutscr:+max,suffix,string}+` | 1.8 |
String with `max` chars displayed on screen, and optional `suffix` if string is cut. +
With the format `+max`, the suffix is counted in max length. |
`+${cutscr:4,…,this is a test}+` +
@@ -2652,8 +2636,7 @@ expanded to last):
`+thi…+` +
`+こ>>+`
-| `+${rev:xxx}+` +
- _(WeeChat ≥ 2.2)_ |
+| `+${rev:xxx}+` | 2.2 |
Reversed string (color codes are reversed, so the string should not contain
color codes). |
`+${rev:Hello, world!}+` +
@@ -2661,38 +2644,33 @@ expanded to last):
`+!dlrow ,olleH+` +
`+!dlrow30F ,olleH+` (no color, the color code is reversed)
-| `+${revscr:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${revscr:xxx}+` | 2.7 |
Reversed string for screen, color codes are not reversed. |
`+${revscr:Hello, world!}+` +
`+${revscr:Hello, ${color:red}world!}+` |
`+!dlrow ,olleH+` +
`+!dlrow ,olleH+` (`pass:[ ,olleH]` in red)
-| `+${repeat:count,string}+` +
- _(WeeChat ≥ 2.3)_ |
+| `+${repeat:count,string}+` | 2.3 |
Repeated string. |
`+${repeat:5,-}+` |
`+-----+`
-| `+${length:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${length:xxx}+` | 2.7 |
Length of string (number of UTF-8 chars), color codes are ignored. |
`+${length:test}+` +
`+${length:こんにちは世界}+` |
`+4+` +
`+7+`
-| `+${lengthscr:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${lengthscr:xxx}+` | 2.7 |
Length of string displayed on screen, color codes are ignored. |
`+${lengthscr:test}+` +
`+${lengthscr:こんにちは世界}+` |
`+4+` +
`+14+`
-| `+${split:number,seps,flags,xxx}+` +
- _(WeeChat ≥ 3.3)_ |
+| `+${split:number,seps,flags,xxx}+` | 3.3 |
Split string, and return, according to `number`: +
- `count`: the number of items after split +
- `random`: a random item +
@@ -2725,8 +2703,7 @@ expanded to last):
`+is+` +
`+is a test+`
-| `+${split_shell:number,xxx}+` +
- _(WeeChat ≥ 3.3)_ |
+| `+${split_shell:number,xxx}+` | 3.3 |
Split shell arguments, and return, according to `number`: +
- `count`: the number of arguments after split +
- `random`: a random argument +
@@ -2741,8 +2718,7 @@ expanded to last):
`+2+` +
`+arg2+`
-| `+${re:xxx}+` +
- _(WeeChat ≥ 1.1)_ |
+| `+${re:xxx}+` | 1.1 |
Regex data: +
`0` = whole string matching, +
`1` to `99` = group captured, +
@@ -2762,8 +2738,7 @@ expanded to last):
`+2+` +
`+1+`
-| `+${color:name}+` +
- _(WeeChat ≥ 0.4.2)_ |
+| `+${color:name}+` | 0.4.2 |
WeeChat color code (the name of color has optional attributes),
see function <<_color,color>> for supported formats. |
`+${color:red}red text+` +
@@ -2771,8 +2746,7 @@ expanded to last):
`+red text+` (in red) +
`+bold orange text+` (in bold orange)
-| `+${modifier:name,data,string}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${modifier:name,data,string}+` | 2.7 |
Result of a modifier, see function
<<_hook_modifier_exec,hook_modifier_exec>>. |
`+${modifier:eval_path_home,,~}+` +
@@ -2781,8 +2755,7 @@ expanded to last):
`+/home/user/.config/weechat/weechat.conf+`
| `+${info:name}+` +
- `+${info:name,arguments}+` +
- _(WeeChat ≥ 0.4.3)_ |
+ `+${info:name,arguments}+` | 0.4.3 |
Info from WeeChat or a plugin, see function
<<_info_get,info_get>>. |
`+${info:version}+` +
@@ -2790,8 +2763,7 @@ expanded to last):
`+1.0+` +
`+lightblue+`
-| `+${base_encode:base,xxx}+` +
- _(WeeChat ≥ 2.9)_ |
+| `+${base_encode:base,xxx}+` | 2.9 |
String encoded in base 16, 32 or 64. |
`+${base_encode:16,test string}+` +
`+${base_encode:32,test string}+` +
@@ -2800,8 +2772,7 @@ expanded to last):
`+ORSXG5BAON2HE2LOM4======+` +
`+dGVzdCBzdHJpbmc=+`
-| `+${base_decode:base,xxx}+` +
- _(WeeChat ≥ 2.9)_ |
+| `+${base_decode:base,xxx}+` | 2.9 |
String decoded from base 16, 32 or 64. |
`+${base_decode:16,7465737420737472696E67}+` +
`+${base_decode:32,ORSXG5BAON2HE2LOM4======}+` +
@@ -2811,8 +2782,7 @@ expanded to last):
`+test string+`
| `+${date}+` +
- `+${date:xxx}+` +
- _(WeeChat ≥ 1.3)_ |
+ `+${date:xxx}+` | 1.3 |
Current date/time, with custom format (see `man strftime`),
default format is `%F %T`. |
`+${date}+` +
@@ -2820,24 +2790,21 @@ expanded to last):
`+2015-06-30 19:02:45+` +
`+19:02:45+`
-| `+${env:NAME}+` +
- _(WeeChat ≥ 1.2)_ |
+| `+${env:NAME}+` | 1.2 |
Value of the environment variable `NAME`. |
`+${env:HOME}+` |
`+/home/user+`
| `+${if:condition}+` +
`+${if:condition?true}+`
- `+${if:condition?true:false}+`
- _(WeeChat ≥ 1.8)_ |
+ `+${if:condition?true:false}+` | 1.8 |
Ternary operator with a condition, a value if the condition is true (optional)
and another value if the condition is false (optional). If values are not
given, "1" or "0" are returned, according to the result of the condition. |
`+${if:${info:term_width}>80?big:small}+` |
`+big+`
-| `+${calc:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${calc:xxx}+` | 2.7 |
Result of expression, where parentheses and the following operators are
supported: +
`+++`: addition +
@@ -2860,47 +2827,44 @@ expanded to last):
`+0.2+` +
`+65536+`
-| `+${random:min,max}+` +
- _(WeeChat ≥ 3.3)_ |
+| `+${random:min,max}+` | 3.3 |
Random integer number in the range from `min` to `max` (inclusive). |
`+${random:0,10}+` |
`+3+`
-| `+${translate:xxx}+` +
- _(WeeChat ≥ 3.2)_ |
+| `+${translate:xxx}+` | 3.2 |
Translated string (depends on the language used by WeeChat to display messages). |
`+${translate:Plugin}+` |
`+Extension+` (example in French)
-| `+${define:name,value}+` +
- _(WeeChat ≥ 3.4)_ |
+| `+${define:name,value}+` | 3.4 |
Define a variable `name` set to `value`, which can then be used in the same
evaluated expression with `+${name}+`. |
`+${define:len,${calc:5+3}}${len}x${len}+` |
`+8x8+`
-| `+${sec.data.name}+` |
+| `+${sec.data.name}+` | |
Value of the secured data `name`. |
`+${sec.data.libera_pass}+` |
`+my_password+`
-| `+${file.section.option}+` |
+| `+${file.section.option}+` | |
Value of the option. |
`+${weechat.look.buffer_time_format}+` |
`+%H:%M:%S+`
-| `+${name}+` |
+| `+${name}+` | |
Value of local variable `name` in buffer. |
`+${nick}+` |
`+FlashCode+`
-| `+${pointer}+` |
+| `+${pointer}+` | |
Variable `pointer` from hashtable _pointers_. |
`+${buffer}+` |
`+0x1234abcd+`
| `+${hdata.var1.var2...}+` +
- `+${hdata[list].var1.var2...}+` |
+ `+${hdata[list].var1.var2...}+` | |
Hdata value (pointers `window` and `buffer` are set by default with current
window/buffer), `list` can be a list name (example: "gui_buffers"), a pointer
(example: "0x1234abcd") or a pointer name (example: "my_pointer"). |
diff --git a/doc/fr/weechat_plugin_api.fr.adoc b/doc/fr/weechat_plugin_api.fr.adoc
index f51ed340a..1d4ff0a27 100644
--- a/doc/fr/weechat_plugin_api.fr.adoc
+++ b/doc/fr/weechat_plugin_api.fr.adoc
@@ -2429,18 +2429,18 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
Liste des opérateurs logiques qui peuvent être utilisés dans les conditions
(par ordre de priorité, du premier utilisé au dernier) :
-[width="100%",cols="2,8,4,4",options="header"]
+[width="100%",cols="2,1,8,4,4",options="header"]
|===
-| Opérateur | Description | Exemples | Résultats
+| Opérateur | WeeChat mini | Description | Exemples | Résultats
-| `+&&+` |
+| `+&&+` | |
"Et" logique |
`+25 && 77+` +
`+25 && 0+` |
`+1+` +
`+0+`
-| `+\|\|+` |
+| `+\|\|+` | |
"Ou" logique |
`+25 \|\| 0+` +
`+0 \|\| 0+` |
@@ -2451,103 +2451,95 @@ Liste des opérateurs logiques qui peuvent être utilisés dans les conditions
Liste des opérateurs de comparaison qui peuvent être utilisés dans les conditions
(par ordre de priorité, du premier utilisé au dernier) :
-[width="100%",cols="2,8,4,4",options="header"]
+[width="100%",cols="2,1,8,4,4",options="header"]
|===
-| Opérateur | Description | Exemples | Résultats
+| Opérateur | WeeChat mini | Description | Exemples | Résultats
-| `+=~+` |
+| `+=~+` | |
Correspond à l'expression régulière POSIX étendue (des "flags" facultatifs sont autorisés, voir la fonction <<_string_regcomp,string_regcomp>>) |
`+abc def =~ ab.*ef+` +
`+abc def =~ y.*z+` |
`+1+` +
`+0+`
-| `+!~+` |
+| `+!~+` | |
Ne correspond PAS à l'expression régulière POSIX étendue (des "flags" facultatifs sont autorisés, voir la fonction <<_string_regcomp,string_regcomp>>) |
`+abc def !~ ab.*ef+` +
`+abc def !~ y.*z+` |
`+0+` +
`+1+`
-| `+==*+` |
- Correspond au masque où le caractère joker "*" est autorisé, sensible à la casse (voir la fonction <<_string_match,string_match>>) +
- _(WeeChat ≥ 2.9)_ |
+| `+==*+` | 2.9 |
+ Correspond au masque où le caractère joker "*" est autorisé, sensible à la casse (voir la fonction <<_string_match,string_match>>) |
`+abc def ==* a*f+` +
`+abc def ==* y*z+` |
`+1+` +
`+0+`
-| `+!!*+` |
- Ne correspond PAS au masque où le caractère joker "*" est autorisé, sensible à la casse (voir la fonction <<_string_match,string_match>>) +
- _(WeeChat ≥ 2.9)_ |
+| `+!!*+` | 2.9 |
+ Ne correspond PAS au masque où le caractère joker "*" est autorisé, sensible à la casse (voir la fonction <<_string_match,string_match>>) |
`+abc def !!* a*f+` +
`+abc def !!* y*z+` |
`+0+` +
`+1+`
-| `+=*+` |
- Correspond au masque où le caractère joker "*" est autorisé, insensible à la casse (voir la fonction <<_string_match,string_match>>) +
- _(WeeChat ≥ 1.8)_ |
+| `+=*+` | 1.8 |
+ Correspond au masque où le caractère joker "*" est autorisé, insensible à la casse (voir la fonction <<_string_match,string_match>>) |
`+abc def =* A*F+` +
`+abc def =* Y*Z+` |
`+1+` +
`+0+`
-| `+!*+` |
- Ne correspond PAS au masque où le caractère joker "*" est autorisé, insensible à la casse (voir la fonction <<_string_match,string_match>>) +
- _(WeeChat ≥ 1.8)_ |
+| `+!*+` | 1.8 |
+ Ne correspond PAS au masque où le caractère joker "*" est autorisé, insensible à la casse (voir la fonction <<_string_match,string_match>>) |
`+abc def !* A*F+` +
`+abc def !* Y*Z+` |
`+0+` +
`+1+`
-| `+==-+` |
- Est inclus, sensible à la casse +
- _(WeeChat ≥ 2.9)_ |
+| `+==-+` | 2.9 |
+ Est inclus, sensible à la casse |
`+abc def ==- bc+` +
`+abc def ==- xyz+` |
`+1+` +
`+0+`
-| `+!!-+` |
- N'est PAS inclus, sensible à la casse +
- _(WeeChat ≥ 2.9)_ |
+| `+!!-+` | 2.9 |
+ N'est PAS inclus, sensible à la casse |
`+abc def !!- bc+` +
`+abc def !!- xyz+` |
`+0+` +
`+1+`
-| `+=-+` |
- Est inclus, insensible à la casse +
- _(WeeChat ≥ 2.9)_ |
+| `+=-+` | 2.9 |
+ Est inclus, insensible à la casse |
`+abc def =- BC+` +
`+abc def =- XYZ+` |
`+1+` +
`+0+`
-| `+!-+` |
- N'est PAS inclus, insensible à la casse +
- _(WeeChat ≥ 2.9)_ |
+| `+!-+` | 2.9 |
+ N'est PAS inclus, insensible à la casse |
`+abc def !- BC+` +
`+abc def !- XYZ+` |
`+0+` +
`+1+`
-| `+==+` |
+| `+==+` | |
Égal |
`+test == test+` +
`+test == string+` |
`+1+` +
`+0+`
-| `+!=+` |
+| `+!=+` | |
Non égal |
`+test != test+` +
`+test != string+` |
`+0+` +
`+1+`
-| `+<=+` |
+| `+<=+` | |
Plus petit ou égal |
`+abc <= defghi+` +
`+abc <= abc+` +
@@ -2558,7 +2550,7 @@ Liste des opérateurs de comparaison qui peuvent être utilisés dans les condit
`+0+` +
`+0+`
-| `+<+` |
+| `+<+` | |
Plus petit |
`+abc < defghi+` +
`+abc < abc+` +
@@ -2569,7 +2561,7 @@ Liste des opérateurs de comparaison qui peuvent être utilisés dans les condit
`+0+` +
`+0+`
-| `+>=+` |
+| `+>=+` | |
Plus grand ou égal |
`+defghi >= abc+` +
`+abc >= abc+` +
@@ -2580,7 +2572,7 @@ Liste des opérateurs de comparaison qui peuvent être utilisés dans les condit
`+0+` +
`+1+`
-| `+>+` |
+| `+>+` | |
Plus grand |
`+defghi > abc+` +
`+abc > abc+` +
@@ -2611,28 +2603,26 @@ de chaque expression, par exemple :
Liste des variables étendues dans l'expression (par ordre de priorité, de la
première étendue à la dernière) :
-[width="100%",cols="2,8,4,4",options="header"]
+[width="100%",cols="2,1,8,4,4",options="header"]
|===
-| Format | Description | Exemples | Résultats
+| Format | WeeChat mini | Description | Exemples | Résultats
-| `+${raw:xxx}+` +
- _(WeeChat ≥ 3.1)_ |
+| `+${raw:xxx}+` | 3.1 |
Chaîne brute (non évaluée). |
`+${raw:${info:version}}+` |
`+${info:version}+`
-| `+${nom}+` +
- _(WeeChat ≥ 3.4)_ |
+| `+${nom}+` | 3.4 |
Variable définie par l'utilisateur (avec `+${define:nom,valeur}+`). |
`+${nom}+` |
`+valeur+`
-| `+${nom}+` |
+| `+${nom}+` | |
Variable `nom` de la table de hachage _extra_vars_. |
`+${nom}+` |
`+valeur+`
-| `+${weechat_xxx_dir}+` |
+| `+${weechat_xxx_dir}+` | 3.2 |
Un répertoire WeeChat : `+${weechat_config_dir}+`, `+${weechat_data_dir}+`,
`+${weechat_cache_dir}+` ou `+${weechat_runtime_dir}+`. |
`+${weechat_config_dir}+` +
@@ -2644,38 +2634,33 @@ première étendue à la dernière) :
`+/home/user/.cache/weechat+` +
`+/run/user/1000/weechat+`
-| `+${eval:xxx}+` +
- _(WeeChat ≥ 1.3)_ |
+| `+${eval:xxx}+` | 1.3 |
Chaîne à évaluer. |
`+${eval:${date:${weechat.look.buffer_time_format}}}+` |
`+19:02:45+` (avec des couleurs s'il y a des codes couleur dans l'option
weechat.look.buffer_time_format)
-| `+${eval_cond:xxx}+` +
- _(WeeChat ≥ 3.1)_ |
+| `+${eval_cond:xxx}+` | 3.1 |
Chaîne à évaluer comme condition. |
`+${eval_cond:${window.win_width} > 100}+` |
`+1+`
| `+${esc:xxx}+` +
- `+${\xxx}+` +
- _(WeeChat ≥ 1.0)_ |
+ `+${\xxx}+` | 1.0 |
Chaîne avec caractères échappés. |
`+${esc:préfixe\tmessage}+` +
`+${\ua9}+` |
`+préfixe<TAB>message+` +
`+©+`
-| `+${hide:x,chaîne}+` +
- _(WeeChat ≥ 1.1)_ |
+| `+${hide:x,chaîne}+` | 1.1 |
Chaîne avec les caractères masqués (tous les caractères dans `chaîne`
remplacés par `x`). |
`+${hide:*,mot_de_passe}+` |
`+************+`
| `+${cut:max,suffixe,chaîne}+` +
- `+${cut:+max,suffixe,chaîne}+` +
- _(WeeChat ≥ 1.8)_ |
+ `+${cut:+max,suffixe,chaîne}+` | 1.8 |
Chaîne avec `max` caractères, et un `suffixe` facultatif si la chaîne est coupée. +
Avec le format `+max`, le suffixe est compté dans la longueur maximale. |
`+${cut:4,…,ceci est un test}+` +
@@ -2686,8 +2671,7 @@ première étendue à la dernière) :
`+こん>>+`
| `+${cutscr:max,suffixe,chaîne}+` +
- `+${cutscr:+max,suffixe,chaîne}+` +
- _(WeeChat ≥ 1.8)_ |
+ `+${cutscr:+max,suffixe,chaîne}+` | 1.8 |
Chaîne avec `max` caractères affichés à l'écran, et un `suffixe` facultatif si la chaîne est coupée. +
Avec le format `+max`, le suffixe est compté dans la longueur maximale. |
`+${cutscr:4,…,ceci est un test}+` +
@@ -2697,8 +2681,7 @@ première étendue à la dernière) :
`+cec…+` +
`+こ>>+`
-| `+${rev:xxx}+` +
- _(WeeChat ≥ 2.2)_ |
+| `+${rev:xxx}+` | 2.2 |
Chaîne inversée (les codes couleurs sont inversés, donc la chaîne ne devrait
pas contenir de codes couleurs). |
`+${rev:Bonjour, le monde !}+` +
@@ -2706,22 +2689,19 @@ première étendue à la dernière) :
`+! ednom el ,ruojnoB+` +
`+! ednom el30F ,ruojnoB+` (pas de couleur, le code couleur est inversé)
-| `+${revscr:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${revscr:xxx}+` | 2.7 |
Chaîne inversée pour l'écran : les codes couleurs ne sont pas inversés. |
`+${revscr:Bonjour, le monde !}+` +
`+${revscr:Bonjour, ${color:red}le monde !}+` |
`+! ednom el ,ruojnoB+` +
`+! ednom el ,ruojnoB+` (`pass:[ ,ruojnoB]` en rouge)
-| `+${repeat:nombre,chaîne}+` +
- _(WeeChat ≥ 2.3)_ |
+| `+${repeat:nombre,chaîne}+` | 2.3 |
Chaîne répétée. |
`+${repeat:5,-}+` |
`+-----+`
-| `+${length:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${length:xxx}+` | 2.7 |
Longueur de la chaîne (nombre de caractères UTF-8), les codes couleurs sont
ignorés. |
`+${length:test}+` +
@@ -2729,16 +2709,14 @@ première étendue à la dernière) :
`+4+` +
`+7+`
-| `+${lengthscr:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${lengthscr:xxx}+` | 2.7 |
Longueur de la chaîne affichée à l'écran, les codes couleurs sont ignorés. |
`+${lengthscr:test}+` +
`+${lengthscr:こんにちは世界}+` |
`+4+` +
`+14+`
-| `+${split:number,seps,flags,xxx}+` +
- _(WeeChat ≥ 3.3)_ |
+| `+${split:number,seps,flags,xxx}+` | 3.3 |
Chaîne découpée, et retour, selon `number` : +
- `count` : nombre d'éléments après le découpage +
- `random` : un élément au hasard +
@@ -2771,8 +2749,7 @@ première étendue à la dernière) :
`+is+` +
`+is a test+`
-| `+${split_shell:number,xxx}+` +
- _(WeeChat ≥ 3.3)_ |
+| `+${split_shell:number,xxx}+` | 3.3 |
Paramètres shells découpés, et retour, selon `number` : +
- `count` : le nombre de paramètres après découpage +
- `random` : un paramètre au hasard +
@@ -2787,8 +2764,7 @@ première étendue à la dernière) :
`+2+` +
`+arg2+`
-| `+${re:xxx}+` +
- _(WeeChat ≥ 1.1)_ |
+| `+${re:xxx}+` | 1.1 |
Données sur l'expression régulière : +
`0` = toute la chaîne correspondante, +
`1` à `99` = groupe capturé, +
@@ -2808,8 +2784,7 @@ première étendue à la dernière) :
`+2+` +
`+1+`
-| `+${color:nom}+` +
- _(WeeChat ≥ 0.4.2)_ |
+| `+${color:nom}+` | 0.4.2 |
Code couleur WeeChat (le nom de couleur a des attributs facultatifs),
voir la fonction <<_color,color>> pour les formats supportés. |
`+${color:red}texte rouge+` +
@@ -2817,8 +2792,7 @@ première étendue à la dernière) :
`+texte rouge+` (en rouge) +
`+texte orange gras+` (en orange gras)
-| `+${modifier:name,data,string}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${modifier:name,data,string}+` | 2.7 |
Résultat d'un modificateur, voir la fonction
<<_hook_modifier_exec,hook_modifier_exec>>. |
`+${modifier:eval_path_home,,~}+` +
@@ -2827,16 +2801,14 @@ première étendue à la dernière) :
`+/home/user/.config/weechat/weechat.conf+`
| `+${info:nom}+` +
- `+${info:nom,paramètres}+` +
- _(WeeChat ≥ 0.4.3)_ |
+ `+${info:nom,paramètres}+` | 0.4.3 |
Info de WeeChat ou d'une extension, voir la fonction <<_info_get,info_get>>. |
`+${info:version}+` +
`+${info:nick_color_name,foo}+` |
`+1.0+` +
`+lightblue+`
-| `+${base_encode:base,xxx}+` +
- _(WeeChat ≥ 2.9)_ |
+| `+${base_encode:base,xxx}+` | 2.9 |
Chaîne encodée en base 16, 32 ou 64. |
`+${base_encode:16,test string}+` +
`+${base_encode:32,test string}+` +
@@ -2845,8 +2817,7 @@ première étendue à la dernière) :
`+ORSXG5BAON2HE2LOM4======+` +
`+dGVzdCBzdHJpbmc=+`
-| `+${base_decode:base,xxx}+` +
- _(WeeChat ≥ 2.9)_ |
+| `+${base_decode:base,xxx}+` | 2.9 |
Chaîne décodée depuis base 16, 32 ou 64. |
`+${base_decode:16,7465737420737472696E67}+` +
`+${base_decode:32,ORSXG5BAON2HE2LOM4======}+` +
@@ -2856,8 +2827,7 @@ première étendue à la dernière) :
`+test string+`
| `+${date}+` +
- `+${date:xxx}+` +
- _(WeeChat ≥ 1.3)_ |
+ `+${date:xxx}+` | 1.3 |
La date/heure courante, avec un format personnalisé (voir `man strftime`),
le format par défaut est `%F %T`. |
`+${date}+` +
@@ -2865,16 +2835,14 @@ première étendue à la dernière) :
`+2015-06-30 19:02:45+` +
`+19:02:45+`
-| `+${env:NOM}+` +
- _(WeeChat ≥ 1.2)_ |
+| `+${env:NOM}+` | 1.2 |
Valeur de la variable d'environnement `NOM`. |
`+${env:HOME}+` |
`+/home/user+`
| `+${if:condition}+` +
`+${if:condition?vrai}+`
- `+${if:condition?vrai:faux}+` +
- _(WeeChat ≥ 1.8)_ |
+ `+${if:condition?vrai:faux}+` | 1.8 |
Opérateur ternaire avec une condition, une valeur si la condition est vraie
(optionnelle) et une autre valeur si la condition est fausse (optionnelle).
Si les valeurs ne sont pas données, "1" ou "0" est retourné, selon le résultat
@@ -2882,8 +2850,7 @@ première étendue à la dernière) :
`+${if:${info:term_width}>80?grand:petit}+` |
`+grand+`
-| `+${calc:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${calc:xxx}+` | 2.7 |
Résultat de l'expression, où les parenthèses et les opérateurs suivants sont
supportés : +
`+++` : addition +
@@ -2906,48 +2873,45 @@ première étendue à la dernière) :
`+0.2+` +
`+65536+`
-| `+${random:min,max}+` +
- _(WeeChat ≥ 3.3)_ |
+| `+${random:min,max}+` | 3.3 |
Nombre entier aléatoire dans l'intervalle de `min` à `max` (inclus). |
`+${random:0,10}+` |
`+3+`
-| `+${translate:xxx}+` +
- _(WeeChat ≥ 3.2)_ |
+| `+${translate:xxx}+` | 3.2 |
Chaîne traduite (dépend de la langue utilisée par WeeChat pour afficher les
messages). |
`+${translate:Plugin}+` |
`+Extension+` (exemple en Français)
-| `+${define:nom,valeur}+` +
- _(WeeChat ≥ 3.4)_ |
+| `+${define:nom,valeur}+` | 3.4 |
Définir une variable `nom` à `valeur`, qui peut être utilisée dans la même
expression évaluée avec `+${nom}+`. |
`+${define:len,${calc:5+3}}${len}x${len}+` |
`+8x8+`
-| `+${sec.data.nom}+` |
+| `+${sec.data.nom}+` | |
Valeur de la donnée sécurisée `nom`. |
`+${sec.data.libera_pass}+` |
`+mon_mot_de_passe+`
-| `+${fichier.section.option}+` |
+| `+${fichier.section.option}+` | |
Valeur de l'option. |
`+${weechat.look.buffer_time_format}+` |
`+%H:%M:%S+`
-| `+${nom}+` |
+| `+${nom}+` | |
Valeur de la variable locale `nom` dans le tampon. |
`+${nick}+` |
`+FlashCode+`
-| `+${pointeur}+` |
+| `+${pointeur}+` | |
Variable `pointeur` de la table de hachage _pointers_. |
`+${buffer}+` |
`+0x1234abcd+`
| `+${hdata.var1.var2...}+` +
- `+${hdata[list].var1.var2...}+` |
+ `+${hdata[list].var1.var2...}+` | |
Valeur d'un hdata (les pointeurs `window` et `buffer` sont définis par défaut
avec la fenêtre et tampon courants), `list` peut être le nom d'une liste
(exemple : "gui_buffers"), un pointeur (exemple : "0x1234abcd") ou un nom
diff --git a/doc/it/weechat_plugin_api.it.adoc b/doc/it/weechat_plugin_api.it.adoc
index 311ec3c2e..a645df27f 100644
--- a/doc/it/weechat_plugin_api.it.adoc
+++ b/doc/it/weechat_plugin_api.it.adoc
@@ -2485,18 +2485,18 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
List of logical operators that can be used in conditions (by order of priority,
from first used to last):
-[width="100%",cols="2,8,4,4",options="header"]
+[width="100%",cols="2,1,8,4,4",options="header"]
|===
-| Operator | Description | Examples | Results
+| Operator | Min WeeChat | Description | Examples | Results
-| `+&&+` |
+| `+&&+` | |
Logical "and" |
`+25 && 77+` +
`+25 && 0+` |
`+1+` +
`+0+`
-| `+\|\|+` |
+| `+\|\|+` | |
Logical "or" |
`+25 \|\| 0+` +
`+0 \|\| 0+` |
@@ -2507,103 +2507,95 @@ from first used to last):
List of comparison operators that can be used in conditions (by order of priority,
from first used to last):
-[width="100%",cols="2,8,4,4",options="header"]
+[width="100%",cols="2,1,8,4,4",options="header"]
|===
-| Operator | Description | Examples | Results
+| Operator | Min WeeChat | Description | Examples | Results
-| `+=~+` |
+| `+=~+` | |
Is matching POSIX extended regex (optional flags are allowed, see function <<_string_regcomp,string_regcomp>>) |
`+abc def =~ ab.*ef+` +
`+abc def =~ y.*z+` |
`+1+` +
`+0+`
-| `+!~+` |
+| `+!~+` | |
Is NOT matching POSIX extended regex (optional flags are allowed, see function <<_string_regcomp,string_regcomp>>) |
`+abc def !~ ab.*ef+` +
`+abc def !~ y.*z+` |
`+0+` +
`+1+`
-| `+==*+` |
- Is matching mask where "*" is allowed, case sensitive (see function <<_string_match,string_match>>) +
- _(WeeChat ≥ 2.9)_ |
+| `+==*+` | 2.9 |
+ Is matching mask where "*" is allowed, case sensitive (see function <<_string_match,string_match>>) |
`+abc def ==* a*f+` +
`+abc def ==* y*z+` |
`+1+` +
`+0+`
-| `+!!*+` |
- Is NOT wildcard mask where "*" is allowed, case sensitive (see function <<_string_match,string_match>>) +
- _(WeeChat ≥ 2.9)_ |
+| `+!!*+` | 2.9 |
+ Is NOT wildcard mask where "*" is allowed, case sensitive (see function <<_string_match,string_match>>) |
`+abc def !!* a*f+` +
`+abc def !!* y*z+` |
`+0+` +
`+1+`
-| `+=*+` |
- Is matching mask where "*" is allowed, case insensitive (see function <<_string_match,string_match>>) +
- _(WeeChat ≥ 1.8)_ |
+| `+=*+` | 1.8 |
+ Is matching mask where "*" is allowed, case insensitive (see function <<_string_match,string_match>>) |
`+abc def =* A*F+` +
`+abc def =* Y*Z+` |
`+1+` +
`+0+`
-| `+!*+` |
- Is NOT wildcard mask where "*" is allowed, case insensitive (see function <<_string_match,string_match>>) +
- _(WeeChat ≥ 1.8)_ |
+| `+!*+` | 1.8 |
+ Is NOT wildcard mask where "*" is allowed, case insensitive (see function <<_string_match,string_match>>) |
`+abc def !* A*F+` +
`+abc def !* Y*Z+` |
`+0+` +
`+1+`
-| `+==-+` |
- Is included, case sensitive +
- _(WeeChat ≥ 2.9)_ |
+| `+==-+` | 2.9 |
+ Is included, case sensitive |
`+abc def ==- bc+` +
`+abc def ==- xyz+` |
`+1+` +
`+0+`
-| `+!!-+` |
- Is NOT included, case sensitive +
- _(WeeChat ≥ 2.9)_ |
+| `+!!-+` | 2.9 |
+ Is NOT included, case sensitive |
`+abc def !!- bc+` +
`+abc def !!- xyz+` |
`+0+` +
`+1+`
-| `+=-+` |
- Is included, case insensitive +
- _(WeeChat ≥ 2.9)_ |
+| `+=-+` | 2.9 |
+ Is included, case insensitive |
`+abc def =- BC+` +
`+abc def =- XYZ+` |
`+1+` +
`+0+`
-| `+!-+` |
- Is NOT included, case insensitive +
- _(WeeChat ≥ 2.9)_ |
+| `+!-+` | 2.9 |
+ Is NOT included, case insensitive |
`+abc def !- BC+` +
`+abc def !- XYZ+` |
`+0+` +
`+1+`
-| `+==+` |
+| `+==+` | |
Equal |
`+test == test+` +
`+test == string+` |
`+1+` +
`+0+`
-| `+!=+` |
+| `+!=+` | |
Not equal |
`+test != test+` +
`+test != string+` |
`+0+` +
`+1+`
-| `+<=+` |
+| `+<=+` | |
Less or equal |
`+abc <= defghi+` +
`+abc <= abc+` +
@@ -2614,7 +2606,7 @@ from first used to last):
`+0+` +
`+0+`
-| `+<+` |
+| `+<+` | |
Less |
`+abc < defghi+` +
`+abc < abc+` +
@@ -2625,7 +2617,7 @@ from first used to last):
`+0+` +
`+0+`
-| `+>=+` |
+| `+>=+` | |
Greater or equal |
`+defghi >= abc+` +
`+abc >= abc+` +
@@ -2636,7 +2628,7 @@ from first used to last):
`+0+` +
`+1+`
-| `+>+` |
+| `+>+` | |
Greater |
`+defghi > abc+` +
`+abc > abc+` +
@@ -2667,28 +2659,26 @@ for example:
List of variables expanded in expression (by order of priority, from first
expanded to last):
-[width="100%",cols="2,8,4,4",options="header"]
+[width="100%",cols="2,1,8,4,4",options="header"]
|===
-| Format | Description | Examples | Results
+| Format | Min WeeChat | Description | Examples | Results
-| `+${raw:xxx}+` +
- _(WeeChat ≥ 3.1)_ |
+| `+${raw:xxx}+` | 3.1 |
Raw string (not evaluated). |
`+${raw:${info:version}}+` |
`+${info:version}+`
-| `+${name}+` +
- _(WeeChat ≥ 3.4)_ |
+| `+${name}+` | 3.4 |
User variable (defined with `+${define:name,value}+`). |
`+${name}+` |
`+value+`
-| `+${name}+` |
+| `+${name}+` | |
Variable `name` from hashtable _extra_vars_. |
`+${name}+` |
`+value+`
-| `+${weechat_xxx_dir}+` |
+| `+${weechat_xxx_dir}+` | 3.2 |
A WeeChat directory: `+${weechat_config_dir}+`, `+${weechat_data_dir}+`,
`+${weechat_cache_dir}+` or `+${weechat_runtime_dir}+`. |
`+${weechat_config_dir}+` +
@@ -2700,37 +2690,32 @@ expanded to last):
`+/home/user/.cache/weechat+` +
`+/run/user/1000/weechat+`
-| `+${eval:xxx}+` +
- _(WeeChat ≥ 1.3)_ |
+| `+${eval:xxx}+` | 1.3 |
String to evaluate. |
`+${eval:${date:${weechat.look.buffer_time_format}}}+` |
`+19:02:45+` (with colors if there are color codes in the option
weechat.look.buffer_time_format)
-| `+${eval_cond:xxx}+` +
- _(WeeChat ≥ 3.1)_ |
+| `+${eval_cond:xxx}+` | 3.1 |
String to evaluate as condition. |
`+${eval_cond:${window.win_width} > 100}+` |
`+1+`
| `+${esc:xxx}+` +
- `+${\xxx}+` +
- _(WeeChat ≥ 1.0)_ |
+ `+${\xxx}+` | 1.0 |
String with escaped chars. |
`+${esc:prefix\tmessage}+` +
`+${\ua9}+` |
`+prefix<TAB>message+` +
`+©+`
-| `+${hide:x,string}+` +
- _(WeeChat ≥ 1.1)_ |
+| `+${hide:x,string}+` | 1.1 |
String with hidden chars (all chars in `string` replaced `x`). |
`+${hide:*,password}+` |
`+********+`
| `+${cut:max,suffix,string}+` +
- `+${cut:+max,suffix,string}+` +
- _(WeeChat ≥ 1.8)_ |
+ `+${cut:+max,suffix,string}+` | 1.8 |
String with `max` chars, and optional `suffix` if string is cut. +
With the format `+max`, the suffix is counted in max length. |
`+${cut:4,…,this is a test}+` +
@@ -2741,8 +2726,7 @@ expanded to last):
`+こん>>+`
| `+${cutscr:max,suffix,string}+` +
- `+${cutscr:+max,suffix,string}+` +
- _(WeeChat ≥ 1.8)_ |
+ `+${cutscr:+max,suffix,string}+` | 1.8 |
String with `max` chars displayed on screen, and optional `suffix` if string is cut. +
With the format `+max`, the suffix is counted in max length. |
`+${cutscr:4,…,this is a test}+` +
@@ -2752,8 +2736,7 @@ expanded to last):
`+thi…+` +
`+こ>>+`
-| `+${rev:xxx}+` +
- _(WeeChat ≥ 2.2)_ |
+| `+${rev:xxx}+` | 2.2 |
Reversed string (color codes are reversed, so the string should not contain
color codes). |
`+${rev:Hello, world!}+` +
@@ -2761,38 +2744,33 @@ expanded to last):
`+!dlrow ,olleH+` +
`+!dlrow30F ,olleH+` (no color, the color code is reversed)
-| `+${revscr:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${revscr:xxx}+` | 2.7 |
Reversed string for screen, color codes are not reversed. |
`+${revscr:Hello, world!}+` +
`+${revscr:Hello, ${color:red}world!}+` |
`+!dlrow ,olleH+` +
`+!dlrow ,olleH+` (`pass:[ ,olleH]` in red)
-| `+${repeat:count,string}+` +
- _(WeeChat ≥ 2.3)_ |
+| `+${repeat:count,string}+` | 2.3 |
Repeated string. |
`+${repeat:5,-}+` |
`+-----+`
-| `+${length:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${length:xxx}+` | 2.7 |
Length of string (number of UTF-8 chars), color codes are ignored. |
`+${length:test}+` +
`+${length:こんにちは世界}+` |
`+4+` +
`+7+`
-| `+${lengthscr:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${lengthscr:xxx}+` | 2.7 |
Length of string displayed on screen, color codes are ignored. |
`+${lengthscr:test}+` +
`+${lengthscr:こんにちは世界}+` |
`+4+` +
`+14+`
-| `+${split:number,seps,flags,xxx}+` +
- _(WeeChat ≥ 3.3)_ |
+| `+${split:number,seps,flags,xxx}+` | 3.3 |
Split string, and return, according to `number`: +
- `count`: the number of items after split +
- `random`: a random item +
@@ -2825,8 +2803,7 @@ expanded to last):
`+is+` +
`+is a test+`
-| `+${split_shell:number,xxx}+` +
- _(WeeChat ≥ 3.3)_ |
+| `+${split_shell:number,xxx}+` | 3.3 |
Split shell arguments, and return, according to `number`: +
- `count`: the number of arguments after split +
- `random`: a random argument +
@@ -2841,8 +2818,7 @@ expanded to last):
`+2+` +
`+arg2+`
-| `+${re:xxx}+` +
- _(WeeChat ≥ 1.1)_ |
+| `+${re:xxx}+` | 1.1 |
Regex data: +
`0` = whole string matching, +
`1` to `99` = group captured, +
@@ -2862,8 +2838,7 @@ expanded to last):
`+2+` +
`+1+`
-| `+${color:name}+` +
- _(WeeChat ≥ 0.4.2)_ |
+| `+${color:name}+` | 0.4.2 |
WeeChat color code (the name of color has optional attributes),
see function <<_color,color>> for supported formats. |
`+${color:red}red text+` +
@@ -2871,8 +2846,7 @@ expanded to last):
`+red text+` (in red) +
`+bold orange text+` (in bold orange)
-| `+${modifier:name,data,string}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${modifier:name,data,string}+` | 2.7 |
Result of a modifier, see function
<<_hook_modifier_exec,hook_modifier_exec>>. |
`+${modifier:eval_path_home,,~}+` +
@@ -2881,16 +2855,14 @@ expanded to last):
`+/home/user/.config/weechat/weechat.conf+`
| `+${info:name}+` +
- `+${info:name,arguments}+` +
- _(WeeChat ≥ 0.4.3)_ |
+ `+${info:name,arguments}+` | 0.4.3 |
Info from WeeChat or a plugin, see function <<_info_get,info_get>>. |
`+${info:version}+` +
`+${info:nick_color_name,foo}+` |
`+1.0+` +
`+lightblue+`
-| `+${base_encode:base,xxx}+` +
- _(WeeChat ≥ 2.9)_ |
+| `+${base_encode:base,xxx}+` | 2.9 |
String encoded in base 16, 32 or 64. |
`+${base_encode:16,test string}+` +
`+${base_encode:32,test string}+` +
@@ -2899,8 +2871,7 @@ expanded to last):
`+ORSXG5BAON2HE2LOM4======+` +
`+dGVzdCBzdHJpbmc=+`
-| `+${base_decode:base,xxx}+` +
- _(WeeChat ≥ 2.9)_ |
+| `+${base_decode:base,xxx}+` | 2.9 |
String decoded from base 16, 32 or 64. |
`+${base_decode:16,7465737420737472696E67}+` +
`+${base_decode:32,ORSXG5BAON2HE2LOM4======}+` +
@@ -2910,8 +2881,7 @@ expanded to last):
`+test string+`
| `+${date}+` +
- `+${date:xxx}+` +
- _(WeeChat ≥ 1.3)_ |
+ `+${date:xxx}+` | 1.3 |
Current date/time, with custom format (see `man strftime`),
default format is `%F %T`. |
`+${date}+` +
@@ -2919,24 +2889,21 @@ expanded to last):
`+2015-06-30 19:02:45+` +
`+19:02:45+`
-| `+${env:NAME}+` +
- _(WeeChat ≥ 1.2)_ |
+| `+${env:NAME}+` | 1.2 |
Value of the environment variable `NAME`. |
`+${env:HOME}+` |
`+/home/user+`
| `+${if:condition}+` +
`+${if:condition?true}+`
- `+${if:condition?true:false}+` +
- _(WeeChat ≥ 1.8)_ |
+ `+${if:condition?true:false}+` | 1.8 |
Ternary operator with a condition, a value if the condition is true (optional)
and another value if the condition is false (optional). If values are not
given, "1" or "0" are returned, according to the result of the condition. |
`+${if:${info:term_width}>80?big:small}+` |
`+big+`
-| `+${calc:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${calc:xxx}+` | 2.7 |
Result of expression, where parentheses and the following operators are
supported: +
`+++`: addition +
@@ -2959,47 +2926,44 @@ expanded to last):
`+0.2+` +
`+65536+`
-| `+${random:min,max}+` +
- _(WeeChat ≥ 3.3)_ |
+| `+${random:min,max}+` | 3.3 |
Random integer number in the range from `min` to `max` (inclusive). |
`+${random:0,10}+` |
`+3+`
-| `+${translate:xxx}+` +
- _(WeeChat ≥ 3.2)_ |
+| `+${translate:xxx}+` | 3.2 |
Translated string (depends on the language used by WeeChat to display messages). |
`+${translate:Plugin}+` |
`+Extension+` (example in French)
-| `+${define:name,value}+` +
- _(WeeChat ≥ 3.4)_ |
+| `+${define:name,value}+` | 3.4 |
Define a variable `name` set to `value`, which can then be used in the same
evaluated expression with `+${name}+`. |
`+${define:len,${calc:5+3}}${len}x${len}+` |
`+8x8+`
-| `+${sec.data.name}+` |
+| `+${sec.data.name}+` | |
Value of the secured data `name`. |
`+${sec.data.libera_pass}+` |
`+my_password+`
-| `+${file.section.option}+` |
+| `+${file.section.option}+` | |
Value of the option. |
`+${weechat.look.buffer_time_format}+` |
`+%H:%M:%S+`
-| `+${name}+` |
+| `+${name}+` | |
Value of local variable `name` in buffer. |
`+${nick}+` |
`+FlashCode+`
-| `+${pointer}+` |
+| `+${pointer}+` | |
Variable `pointer` from hashtable _pointers_. |
`+${buffer}+` |
`+0x1234abcd+`
| `+${hdata.var1.var2...}+` +
- `+${hdata[list].var1.var2...}+` |
+ `+${hdata[list].var1.var2...}+` | |
Hdata value (pointers `window` and `buffer` are set by default with current
window/buffer), `list` can be a list name (example: "gui_buffers"), a pointer
(example: "0x1234abcd") or a pointer name (example: "my_pointer"). |
diff --git a/doc/ja/weechat_plugin_api.ja.adoc b/doc/ja/weechat_plugin_api.ja.adoc
index 20c7af10f..537099f6b 100644
--- a/doc/ja/weechat_plugin_api.ja.adoc
+++ b/doc/ja/weechat_plugin_api.ja.adoc
@@ -2410,18 +2410,19 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
条件に使える論理演算子のリスト
(上から優先順位の高い順):
-[width="100%",cols="2,8,4,4",options="header"]
+[width="100%",cols="2,1,8,4,4",options="header"]
|===
-| 演算子 | 説明 | 例 | 結果
+// TRANSLATION MISSING
+| 演算子 | Min WeeChat | 説明 | 例 | 結果
-| `+&&+` |
+| `+&&+` | |
論理積 |
`+25 && 77+` +
`+25 && 0+` |
`+1+` +
`+0+`
-| `+\|\|+` |
+| `+\|\|+` | |
論理和 |
`+25 \|\| 0+` +
`+0 \|\| 0+` |
@@ -2432,18 +2433,19 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
条件に使える比較演算子のリスト
(上から優先順位の高い順):
-[width="100%",cols="2,8,4,4",options="header"]
+[width="100%",cols="2,1,8,4,4",options="header"]
|===
-| 演算子 | 説明 | 例 | 結果
+// TRANSLATION MISSING
+| 演算子 | Min WeeChat | 説明 | 例 | 結果
-| `+=~+` |
+| `+=~+` | |
POSIX 拡張正規表現にマッチ (任意でフラグを指定することも可能です、関数 <<_string_regcomp,string_regcomp>> を確認してください) |
`+abc def =~ ab.*ef+` +
`+abc def =~ y.*z+` |
`+1+` +
`+0+`
-| `+!~+` |
+| `+!~+` | |
POSIX 拡張正規表現にマッチしない (任意でフラグを指定することも可能です、関数 <<_string_regcomp,string_regcomp>> を確認してください) |
`+abc def !~ ab.*ef+` +
`+abc def !~ y.*z+` |
@@ -2451,92 +2453,84 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+1+`
// TRANSLATION MISSING
-| `+==*+` |
- Is matching mask where "*" is allowed, case sensitive (see function <<_string_match,string_match>>) +
- _(WeeChat ≥ 2.9)_ |
+| `+==*+` | 2.9 |
+ Is matching mask where "*" is allowed, case sensitive (see function <<_string_match,string_match>>) |
`+abc def ==* a*f+` +
`+abc def ==* y*z+` |
`+1+` +
`+0+`
// TRANSLATION MISSING
-| `+!!*+` |
- Is NOT wildcard mask where "*" is allowed, case sensitive (see function <<_string_match,string_match>>) +
- _(WeeChat ≥ 2.9)_ |
+| `+!!*+` | 2.9 |
+ Is NOT wildcard mask where "*" is allowed, case sensitive (see function <<_string_match,string_match>>) |
`+abc def !!* a*f+` +
`+abc def !!* y*z+` |
`+0+` +
`+1+`
// TRANSLATION MISSING
-| `+=*+` |
- Is matching mask where "*" is allowed, case insensitive (see function <<_string_match,string_match>>) +
- _(WeeChat ≥ 1.8)_ |
+| `+=*+` | 1.8 |
+ Is matching mask where "*" is allowed, case insensitive (see function <<_string_match,string_match>>) |
`+abc def =* A*F+` +
`+abc def =* Y*Z+` |
`+1+` +
`+0+`
// TRANSLATION MISSING
-| `+!*+` |
- Is NOT wildcard mask where "*" is allowed, case insensitive (see function <<_string_match,string_match>>) +
- _(WeeChat ≥ 1.8)_ |
+| `+!*+` | 1.8 |
+ Is NOT wildcard mask where "*" is allowed, case insensitive (see function <<_string_match,string_match>>) |
`+abc def !* A*F+` +
`+abc def !* Y*Z+` |
`+0+` +
`+1+`
// TRANSLATION MISSING
-| `+==-+` |
- Is included, case sensitive +
- _(WeeChat ≥ 2.9)_ |
+| `+==-+` | 2.9 |
+ Is included, case sensitive |
`+abc def ==- bc+` +
`+abc def ==- xyz+` |
`+1+` +
`+0+`
// TRANSLATION MISSING
-| `+!!-+` |
- Is NOT included, case sensitive +
- _(WeeChat ≥ 2.9)_ |
+| `+!!-+` | 2.9 |
+ Is NOT included, case sensitive |
`+abc def !!- bc+` +
`+abc def !!- xyz+` |
`+0+` +
`+1+`
// TRANSLATION MISSING
-| `+=-+` |
- Is included, case insensitive +
- _(WeeChat ≥ 2.9)_ |
+| `+=-+` | 2.9 |
+ Is included, case insensitive |
`+abc def =- BC+` +
`+abc def =- XYZ+` |
`+1+` +
`+0+`
// TRANSLATION MISSING
-| `+!-+` |
- Is NOT included, case insensitive +
- _(WeeChat ≥ 2.9)_ |
+| `+!-+` | 2.9 |
+ Is NOT included, case insensitive |
`+abc def !- BC+` +
`+abc def !- XYZ+` |
`+0+` +
`+1+`
-| `+==+` |
+| `+==+` | |
等しい |
`+test == test+` +
`+test == string+` |
`+1+` +
`+0+`
-| `+!=+` |
+| `+!=+` | |
等しくない |
`+test != test+` +
`+test != string+` |
`+0+` +
`+1+`
-| `+<=+` |
+| `+<=+` | |
以下 |
`+abc <= defghi+` +
`+abc <= abc+` +
@@ -2547,7 +2541,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+0+` +
`+0+`
-| `+<+` |
+| `+<+` | |
より小さい |
`+abc < defghi+` +
`+abc < abc+` +
@@ -2558,7 +2552,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+0+` +
`+0+`
-| `+>=+` |
+| `+>=+` | |
以上 |
`+defghi >= abc+` +
`+abc >= abc+` +
@@ -2569,7 +2563,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+0+` +
`+1+`
-| `+>+` |
+| `+>+` | |
より大きい |
`+defghi > abc+` +
`+abc > abc+` +
@@ -2598,31 +2592,30 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
式中で展開される変数のリスト
(優先度の高い順、展開順の早いものを上に遅いものを下に):
-[width="100%",cols="2,8,4,4",options="header"]
+[width="100%",cols="2,1,8,4,4",options="header"]
|===
-| 書式 | 説明 | 例 | 結果
+// TRANSLATION MISSING
+| 書式 | Min WeeChat | 説明 | 例 | 結果
// TRANSLATION MISSING
-| `+${raw:xxx}+` +
- _(WeeChat ≥ 3.1)_ |
+| `+${raw:xxx}+` | 3.1 |
Raw string (not evaluated). |
`+${raw:${info:version}}+` |
`+${info:version}+`
// TRANSLATION MISSING
-| `+${name}+` +
- _(WeeChat ≥ 3.4)_ |
+| `+${name}+` | 3.4 |
User variable (defined with `+${define:name,value}+`). |
`+${name}+` |
`+value+`
-| `+${name}+` |
+| `+${name}+` | |
_extra_vars_ の変数 `name` の値に展開 |
`+${name}+` |
`+value+`
// TRANSLATION MISSING
-| `+${weechat_xxx_dir}+` |
+| `+${weechat_xxx_dir}+` | 3.2 |
A WeeChat directory: `+${weechat_config_dir}+`, `+${weechat_data_dir}+`,
`+${weechat_cache_dir}+` or `+${weechat_runtime_dir}+`. |
`+${weechat_config_dir}+` +
@@ -2634,38 +2627,33 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+/home/user/.cache/weechat+` +
`+/run/user/1000/weechat+`
-| `+${eval:xxx}+` +
- _(WeeChat バージョン 1.3 以上で利用可)_ |
+| `+${eval:xxx}+` | 1.3 |
評価する文字列 |
`+${eval:${date:${weechat.look.buffer_time_format}}}+` |
`+19:02:45+` (オプション weechat.look.buffer_time_format
内に色コードが存在する場合色付き)
// TRANSLATION MISSING
-| `+${eval_cond:xxx}+` +
- _(WeeChat バージョン 3.1 以上で利用可)_ |
+| `+${eval_cond:xxx}+` | 3.1 |
String to evaluate as condition. |
`+${eval_cond:${window.win_width} > 100}+` |
`+1+`
| `+${esc:xxx}+` +
- `+${\xxx}+` +
- _(WeeChat バージョン 1.0 以上で利用可)_ |
+ `+${\xxx}+` | 1.0 |
エスケープ文字を含む文字列 |
`+${esc:prefix\tmessage}+` +
`+${\ua9}+` |
`+prefix<TAB>message+` +
`+©+`
-| `+${hide:x,string}+` +
- (_WeeChat バージョン 1.1 以上で利用可_) |
+| `+${hide:x,string}+` | 1.1 |
隠す文字を含むテキスト (`string` に含まれる文字をすべて `x` で置換) |
`+${hide:*,password}+` |
`+********+`
| `+${cut:max,suffix,string}+` +
- `+${cut:+max,suffix,string}+` +
- _(WeeChat バージョン 1.8 以上で利用可)_ |
+ `+${cut:+max,suffix,string}+` | 1.8 |
`string` の先頭 `max` 文字とオプションの `suffix` 文字 (`string` の文字数が `max` 文字を超える場合) +
`+max` を使った場合、`max` 文字にはサフィックスの文字数も含まれます。|
`+${cut:4,…,this is a test}+` +
@@ -2676,8 +2664,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+こん>>+`
| `+${cutscr:max,suffix,string}+` +
- `+${cutscr:+max,suffix,string}+` +
- _(WeeChat バージョン 1.8 以上で利用可)_ |
+ `+${cutscr:+max,suffix,string}+` | 1.8 |
`string` の先頭 `max` 文字 (半角文字幅換算) とオプションの `suffix` 文字 (`string` の文字数が `max` 文字を超える場合) +
`+max` を使った場合、`max` 文字にはサフィックスの文字数も含まれます。|
`+${cutscr:4,…,this is a test}+` +
@@ -2688,8 +2675,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+こ>>+`
// TRANSLATION MISSING
-| `+${rev:xxx}+` +
- _(WeeChat バージョン 2.2 以上で利用可)_ |
+| `+${rev:xxx}+` | 2.2 |
Reversed string (color codes are reversed, so the string should not contain
color codes). |
`+${rev:Hello, world!}+` +
@@ -2698,23 +2684,20 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+!dlrow30F ,olleH+` (no color, the color code is reversed)
// TRANSLATION MISSING
-| `+${revscr:xxx}+` +
- _(WeeChat バージョン 2.7 以上で利用可)_ |
+| `+${revscr:xxx}+` | 2.7 |
Reversed string for screen, color codes are not reversed. |
`+${revscr:Hello, world!}+` +
`+${revscr:Hello, ${color:red}world!}+` |
`+!dlrow ,olleH+` +
`+!dlrow ,olleH+` (`pass:[ ,olleH]` in red)
-| `+${repeat:count,string}+` +
- _(WeeChat バージョン 2.3 以上で利用可)_ |
+| `+${repeat:count,string}+` | 2.3 |
繰り返し文字列。|
`+${repeat:5,-}+` |
`+-----+`
// TRANSLATION MISSING
-| `+${length:xxx}+` +
- _(WeeChat バージョン 2.7 以上で利用可)_ |
+| `+${length:xxx}+` | 2.7 |
Length of string (number of UTF-8 chars), color codes are ignored. |
`+${length:test}+` +
`+${length:こんにちは世界}+` |
@@ -2722,8 +2705,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+7+`
// TRANSLATION MISSING
-| `+${lengthscr:xxx}+` +
- _(WeeChat バージョン 2.7 以上で利用可)_ |
+| `+${lengthscr:xxx}+` | 2.7 |
Length of string displayed on screen, color codes are ignored. |
`+${lengthscr:test}+` +
`+${lengthscr:こんにちは世界}+` |
@@ -2731,8 +2713,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+14+`
// TRANSLATION MISSING
-| `+${split:number,seps,flags,xxx}+` +
- _(WeeChat ≥ 3.3)_ |
+| `+${split:number,seps,flags,xxx}+` | 3.3 |
Split string, and return, according to `number`: +
- `count`: the number of items after split +
- `random`: a random item +
@@ -2766,8 +2747,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+is a test+`
// TRANSLATION MISSING
-| `+${split_shell:number,xxx}+` +
- _(WeeChat ≥ 3.3)_ |
+| `+${split_shell:number,xxx}+` | 3.3 |
Split shell arguments, and return, according to `number`: +
- `count`: the number of arguments after split +
- `random`: a random argument +
@@ -2783,8 +2763,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+arg2+`
// TRANSLATION MISSING
-| `+${re:xxx}+` +
- _(WeeChat ≥ 1.1)_ |
+| `+${re:xxx}+` | 1.1 |
Regex data: +
`0` = whole string matching, +
`1` to `99` = group captured, +
@@ -2804,8 +2783,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+2+` +
`+1+`
-| `+${color:name}+` +
- _(WeeChat バージョン 0.4.2 以上で利用可)_ |
+| `+${color:name}+` | 0.4.2 |
WeeChat 色コード (色名部分はオプション属性をとることも可能です),
書式を確認するには関数 <<_color,color>> をご確認ください |
`+${color:red}red text+` +
@@ -2814,8 +2792,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+bold orange text+` (太字オレンジ色で)
// TRANSLATION MISSING
-| `+${modifier:name,data,string}+` +
- _(WeeChat バージョン 2.7 以上で利用可)_ |
+| `+${modifier:name,data,string}+` | 2.7 |
Result of a modifier, see function
<<_hook_modifier_exec,hook_modifier_exec>>. |
`+${modifier:eval_path_home,,~}+` +
@@ -2824,8 +2801,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+/home/user/.config/weechat/weechat.conf+`
| `+${info:name}+` +
- `+${info:name,arguments}+` +
- _(WeeChat バージョン 0.4.3 以上で利用可)_ |
+ `+${info:name,arguments}+` | 0.4.3 |
WeeChat またはプラグインのインフォ、<<_info_get,info_get>>
を参照 |
`+${info:version}+` +
@@ -2834,8 +2810,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+lightblue+`
// TRANSLATION MISSING
-| `+${base_encode:base,xxx}+` +
- _(WeeChat バージョン 2.9 以上で利用可)_ |
+| `+${base_encode:base,xxx}+` | 2.9 |
String encoded in base 16, 32 or 64. |
`+${base_encode:16,test string}+` +
`+${base_encode:32,test string}+` +
@@ -2845,8 +2820,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+dGVzdCBzdHJpbmc=+`
// TRANSLATION MISSING
-| `+${base_decode:base,xxx}+` +
- _(WeeChat バージョン 2.9 以上で利用可)_ |
+| `+${base_decode:base,xxx}+` | 2.9 |
String decoded from base 16, 32 or 64. |
`+${base_decode:16,7465737420737472696E67}+` +
`+${base_decode:32,ORSXG5BAON2HE2LOM4======}+` +
@@ -2856,8 +2830,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+test string+`
| `+${date}+` +
- `+${date:xxx}+` +
- _(WeeChat バージョン 1.3 以上で利用可)_ |
+ `+${date:xxx}+` | 1.3 |
現在の日付/時刻、カスタム書式を使うことも可能です (`man strftime` を参照)、
デフォルト書式は `%F %T` |
`+${date}+` +
@@ -2865,16 +2838,14 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+2015-06-30 19:02:45+` +
`+19:02:45+`
-| `+${env:NAME}+` +
- _(WeeChat バージョン 1.2 以上で利用可)_ |
+| `+${env:NAME}+` | 1.2 |
環境変数 `NAME` の値 |
`+${env:HOME}+` |
`+/home/user+`
| `+${if:condition}+` +
`+${if:condition?true}+`
- `+${if:condition?true:false}+` +
- _(WeeChat バージョン 1.8 以上で利用可)_ |
+ `+${if:condition?true:false}+` | 1.8 |
条件、条件が真の場合の値 (任意)、条件が偽の場合の値 (任意)
からなる三項演算子。値を指定しなかった場合、条件の評価結果に応じて
"1" または "0" が返されます |
@@ -2882,8 +2853,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+big+`
// TRANSLATION MISSING
-| `+${calc:xxx}+` +
- _(WeeChat バージョン 2.7 以上で利用可)_ |
+| `+${calc:xxx}+` | 2.7 |
Result of expression, where parentheses and the following operators are
supported: +
`+++`: addition +
@@ -2907,50 +2877,47 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+65536+`
// TRANSLATION MISSING
-| `+${random:min,max}+` +
- _(WeeChat ≥ 3.3)_ |
+| `+${random:min,max}+` | 3.3 |
Random integer number in the range from `min` to `max` (inclusive). |
`+${random:0,10}+` |
`+3+`
// TRANSLATION MISSING
-| `+${translate:xxx}+` +
- _(WeeChat ≥ 3.2)_ |
+| `+${translate:xxx}+` | 3.2 |
Translated string (depends on the language used by WeeChat to display messages). |
`+${translate:Plugin}+` |
`+Extension+` (example in French)
// TRANSLATION MISSING
-| `+${define:name,value}+` +
- _(WeeChat ≥ 3.4)_ |
+| `+${define:name,value}+` | 3.4 |
Define a variable `name` set to `value`, which can then be used in the same
evaluated expression with `+${name}+`. |
`+${define:len,${calc:5+3}}${len}x${len}+` |
`+8x8+`
-| `+${sec.data.name}+` |
+| `+${sec.data.name}+` | |
セキュアデータ `name` の値 |
`+${sec.data.libera_pass}+` |
`+my_password+`
-| `+${file.section.option}+` |
+| `+${file.section.option}+` | |
オプションの値 |
`+${weechat.look.buffer_time_format}+` |
`+%H:%M:%S+`
-| `+${name}+` |
+| `+${name}+` | |
バッファに対するローカル変数 `name` の値 |
`+${nick}+` |
`+FlashCode+`
-| `+${pointer}+` |
+| `+${pointer}+` | |
_pointers_ の変数 `pointer` の値に展開 |
`+${buffer}+` |
`+0x1234abcd+`
// TRANSLATION MISSING
| `+${hdata.var1.var2...}+` +
- `+${hdata[list].var1.var2...}+` |
+ `+${hdata[list].var1.var2...}+` | |
hdata の値 (`window` と `buffer`
ポインタはデフォルトで現在のウィンドウ/バッファに設定されます),
`list` can be a list name (example: "gui_buffers"), a pointer
diff --git a/doc/sr/weechat_plugin_api.sr.adoc b/doc/sr/weechat_plugin_api.sr.adoc
index 2fa238e45..1e5b0380e 100644
--- a/doc/sr/weechat_plugin_api.sr.adoc
+++ b/doc/sr/weechat_plugin_api.sr.adoc
@@ -2272,18 +2272,18 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
Листа логичких оператора који могу да се користе у условима (по редоследу приоритета, од првог до последњег):
-[width="100%", cols="2,8,4,4", options="header"]
+[width="100%", cols="2,1,8,4,4", options="header"]
|===
-| Оператор | Опис | Примери | Резултати
+| Оператор | Мин WeeChat | Опис | Примери | Резултати
-| `+&&+` |
+| `+&&+` | |
Логичко „и” |
`+25 && 77+` +
`+25 && 0+` |
`+1+` +
`+0+`
-| `+\|\|+` |
+| `+\|\|+` | |
Логичко „или” |
`+25 \|\| 0+` +
`+0 \|\| 0+` |
@@ -2293,103 +2293,95 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
Листа оператора поређења који могу да се користе у условима (према редоследу приоритета, од првог до последњег):
-[width="100%", cols="2,8,4,4", options="header"]
+[width="100%", cols="2,1,8,4,4", options="header"]
|===
-| Оператор | Опис | Примери | Резултат
+| Оператор | Мин WeeChat | Опис | Примери | Резултат
-| `+=~+` |
+| `+=~+` | |
Подудара се са POSIX проширеним регуларним изразом (дозвољене су необавезне заставице, погледајте функцију <<_string_regcomp,string_regcomp>>) |
`+abc def =~ ab.*ef+` +
`+abc def =~ y.*z+` |
`+1+` +
`+0+`
-| `+!~+` |
+| `+!~+` | |
НЕ подудара се са POSIX проширеним регуларним изразом (дозвољене су необавезне заставице, погледајте функцију <<_string_regcomp,string_regcomp>>) |
`+abc def !~ ab.*ef+` +
`+abc def !~ y.*z+` |
`+0+` +
`+1+`
-| `+==*+` |
- Подудара се са маском где је дозвољено „*”, разликује величину слова (погледајте функцију <<_string_match,string_match>>) +
- _(WeeChat ≥ 2.9)_ |
+| `+==*+` | 2.9 |
+ Подудара се са маском где је дозвољено „*”, разликује величину слова (погледајте функцију <<_string_match,string_match>>) |
`+abc def ==* a*f+` +
`+abc def ==* y*z+` |
`+1+` +
`+0+`
-| `+!!*+` |
- НИЈЕ џокер маска у којој је дозвољено „*”, разликује величину слова (погледајте функцију <<_string_match,string_match>>) +
- _(WeeChat ≥ 2.9)_ |
+| `+!!*+` | 2.9 |
+ НИЈЕ џокер маска у којој је дозвољено „*”, разликује величину слова (погледајте функцију <<_string_match,string_match>>) |
`+abc def !!* a*f+` +
`+abc def !!* y*z+` |
`+0+` +
`+1+`
-| `+=*+` |
- Подудара се са маском где је дозвољено „*”, не разликује величину слова (погледајте функцију <<_string_match,string_match>>) +
- _(WeeChat ≥ 1.8)_ |
+| `+=*+` | 1.8 |
+ Подудара се са маском где је дозвољено „*”, не разликује величину слова (погледајте функцију <<_string_match,string_match>>) |
`+abc def =* A*F+` +
`+abc def =* Y*Z+` |
`+1+` +
`+0+`
-| `+!*+` |
- НИЈЕ џокер маска у којој је дозвољено „*”, не разликује величину слова (погледајте функцију <<_string_match,string_match>>) +
- _(WeeChat ≥ 1.8)_ |
+| `+!*+` | 1.8 |
+ НИЈЕ џокер маска у којој је дозвољено „*”, не разликује величину слова (погледајте функцију <<_string_match,string_match>>) |
`+abc def !* A*F+` +
`+abc def !* Y*Z+` |
`+0+` +
`+1+`
-| `+==-+` |
- Је укључено, разликује величину слова +
- _(WeeChat ≥ 2.9)_ |
+| `+==-+` | 2.9 |
+ Је укључено, разликује величину слова |
`+abc def ==- bc+` +
`+abc def ==- xyz+` |
`+1+` +
`+0+`
-| `+!!-+` |
- НИЈЕ укључено, разликује величину слова +
- _(WeeChat ≥ 2.9)_ |
+| `+!!-+` | 2.9 |
+ НИЈЕ укључено, разликује величину слова |
`+abc def !!- bc+` +
`+abc def !!- xyz+` |
`+0+` +
`+1+`
-| `+=-+` |
- Је укључено, не разликује величину слова +
- _(WeeChat ≥ 2.9)_ |
+| `+=-+` | 2.9 |
+ Је укључено, не разликује величину слова |
`+abc def =- BC+` +
`+abc def =- XYZ+` |
`+1+` +
`+0+`
-| `+!-+` |
- НИЈЕ укључено, не разликује величину слова +
- _(WeeChat ≥ 2.9)_ |
+| `+!-+` | 2.9 |
+ НИЈЕ укључено, не разликује величину слова |
`+abc def !- BC+` +
`+abc def !- XYZ+` |
`+0+` +
`+1+`
-| `+==+` |
+| `+==+` | |
Једнако |
`+test == test+` +
`+test == string+` |
`+1+` +
`+0+`
-| `+!=+` |
+| `+!=+` | |
Није једнако |
`+test != test+` +
`+test != string+` |
`+0+` +
`+1+`
-| `+<=+` |
+| `+<=+` | |
Мање или једнако |
`+abc <= defghi+` +
`+abc <= abc+` +
@@ -2400,7 +2392,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+0+` +
`+0+`
-| `+<+` |
+| `+<+` | |
Мање |
`+abc < defghi+` +
`+abc < abc+` +
@@ -2411,7 +2403,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+0+` +
`+0+`
-| `+>=+` |
+| `+>=+` | |
Веће или једнако |
`+defghi >= abc+` +
`+abc >= abc+` +
@@ -2422,7 +2414,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+0+` +
`+1+`
-| `+>+` |
+| `+>+` | |
Веће |
`+defghi > abc+` +
`+abc > abc+` +
@@ -2450,28 +2442,26 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
Листа развијених променљивих у изразу (према редоследу приоритета, од прве развијене, до последње):
-[width="100%", cols="2,8,4,4", options="header"]
+[width="100%", cols="2,1,8,4,4", options="header"]
|===
-| Формат | Опис | Примери | Резултати
+| Формат | Мин WeeChat | Опис | Примери | Резултати
-| `+${raw:xxx}+` +
- _(WeeChat ≥ 3.1)_ |
+| `+${raw:xxx}+` | 3.1 |
Сирови стринг (не израчунава се). |
`+${raw:${info:version}}+` |
`+${info:version}+`
-| `+${име}+` +
- _(WeeChat ≥ 3.4)_ |
+| `+${име}+` | 3.4 |
Корисничка променљива (дефинисана са `+${define:име,вредност}+`). |
`+${име}+` |
`+вредност+`
-| `+${име}+` |
+| `+${име}+` | |
Променљива `name` из хеш табеле _extra_vars_. |
`+${име}+` |
`+вредност+`
-| `+${weechat_xxx_dir}+` |
+| `+${weechat_xxx_dir}+` | 3.2 |
WeeChat директоријум: `+${weechat_config_dir}+`, `+${weechat_data_dir}+`,
`+${weechat_cache_dir}+` или `+${weechat_runtime_dir}+`. |
`+${weechat_config_dir}+` +
@@ -2483,37 +2473,32 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+/home/user/.cache/weechat+` +
`+/run/user/1000/weechat+`
-| `+${eval:xxx}+` +
- _(WeeChat ≥ 1.3)_ |
+| `+${eval:xxx}+` | 1.3 |
Стринг који се израчунава. |
`+${eval:${date:${weechat.look.buffer_time_format}}}+` |
`+19:02:45+` (са бојама, ако у опцији weechat.look.buffer_time_format
постоје боје)
-| `+${eval_cond:xxx}+` +
- _(WeeChat ≥ 3.1)_ |
+| `+${eval_cond:xxx}+` | 3.1 |
Стринг који се израчунава као услов. |
`+${eval_cond:${window.win_width} > 100}+` |
`+1+`
| `+${esc:xxx}+` +
- `+${\xxx}+` +
- _(WeeChat ≥ 1.0)_ |
+ `+${\xxx}+` | 1.0 |
Стринг са означеним карактерима. |
`+${esc:prefix\tmessage}+` +
`+${\ua9}+` |
`+prefix<TAB>message+` +
`+©+`
-| `+${hide:x,стринг}+` +
- _(WeeChat ≥ 1.1)_ |
+| `+${hide:x,стринг}+` | 1.1 |
Стринг са скривеним карактерима (сви карактери у `стринг` се замењују са `x`). |
`+${hide:*,password}+` |
`+********+`
| `+${cut:макс,суфикс,стринг}+` +
- `+${cut:+макс,суфикс,стринг}+` +
- _(WeeChat ≥ 1.8)_ |
+ `+${cut:+макс,суфикс,стринг}+` | 1.8 |
Стринг са `макс` карактера и необавезним `суфикс` ако се стринг сече. +
У формату `+макс`, суфикс се рачуна у максималну дужину. |
`+${cut:4,…,this is a test}+` +
@@ -2524,8 +2509,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+こん>>+`
| `+${cutscr:макс,суфикс,стринг}+` +
- `+${cutscr:+макс,суфикс,стринг}+` +
- _(WeeChat ≥ 1.8)_ |
+ `+${cutscr:+макс,суфикс,стринг}+` | 1.8 |
Стринг са `макс` карактера приказаних на екрану, и необавезним `суфикс` ако се стринг сече.
У формату `+макс`, суфикс се рачуна у максималну дужину. |
`+${cutscr:4,…,this is a test}+` +
@@ -2535,8 +2519,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+thi…+` +
`+こ>>+`
-| `+${rev:xxx}+` +
- _(WeeChat ≥ 2.2)_ |
+| `+${rev:xxx}+` | 2.2 |
Обрнути стринг (и кодови боја се обрћу, тако да стринг не би требало да садржи
кодове боја). |
`+${rev:Hello, world!}+` +
@@ -2544,38 +2527,33 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+!dlrow ,olleH+` +
`+!dlrow30F ,olleH+` (нема боје, кôд боје је обрнут)
-| `+${revscr:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${revscr:xxx}+` | 2.7 |
Обрнути стринг за екран, кодови боја се не обрћу. |
`+${revscr:Hello, world!}+` +
`+${revscr:Hello, ${color:red}world!}+` |
`+!dlrow ,olleH+` +
`+!dlrow ,olleH+` (`pass:[ ,olleH]` у црвеној боји)
-| `+${repeat:број,стринг}+` +
- _(WeeChat ≥ 2.3)_ |
+| `+${repeat:број,стринг}+` | 2.3 |
Поновљени стринг. |
`+${repeat:5,-}+` |
`+-----+`
-| `+${length:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${length:xxx}+` | 2.7 |
Дужина стринга (број UTF-8 карактера), кодови боја се игноришу. |
`+${length:test}+` +
`+${length:こんにちは世界}+` |
`+4+` +
`+7+`
-| `+${lengthscr:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${lengthscr:xxx}+` | 2.7 |
Дужина стринга приказаног на екрану, кодови боја се игноришу. |
`+${lengthscr:test}+` +
`+${lengthscr:こんにちは世界}+` |
`+4+` +
`+14+`
-| `+${split:number,seps,flags,xxx}+` +
- _(WeeChat ≥ 3.3)_ |
+| `+${split:number,seps,flags,xxx}+` | 3.3 |
Дели стринг и враћа сагласно са `number`: +
- `count`: број ставки након поделе +
- `random`: произвољну ставку +
@@ -2608,8 +2586,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+is+` +
`+is a test+`
-| `+${split_shell:number,xxx}+` +
- _(WeeChat ≥ 3.3)_ |
+| `+${split_shell:number,xxx}+` | 3.3 |
Дели аргументе љуске и враћа сагласно са `number`: +
- `count`: број аргумената након поделе +
- `random`: произвољни аргумент +
@@ -2624,8 +2601,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+2+` +
`+arg2+`
-| `+${re:xxx}+` +
- _(WeeChat ≥ 1.1)_ |
+| `+${re:xxx}+` | 1.1 |
Подаци регуларног израза: +
`0` = цео подударени стринг, +
`1` до `99` = ухваћена група, +
@@ -2645,8 +2621,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+2+` +
`+1+`
-| `+${color:име}+` +
- _(WeeChat ≥ 0.4.2)_ |
+| `+${color:име}+` | 0.4.2 |
Кôд WeeChat боје (име боје има и необавезне атрибуте), погледајте
функцију <<_color,color>> у вези подржаних формата. |
`+${color:red}red text+` +
@@ -2654,8 +2629,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+red text+` (у црвеној) +
`+bold orange text+` (подебљано наранџасто)
-| `+${modifier:име,подаци,стринг}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${modifier:име,подаци,стринг}+` | 2.7 |
Резултат модификатора, погледајте функцију
<<_hook_modifier_exec,hook_modifier_exec>>. |
`+${modifier:eval_path_home,,~}+` +
@@ -2664,8 +2638,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+/home/user/.config/weechat/weechat.conf+`
| `+${info:име}+` +
- `+${info:име,аргументи}+` +
- _(WeeChat ≥ 0.4.3)_ |
+ `+${info:име,аргументи}+` | 0.4.3 |
Инфо из програма WeeChat или додатка, погледајте функцију
<<_info_get,info_get>>. |
`+${info:version}+` +
@@ -2673,8 +2646,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+1.0+` +
`+lightblue+`
-| `+${base_encode:base,xxx}+` +
- _(WeeChat ≥ 2.9)_ |
+| `+${base_encode:base,xxx}+` | 2.9 |
Стринг кодиран у base 16, 32 или 64. |
`+${base_encode:16,test string}+` +
`+${base_encode:32,test string}+` +
@@ -2683,8 +2655,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+ORSXG5BAON2HE2LOM4======+` +
`+dGVzdCBzdHJpbmc=+`
-| `+${base_decode:base,xxx}+` +
- _(WeeChat ≥ 2.9)_ |
+| `+${base_decode:base,xxx}+` | 2.9 |
Декодиран стринг из base 16, 32 или 64. |
`+${base_decode:16,7465737420737472696E67}+` +
`+${base_decode:32,ORSXG5BAON2HE2LOM4======}+` +
@@ -2694,8 +2665,7 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+test string+`
| `+${date}+` +
- `+${date:xxx}+` +
- _(WeeChat ≥ 1.3)_ |
+ `+${date:xxx}+` | 1.3 |
Текући датум/време, у прилагођеном формату (погледајте `man strftime`),
подразумевани формат је `%F %T`. |
`+${date}+` +
@@ -2703,24 +2673,21 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+2015-06-30 19:02:45+` +
`+19:02:45+`
-| `+${env:ИМЕ}+` +
- _(WeeChat ≥ 1.2)_ |
+| `+${env:ИМЕ}+` | 1.2 |
Име променљиве окружења `ИМЕ`. |
`+${env:HOME}+` |
`+/home/user+`
| `+${if:condition}+` +
`+${if:condition?true}+`
- `+${if:condition?true:false}+`
- _(WeeChat ≥ 1.8)_ |
+ `+${if:condition?true:false}+| 1.8 |
Тернарни оператор са условом, вредност када је услов истинит (није обавезна) и
друга вредност када је услов неистинит (није обавезна). Ако се вредности не
задају, враћа се „1” или „0”, у зависности од резултата услова. |
`+${if:${info:term_width}>80?big:small}+` |
`+big+`
-| `+${calc:xxx}+` +
- _(WeeChat ≥ 2.7)_ |
+| `+${calc:xxx}+` | 2.7 |
Резултат израза, у коме су подржане заграде и следећи
оператори: +
`+++`: сабирање +
@@ -2743,47 +2710,44 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+0.2+` +
`+65536+`
-| `+${random:min,max}+` +
- _(WeeChat ≥ 3.3)_ |
+| `+${random:min,max}+` | 3.3 |
Случајни цео број из опсега `min` до `max` (укључујући и њих). |
`+${random:0,10}+` |
`+3+`
-| `+${translate:xxx}+` +
- _(WeeChat ≥ 3.2)_ |
+| `+${translate:xxx}+` | 3.2 |
Преведени стринг (зависи од језика који програм WeeChat користи за приказ порука). |
`+${translate:Plugin}+` |
`+Extension+` (пример из француског)
-| `+${define:name,value}+` +
- _(WeeChat ≥ 3.4)_ |
+| `+${define:name,value}+` | 3.4 |
Дефинисање променљиве `име` постављене на `вредност`, која онда може да се користи у истом
израчунатом изразу са `+${име}+`. |
`+${define:len,${calc:5+3}}${len}x${len}+` |
`+8x8+`
-| `+${sec.data.име}+` |
+| `+${sec.data.име}+` | |
Вредност обезбеђених података `име`. |
`+${sec.data.libera_pass}+` |
`+my_password+`
-| `+${фајл.одељак.опција}+` |
+| `+${фајл.одељак.опција}+` | |
Вредност опције. |
`+${weechat.look.buffer_time_format}+` |
`+%H:%M:%S+`
-| `+${име}+` |
+| `+${име}+` | |
Вредност локалне променљиве `име` у баферу. |
`+${nick}+` |
`+FlashCode+`
-| `+${pointer}+` |
+| `+${pointer}+` | |
Променљива `pointer` из хеш табеле _pointers_. |
`+${buffer}+` |
`+0x1234abcd+`
| `+${hdata.пром1.пром2...}+` +
- `+${hdata[листа].пром1.пром2...}+` |
+ `+${hdata[листа].пром1.пром2...}+` | |
Hdata вредност (показивачи `window` и `buffer` се подразумевано постављају на текући
прозор/бафер), `листа` може бити име листе (пример: „gui_buffers”), показивач
(пример: „0x1234abcd”) или име показивача (пример: „my_pointer”). |