builtin.jax: Update Vim 8.2.4854 translate

Author: tsuyoshicho

doc/builtin.jax

@@ -1,4 +1,4 @@
-*builtin.txt*	For Vim バージョン 8.2.  Last change: 2022 Mar 08
+*builtin.txt*	For Vim バージョン 8.2.  Last change: 2022 Apr 25
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -173,7 +173,8 @@ exists_compiled({expr})		数値	変数{var}がコンパイル時に存在した
 exp({expr})			浮動小数点数	{expr}の指数
 expand({expr} [, {nosuf} [, {list}]])
 				任意	{expr}内の特別なキーワードを展開
-expandcmd({expr})		文字列	`:edit` のように{expr}を展開
+expandcmd({string} [, {options}])
+				文字列	`:edit` のように{string}を展開
 extend({expr1}, {expr2} [, {expr3}])
 				リスト/辞書 {expr1}に{expr2}を要素として挿入
 extendnew({expr1}, {expr2} [, {expr3}])
@@ -311,6 +312,7 @@ insert({object}, {item} [, {idx}])
 				リスト	{object}に要素{item}を挿入 [{idx}の前]
 interrupt()			なし	スクリプトの実行を中断する
 invert({expr})			数値	ビット反転
+isabsolutepath({path})		数値	{path} が絶対パスならば |TRUE|
 isdirectory({directory})	数値	{directory}がディレクトリならば|TRUE|
 isinf({expr})			数値	{expr}が無限大の値(正または負)かどうか
 					を判定する
@@ -354,6 +356,7 @@ maparg({name} [, {mode} [, {abbr} [, {dict}]]])
 					モード{mode}でのマッピング{name}の値
 mapcheck({name} [, {mode} [, {abbr}]])
 				文字列	{name}にマッチするマッピングを確認
+maplist([{abbr}])		リスト	全マッピングのリスト、各要素は辞書
 mapnew({expr1}, {expr2})	リスト/辞書/Blob/文字列
 					|map()| と同様だが新規のリストか辞書を
 					作る
@@ -1581,14 +1584,15 @@ confirm({msg} [, {choices} [, {default} [, {type}]]])
 		中断した場合、confirm()は0を返す。
 
 		例: >
-   :let choice = confirm("What do you want?", "&Apples\n&Oranges\n&Bananas", 2)
-   :if choice == 0
-   :	echo "make up your mind!"
-   :elseif choice == 3
-   :	echo "tasteful"
-   :else
-   :	echo "I prefer bananas myself."
-   :endif
+		   let choice = confirm("What do you want?",
+		   			\ "&Apples\n&Oranges\n&Bananas", 2)
+		   if choice == 0
+		   	echo "make up your mind!"
+		   elseif choice == 3
+		   	echo "tasteful"
+		   else
+		   	echo "I prefer bananas myself."
+		   endif
 <		GUIのダイアログではボタンが使用される。ボタンの配置は
 		'guioptions' の 'v' フラグに依存する。もしも 'v' フラグが含ま
 		れているのなら、ボタンは常に垂直に配置される。そうでなければ水
@@ -1765,7 +1769,9 @@ deepcopy({expr} [, {noref}])				*deepcopy()* *E698*
 delete({fname} [, {flags}])				*delete()*
 		{flags}を指定しないもしくは{flags}を空で指定した場合: ファイル
 		{fname}を削除する。
-		これは{fname}がシンボリックリンクの時でも動作する。
+
+		これは{fname}がシンボリックリンクの時でも動作し、シンボリック
+		リンクは、それが示すものではなく、リンク自身が削除される。
 
 		{flags}が "d" の場合: ディレクトリ{fname}を削除する。
 		これはディレクトリ{fname}が空でない場合は失敗する。
@@ -1775,9 +1781,6 @@ delete({fname} [, {flags}])				*delete()*
 		Note: MS-Windowsでは、使用中のディレクトリを削除することはでき
 		ない。
 
-		シンボリックリンクは、それが示すものではなく、リンク自身が削除
-		される。
-
 		結果は数値であり、削除に成功すれば 0/false、削除に(部分的にで
 		も)失敗すれば -1/true である。
 
@@ -2044,9 +2047,8 @@ execute({command} [, {silent}])					*execute()*
 							*E930*
 		{command} の中のどこかで`:redir`を使うことができない。
 
-		行のリストを得るために、出力に|split()|を使うことができる:
->
-			split(execute('args'), "\n")
+		行のリストを得るために、出力に|split()|を使うことができる: >
+			execute('args')->split("\n")
 
 <		現在のウィンドウとは別のウィンドウでコマンドを実行するには
 		`win_execute()` を使用すること。
@@ -2233,6 +2235,9 @@ expand({string} [, {nosuf} [, {list}]])				*expand()*
 					同様。
 			<SID>		"<SNR>123_"  ここで "123" は現在のスク
 					リプトのID |<SID>|
