Module std::convert

1.0.0 · source ·
Expand description

用于类型之间的转换 traits。

此模块中的 traits 提供了一种从一种类型转换为另一种类型的方法。 每个 trait 都有不同的用途:

  • 实现 AsRef trait 以实现廉价的引用到引用转换
  • 实现 AsMut trait 进行廉价的变量到变量转换
  • 实现 From trait 以进行值到值的转换
  • 实现 Into trait,以便将值转换为当前 crate 之外的类型
  • TryFromTryInto traits 的行为类似于 FromInto,但应在转换失败时实现。

此模块中的 traits 通常用作泛型函数的 trait bounds,以便支持多种类型的参数。有关示例,请参见每个 trait 的文档。

作为库作者,您应该总是更喜欢实现 From<T>TryFrom<T>,而不是 Into<U>TryInto<U>,因为 FromTryFrom 提供了更大的灵活性,并免费提供了等效的 IntoTryInto 实现,这要归功于标准库中的全面实现。 当定位到 Rust 1.41 之前的版本时,当转换为当前 crate 之外的类型时,可能有必要直接实现 IntoTryInto

泛型实现

有关用法示例,请参见每个 trait。

Enums

  • 永远不会发生的错误的错误类型。

Traits

  • FloatToIntExperimental
    支持 f32f64 的固有方法 (例如 to_int_unchecked) 的 trait。 通常不需要直接使用。
  • 用于进行廉价的可变到可变引用转换。
  • 用于执行廉价的引用到引用转换。
  • 用于在消耗输入值的同时进行值到值的转换。它是 Into 的倒数。
  • 消耗输入值的值到值转换。与 From 相反。
  • 简单安全的类型转换在某些情况下可能会以受控方式失败。它是 TryInto 的倒数。
  • 消耗 self 的尝试转换,这可能很昂贵,也可能不昂贵。

Functions