通用规范概念

状态: 功能冻结。

目录 - 属性

属性

属性是一个由零或多个键值对组成的列表。一个属性必须具有以下属性。

  • 属性的键，必须是一个非 null 且非空字符串。

  • 属性的值，可以是：

    • 一个原始类型：字符串，布尔类型，双精度浮点数（IEEE 754-1985）或有符号的 64 位整数。
    • 一个原始类型值的数组。数组必须是同类型的，也就是说，它不能包含不同类型的值。对于原生不支持数组值的协议，这些值应该用 JSON 字符串表示。

值为零，空字符串或空数组的属性值是有意义的，必须被存储并传递给处理器/导出器。

值为 null 的属性无效，试图设置 null 值是未定义的行为。

数组中不应该有 null 值。但是，如果无法确保拒绝 null 值（例如，没有适当的编译时类型检查的语言中），数组中的 null 值必须按原样保留（即作为 null 值传递给 span 处理器/导出器）。如果出口商不支持导出 null值，他们可以用 0、false 或空字符串替换这些值。这对于一对具有同步索引的数组的map/dictionary 结构而言是必须的（例如，两个属性 header_keys 和 header_values，都包含一个字符串数组来表示映射 header_keys[i] -> header_values[i]）。

命名指南请参见属性和标签命名。