Update by original

Author: h-east

doc/builtin.jax

@@ -1,4 +1,4 @@
-*builtin.txt*	For Vim バージョン 9.1.  Last change: 2025 Aug 20
+*builtin.txt*	For Vim バージョン 9.1.  Last change: 2025 Aug 24
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -368,7 +368,8 @@ isinf({expr})			数値	{expr}が無限大の値(正または負)かどうか
 					を判定する
 islocked({expr})		数値	{expr}がロックされているなら|TRUE|
 isnan({expr})			数値	{expr}がNaNならば|TRUE|
-items({expr})			リスト	{expr} のキーと値のペアを取得
+items({expr})			リスト	{expr} のキーとインデックス値のペアを
+					取得
 job_getchannel({job})		チャネル  {job}のチャネルハンドルを取得
 job_info([{job}])		辞書	{job}についての情報を取得
 job_setoptions({job}, {options}) なし	{job}のオプションを設定する
@@ -814,6 +815,8 @@ undofile({name})		文字列	{name}に対するアンドゥファイルの名前
 undotree([{buf}])		リスト	バッファ {buf} のアンドゥファイルツリー
 uniq({list} [, {func} [, {dict}]])
 				リスト	リストから隣接した重複を削除
+uri_decode({string})		文字列	文字列を URI デコードする
+uri_encode({string})		文字列	文字列を URI エンコードする
 utf16idx({string}, {idx} [, {countcc} [, {charidx}]])
 				数値	{string} のバイト {idx} の UTF-16 イン
 					デックス
@@ -6248,7 +6251,8 @@ items({expr})						*items()*
 		{expr} のすべてのキー/インデックスと値のペアを含む |List| を返
 		す。各 |List| の項目は 2 つの項目を持つリストである。
 		- |Dict| の場合: キーと値
-		- |List|、|Tuple| または |String| の場合: インデックスと値
+		- |List|、|Tuple|、|Blob| または |String| の場合: インデックス
+		  と値
 		返される |List| は、|Dict| の場合は任意の順序で返されるが、そ
 		れ以外の場合はインデックスの昇順になる。
 
@@ -6262,6 +6266,7 @@ items({expr})						*items()*
 			echo items([1, 2, 3])
 			echo items(('a', 'b', 'c'))
 			echo items("foobar")
+			echo items(0z0102)
 <
 		|method| としても使用できる: >
 			mydict->items()
@@ -7518,7 +7523,7 @@ max({expr})							*max()*
 		|method| としても使用できる: >
 			mylist->max()
 <
-		戻り値の型: |Number|
+		戻り値の型: any。{expr} による
 
 
 menu_info({name} [, {mode}])				*menu_info()*
@@ -7609,7 +7614,7 @@ min({expr})							*min()*
 		|method| としても使用できる: >
 			mylist->min()
 <
-		戻り値の型: |Number|
+		戻り値の型: any。{expr} による
 
 
 mkdir({name} [, {flags} [, {prot}]])			*mkdir()* *E739*
@@ -11935,6 +11940,58 @@ uniq({list} [, {func} [, {dict}]])			*uniq()* *E882*
 		戻り値の型: list<{type}>
 
 
+uri_decode({string})					*uri_decode()*
+		パーセントエンコーディングを逆にして、{string} の URI デコード
+		形式を返す ("%3D" のようなシーケンスを対応する文字に戻す)。
+
+		デコードは標準のパーセントデコードルールに従う:
+		    - "%HH" は 16 進数値 HH の文字に置き換えられる。
+		    - デコードされたバイトが有効な UTF-8 を形成する場合、対応
+		      する文字に結合される。それ以外の場合、バイトはそのまま保
+		      持される。
+		    - 無効または不完全なエンコーディング (例："%GZ"、"%3"、末
+		      尾の "%") は変更されない。
+
+		{string} が空の場合、空の文字列を返す。
+
+		例: >
+			:echo uri_decode('c%3A%5Cmy%5Cdir%5Cfoo%20bar')
+			c:\my\dir\foo bar
+			:echo uri_decode('%CE%B1%CE%B2%CE%B3')
+			αβγ
+<
+		|method| としても使用できる: >
+			mystr->uri_decode()
+<
+		戻り値の型: |Number|
+
+uri_encode({string})					*uri_encode()*
+		{string} の URI エンコード形式を返す。URI エンコードでは、安全
+		でない文字や予約文字がパーセントエンコードされたシーケンスに置
+		き換えられる。
+
+		エンコーディングは標準のパーセントエンコーディングルールに従
+		う。
+		    - 英数字 [0-9A-Za-z] は変更されない。
+		    - 文字 "-"、"_"、"." および "~" も変更されない。
+		    - その他の文字はすべて "%HH" に置き換えられる。HH は 2 桁
+		      の大文字の 16 進数値である。
+		    - 既存のパーセントエンコードされたシーケンスは変更されな
+		      い。
+
+		{string} が空の場合、空の文字列を返す。
+
+		例: >
+			:echo uri_encode('c:\my\dir\foo bar')
+			c%3A%5Cmy%5Cdir%5Cfoo%20bar
+			:echo uri_encode('key=value&name=αβγ')
+			key%3Dvalue%26name%3D%CE%B1%CE%B2%CE%B3
+<
+		|method| としても使用できる: >
+			mystr->uri_encode()
+<
+		戻り値の型: |String|
+
 							*utf16idx()*
 utf16idx({string}, {idx} [, {countcc} [, {charidx}]])
 		|charidx()| と同じだが、{string} の {idx} にあるバイトの

