WOLFRAM

Wolfram 语言与系统参考资料中心

UBJSON (.ubj)

背景

    • MIME 类型：application/ubjson.
    • 数据交换二进制格式.
    • 支持完整 UBJSON 语法.
    • UBJSON 确定有 Wolfram 语言关联的 UBJSON 对象.
    • UBJSON 从通用二进制 JSON 衍生缩写.
    • 对于数值用高位优先顺序的二进制格式.
    • JSON 和 UBJSON 有一对一的变换.
    • UBJSON 在 http://ubjson.org/ 中指定.

Import 与 Export

  • Import["file.ubj"] 将 UBJSON 文件导入为嵌套列表和关联的组合.
  • ImportString["string","UBJSON"] 导入 UBJSON 的字节字符串.
  • Export["file",expr,"UBJSON"] 将嵌套列表和关联的组合导出到 UBJSON 文件.
  • ExportString[expr,"UBJSON"] 导出 UBJSON 字节字符串.
  • "UBJSON" 格式定义在 Wolfram 语言中有关联的 UBJSON 对象.
  • "UBJSON" 使用 Wolfram 语言列表 {e1,e2,…} 来识别 JSON 列表 [e1,e2,…].
  • 在 Wolfram 语言中的单字符的字符串在 UBJSON 中表示为字符. Wolfram 语言中的多字符的字符串表示为 UBJSON 字符串.
  • 机器精度的整数表示为其可以匹配的最小 UBJSON 整数类型.
  • 大整数表示为数字的 UBJSON 字符串.
  • Wolfram 语言压缩数组表示为 UBJSON 数组. 复数值不被支持.
  • 请到以下参考页面了解完整的基本信息：
  • Import, Export从文件导入或导出到文件
    CloudImport, CloudExport从云对象导入或导出到云对象
    ImportString, ExportString从字符串导入或导出到字符串
    ImportByteArray, ExportByteArray从字节数组导入或导出到字节数组

参数

  • Import 的通用参数：
  • "Elements" 该文件可用的参数和选项列表
    "Summary"文件摘要
    "Rules"所有可用参数的规则列表

选项

  • Export 选项：
  • "ConversionFunction"None用于额外转换的函数
    "ConversionRules"{}用于覆盖或添加转换的规则
  • 在内嵌对话运行前，"ConversionRules" 的设置用于替换子表达式.
  • "ConversionFunction" 的设置可用于没有定义内嵌对话的子表达式.

范例

基本范例  (7)

将一个 List 导出为 UBJSON 格式：

Wolfram Language code: bytes = ExportString[{1, 2, 3}, "UBJSON"];

导入为一个表达式：

Wolfram Language code: ImportString[bytes, "UBJSON"]

将一个 Association 导出为 UBJSON 格式：

Wolfram Language code: bytes = ExportString[<|"x" -> 1, "y" -> 2.5|>, "UBJSON"];

导入为一个表达式：

Wolfram Language code: ImportString[bytes, "UBJSON"]

导出一个整数产生不同大小的结果：

Wolfram Language code: ExportString[2 ^ 7 - 1, "UBJSON"]//StringLength
Wolfram Language code: ExportString[2 ^ 15 - 1, "UBJSON"]//StringLength
Wolfram Language code: ExportString[2 ^ 31 - 1, "UBJSON"]//StringLength
Wolfram Language code: ExportString[2 ^ 63 - 1, "UBJSON"]//StringLength

导出一个大整数产生大小与位数比的结果：

Wolfram Language code: ListPlot[Table[ {exponent, StringLength[ExportString[10 ^ exponent, "UBJSON"]]}, {exponent, 20, 40, 2}]]

导出 ByteArray 产生一个简洁、強型別的 UBJSON 数组输出：

Wolfram Language code: ExportString[ByteArray[Range[255]], "UBJSON"]//StringLength

将相同数据导出为标准 List：

Wolfram Language code: ExportString[Range[255], "UBJSON"]//StringLength

导出一个 ASCII 字符的字符串产生一个 UBJSON 字符：

Wolfram Language code: ExportString["A", "UBJSON"]

导出非 ASCII 字符产生一个 UBJSON 字符串输出：

Wolfram Language code: ExportString["", "UBJSON"]//StringLength

导出一个字符串产生一个 UBJSON 字符串：

Wolfram Language code: ExportString["hello", "UBJSON"]//StringLength

用变换规则将量值转换为关联：

Wolfram Language code: data = ExportString[{Quantity["42.195", "Kilometers"], Quantity["21.097", "Kilometers"], Quantity["10", "Kilometers"]}, "UBJSON", "ConversionRules" -> {Quantity[magnitude_, unit_] :> <|"magnitude" -> magnitude, "unit" -> unit|>}];

导入为表达式：

Wolfram Language code: ImportString[data, "UBJSON"]