if_lua.txt: Vim 8.1.1099 まで追従

Author: hiromi-mi

doc/if_lua.jax

@@ -10,11 +10,12 @@ Vim の Lua インターフェイス				*lua* *Lua*
 2. vim モジュール		|lua-vim|
 3. List ユーザーデータ		|lua-list|
 4. Dict ユーザーデータ		|lua-dict|
-5. Funcref ユーザーデータ	|lua-funcref|
-6. バッファユーザーデータ	|lua-buffer|
-7. ウィンドウユーザーデータ	|lua-window|
-8. luaeval 関数			|lua-luaeval|
-9. 動的ローディング		|lua-dynamic|
+5. Blob ユーザーデータ		|lua-blob|
+6. Funcref ユーザーデータ	|lua-funcref|
+7. バッファユーザーデータ	|lua-buffer|
+8. ウィンドウユーザーデータ	|lua-window|
+9. luaeval() Vim 関数		|lua-luaeval|
+10. 動的ローディング		|lua-dynamic|
 
 {Vi にはこれらのコマンドはありません}
 
@@ -251,7 +252,36 @@ list ユーザーデータと同様、dict ユーザーデータは vim の辞
 <
 
 ==============================================================================
-5. Funcref ユーザーデータ				*lua-funcref*
+5. Blob ユーザーデータ					*lua-blob*
+
+Blob ユーザーデータは vim の Blob を表します。Blob "b" は以下のプロパティを持
+っています。
+
+プロパティ
+----------
+	o "#b" は Blob "b" の要素数。Vim の"len(b)" と同じ。
+	o "b[k]" は "b" の k 個目の要素を返す。"b" のインデックスは Vim と同じ
+	  で、0 を基準とする。
+	  k 個目の要素を変更するには、単に "b[k] = number" とする。特に、
+	  "b[#b] = number" で末尾にバイトを追加できる。
+
+メソッド
+--------
+	o "b:add(bytes)" は "bytes" を "b" の末尾に追加する。
+
+例:
+>
+	:let b = 0z001122
+	:lua b = vim.eval('b') -- same 'b'
+	:lua print(b, b[0], #b)
+	:lua b[1] = 32
+	:lua b[#b] = 0x33 -- append a byte to tail
+	:lua b:add("\x80\x81\xfe\xff")
+	:echo b
+<
+
+==============================================================================
+6. Funcref ユーザーデータ				*lua-funcref*
 
 Funcref ユーザーデータは Vim における関数参照変数を表します。"dict" 属性付きで
 定義された Vim の関数参照 はその呼び出し時に "self" に適切に辞書が代入できるよ
@@ -284,7 +314,7 @@ Funcref ユーザーデータは Vim における関数参照変数を表しま
 <
 
 ==============================================================================
-6. バッファユーザーデータ				*lua-buffer*
+7. バッファユーザーデータ				*lua-buffer*
 
 バッファユーザーデータは Vim のバッファを表します。バッファユーザーデータ "b"
 は以下のプロパティとメソッドを持っています:
@@ -341,7 +371,7 @@ Funcref ユーザーデータは Vim における関数参照変数を表しま
 <
 
 ==============================================================================
-7. ウィンドウユーザーデータ				*lua-window*
+8. ウィンドウユーザーデータ				*lua-window*
 
 ウィンドウオブジェクトは Vim のウィンドウを表します。ウィンドウユーザーデータ
 "w" は以下のプロパティとメソッドを持っています:
@@ -373,7 +403,7 @@ Funcref ユーザーデータは Vim における関数参照変数を表しま
 <
 
 ==============================================================================
-8. luaeval 関数						*lua-luaeval* *lua-eval*
+9. luaeval() Vim 関数					*lua-luaeval* *lua-eval*
 
 "luaeval" は "vim.eval" と対となる関数で Lua の値を Vim に渡すことができます。
 "luaeval" は式文字列と任意の引数を受け取り、式の結果を返します。意味的には次の
@@ -385,10 +415,10 @@ Lua コードと同じです:
 	    return chunk(arg) -- return typval
 	end
 <
-Note "_A" には "luaeval" の引数が渡されます。Lua の数値、文字列、リスト、辞書
-そして Funcref ユーザーデータはそれぞれの Vim の型に変換されます。ただし、Lua
-のブール値は数値に変換されます。リスト、辞書および関数参照以外のユーザーデータ
-を含む、それ以外の Lua の型を変換しようとするとエラーが返されます。
+Note "_A" には "luaeval" の引数が渡されます。Lua の数値、文字列、リスト、Blob、
+辞書そして Funcref ユーザーデータはそれぞれの Vim の型に変換されます。ただし、
+Lua のブール値は数値に変換されます。リスト、辞書および関数参照以外のユーザーデ
+ータを含む、それ以外の Lua の型を変換しようとするとエラーが返されます。
 
 例: >
 
@@ -403,7 +433,7 @@ Note "_A" には "luaeval" の引数が渡されます。Lua の数値、文字
 
 
 ==============================================================================
-9. 動的ローディング					*lua-dynamic*
+10. 動的ローディング					*lua-dynamic*
 
 MS-Windows と Unix では Lua ライブラリを動的にロードすることができます。
 |+lua/dyn| が |:version| の出力に含まれている時に利用できます。