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} 是大于或等于 0 的整数，则返回 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) 必须为真。需要 ||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，则返回 0。如果是，则返回 v:msgpack_types 中代表 {msgpack-value} 类型的键的名称。

msgpack#type({msgpack-value}) msgpack#type()
返回 v:msgpack_types 中代表 {msgpack-value} 类型的键的名称。永远不会返回 0：此函数返回由 msgpackdump() 应该将一个列表作为输入（其中包含单个 {msgpack-value}）时所转储的 msgpack 类型。

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"。

msgpack#eval({string}, {dict}) msgpack#eval()
将由 msgpack#string() 创建的字符串转换为适合 msgpackdump() 的值。第二个参数允许添加以头部字符（/\h）开头并且只包含单词字符（/\w）的特殊值。内置特殊值为 "TRUE"、"FALSE"、"NIL"、"nan" 和 "inf"，它们不能被覆盖。映射值始终被评估为 msgpack-special-dict 值，以及十六进制数字。评估映射时，键的顺序将被保留。

请注意，除了可以使用 msgpack#string() 获得的常规整数表示之外，msgpack#eval() 还支持 C 样式的“字符”整数常量，例如 '/'（等效于 char2nr('/')：47）。这也允许 '\0'（数字为十进制）。

msgpack#equal
msgpack#equal({msgpack-value}, {msgpack-value}) msgpack#equal()
如果给定值相等，则返回 1，否则返回 0。比较 msgpack 映射值时，将忽略键的顺序。将 msgpack-special-dict 与等效的非特殊字典值进行比较将评估为 1。