Pi_msgpack

Nvim 的 :help 頁面，由產生，來源是原始碼，並使用 tree-sitter-vimdoc 解析器。

Apache 授權適用於此套件中的檔案，包括 runtime/autoload/msgpack.vim、runtime/doc/pi_msgpack.txt 和 test/functional/plugin/msgpack_spec.lua。就像任何免費的東西一樣，msgpack.vim 及其相關檔案是按「現狀」提供，且不提供任何明示或暗示的擔保。不保證適銷性。不保證適用於任何目的。使用此外掛程式，您同意在任何情況下，版權持有人均不對因使用此軟體而造成的任何損害承擔責任。使用風險自負！

1. 目錄

1. 目錄..............................: msgpack.vim-contents 2. Msgpack.vim 簡介................: msgpack.vim-intro 3. Msgpack.vim 手冊....................: msgpack.vim-manual 函數參數........................: msgpack.vim-arguments msgpack#is_int 函數...............: msgpack#is_int() msgpack#is_uint 函數..............: msgpack#is_uint() msgpack#strftime 函數.............: msgpack#strftime() msgpack#strptime 函數.............: msgpack#strptime() msgpack#int_dict_to_str 函數......: msgpack#int_dict_to_str() msgpack#special_type 函數.........: msgpack#special_type() msgpack#type 函數.................: msgpack#type() msgpack#deepcopy 函數.............: msgpack#deepcopy() msgpack#string 函數...............: msgpack#string() msgpack#eval 函數.................: msgpack#eval() msgpack#equal 函數................: msgpack#equal()

2. Msgpack.vim 簡介 msgpack.vim-intro

此外掛程式包含實用工具函數，用於與 msgpackdump() 和 msgpackparse() 函數結合使用。

3. Msgpack.vim 手冊 msgpack.vim-manual

函數參數 msgpack.vim-arguments

以下描述參數的歧義。注意：如果例如函數被列為接受 {msgpack-integer}（或其他任何內容），則表示函數不會檢查參數是否與其描述相符。

{msgpack-value} 要嘛是 msgpack-special-dict，要嘛是一般值，但不能是函數參考。{msgpack-integer} 任何 msgpack#type() 會返回「integer」的值。{msgpack-special-int} 代表整數的 msgpack-special-dict。

msgpack#is_int({msgpack-value}) msgpack#is_int()
如果給定的 {msgpack-value} 是整數值，則返回 1，否則返回 0。

msgpack#is_uint({msgpack-value}) msgpack#is_uint()
如果給定的 {msgpack-value} 是大於或等於零的整數值，則返回 1，否則返回 0。

msgpack#strftime
msgpack#strftime({format}, {msgpack-integer}) msgpack#strftime()
與 strftime() 相同，但第二個參數可以是 msgpack-special-dict。需要 Python 才能真正使用 msgpack-special-dict。

msgpack#strptime
msgpack#strptime({format}, {time}) msgpack#strptime()
msgpack#strftime() 的反向操作：對於任何時間和格式 msgpack#equal( msgpack#strptime(format, msgpack#strftime(format, time)), time) 應為 true。需要 ||Python|，沒有它的話，僅支援非-|msgpack-special-dict| 非負時間和等於 %Y-%m-%dT%H:%M:%S 的格式。

msgpack#int_dict_to_str({msgpack-special-int}) msgpack#int_dict_to_str() 將 msgpack-special-dict 整數值轉換為十六進位值（如 0x1234567890ABCDEF）的函數（始終返回正好 16 個十六進位數字）。

msgpack#special_type({msgpack-value}) msgpack#special_type()
如果 {msgpack-value} 不是 msgpack-special-dict，則返回零。如果它是 v:msgpack_types 中代表 {msgpack-value} 類型的鍵名。

msgpack#type({msgpack-value}) msgpack#type()
返回 v:msgpack_types 中代表 {msgpack-value} 類型的鍵名。永遠不會返回零：此函數返回將由 msgpackdump() 轉儲的 msgpack 類型，如果它收到一個將單個 {msgpack-value} 作為輸入的列表。

msgpack#deepcopy({msgpack-value}) msgpack#deepcopy()
類似 deepcopy()，但可正確處理 msgpack-special-dict 值。普通的 deepcopy() 會破壞 msgpack-special-dict 值中的所有類型，因為它會複製 _TYPE 鍵值，而這些鍵值應被保留。

msgpack#string({msgpack-value}) msgpack#string()
類似 string()，但會保存有關 msgpack 類型的資訊。msgpack#string 轉儲的值可以透過 msgpack#eval() 讀回。傳回值如下

字典會以「{key1: value1, key2: value2}」的形式轉儲。注意：msgpack 允許鍵中包含任何值，因此，使用某些 msgpack-special-dict 值，msgpack#string() 甚至可能產生「{{1: 2}: 3, [4]: 5}」。

列表會以「[value1, value2]」的形式轉儲。

字串會轉儲為 1. "abc"：二進位字串。2. ="abc"：字串。3. +(10)"ext"：擴充字串（10 可以替換為任何 8 位元帶符號整數）。在字串內部，可能會出現以下跳脫序列：「\0」（代表 NUL 位元組）、「\n」（代表換行）和「\"」（代表雙引號）。

浮點數和整數值會使用 string() 或 msgpack#int_dict_to_str() 轉儲。

布林值會轉儲為「TRUE」或「FALSE」。

Nil 值會轉儲為「NIL」。

msgpack#eval({string}, {dict}) msgpack#eval()
將 msgpack#string() 建立的字串轉換為適用於 msgpackdump() 的值。第二個參數允許添加以首字符 (/\h) 開頭且僅包含文字字元 (/\w) 的特殊值。內建特殊值為「TRUE」、「FALSE」、「NIL」、「nan」和「inf」，且它們無法被覆寫。Map 值始終被評估為 msgpack-special-dict 值，以及十六進位數字。當評估 map 時，會保留鍵的順序。

請注意，除了可以使用 msgpack#string() 獲得的常規整數表示法之外，msgpack#eval() 還支援 C 樣式的「字元」整數常數，如 '/'（相當於 char2nr('/')：47）。這也允許 '\0'（數字為十進制）。

msgpack#equal
msgpack#equal({msgpack-value}, {msgpack-value}) msgpack#equal()
如果給定的值相等，則返回 1，否則返回 0。當比較 msgpack map 值時，會忽略鍵的順序。比較 msgpack-special-dict 與等效的非 special-dict 值會評估為 1。