core: add cut of string with max chars displayed in evaluation of expressions

The syntax is: ${cutscr:max,suffix,string}.
The string is cut after max chars displayed on screen. If the string is cut,
the optional suffix is added after.

2 files changed, 61 insertions, 48 deletions

diff --git a/doc/ja/autogen/user/weechat_commands.adoc b/doc/ja/autogen/user/weechat_commands.adoc
index cc8a84c0a..d5dc4161b 100644
--- a/doc/ja/autogen/user/weechat_commands.adoc
+++ b/doc/ja/autogen/user/weechat_commands.adoc
@@ -257,53 +257,54 @@ infolists: インフォリストに関する情報を表示
 /eval  [-n|-s] <expression>
        [-n] -c <expression1> <operator> <expression2>
 
-        -n: 結果をバッファに送信せずに表示 (デバッグモード)
-        -s: 評価前に式を分割する (複数のコマンドを指定する場合はセミコロンで区切ってください)
-        -c: 条件として評価: 演算子と括弧をを使い、ブール値 ("0" または "1") を返します
-expression: 評価する式、${variable} 型の書式の変数は置換されます (以下を参照); 複数のコマンドを指定する場合はセミコロンで区切ってください
-  operator: 論理演算子や比較演算子:
-            - 論理演算子:
-                &&  ブール演算の "and"
-                ||  ブール演算の "or"
-            - 比較演算子:
-                ==  等しい
-                !=  等しくない
-                <=  以下
-                <   より少ない
-                >=  以上
-                >   より大きい
-                =~  正規表現にマッチ
-                !~  正規表現にマッチしない
-
-式が NULL でない場合、空でない場合、"0" でない場合、式は "真" と評価されます。
-両方の式が有効な整数である場合、比較は整数を使って行われます。
-文字列比較を強制するには、それぞれの式をダブルクォートで囲みます、例:
+        -n: display result without sending it to buffer (debug mode)
+        -s: split expression before evaluating it (many commands can be separated by semicolons)
+        -c: evaluate as condition: use operators and parentheses, return a boolean value ("0" or "1")
+expression: expression to evaluate, variables with format ${variable} are replaced (see below); many commands can be separated by semicolons
+  operator: a logical or comparison operator:
+            - logical operators:
+                &&  boolean "and"
+                ||  boolean "or"
+            - comparison operators:
+                ==  equal
+                !=  not equal
+                <=  less or equal
+                <   less
+                >=  greater or equal
+                >   greater
+                =~  is matching POSIX extended regex
+                !~  is NOT matching POSIX extended regex
+
+An expression is considered as "true" if it is not NULL, not empty, and different from "0".
+The comparison is made using integers if the two expressions are valid integers.
+To force a string comparison, add double quotes around each expression, for example:
   50 > 100      ==> 0
   "50" > "100"  ==> 1
 
