Quantity

    数量(Quantity)是数字的定点表示。 除了 String() 和 AsInt64() 的访问接口之外, 它以 JSON 和 YAML 形式提供方便的打包和解包方法。

    序列化格式如下:

    当从字符串解析数量时,它将记住它具有的后缀类型,并且在序列化时将再次使用相同类型。

    在序列化之前,数量将以“规范形式”放置。这意味着指数或者后缀将被向上或向下调整(尾数相应增加或减少),并确保:

    • 没有精度丢失
    • 指数(或后缀)尽可能大。

    除非数量是负数,否则将省略正负号。

    • 1.5Gi 将会被序列化成 “1536Mi”

    请注意,数量永远不会在内部以浮点数表示。这是本设计的重中之重。

    只要它们格式正确,非规范值仍将解析,但将以其规范形式重新输出(所以应该总是使用规范形式,否则不要执行 diff 比较)。

    这种格式旨在使得很难在不撰写某种特殊处理代码的情况下使用这些数字,进而希望实现者也使用定点实现。