+			<script>	取り込み(source)中のファイル名、あるい
+					は現在の関数が定義されたスクリプトファ
+					イル名
 			<stack>		コールスタック
 			<cword>		カーソル下の単語(word)
 			<cWORD>		カーソル下の単語(WORD)
@@ -2264,6 +2269,8 @@ expand({string} [, {nosuf} [, {list}]])				*expand()*
 		カレントバッファや代替バッファの名前が未定義のときに '%' や
 		'#' を使うと空文字列になる。"%:p" を名無しのバッファに使用した
 		場合、結果はカレントディレクトリに '/' が付加されたものになる。
+		'verbose' を設定した場合、'%', '#' および <> の項目の展開で
+		展開ができないと結果がエラーメッセージになる。
 
 		'%' や '#' や '<' で始まらない{string}は、コマンドラインのファ
 		イル名と同じように展開される。{nosuf}引数に|TRUE|を指定しない
@@ -2286,15 +2293,26 @@ expand({string} [, {nosuf} [, {list}]])				*expand()*
 		|method| としても使用できる: >
 			Getpattern()->expand()
 
-expandcmd({string})					*expandcmd()*
+expandcmd({string} [, {options}])			*expandcmd()*
 		`:edit` などのExコマンドに対しておこなわれているように、文字列
 		{string} の特殊な項目を展開する。これは {string} の中のどこで
 		も、|expand()| のような特殊なキーワードと環境変数を展開する。
 		"~user" および "~/path" は冒頭でのみ展開される。
+
+		引数の辞書 {options} は以下の項目をサポートする:
+		    errmsg	TRUEに設定された場合、展開中に遭遇したエラーの
+				エラーメッセージを表示する。デフォルトでは、エ
+				ラーメッセージは表示されない。
+
+		展開された文字列を返す。展開中にエラーに遭遇した場合、変更され
+		ていない {string} を返す。
+
 		展開された文字列を返す。例: >
 			:echo expandcmd('make %<.o')
-
-<		|method| としても使用できる: >
+			make /path/runtime/doc/builtin.o
+			:echo expandcmd('make %<.o', {'errmsg': v:true})
+<
+		|method| としても使用できる: >
 			GetCommand()->expandcmd()
 <
 extend({expr1}, {expr2} [, {expr3}])			*extend()*
@@ -2387,6 +2405,8 @@ feedkeys({string} [, {mode}])				*feedkeys()*
 			た場合、最後の呼び出しですべての先行入力が消費される。
 		'c'	実行時のスクリプトのコンテキストを削除し、旧来のスクリ
 			プトの構文が適用され、"s:var" が動作しないようにする。
+			Note 使用しているキーがスクリプトのコンテキストを設定
+			していてもこれは適用される。
 		'!'	'x' と一緒に使用すると挿入モードを終了しない。タイマー
 			が少し後で挿入モードを終了するように設定されているとき
 			にテストで使用できる。CursorHoldIのテストに便利である。
@@ -2724,8 +2744,8 @@ foreground()	Vimのウィンドウを前面に移動する。この関数はク
 		Win32では自分自身のウィンドウを前面に持ってくることが必ずしも
 		許可されていないので、動作しないかもしれない。そのときは代わり
 		に|remote_foreground()|を使うこと。
-		{Win32, Athena, Motif, GTKいずれかのGUI版とWin32コンソール版で
-		のみ利用できる}
+		{Win32, Motif, GTKいずれかのGUI版とWin32コンソール版でのみ利用
+		できる}
 
 fullcommand({name})						*fullcommand()*
 		短縮コマンド名から完全なコマンド名を取得する。コマンドの短縮名
@@ -4580,6 +4600,25 @@ invert({expr})						*invert()*
 <		|method| としても使用できる: >
 			:let bits = bits->invert()
 
+isabsolutepath({directory})				*isabsolutepath()*
+		結果は数値で、{path} が絶対パスであれば |TRUE| となる。
+		The result is a Number, which is |TRUE| when {path} is an
+		absolute path.
+		Unix では、'/' から開始するパスが絶対パスと考えられる。
+		MS-Windows では、ドライブのプリフィックスから開始し '\' か '/'
+		が続くパスが絶対パスと考えられる。UNC パスは常に絶対パスであ
+		る。
+		例: >
+			echo isabsolutepath('/usr/share/')	" 1
+			echo isabsolutepath('./foobar')		" 0
+			echo isabsolutepath('C:\Windows')	" 1
+			echo isabsolutepath('foobar')		" 0
+			echo isabsolutepath('\\remote\file')	" 1
+<
+		|method| としても使用できる: >
+			GetName()->isabsolutepath()
+
+
 isdirectory({directory})				*isdirectory()*
 		結果は数値で、{directory}という名前のディレクトリが存在すれば
 		|TRUE|となる。{directory}が存在しないか、存在したとしても
@@ -4749,6 +4788,8 @@ json_encode({expr})					*json_encode()*
 		NaNとInfinityは値として渡されることに注意すること。これはJSON
 		標準には存在しないが、いくつかの実装でそれが可能である。そうで
 		ない場合、エラーが発生する。
