doc: add min WeeChat version in function string_eval_expression (plugin API reference)

v2.8-utf8proc
Sébastien Helleu 2017-04-02 15:54:20 +02:00
parent 4c8d37e09f
commit a86a32334a
4 changed files with 48 additions and 28 deletions

View File

@ -1955,7 +1955,7 @@ str3 = weechat.string_input_for_buffer("//test") # "/test"
==== string_eval_expression
_WeeChat ≥ 0.4.0, updated in 0.4.2, 1.0, 1.1, 1.2, 1.3 and 1.8._
_WeeChat ≥ 0.4.0, updated in 0.4.2, 0.4.3, 1.0, 1.1, 1.2, 1.3, 1.6 and 1.8._
Evaluate an expression and return result as a string.
Special variables with format `+${variable}+` are expanded (see table below).
@ -1996,7 +1996,7 @@ Arguments:
** _extra_: default behavior is to just replace extra variables (_extra_vars_),
other behavior can be selected:
*** _eval_: extra variables (_extra_vars_) are evaluated themselves before
replacing
replacing (_WeeChat ≥ 1.6_)
** _regex_: a regex used to replace text in _expr_ (which is then not
evaluated)
** _regex_replace_: the replacement text to use with _regex_, to replace
@ -2028,14 +2028,16 @@ expanded to last):
weechat.look.buffer_time_format)
| `+${esc:xxx}+` +
`+${\xxx}+` |
`+${\xxx}+` +
(_WeeChat ≥ 1.0_) |
String with escaped chars. |
`+${esc:prefix\tmessage}+` +
`+${\ua9}+` |
`+prefix<TAB>message+` +
`+©+`
| `+${hide:x,string}+` |
| `+${hide:x,string}+` +
(_WeeChat ≥ 1.1_) |
String with hidden chars (all chars in `string` replaced by `x`). |
`+${hide:*,password}+` |
`+********+`
@ -2056,7 +2058,8 @@ expanded to last):
`+this…+` +
`+こ>>+`
| `+${re:N}+` |
| `+${re:N}+` +
(_WeeChat ≥ 1.1_) |
Regex captured group: `0` = whole string matching, `1` to `99` = group
captured, `+++` = last group captured,
`#` = index of last group captured (_WeeChat ≥ 1.8_). |
@ -2071,7 +2074,8 @@ expanded to last):
`+test2+` +
`+2+`
| `+${color:name}+` |
| `+${color:name}+` +
(_WeeChat ≥ 0.4.2_) |
WeeChat color code (the name of color has optional attributes),
see function <<_color,color>> for supported formats. |
`+${color:red}red text+` +
@ -2080,7 +2084,8 @@ expanded to last):
`+bold orange text+` (in bold orange)
| `+${info:name}+` +
`+${info:name,arguments}+` |
`+${info:name,arguments}+` +
(_WeeChat ≥ 0.4.3_) |
Info from WeeChat or a plugin, see function
<<_info_get,info_get>>. |
`+${info:version}+` +

View File

