maths

启用 maths 功能可以启用额外的复杂数学函数，如 pow、ln、enf、exp 等。有关附加函数的详细说明，请参阅 MathematicalOps 特性。

请注意，ln 和 log10 在无效输入时会引发恐慌。使用 checked_ln 和 checked_log10 是避免这种情况的首选函数。当 maths 功能最初开发时，库会在无效输入时返回 0。要重新启用这种非恐慌行为，请使用功能：maths-nopanic。

ndarray

启用使用 ndarray 在 Decimal 数组上执行算术操作。

proptest

启用 proptest 策略，用于生成 Rust Decimal 的值。

rand

实现 rand::distributions::Distribution<Decimal>，允许创建随机实例。

注意：当使用 rand::Rng 特性生成两个其他十进制数之间的十进制数时，随机生成的十进制数的刻度将与输入十进制数的刻度相同（或者，如果输入具有不同的刻度，则为较高的一个）。

rkyv

启用 rkyv 序列化功能，适用于 Decimal。当启用 rkyv-safe 功能时，也支持 rkyv 的安全 API。

rocket-traits

通过实现 FromFormField 特性来启用对 Rocket 表单的支持。

rust-fuzz

通过实现 Arbitrary 特性来启用 rust-fuzz 支持。

serde-float

注意： 此功能将浮点序列化/反序列化规则作为处理 Decimal 数字的默认方法。有关更灵活的功能，请参阅 serde-with-*。

启用此功能，以便将 Decimal 类型的 JSON 序列化发送为浮点数而不是字符串（默认）。

例如，启用此功能后，JSON 序列化将输出

{
  "value": 1.234
}

serde-str

注意： 此功能将字符串序列化/反序列化规则作为处理 Decimal 数字的默认方法。有关更灵活的功能，请参阅 serde-with-*。

这对于类似 bincode 或 csv 的实现通常很有用。

由于 bincode 未指定类型信息，我们需要确保提供类型提示，以便正确地反序列化。单独启用此功能将强制使用 deserialize_str 而不是 deserialize_any 进行反序列化。

如果您还启用了 serde-float，则此功能将使用 deserialize_f64 作为类型提示。因为将 f64 转换为会 丢失 精度，所以在与 bincode 一起使用时，强烈建议您不要启用此功能。话虽如此，这将仅使用 8 字节，因此在存储大小方面略微更有效率。

serde-arbitrary-precision

注意： 此功能将任意序列化/反序列化规则作为处理 Decimal 数字的默认方法。有关更灵活的功能，请参阅 serde-with-*。

此功能主要用于与 serde_json 一起使用，因此将其作为“弱依赖项”添加。此功能支持在解析小数时 serde_json 内部的 arbitrary_precision 功能。

在解析看起来像“浮点数”的数据时推荐使用此功能，因为它可以防止数据丢失。

请注意，此功能当前默认以浮点数格式序列化数字，这可能会产生意外的后果。要更好地控制序列化格式，请使用 serde-with-arbitrary-precision 功能。

serde-with-float

启用此功能以访问将 Decimal 类型序列化为浮点数的模块。这可以在如下所示的 struct 定义中使用

#[derive(Serialize, Deserialize)]
pub struct FloatExample {
    #[serde(with = "rust_decimal::serde::float")]
    value: Decimal,
}

#[derive(Serialize, Deserialize)]
pub struct OptionFloatExample {
    #[serde(with = "rust_decimal::serde::float_option")]
    value: Option<Decimal>,
}

或者，如果只想使用序列化功能（例如，在保持反序列化灵活性的同时）

#[derive(Serialize, Deserialize)]
pub struct FloatExample {
    #[serde(serialize_with = "rust_decimal::serde::float::serialize")]
    value: Decimal,
}

serde-with-str

启用此功能以访问将 Decimal 类型序列化为 String 的模块。这可以在如下所示的 struct 定义中使用

#[derive(Serialize, Deserialize)]
pub struct StrExample {
    #[serde(with = "rust_decimal::serde::str")]
    value: Decimal,
}

#[derive(Serialize, Deserialize)]
pub struct OptionStrExample {
    #[serde(with = "rust_decimal::serde::str_option")]
    value: Option<Decimal>,
}

虽然此功能通常不需要用于序列化，但对于反序列化来说可能很有用，因为它不需要类型提示。因此，您可以通过以下方式仅强制反序列化使用此功能

#[derive(Serialize, Deserialize)]
pub struct StrExample {
    #[serde(deserialize_with = "rust_decimal::serde::str::deserialize")]
    value: Decimal,
}

serde-with-arbitrary-precision

启用此功能以访问使用 serde_json/arbitrary_precision 功能反序列化 Decimal 类型的模块。这可以在如下所示的 struct 定义中使用

#[derive(Serialize, Deserialize)]
pub struct ArbitraryExample {
    #[serde(with = "rust_decimal::serde::arbitrary_precision")]
    value: Decimal,
}

#[derive(Serialize, Deserialize)]
pub struct OptionArbitraryExample {
    #[serde(with = "rust_decimal::serde::arbitrary_precision_option")]
    value: Option<Decimal>,
}

此功能的意外后果是它将以类似浮点数的格式进行序列化。为了防止这种情况，您可以将结构体仅针对 arbitrary_precision 功能进行反序列化

#[derive(Serialize, Deserialize)]
pub struct ArbitraryExample {
    #[serde(deserialize_with = "rust_decimal::serde::arbitrary_precision::deserialize")]
    value: Decimal,
}

这将确保序列化仍然以字符串形式发生。

请参阅 examples 目录以获取有关 serde_json 场景的更多信息。

std

启用 std 库支持。这默认启用，但在将来将是可选的。目前，为了支持 no_std 库，可以使用 --no-default-features 编译此包。

构建

有关构建和测试 Rust Decimal 的更多信息，请参阅构建文档。

最小 Rust 编译器版本

当前的 最小 编译器版本是 1.60.0，该版本于 2022-04-07 发布。

此库维护对与当前稳定版 Rust 编译器版本相差 4 个小版本的 rust 编译器版本的支持。例如，如果当前稳定编译器版本是 1.50.0，则我们将保证支持到 1.46.0 及更高版本。值得注意的是，只有在需要时，我们才会更新最低支持版本。