eval.jax: Update Vim 8.2.4987 translate and fix interpolated-string

Author: tsuyoshicho

doc/eval.jax

@@ -1,4 +1,4 @@
-*eval.txt*	For Vim バージョン 8.2.  Last change: 2022 Apr 17
+*eval.txt*	For Vim バージョン 8.2.  Last change: 2022 May 13
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -504,7 +504,7 @@ Blob の場合、一度に 1 バイトが使われる。
 キーは必ず文字列である。数値を使うこともできるが、自動的に文字列に変換される。
 よって文字列 '4' のキーと数値4のキーは同一の要素を参照する。
 Note 文字列 '04' と数値04は異なることに注意。なぜなら数値04は文字列 '4' に変換
-されるからである。空文字列もまたキーとして使用できる。
+され、先頭の0は脱落するからである。空文字列もまたキーとして使用できる。
 
 |Vim9| script では、キーが英数字、アンダースコア、ダッシュで構成されている場
 合、リテラルキーが使える。|vim9-literal-dict| を参照。
@@ -516,7 +516,8 @@ Note 文字列 '04' と数値04は異なることに注意。なぜなら数値0
 	:let mydict = #{zero: 0, one_key: 1, two-key: 2, 333: 3}
 Note ここでは 333 は 文字列 "333" であることに注意。空のキーは #{} を使うこと
 ができない。
-|Vim9| script では #{} 形式は使用できない。
+|Vim9| script では #{} 形式は使用できない、なぜならコメントの開始と紛らわしい
+ためである。
 
 値はどんな式でもよい。辞書を値にすると、ネストした辞書ができる: >
 	:let nestdict = {1: {11: 'a', 12: 'b'}, 2: {21: 'c'}}
@@ -1481,24 +1482,31 @@ Note シングルクォートが使われていることに注意。
 	if a =~ '\s*'
 
 
-interpolated-string					*interp-string* *E256*
+文字列補間						*interp-string* *E256*
 --------------------
-$"string"		interpolated string constant		*expr-$quote*
-$'string'		interpolated literal string constant	*expr-$'*
+$"string"		補間された文字列定数			*expr-$quote*
+$'string'		補間されたリテラル文字列定数		*expr-$'*
+
+文字列補間は文字列 |string| およびリテラル文字列 |literal-string| の拡張であ
+り、Vim スクリプトの式(|expr1| を参照)を含むことができる。波括弧にくくられた値
+を返す任意の式を含むことを許す。値は文字列に変換される。すべてのテキストと式の
+結果は結合され新しい文字列を作る。
+								*E1278*
+開き波括弧 '{' あるいは閉じ波括弧 '}' を文字列として入れる場合は二重にする。ダ
+ブルクォートの文字列はバックスラッシュを使うこともできる。単一の閉じ波括弧 '}'
+はエラーになる。
 
-Interpolated strings are an extension of the |string| and |literal-string|,
-allowing the inclusion of Vim script expressions (see |expr1|).  Any
-expression returning a value can be enclosed between curly braces.  The value
-is converted to a string.  All the text and results of the expressions
-are concatenated to make a new string.
-
-To include an opening brace '{' or closing brace '}' in the string content
-double it.
-
-Examples: >
+例: >
 	let your_name = input("What's your name? ")
+<	What's your name?  Peter ~
+>
+	echo
 	echo $"Hello, {your_name}!"
-	echo $"The square root of 9 is {sqrt(9)}"
+<	Hello, Peter! ~
+>
+	echo $"The square root of {{9}} is {sqrt(9)}"
+<	The square root of {9} is 3.0 ~
+
 
 オプション					*expr-option* *E112* *E113*
 ---------
@@ -2863,7 +2871,7 @@ script の場合は、関数がエクスポートされていないことが原
 
 自動コマンドを使う方法 ~
 
-これはユーザーマニュアルのセクション|41.14|で説明されている。
+これはユーザーマニュアルのセクション |51.4| で説明されている。
 
 自動コマンドは、長いVim scriptファイルのプラグインに対して有用である。自動コマ
 ンドを定義し、すぐに `:finish` でそのスクリプトを抜ける。こうするとVimの起動が
@@ -2881,7 +2889,7 @@ FuncUndefinedを使う。例: >
 
 オートロードスクリプトの使い方 ~
 							*autoload* *E746*
-これはユーザーマニュアルのセクション|41.15|で説明されている。
+これはユーザーマニュアルのセクション |51.5| で説明されている。
 
 "autoload" ディレクトリのスクリプトを使う方法はより簡単である。しかし完全に正
 しいファイル名を使う必要がある。オートロードされる関数は次のような名前を持つ: >
@@ -3155,20 +3163,19 @@ text...
 			空白を含んではならない。
 
 			"eval" が指定されていない場合、テキストの各行は
-			|literal-string| として扱われる。"eval" が指定されてい
-			る場合、任意のVimの式が ``={expr}`` として入ることで評
-			価されその結果で置き換える。
+			|literal-string| として扱われるが、シングルクォートは
+			除外され二重にする必要はない。
+			"eval" が指定されている場合、任意のVimの式を {expr} と
+			して入ることでそれが評価され結果で置き換えられる。
 			例として $HOME を展開する: >
 				let lines =<< trim eval END
 				  some text
-				  See the file `=$HOME`/.vimrc
+				  See the file {$HOME}/.vimrc
 				  more text
 				END
 <			1行に複数のVimの式は許容されるが、複数行に跨る式は許容
 			されない。どれかの式の評価が失敗する場合、変数への割り
 			当てに失敗する。
-			"`=" が見付かったら式とバッククォートが続くく必要があ
-			る。{expr} は空にはできない。
 
 			{endmarker} は小文字で始めることができない。
 			最後の行は {endmarker} 文字列だけで終わり、他の文字は
@@ -3218,10 +3225,10 @@ text...
 				DATA
 
 				let code =<< trim eval CODE
-				   let v = `=10 + 20`
-				   let h = "`=$HOME`"
-				   let s = "`=Str1()` abc `=Str2()`"
-				   let n = `=MyFunc(3, 4)`
+				   let v = {10 + 20}
+				   let h = "{$HOME}"
+				   let s = "{Str1()} abc {Str2()}"
+				   let n = {MyFunc(3, 4)}
 				CODE
 <
 								*E121*
@@ -3432,8 +3439,8 @@ text...
 :for {var} in {object}					*:for* *E690* *E732*
 :endfo[r]						*:endfo* *:endfor*
 			{object}の各要素に対し、`:for` と `:endfor` の間のコマ
-			ンドを繰り返す。{object}はリスト |List| または |Blob|
-			である。 *E1177*
+			ンドを繰り返す。{object}はリスト |List|、|Blob|、また
+			は文字列 |String| である。 *E1177*
 
 			変数{var}に各要素の値がセットされる。
 			|Vim9| script ではループ変数がグローバル/ウィンドウ/タ