@ -1991,7 +1991,7 @@ str3 = weechat.string_input_for_buffer("//test") # "/test"
==== string_eval_expression
_WeeChat ≥ 0.4.0, mis à jour dans la 0.4.2, 1.0, 1.1, 1.2, 1.3 et 1.8._
_WeeChat ≥ 0.4.0, mis à jour dans la 0.4.2, 0.4.3, 1.0, 1.1, 1.2, 1.3, 1.6 et 1.8._
Évaluer l'expression et retourner le résultat sous forme de chaîne.
Les variables spéciales avec le format `+${variable}+` sont étendues (voir le
@ -2036,7 +2036,7 @@ Paramètres :
** _extra_ : le comportement par défaut est juste de remplacer les variables
additionnelles (_extra_vars_), un autre comportement peut être sélectionné :
*** _eval_ : les variables additionnelles (_extra_vars_) sont évaluées
elles-mêmes avant remplacement
elles-mêmes avant remplacement (_WeeChat ≥ 1.6_)
** _regex_ : une expression regulière pour remplacer du texte dans _expr_ (qui
n'est alors pas évalué)
** _regex_replace_ : le texte de remplacement à utiliser avec _regex_, pour
@ -2070,14 +2070,16 @@ première étendue à la dernière) :
weechat.look.buffer_time_format)
| `+${esc:xxx}+` +
`+${\xxx}+` |
`+${\xxx}+` +
(_WeeChat ≥ 1.0_) |
Chaîne avec caractères échappés. |
`+${esc:préfixe\tmessage}+` +
`+${\ua9}+` |
`+préfixe<TAB>message+` +
`+©+`
| `+${hide:x,chaîne}+` |
| `+${hide:x,chaîne}+` +
(_WeeChat ≥ 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}+` |
@ -2099,7 +2101,8 @@ première étendue à la dernière) :
`+ceci…+` +
`+こ>>+`
| `+${re:N}+` |
| `+${re:N}+` +
(_WeeChat ≥ 1.1_) |
Groupe regex capturé : `0` = toute la chaîne correspondante,
`1` à `99` = groupe capturé, `+++` = dernier groupe capturé,
`#` = index du dernier groupe capturé (_WeeChat ≥ 1.8_). |
@ -2114,7 +2117,8 @@ première étendue à la dernière) :
`+test2+` +
`+2+`
| `+${color:nom}+` |
| `+${color:nom}+` +
(_WeeChat ≥ 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+` +
@ -2123,7 +2127,8 @@ première étendue à la dernière) :
`+texte orange gras+` (en orange gras)
| `+${info:nom}+` +
`+${info:nom,paramètres}+` |
`+${info:nom,paramètres}+` +
(_WeeChat ≥ 0.4.3_) |
Info de WeeChat ou d'une extension, voir la fonction <<_info_get,info_get>>. |
`+${info:version}+` +
`+${info:irc_nick_color_name,foo}+` |

View File

@ -2027,7 +2027,7 @@ str3 = weechat.string_input_for_buffer("//test") # "/test"
==== string_eval_expression
// TRANSLATION MISSING
_WeeChat ≥ 0.4.0, updated in 0.4.2, 1.0, 1.1, 1.2, 1.3 and 1.8._
_WeeChat ≥ 0.4.0, updated in 0.4.2, 0.4.3, 1.0, 1.1, 1.2, 1.3, 1.6 and 1.8._
// TRANSLATION MISSING
Evaluate an expression and return result as a string.
@ -2071,7 +2071,7 @@ Argomenti:
** _extra_: default behavior is to just replace extra variables (_extra_vars_),
other behavior can be selected:
*** _eval_: extra variables (_extra_vars_) are evaluated themselves before
replacing
replacing (_WeeChat ≥ 1.6_)
** _regex_: a regex used to replace text in _expr_ (which is then not
evaluated)
** _regex_replace_: the replacement text to use with _regex_, to replace
@ -2106,14 +2106,16 @@ expanded to last):
weechat.look.buffer_time_format)
| `+${esc:xxx}+` +
`+${\xxx}+` |
`+${\xxx}+` +
(_WeeChat ≥ 1.0_) |
String with escaped chars. |
`+${esc:prefix\tmessage}+` +
`+${\ua9}+` |
`+prefix<TAB>message+` +
`+©+`
| `+${hide:x,string}+` |
| `+${hide:x,string}+` +
(_WeeChat ≥ 1.1_) |
String with hidden chars (all chars in `string` replaced `x`). |
`+${hide:*,password}+` |
`+********+`
@ -2134,7 +2136,8 @@ expanded to last):
`+this…+` +
`+こ>>+`
| `+${re:N}+` |
| `+${re:N}+` +
(_WeeChat ≥ 1.1_) |
Regex captured group: `0` = whole string matching, `1` to `99` = group
captured, `+++` = last group captured,
`#` = index of last group captured (_WeeChat ≥ 1.8_). |
@ -2149,7 +2152,8 @@ expanded to last):
`+test2+` +
`+2+`
| `+${color:name}+` |
| `+${color:name}+` +
(_WeeChat ≥ 0.4.2_) |
WeeChat color code (the name of color has optional attributes),
see function <<_color,color>> for supported formats. |
`+${color:red}red text+` +
@ -2158,7 +2162,8 @@ expanded to last):
`+bold orange text+` (in bold orange)
| `+${info:name}+` +
`+${info:name,arguments}+` |
`+${info:name,arguments}+` +
(_WeeChat ≥ 0.4.3_) |
Info from WeeChat or a plugin, see function <<_info_get,info_get>>. |
`+${info:version}+` +
`+${info:irc_nick_color_name,foo}+` |