+		非対応の文字を含む文字列の場合、0xfffd を使って文字が置換され
+		る。
 
 		|method| としても使用できる: >
 			GetObject()->json_encode()
@@ -5124,6 +5165,8 @@ maparg({name} [, {mode} [, {abbr} [, {dict}]]])			*maparg()*
 		{dict}が省略されたかゼロのとき: モード{mode}におけるキーマップ
 		{name}のrhsを返す。結果の文字列内の特殊文字は、":map" コマンド
 		でリスト表示した時のように変換される。
+		{dict} が TRUE の場合で辞書が返される、以下を参照。全マッピン
+		グのリストを取得するのは |maplist()| を参照。
 
 		{name} というキーマップが存在しない場合、空文字列が返される。
 		{name} というキーマップが空の場合、"<Nop>" が返される。
@@ -5148,7 +5191,7 @@ maparg({name} [, {mode} [, {abbr} [, {dict}]]])			*maparg()*
 		とする。
 
 		{dict} に|TRUE|が指定されたときはマッピングのすべての情報を含
-		んだ辞書が返る:
+		んだ辞書が返る:				*mapping-dict*
 		  "lhs"		マッピングの {lhs} (入力されたまま)
 		  "lhsraw"	マッピングの {lhs} (生のバイト値)
 		  "lhsrawalt"	マッピングの {lhs} (生のバイト値の代替形式、
@@ -5220,6 +5263,18 @@ mapcheck({name} [, {mode} [, {abbr}]])			*mapcheck()*
 			GetKey()->mapcheck('n')
 
 
+maplist([{abbr}])					*maplist()*
+		全マッピングのリスト |List| を返す。各リストの項目は辞書
+		|Dict| で、|maparg()| で返すものと同じになる。|mapping-dict|
+		を参照。{abbr} が存在し |TRUE| であれば、マッピングの代わりに
+		短縮入力を使う。
+
+		'MultiMatch' が rhs に含まれる全マッピングを表示する例: >
+			vim9script
+			echo maplist()->filter(
+				(_, m) => match(m.rhs, 'MultiMatch') >= 0)
+
+
 mapnew({expr1}, {expr2})					*mapnew()*
 		|map()| と同様だが、{expr1} の要素を置き換える代わりに、新しい
 		リストまたは辞書が作成されて返される。{expr1} は変更されない。
@@ -5465,6 +5520,8 @@ matchfuzzy({list}, {str} [, {dict}])			*matchfuzzy()*
 				ごとに |Funcref| が呼ばれる。
 				これは辞書の項目が引数となり、返すテキストがそ
 				の項目のファジーマッチの結果として受け付ける。
+		    limit	{list} 内でマッチしたものの返す最大数。0で制限
+				なし。
 
 		{str} はリテラルの文字列として扱われ、マッチ用の正規表現はサ
 		ポートされない。{str} の長さは最大256までサポートされる。
@@ -5475,6 +5532,9 @@ matchfuzzy({list}, {str} [, {dict}])			*matchfuzzy()*
 		マッチする文字列がないかエラーとなった場合、空のリストが返され
 		る。{str} の長さが256かそれ以上であるなら、空のリストを返す。
 
+		{limit} が与えられた場合、matchfuzzy() はその数を上限として
+		{list} 内でマッチするかを探し、その結果をソートして返す。
+
 		文字列へのファジーマッチについての詳細は |fuzzy-matching| を参
 		照。
 
@@ -5898,8 +5958,10 @@ printf({fmt}, {expr1} ...)				*printf()*
 
 		|method| としても使用でき、ベースは第2引数として渡される: >
 			Compute()->printf("result: %d")
+<
+		`call()` を使うことで、要素をリストとして渡せる。
 
-<		よく使われる変換指示子は次の通り:
+		よく使われる変換指示子は次の通り:
 		  %s	文字列
 		  %6S	6表示幅で右揃えした文字列
 		  %6s	6バイトで右揃えした文字列
@@ -6533,8 +6595,8 @@ remote_foreground({server})				*remote_foreground()*
 		|method| としても使用できる: >
 			ServerName()->remote_foreground()
 
-<		{VimのWin32, Athena, Motif, GTKのGUI版とWin32コンソール版での
-		み利用可能}
+<		{VimのWin32, Motif, GTKのGUI版とWin32コンソール版でのみ利用可
+		能}
 
 
 remote_peek({serverid} [, {retvar}])		*remote_peek()*
@@ -9736,7 +9798,7 @@ footer			GUIのフッターをサポート |gui-footer|
 fork			system()の代わりにfork()/exec()を用いている
 gettext			翻訳メッセージをサポート |multi-lang|
 gui			GUIが有効である
-gui_athena		AthenaのGUIが有効である
+gui_athena		AthenaのGUIが有効である (常に false)
 gui_gnome		Gnomeサポート(gui_gtkも定義される)
 gui_gtk			GTK+のGUIが有効である
 gui_gtk2		GTK+ 2のGUIが有効である (gui_gtkも定義される)