Expand description
用于类型之间的转换 traits。
此模块中的 traits 提供了一种从一种类型转换为另一种类型的方法。 每个 trait 都有不同的用途:
- 实现
AsReftrait 以实现廉价的引用到引用转换 - 实现
AsMuttrait 进行廉价的变量到变量转换 - 实现
Fromtrait 以进行值到值的转换 - 实现
Intotrait,以便将值转换为当前 crate 之外的类型 TryFrom和TryIntotraits 的行为类似于From和Into,但应在转换失败时实现。
此模块中的 traits 通常用作泛型函数的 trait bounds,以便支持多种类型的参数。有关示例,请参见每个 trait 的文档。
作为库作者,您应该总是更喜欢实现 From<T> 或 TryFrom<T>,而不是 Into<U> 或 TryInto<U>,因为 From 和 TryFrom 提供了更大的灵活性,并免费提供了等效的 Into 或 TryInto 实现,这要归功于标准库中的全面实现。
当定位到 Rust 1.41 之前的版本时,当转换为当前 crate 之外的类型时,可能有必要直接实现 Into 或 TryInto。
泛型实现
- 如果内部类型是引用,则
AsRef和AsMut自动解引用 (但通常不适用于所有 dereferenceable types) From<U> for T意味着Into<T> for UTryFrom<U> for T意味着TryInto<T> for UFrom和Into是反射的,这意味着所有类型都可以into自己和from自己
有关用法示例,请参见每个 trait。
Enums
- 永远不会发生的错误的错误类型。
Traits
- FloatToIntExperimental支持
f32和f64的固有方法 (例如to_int_unchecked) 的 trait。 通常不需要直接使用。 - 用于进行廉价的可变到可变引用转换。
- 用于执行廉价的引用到引用转换。
- 用于在消耗输入值的同时进行值到值的转换。它是
Into的倒数。 - 消耗输入值的值到值转换。与
From相反。 - 简单安全的类型转换在某些情况下可能会以受控方式失败。它是
TryInto的倒数。 - 消耗
self的尝试转换,这可能很昂贵,也可能不昂贵。
Functions
- identity 函数。