-式中の ${variable} 型の書式の変数は置換されます。変数は以下の優先順位に従います:
-  1. 評価済みのサブ文字列 (書式: "eval:xxx")
-  2. エスケープ文字を含む文字列 (書式: "esc:xxx" または "\xxx")
-  3. 隠す文字を含む文字列 (書式: "hide:char,string")
-  4. 最大文字数を指定した文字列 (書式: "cut:max,suffix,string")
-  5. 色 (書式: "color:xxx")
-  6. 情報 (書式: "info:name,arguments"、arguments は任意)
-  7. 現在の日付/時刻 (書式: "date" または "date:format")
-  8. 環境変数 (書式: "env:XXX")
-  9. 三項演算子 (書式: "if:condition?value_if_true:value_if_false")
-  10. オプション (書式: "file.section.option")
-  11. バッファのローカル変数
-  12. hdata の名前/変数 (値は自動的に文字列に変換されます)、デフォルトでは "window" と "buffer" は現在のウィンドウ/バッファを指します。
-hdata の書式は以下の 1 つです:
-  hdata.var1.var2...: hdata (ポインタは既知) で開始し、1 個ずつ変数を続ける (他の hdata を続けることも可能)
-  hdata[list].var1.var2...: リストを使う hdata で開始する、例:
-    ${buffer[gui_buffers].full_name}: バッファリストにリンクされた最初のバッファのフルネーム
-    ${plugin[weechat_plugins].name}: プラグインリストにリンクされた最初のプラグインの名前
-  hdata[pointer].var1.var2...: ポインタを使う hdata で開始する、例:
-    ${buffer[0x1234abcd].full_name}: 与えたポインタを持つバッファの完全な名前 (トリガ中で使うことが可能です)
-hdata と変数の名前については、"プラグイン API リファレンス" の "weechat_hdata_get" 関数を参照してください。
-
-例 (単純な文字列):
+Some variables are replaced in expression, using the format ${variable}, variable can be, by order of priority:
+  1. an evaluated sub-string (format: "eval:xxx")
+  2. a string with escaped chars (format: "esc:xxx" or "\xxx")
+  3. a string with chars to hide (format: "hide:char,string")
+  4. a string with max chars (format: "cut:max,suffix,string")
+     or max chars displayed on screen (format: "cutscr:max,suffix,string")
+  5. a color (format: "color:xxx")
+  6. an info (format: "info:name,arguments", arguments are optional)
+  7. current date/time (format: "date" or "date:format")
+  8. an environment variable (format: "env:XXX")
+  9. a ternary operator (format: "if:condition?value_if_true:value_if_false")
+  10. an option (format: "file.section.option")
+  11. a local variable in buffer
+  12. a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
+Format for hdata can be one of following:
+  hdata.var1.var2...: start with a hdata (pointer must be known), and ask variables one after one (other hdata can be followed)
+  hdata[list].var1.var2...: start with a hdata using a list, for example:
+    ${buffer[gui_buffers].full_name}: full name of first buffer in linked list of buffers
+    ${plugin[weechat_plugins].name}: name of first plugin in linked list of plugins
+  hdata[pointer].var1.var2...: start with a hdata using a pointer, for example:
+    ${buffer[0x1234abcd].full_name}: full name of the buffer with this pointer (can be used in triggers)
+For name of hdata and variables, please look at "Plugin API reference", function "weechat_hdata_get".
+
+Examples (simple strings):
   /eval -n ${info:version}                       ==> 0.4.3
   /eval -n ${env:HOME}                           ==> /home/user
   /eval -n ${weechat.look.scroll_amount}         ==> 3
@@ -314,10 +315,12 @@ hdata と変数の名前については、"プラグイン API リファレン�
   /eval -n ${\t}                                 ==> <tab>
   /eval -n ${hide:-,${relay.network.password}}   ==> --------
   /eval -n ${cut:2,+,test}                       ==> te+
+  /eval -n ${cut:2,+,こんにちは世界}             ==> こん+
+  /eval -n ${cutscr:2,+,こんにちは世界}          ==> こ+
   /eval -n ${date:%H:%M:%S}                      ==> 07:46:40
   /eval -n ${if:${info:term_width}>80?big:small} ==> big
 
-例 (条件):
+Examples (conditions):
   /eval -n -c ${window.buffer.number} > 2 ==> 0
   /eval -n -c ${window.win_width} > 100   ==> 1
   /eval -n -c (8 > 12) || (5 > 2)         ==> 1
diff --git a/doc/ja/weechat_plugin_api.ja.adoc b/doc/ja/weechat_plugin_api.ja.adoc
index 55b8f1b29..923d8611b 100644
--- a/doc/ja/weechat_plugin_api.ja.adoc
+++ b/doc/ja/weechat_plugin_api.ja.adoc
@@ -2046,13 +2046,23 @@ char *weechat_string_eval_expression (const char *expr,
   `+${hide:*,password}+` |
  `+********+`
 
+// TRANSLATION MISSING
 | `+${cut:max,suffix,string}+` +
   (_WeeChat バージョン 1.8 以上で利用可_) |
-  `string` の先頭 `max` 文字を表示し、`string` の文字数が `max` 文字を超える場合にはオプションの `suffix` も表示します |
+  String with `max` chars, and optional `suffix` if string is cut. |
   `+${cut:4,…,this is a test}+` +
-  `+${cut:2,>>,àéçôî}+` |
+  `+${cut:2,>>,こんにちは世界}+` |
   `+this…+` +
-  `+àé>>+`
+  `+こん>>+`
+
+// TRANSLATION MISSING
+| `+${cutscr:max,suffix,string}+` +
+  (_WeeChat バージョン 1.8 以上で利用可_) |
+  String with `max` chars displayed on screen, and optional `suffix` if string is cut. |
+  `+${cutscr:4,…,this is a test}+` +
+  `+${cutscr:2,>>,こんにちは世界}+` |
+  `+this…+` +
+  `+こ>>+`
 
 | `+${re:N}+` |
   正規表現のキャプチャグループ: `0` = マッチするすべての文字列、`1` から `99` =