en/builtin.txt

@@ -1,4 +1,4 @@
-*builtin.txt*	For Vim version 9.1.  Last change: 2025 Aug 20
+*builtin.txt*	For Vim version 9.1.  Last change: 2025 Aug 24
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -344,7 +344,7 @@ isinf({expr})			Number	determine if {expr} is infinity value
 					(positive or negative)
 islocked({expr})		Number	|TRUE| if {expr} is locked
 isnan({expr})			Number	|TRUE| if {expr} is NaN
-items({expr})			List	key-value pairs in {expr}
+items({expr})			List	key/index-value pairs in {expr}
 job_getchannel({job})		Channel	get the channel handle for {job}
 job_info([{job}])		Dict	get information about {job}
 job_setoptions({job}, {options}) none	set options for {job}
@@ -747,6 +747,8 @@ undofile({name})		String	undo file name for {name}
 undotree([{buf}])		List	undo file tree for buffer {buf}
 uniq({list} [, {func} [, {dict}]])
 				List	remove adjacent duplicates from a list
+uri_decode({string})		String	URI-decode a string
+uri_encode({string})		String	URI-encode a string
 utf16idx({string}, {idx} [, {countcc} [, {charidx}]])
 				Number	UTF-16 index of byte {idx} in {string}
 values({dict})			List	values in {dict}
@@ -6314,7 +6316,8 @@ items({expr})						*items()*
 		Return a |List| with all key/index and value pairs of {expr}.
 		Each |List| item is a list with two items:
 		- for a |Dict|: the key and the value
-		- for a |List|, |Tuple| or |String|: the index and the value
+		- for a |List|, |Tuple|, |Blob| or |String|: the index and the
+		  value
 		The returned |List| is in arbitrary order for a |Dict|,
 		otherwise it's in ascending order of the index.
 
@@ -6328,6 +6331,7 @@ items({expr})						*items()*
 			echo items([1, 2, 3])
 			echo items(('a', 'b', 'c'))
 			echo items("foobar")
+			echo items(0z0102)
 <
 		Can also be used as a |method|: >
 			mydict->items()
@@ -7622,7 +7626,7 @@ max({expr})							*max()*
 		Can also be used as a |method|: >
 			mylist->max()
 <
-		Return type: |Number|
+		Return type: any, depending on {expr}
 
 
 menu_info({name} [, {mode}])				*menu_info()*
@@ -7714,7 +7718,7 @@ min({expr})							*min()*
 		Can also be used as a |method|: >
 			mylist->min()
 <
-		Return type: |Number|
+		Return type: any, depending on {expr}
 
 
 mkdir({name} [, {flags} [, {prot}]])			*mkdir()* *E739*
@@ -12185,6 +12189,59 @@ uniq({list} [, {func} [, {dict}]])			*uniq()* *E882*
 		Return type: list<{type}>
 
 
+uri_decode({string})					*uri_decode()*
+		Returns the URI-decoded form of {string}, reversing
+		percent-encoding (converting sequences like "%3D" back to
+		the corresponding character).
+
+		The decoding follows standard percent-decoding rules:
+		    - "%HH" is replaced with the character for the hex value
+		      HH.
+		    - If the decoded bytes form valid UTF-8, they are combined
+		      into the corresponding character(s).  Otherwise, the
+		      bytes are kept as-is.
+		    - Invalid or incomplete encodings (e.g. "%GZ", "%3", or a
+		      trailing "%") are left unchanged.
+
+		Returns an empty String if {string} is empty.
+
+		Example: >
+			:echo uri_decode('c%3A%5Cmy%5Cdir%5Cfoo%20bar')
+			c:\my\dir\foo bar
+			:echo uri_decode('%CE%B1%CE%B2%CE%B3')
+			αβγ
+<
+		Can also be used as a |method|: >
+			mystr->uri_decode()
+<
+		Return type: |String|
+
+uri_encode({string})					*uri_encode()*
+		Returns the URI-encoded form of {string}.  URI encoding
+		replaces unsafe or reserved characters with percent-encoded
+		sequences.
+
+		The encoding follows standard percent-encoding rules:
+                    - Alphanumeric characters [0-9A-Za-z] remain unchanged.
+                    - The characters "-", "_", ".", and "~" also remain
+                      unchanged.
+                    - All other characters are replaced with "%HH", where HH
+                      is the two-digit uppercase hexadecimal value.
+                    - Existing percent-encoded sequences are not modified.
+
+		Returns an empty String if {string} is empty.
+
+		Example: >
+			:echo uri_encode('c:\my\dir\foo bar')
+			c%3A%5Cmy%5Cdir%5Cfoo%20bar
+			:echo uri_encode('key=value&name=αβγ')
+			key%3Dvalue%26name%3D%CE%B1%CE%B2%CE%B3
+<
+		Can also be used as a |method|: >
+			mystr->uri_encode()
+<
+		Return type: |String|
+
 							*utf16idx()*
 utf16idx({string}, {idx} [, {countcc} [, {charidx}]])
 		Same as |charidx()| but returns the UTF-16 code unit index of