View File

@ -1961,7 +1961,7 @@ str3 = weechat.string_input_for_buffer("//test") # "/test"
==== string_eval_expression
_WeeChat バージョン 0.4.0 以上で利用可、バージョン 0.4.2、1.0、1.1、1.2、1.3、1.8 で更新。_
_WeeChat バージョン 0.4.0 以上で利用可、バージョン 0.4.2、0.4.3、1.0、1.1、1.2、1.3、1.6、1.8 で更新。_
式を評価して文字列として返す。`+${variable}+`
という書式で書かれた特殊変数は展開されます (以下の表を参照)。
@ -2002,7 +2002,7 @@ char *weechat_string_eval_expression (const char *expr,
** _extra_: デフォルトの挙動では追加変数 (_extra_vars_)
を単純に置換するだけですが、この挙動を変更します。設定可能な値は以下です:
*** _eval_: 置換前に追加変数 (_extra_vars_)
を評価します
を評価します (_WeeChat バージョン 1.6 以上で利用可_)
** _regex_: _expr_ のテキストを置換する正規表現
(この場合 _expr_ は評価されません)
** _regex_replace_: _regex_ と一緒に使われる置換テキスト、_expr_
@ -2034,14 +2034,16 @@ char *weechat_string_eval_expression (const char *expr,
内に色コードが存在する場合色付き)
| `+${esc:xxx}+` +
`+${\xxx}+` |
`+${\xxx}+` +
(_WeeChat バージョン 1.0 以上で利用可_) |
エスケープ文字を含む文字列 |
`+${esc:prefix\tmessage}+` +
`+${\ua9}+` |
`+prefix<TAB>message+` +
`+©+`
| `+${hide:x,string}+` |
| `+${hide:x,string}+` +
(_WeeChat バージョン 1.1 以上で利用可_) |
隠す文字を含むテキスト (`string` に含まれる文字をすべて `x` で置換) |
`+${hide:*,password}+` |
`+********+`
@ -2062,7 +2064,8 @@ char *weechat_string_eval_expression (const char *expr,
`+this…+` +
`+こ>>+`
| `+${re:N}+` |
| `+${re:N}+` +
(_WeeChat バージョン 1.1 以上で利用可_) |
正規表現のキャプチャグループ: `0` = マッチするすべての文字列、`1` から `99` =
キャプチャされたグループ、`+++` = 最後にキャプチャされたグループ、
`#` = 最後にキャプチャされたグループのインデックス番号 (_WeeChat バージョン 1.8 以上で利用可_) |
@ -2077,7 +2080,8 @@ char *weechat_string_eval_expression (const char *expr,
`+test2+` +
`+2+`
| `+${color:name}+` |
| `+${color:name}+` +
(_WeeChat バージョン 0.4.2 以上で利用可_) |
WeeChat 色コード (色名部分はオプション属性をとることも可能です),
書式を確認するには関数 <<_color,color>> をご確認ください |
`+${color:red}red text+` +
@ -2086,7 +2090,8 @@ char *weechat_string_eval_expression (const char *expr,
`+bold orange text+` (太字オレンジ色で)
| `+${info:name}+` +
`+${info:name,arguments}+` |
`+${info:name,arguments}+` +
(_WeeChat バージョン 0.4.3 以上で利用可_) |
WeeChat またはプラグインのインフォ、<<_info_get,info_get>>
を参照 |
`+${info:version}+` +