为了学习Rust,阅读了github上的Rust By Practice电子书,本文章只是用来记录自己的学习过程,感兴趣的可以阅读原书,希望大家都能掌握Rust!
Rust 是类型安全的语言,因此在 Rust 中做类型转换不是一件简单的事,这一章节我们将对 Rust 中的类型转换进行详尽讲解。
as
转换先来看一段代码:
fn main() {
let a: i32 = 10;
let b: u16 = 100;
if a < b {
println!("Ten is less than one hundred.");
}
}
能跟着这本书一直学习到这里,说明你对 Rust 已经有了一定的理解,那么一眼就能看出这段代码注定会报错,因为 a
和 b
拥有不同的类型,Rust 不允许两种不同的类型进行比较。
解决办法很简单,只要把 b
转换成 i32
类型即可,Rust 中内置了一些基本类型之间的转换,这里使用 as
操作符来完成: if a < (b as i32) {...}
。那么为什么不把 a
转换成 u16
类型呢?
因为每个类型能表达的数据范围不同,如果把范围较大的类型转换成较小的类型,会造成错误,因此我们需要把范围较小的类型转换成较大的类型,来避免这些问题的发生。
使用类型转换需要小心,因为如果执行以下操作
300_i32 as i8
,你将获得44
这个值,而不是300
,因为i8
类型能表达的的最大值为2^7 - 1
,使用以下代码可以查看i8
的最大值:
let a = i8::MAX;
println!("{}",a);
下面列出了常用的转换形式:
fn main() {
let a = 3.1 as i8;
let b = 100_i8 as i32;
let c = 'a' as u8; // 将字符'a'转换为整数,97
println!("{},{},{}",a,b,c)
}
let mut values: [i32; 2] = [1, 2];
let p1: *mut i32 = values.as_mut_ptr();
let first_address = p1 as usize; // 将p1内存地址转换为一个整数
let second_address = first_address + 4; // 4 == std::mem::size_of::<i32>(),i32类型占用4个字节,因此将内存地址 + 4
let p2 = second_address as *mut i32; // 访问该地址指向的下一个整数p2
unsafe {
*p2 += 1;
}
assert_eq!(values[1], 3);
e as U1 as U2
是合法的,也不能说明 e as U2
是合法的(e
不能直接转换成 U2
)。在一些场景中,使用 as
关键字会有比较大的限制。如果你想要在类型转换上拥有完全的控制而不依赖内置的转换,例如处理转换错误,那么可以使用 TryInto
:
use std::convert::TryInto;
fn main() {
let a: u8 = 10;
let b: u16 = 1500;
let b_: u8 = b.try_into().unwrap();
if a < b_ {
println!("Ten is less than one hundred.");
}
}
上面代码中引入了 std::convert::TryInto
特征,但是却没有使用它,可能有些同学会为此困惑,主要原因在于如果你要使用一个特征的方法,那么你需要引入该特征到当前的作用域中,我们在上面用到了 try_into
方法,因此需要引入对应的特征。但是 Rust 又提供了一个非常便利的办法,把最常用的标准库中的特征通过std::prelude
模块提前引入到当前作用域中,其中包括了 std::convert::TryInto
,你可以尝试删除第一行的代码 use ...
,看看是否会报错。
try_into
会尝试进行一次转换,并返回一个 Result
,此时就可以对其进行相应的错误处理。由于我们的例子只是为了快速测试,因此使用了 unwrap
方法,该方法在发现错误时,会直接调用 panic
导致程序的崩溃退出,在实际项目中,请不要这么使用,具体见panic部分。
最主要的是 try_into
转换会捕获大类型向小类型转换时导致的溢出错误:
fn main() {
let b: i16 = 1500;
let b_: u8 = match b.try_into() {
Ok(b1) => b1,
Err(e) => {
println!("{:?}", e.to_string());
0
}
};
}
运行后输出如下 "out of range integral type conversion attempted"
,在这里我们程序捕获了错误,编译器告诉我们类型范围超出的转换是不被允许的,因为我们试图把 1500_i16
转换为 u8
类型,后者明显不足以承载这么大的值。
虽然 as
和 TryInto
很强大,但是只能应用在数值类型上,可是 Rust 有如此多的类型,想要为这些类型实现转换,我们需要另谋出路,先来看看在一个笨办法,将一个结构体转换为另外一个结构体:
struct Foo {
x: u32,
y: u16,
}
struct Bar {
a: u32,
b: u16,
}
fn reinterpret(foo: Foo) -> Bar {
let Foo { x, y } = foo;
Bar { a: x, b: y }
}
简单粗暴,但是从另外一个角度来看,也挺啰嗦的,好在 Rust 为我们提供了更通用的方式来完成这个目的。
在某些情况下,类型是可以进行隐式强制转换的,虽然这些转换弱化了 Rust 的类型系统,但是它们的存在是为了让 Rust 在大多数场景可以工作(说白了,帮助用户省事),而不是报各种类型上的编译错误。
首先,在匹配特征时,不会做任何强制转换(除了方法)。一个类型 T
可以强制转换为 U
,不代表 impl T
可以强制转换为 impl U
,例如下面的代码就无法通过编译检查:
trait Trait {}
fn foo<X: Trait>(t: X) {}
impl<'a> Trait for &'a i32 {}
fn main() {
let t: &mut i32 = &mut 0;
foo(t);
}
报错如下:
error[E0277]: the trait bound `&mut i32: Trait` is not satisfied
--> src/main.rs:9:9
|
9 | foo(t);
| ^ the trait `Trait` is not implemented for `&mut i32`
|
= help: the following implementations were found:
<&'a i32 as Trait>
= note: `Trait` is implemented for `&i32`, but not for `&mut i32`
&i32
实现了特征 Trait
, &mut i32
可以转换为 &i32
,但是 &mut i32
依然无法作为 Trait
来使用。
方法调用的点操作符看起来简单,实际上非常不简单,它在调用时,会发生很多魔法般的类型转换,例如:自动引用、自动解引用,强制类型转换直到类型能匹配等。
假设有一个方法 foo
,它有一个接收器(接收器就是 self
、&self
、&mut self
参数)。如果调用 value.foo()
,编译器在调用 foo
之前,需要决定到底使用哪个 Self
类型来调用。现在假设 value
拥有类型 T
。
再进一步,我们使用完全限定语法来进行准确的函数调用:
T::foo(value)
,称之为值方法调用Self
进行实现,上文提到过特征不能进行强制转换),那么编译器会尝试增加自动引用,例如会尝试以下调用: <&T>::foo(value)
和 <&mut T>::foo(value)
,称之为引用方法调用T
,然后再进行尝试。这里使用了 Deref
特征 —— 若 T: Deref<Target = U>
(T
可以被解引用为 U
),那么编译器会使用 U
类型进行尝试,称之为解引用方法调用T
不能被解引用,且 T
是一个定长类型(在编译器类型长度是已知的),那么编译器也会尝试将 T
从定长类型转为不定长类型,例如将 [i32; 2]
转为 [i32]
下面我们来用一个例子来解释上面的方法查找算法:
let array: Rc<Box<[T; 3]>> = ...;
let first_entry = array[0];
array
数组的底层数据隐藏在了重重封锁之后,那么编译器如何使用 array[0]
这种数组原生访问语法通过重重封锁,准确的访问到数组中的第一个元素?
array[0]
只是Index
特征的语法糖:编译器会将 array[0]
转换为 array.index(0)
调用,当然在调用之前,编译器会先检查 array
是否实现了 Index
特征。Rc<Box<[T; 3]>>
是否有实现 Index
特征,结果是否,不仅如此,&Rc<Box<[T; 3]>>
与 &mut Rc<Box<[T; 3]>>
也没有实现。Rc<Box<[T; 3]>>
进行解引用,把它转变成 Box<[T; 3]>
Box<[T; 3]>
进行上面的操作 :Box<[T; 3]>
, &Box<[T; 3]>
,和 &mut Box<[T; 3]>
都没有实现 Index
特征,所以编译器开始对 Box<[T; 3]>
进行解引用,然后我们得到了 [T; 3]
[T; 3]
以及它的各种引用都没有实现 Index
索引(是不是很反直觉:D,在直觉中,数组都可以通过索引访问,实际上只有数组切片才可以!),它也不能再进行解引用,因此编译器只能祭出最后的大杀器:将定长转为不定长,因此 [T; 3]
被转换成 [T]
,也就是数组切片,它实现了 Index
特征,因此最终我们可以通过 index
方法访问到对应的元素。过程看起来很复杂,但是也还好,挺好理解,如果你现在不能彻底理解,也不要紧,等以后对 Rust 理解更深了,同时需要深入理解类型转换时,再来细细品读本章。
再来看看以下更复杂的例子:
fn do_stuff<T: Clone>(value: &T) {
let cloned = value.clone();
}
上面例子中 cloned
的类型是什么?首先编译器检查能不能进行值方法调用, value
的类型是 &T
,同时 clone
方法的签名也是 &T
: fn clone(&T) -> T
,因此可以进行值方法调用,再加上编译器知道了 T
实现了 Clone
,因此 cloned
的类型是 T
。
如果 T: Clone
的特征约束被移除呢?
fn do_stuff<T>(value: &T) {
let cloned = value.clone();
}
首先,从直觉上来说,该方法会报错,因为 T
没有实现 Clone
特征,但是真实情况是什么呢?
我们先来推导一番。 首先通过值方法调用就不再可行,因为 T
没有实现 Clone
特征,也就无法调用 T
的 clone
方法。接着编译器尝试引用方法调用,此时 T
变成 &T
,在这种情况下, clone
方法的签名如下: fn clone(&&T) -> &T
,接着我们现在对 value
进行了引用。 编译器发现 &T
实现了 Clone
类型(所有的引用类型都可以被复制,因为其实就是复制一份地址),因此可以推出 cloned
也是 &T
类型。
最终,我们复制出一份引用指针,这很合理,因为值类型 T
没有实现 Clone
,只能去复制一个指针了。
下面的例子也是自动引用生效的地方:
#[derive(Clone)]
struct Container<T>(Arc<T>);
fn clone_containers<T>(foo: &Container<i32>, bar: &Container<T>) {
let foo_cloned = foo.clone();
let bar_cloned = bar.clone();
}
推断下上面的 foo_cloned
和 bar_cloned
是什么类型?提示: 关键在 Container
的泛型参数,一个是 i32
的具体类型,一个是泛型类型,其中 i32
实现了 Clone
,但是 T
并没有。
首先要复习一下复杂类型派生 Clone
的规则:一个复杂类型能否派生 Clone
,需要它内部的所有子类型都能进行 Clone
。因此 Container<T>(Arc<T>)
是否实现 Clone
的关键在于 T
类型是否实现了 Clone
特征。
上面代码中,Container<i32>
实现了 Clone
特征,因此编译器可以直接进行值方法调用,此时相当于直接调用 foo.clone
,其中 clone
的函数签名是 fn clone(&T) -> T
,由此可以看出 foo_cloned
的类型是 Container<i32>
。
然而,bar_cloned
的类型却是 &Container<T>
,这个不合理啊,明明我们为 Container<T>
派生了 Clone
特征,因此它也应该是 Container<T>
类型才对。万事皆有因,我们先来看下 derive
宏最终生成的代码大概是啥样的:
impl<T> Clone for Container<T> where T: Clone {
fn clone(&self) -> Self {
Self(Arc::clone(&self.0))
}
}
从上面代码可以看出,派生 Clone
能实现的根本是 T
实现了Clone
特征:where T: Clone
, 因此 Container<T>
就没有实现 Clone
特征。
编译器接着会去尝试引用方法调用,此时 &Container<T>
引用实现了 Clone
,最终可以得出 bar_cloned
的类型是 &Container<T>
。
当然,也可以为 Container<T>
手动实现 Clone
特征:
impl<T> Clone for Container<T> {
fn clone(&self) -> Self {
Self(Arc::clone(&self.0))
}
}
此时,编译器首次尝试值方法调用即可通过,因此 bar_cloned
的类型变成 Container<T>
。
这一块儿内容真的挺复杂,每一个坚持看完的读者都是真正的勇士,我也是:为了写好这块儿内容,作者足足花了 4 个小时!
前方危险,敬请绕行!
类型系统,你让开!我要自己转换这些类型,不成功便成仁!虽然本书大多是关于安全的内容,我还是希望你能仔细考虑避免使用本章讲到的内容。这是你在 Rust 中所能做到的真真正正、彻彻底底、最最可怕的非安全行为,在这里,所有的保护机制都形同虚设。
先让你看看深渊长什么样,开开眼,然后你再决定是否深入: mem::transmute<T, U>
将类型 T
直接转成类型 U
,唯一的要求就是,这两个类型占用同样大小的字节数!我的天,这也算限制?这简直就是无底线的转换好吧?看看会导致什么问题:
3
转换成 bool
类型,就算你根本不会去使用该 bool
类型,也不要去这样转换&
变形为&mut
是未定义的行为
对于第 5 条,你该如何知道内存的排列布局是一样的呢?对于 repr(C)
类型和 repr(transparent)
类型来说,它们的布局是有着精确定义的。但是对于你自己的"普通却自信"的 Rust 类型 repr(Rust)
来说,它可不是有着精确定义的。甚至同一个泛型类型的不同实例都可以有不同的内存布局。 Vec<i32>
和 Vec<u32>
它们的字段可能有着相同的顺序,也可能没有。对于数据排列布局来说,什么能保证,什么不能保证目前还在 Rust 开发组的工作任务中呢。
你以为你之前凝视的是深渊吗?不,你凝视的只是深渊的大门。 mem::transmute_copy<T, U>
才是真正的深渊,它比之前的还要更加危险和不安全。它从 T
类型中拷贝出 U
类型所需的字节数,然后转换成 U
。 mem::transmute
尚有大小检查,能保证两个数据的内存大小一致,现在这哥们干脆连这个也丢了,只不过 U
的尺寸若是比 T
大,会是一个未定义行为。
当然,你也可以通过裸指针转换和 unions
(todo!)获得所有的这些功能,但是你将无法获得任何编译提示或者检查。裸指针转换和 unions
也不是魔法,无法逃避上面说的规则。
transmute
虽然危险,但作为一本工具书,知识当然要全面,下面列举两个有用的 transmute
应用场景 。
fn foo() -> i32 {
0
}
let pointer = foo as *const ();
let function = unsafe {
// 将裸指针转换为函数指针
std::mem::transmute::<*const (), fn() -> i32>(pointer)
};
assert_eq!(function(), 0);
struct R<'a>(&'a i32);
// 将 'b 生命周期延长至 'static 生命周期
unsafe fn extend_lifetime<'b>(r: R<'b>) -> R<'static> {
std::mem::transmute::<R<'b>, R<'static>>(r)
}
// 将 'static 生命周期缩短至 'c 生命周期
unsafe fn shorten_invariant_lifetime<'b, 'c>(r: &'b mut R<'static>) -> &'b mut R<'c> {
std::mem::transmute::<&'b mut R<'static>, &'b mut R<'c>>(r)
}
以上例子非常先进!但是是非常不安全的 Rust 行为!
Rust 并没有为基本类型提供隐式的类型转换( coercion ),但是我们可以通过 as
来进行显式地转换。
// 修复错误,填空
// 不要移除任何代码
fn main() {
let decimal = 97.123_f32;
let integer: __ = decimal as u8;
let c1: char = decimal as char;
let c2 = integer as char;
assert_eq!(integer, 'b' as u8);
println!("Success!")
}
✅修改:
// 修复错误,填空
// 不要移除任何代码
fn main() {
let decimal = 97.123_f32;
let integer: u8 = decimal as u8;
let c1: char = decimal as u8 as char;
let c2 = integer as char;
assert_eq!(integer, 'b' as u8 - 1);
println!("Success!")
}
默认情况下, 数值溢出会导致编译错误,但是我们可以通过添加一行全局注解的方式来避免编译错误(溢出还是会发生)
fn main() {
assert_eq!(u8::MAX, 255);
// 如上所示,u8 类型允许的最大值是 255.
// 因此以下代码会报溢出的错误: literal out of range for `u8`.
// **请仔细查看相应的编译错误,从中寻找到解决的办法**
// **不要修改 main 中的任何代码**
let v = 1000 as u8;
println!("Success!")
}
✅修改:
fn main() {
assert_eq!(u8::MAX, 255);
// 如上所示,u8 类型允许的最大值是 255.
// 因此以下代码会报溢出的错误: literal out of range for `u8`.
// **请仔细查看相应的编译错误,从中寻找到解决的办法**
// **不要修改 main 中的任何代码**
let v = 1000 as u16;
println!("Success!")
}
当将任何数值转换成无符号整型 T
时,如果当前的数值不在新类型的范围内,我们可以对当前数值进行加值或减值操作( 增加或减少 T::MAX + 1
),直到最新的值在新类型的范围内,假设我们要将 300
转成 u8
类型,由于u8
最大值是 255,因此 300
不在新类型的范围内并且大于新类型的最大值,因此我们需要减去 T::MAX + 1
,也就是 300
- 256
= 44
。
fn main() {
assert_eq!(1000 as u16, __);
assert_eq!(1000 as u8, __);
// 事实上,之前说的规则对于正整数而言,就是如下的取模
println!("1000 mod 256 is : {}", 1000 % 256);
assert_eq!(-1_i8 as u8, __);
// 从 Rust 1.45 开始,当浮点数超出目标整数的范围时,转化会直接取正整数取值范围的最大或最小值
assert_eq!(300.1_f32 as u8, __);
assert_eq!(-100.1_f32 as u8, __);
// 上面的浮点数转换有一点性能损耗,如果大家对于某段代码有极致的性能要求,
// 可以考虑下面的方法,但是这些方法的结果可能会溢出并且返回一些无意义的值
// 总之,请小心使用
unsafe {
// 300.0 is 44
println!("300.0 is {}", 300.0_f32.to_int_unchecked::<u8>());
// -100.0 as u8 is 156
println!("-100.0 as u8 is {}", (-100.0_f32).to_int_unchecked::<u8>());
// nan as u8 is 0
println!("nan as u8 is {}", f32::NAN.to_int_unchecked::<u8>());
}
}
✅修改:
#[allow(overflowing_literals)]
fn main() {
assert_eq!(1000 as u16, 1000);
assert_eq!(1000 as u8, 232);
// 事实上,之前说的规则对于正整数而言,就是如下的取模
println!("1000 mod 256 is : {}", 1000 % 256);
assert_eq!(-1_i8 as u8, 255);
// 从 Rust 1.45 开始,当浮点数超出目标整数的范围时,转化会直接取正整数取值范围的最大或最小值
assert_eq!(300.1_f32 as u8, 255);
assert_eq!(-100.1_f32 as u8, 0);
// 上面的浮点数转换有一点性能损耗,如果大家对于某段代码有极致的性能要求,
// 可以考虑下面的方法,但是这些方法的结果可能会溢出并且返回一些无意义的值
// 总之,请小心使用
unsafe {
// 300.0 is 44
println!("300.0 is {}", 300.0_f32.to_int_unchecked::<u8>());
// -100.0 as u8 is 156
println!("-100.0 as u8 is {}", (-100.0_f32).to_int_unchecked::<u8>());
// nan as u8 is 0
println!("nan as u8 is {}", f32::NAN.to_int_unchecked::<u8>());
}
}
裸指针可以和代表内存地址的整数互相转换
// 填空
fn main() {
let mut values: [i32; 2] = [1, 2];
let p1: *mut i32 = values.as_mut_ptr();
let first_address: usize = p1 __;
let second_address = first_address + 4; // 4 == std::mem::size_of::<i32>()
let p2: *mut i32 = second_address __; // p2 指向 values 数组中的第二个元素
unsafe {
// 将第二个元素加 1
__
}
assert_eq!(values[1], 3);
println!("Success!")
}
✅修改:
// 填空
fn main() {
let mut values: [i32; 2] = [1, 2];
let p1: *mut i32 = values.as_mut_ptr();
let first_address: usize = p1 as usize;
let second_address = first_address + 4; // 4 == std::mem::size_of::<i32>()
let p2: *mut i32 = second_address as *mut i32; // p2 指向 values 数组中的第二个元素
unsafe {
// 将第二个元素加 1
*p2 += 1;
}
assert_eq!(values[1], 3);
println!("Success!")
}
fn main() {
let arr :[u64; 13] = [0; 13];
assert_eq!(std::mem::size_of_val(&arr), 8 * 13);
let a: *const [u64] = &arr;
let b = a as *const [u8];
unsafe {
assert_eq!(std::mem::size_of_val(&*b), __)
}
}
✅修改:
fn main() {
let arr :[u64; 13] = [0; 13];
assert_eq!(std::mem::size_of_val(&arr), 8 * 13);
let a: *const [u64] = &arr;
let b = a as *const [u8];
unsafe {
assert_eq!(std::mem::size_of_val(&*b), 13)
}
}
From
特征允许让一个类型定义如何基于另一个类型来创建自己,因此它提供了一个很方便的类型转换的方式。
From
和 Into
是配对的,我们只要实现了前者,那后者就会自动被实现:只要实现了 impl From<T> for U
, 就可以使用以下两个方法: let u: U = U::from(T)
和 let u:U = T.into()
,前者由 From
特征提供,而后者由自动实现的 Into
特征提供。
需要注意的是,当使用 into
方法时,你需要进行显式地类型标注,因为编译器很可能无法帮我们推导出所需的类型。
来看一个例子,我们可以简单的将 &str
转换成 String
。`
fn main() {
let my_str = "hello";
// 以下三个转换都依赖于一个事实:String 实现了 From<&str> 特征
let string1 = String::from(my_str);
let string2 = my_str.to_string();
// 这里需要显式地类型标注
let string3: String = my_str.into();
}
这种转换可以发生是因为标准库已经帮我们实现了 From
特征: impl From<&'_ str> for String
。你还可以在这里)找到其它实现 From
特征的常用类型。
fn main() {
// impl From<bool> for i32
let i1:i32 = false.into();
let i2:i32 = i32::from(false);
assert_eq!(i1, i2);
assert_eq!(i1, 0);
// 使用两种方式修复错误
// 1. 哪个类型实现 From 特征 : impl From<char> for ? , 你可以查看一下之前提到的文档,来找到合适的类型
// 2. 上一章节中介绍过的某个关键字
let i3: i32 = 'a'.into();
// 使用两种方法来解决错误
let s: String = 'a' as String;
println!("Success!")
}
✅修改1:
fn main() {
// impl From<bool> for i32
let i1:i32 = false.into();
let i2:i32 = i32::from(false);
assert_eq!(i1, i2);
assert_eq!(i1, 0);
// 使用两种方式修复错误
// 1. 哪个类型实现 From 特征 : impl From<char> for ? , 你可以查看一下之前提到的文档,来找到合适的类型
// 2. 上一章节中介绍过的某个关键字
let i3: u32 = 'a'.into();
// 使用两种方法来解决错误
let s: String = 'a'.into();
println!("Success!")
}
✅修改2:
fn main() {
// impl From<bool> for i32
let i1:i32 = false.into();
let i2:i32 = i32::from(false);
assert_eq!(i1, i2);
assert_eq!(i1, 0);
// 使用两种方式修复错误
// 1. 哪个类型实现 From 特征 : impl From<char> for ? , 你可以查看一下之前提到的文档,来找到合适的类型
// 2. 上一章节中介绍过的某个关键字
let i3: u32 = 'a' as u32;
// 使用两种方法来解决错误
let s: String = String::from("a");
println!("Success!")
}
// From 被包含在 `std::prelude` 中,因此我们没必要手动将其引入到当前作用域来
// use std::convert::From;
#[derive(Debug)]
struct Number {
value: i32,
}
impl From<i32> for Number {
// 实现 `from` 方法
}
// 填空
fn main() {
let num = __(30);
assert_eq!(num.value, 30);
let num: Number = __;
assert_eq!(num.value, 30);
println!("Success!")
}
✅修改:
// From 被包含在 `std::prelude` 中,因此我们没必要手动将其引入到当前作用域来
// use std::convert::From;
#[derive(Debug)]
struct Number {
value: i32,
}
impl From<i32> for Number {
// 实现 `from` 方法
fn from(x: i32) -> Self{
Number{
value: x
}
}
}
// 填空
fn main() {
let num = Number::from(30);
assert_eq!(num.value, 30);
let num: Number = Number{value: 30};
assert_eq!(num.value, 30);
println!("Success!")
}
当执行错误处理时,为我们自定义的错误类型实现 From
特征是非常有用。这样就可以通过 ?
自动将某个错误类型转换成我们自定义的错误类型
use std::fs;
use std::io;
use std::num;
enum CliError {
IoError(io::Error),
ParseError(num::ParseIntError),
}
impl From<io::Error> for CliError {
// 实现 from 方法
}
impl From<num::ParseIntError> for CliError {
// 实现 from 方法
}
fn open_and_parse_file(file_name: &str) -> Result<i32, CliError> {
// ? 自动将 io::Error 转换成 CliError
let contents = fs::read_to_string(&file_name)?;
// num::ParseIntError -> CliError
let num: i32 = contents.trim().parse()?;
Ok(num)
}
fn main() {
println!("Success!")
}
✅修改:
use std::fs;
use std::io;
use std::num;
enum CliError {
IoError(io::Error),
ParseError(num::ParseIntError),
}
impl From<io::Error> for CliError {
// 实现 from 方法
fn from(err : io::Error) -> Self{
CliError::IoError(err)
}
}
impl From<num::ParseIntError> for CliError {
// 实现 from 方法
fn from(err : num::ParseIntError) -> Self{
CliError::ParseError(err)
}
}
fn open_and_parse_file(file_name: &str) -> Result<i32, CliError> {
// ? 自动将 io::Error 转换成 CliError
let contents = fs::read_to_string(&file_name)?;
// num::ParseIntError -> CliError
let num: i32 = contents.trim().parse()?;
Ok(num)
}
fn main() {
println!("Success!")
}
类似于 From
和 Into
, TryFrom
和 TryInto
也是用于类型转换的泛型特。
但是又与 From/Into
不同, TryFrom
和 TryInto
可以对转换后的失败进行处理,然后返回一个 Result
。
// TryFrom 和 TryInto 也被包含在 `std::prelude` 中, 因此以下引入是没必要的
// use std::convert::TryInto;
fn main() {
let n: i16 = 256;
// Into 特征拥有一个方法`into`,
// 因此 TryInto 有一个方法是 ?
let n: u8 = match n.__() {
Ok(n) => n,
Err(e) => {
println!("there is an error when converting: {:?}, but we catch it", e.to_string());
0
}
};
assert_eq!(n, __);
println!("Success!")
}
✅修改:
// TryFrom 和 TryInto 也被包含在 `std::prelude` 中, 因此以下引入是没必要的
use std::convert::TryInto;
fn main() {
let n: i16 = 256;
// Into 特征拥有一个方法`into`,
// 因此 TryInto 有一个方法是 ?
let n: u8 = match n.try_into() {
Ok(n) => n,
Err(e) => {
println!("there is an error when converting: {:?}, but we catch it", e.to_string());
0
}
};
assert_eq!(n, 0);
println!("Success!")
}
#[derive(Debug, PartialEq)]
struct EvenNum(i32);
impl TryFrom<i32> for EvenNum {
type Error = ();
// 实现 `try_from`
fn try_from(value: i32) -> Result<Self, Self::Error> {
if value % 2 == 0 {
Ok(EvenNum(value))
} else {
Err(())
}
}
}
fn main() {
assert_eq!(EvenNum::try_from(8), Ok(EvenNum(8)));
assert_eq!(EvenNum::try_from(5), Err(()));
// 填空
let result: Result<EvenNum, ()> = 8i32.try_into();
assert_eq!(result, __);
let result: Result<EvenNum, ()> = 5i32.try_into();
assert_eq!(result, __);
println!("Success!")
}
✅修改:
#[derive(Debug, PartialEq)]
struct EvenNum(i32);
impl TryFrom<i32> for EvenNum {
type Error = ();
fn try_from(value: i32) -> Result<Self, Self::Error> {
if value % 2 == 0 {
Ok(EvenNum(value))
} else {
Err(())
}
}
}
fn main() {
assert_eq!(EvenNum::try_from(8), Ok(EvenNum(8)));
assert_eq!(EvenNum::try_from(5), Err(()));
let result: Result<EvenNum, ()> = 8i32.try_into();
assert_eq!(result, Ok(EvenNum(8)));
let result: Result<EvenNum, ()> = 5i32.try_into();
assert_eq!(result, Err(()));
}
只要为一个类型实现了 ToString
,就可以将任何类型转换成 String
。事实上,这种方式并不是最好的,大家还记得 fmt::Display
特征吗?它可以控制一个类型如何打印,在实现它的时候还会自动实现 ToString
。
use std::fmt;
struct Point {
x: i32,
y: i32,
}
impl fmt::Display for Point {
// 实现 fmt 方法
}
fn main() {
let origin = Point { x: 0, y: 0 };
// 填空
assert_eq!(origin.__, "The point is (0, 0)");
assert_eq!(format!(__), "The point is (0, 0)");
println!("Success!")
}
✅修改:
use std::fmt;
struct Point {
x: i32,
y: i32,
}
impl fmt::Display for Point {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
write!(f, "The point is ({}, {})", self.x, self.y)
}
}
fn main() {
let origin = Point { x: 0, y: 0 };
// 填空
assert_eq!(origin.to_string(), "The point is (0, 0)");
assert_eq!(format!("{}", origin), "The point is (0, 0)");
println!("Success!")
}
使用 parse
方法可以将一个 String
转换成 i32
数字,这是因为在标准库中为 i32
类型实现了 FromStr
: : impl FromStr for i32
// 为了使用 `from_str` 方法, 你需要引入该特征到当前作用域中
use std::str::FromStr;
fn main() {
let parsed: i32 = "5".__.unwrap();
let turbo_parsed = "10".__.unwrap();
let from_str = __.unwrap();
let sum = parsed + turbo_parsed + from_str;
assert_eq!(sum, 35);
println!("Success!")
}
✅修改:
// 为了使用 `from_str` 方法, 你需要引入该特征到当前作用域中
use std::str::FromStr;
fn main() {
let parsed: i32 = "5".parse().unwrap();
let turbo_parsed: i32 = "10".parse::<i32>().unwrap();
let from_str = i32::from_str("20").unwrap();
let sum = parsed + turbo_parsed + from_str;
assert_eq!(sum, 35);
println!("Success!")
}
还可以为自定义类型实现 FromStr
特征
use std::str::FromStr;
use std::num::ParseIntError;
#[derive(Debug, PartialEq)]
struct Point {
x: i32,
y: i32
}
impl FromStr for Point {
type Err = ParseIntError;
fn from_str(s: &str) -> Result<Self, Self::Err> {
let coords: Vec<&str> = s.trim_matches(|p| p == '(' || p == ')' )
.split(',')
.collect();
let x_fromstr = coords[0].parse::<i32>()?;
let y_fromstr = coords[1].parse::<i32>()?;
Ok(Point { x: x_fromstr, y: y_fromstr })
}
}
fn main() {
// 使用两种方式填空
// 不要修改其它地方的代码
let p = __;
assert_eq!(p.unwrap(), Point{ x: 3, y: 4} );
println!("Success!")
}
✅修改1:
use std::str::FromStr;
use std::num::ParseIntError;
#[derive(Debug, PartialEq)]
struct Point {
x: i32,
y: i32
}
impl FromStr for Point {
type Err = ParseIntError;
fn from_str(s: &str) -> Result<Self, Self::Err> {
let coords: Vec<&str> = s.trim_matches(|p| p == '(' || p == ')' )
.split(',')
.collect();
let x_fromstr = coords[0].parse::<i32>()?;
let y_fromstr = coords[1].parse::<i32>()?;
Ok(Point { x: x_fromstr, y: y_fromstr })
}
}
fn main() {
// 使用两种方式填空
// 不要修改其它地方的代码
let p = Point::from_str("(3,4)");
assert_eq!(p.unwrap(), Point{ x: 3, y: 4} );
println!("Success!")
}
✅修改2:
use std::str::FromStr;
use std::num::ParseIntError;
#[derive(Debug, PartialEq)]
struct Point {
x: i32,
y: i32
}
impl FromStr for Point {
type Err = ParseIntError;
fn from_str(s: &str) -> Result<Self, Self::Err> {
let coords: Vec<&str> = s.trim_matches(|p| p == '(' || p == ')' )
.split(',')
.collect();
let x_fromstr = coords[0].parse::<i32>()?;
let y_fromstr = coords[1].parse::<i32>()?;
Ok(Point { x: x_fromstr, y: y_fromstr })
}
}
fn main() {
// 使用两种方式填空
// 不要修改其它地方的代码
let p = Point{x:3, y:4};
assert_eq!(p, Point{ x: 3, y: 4} );
println!("Success!")
}
Deref 特征在智能指针 - Deref章节中有更加详细的介绍。
std::mem::transmute
是一个 unsafe 函数,可以把一个类型按位解释为另一个类型,其中这两个类型必须有同样的位数( bits )。
transmute
相当于将一个类型按位移动到另一个类型,它会将源值的所有位拷贝到目标值中,然后遗忘源值。该函数跟 C 语言中的 memcpy
函数类似。
正因为此,transmute
非常非常不安全! 调用者必须要自己保证代码的安全性,当然这也是 unsafe 的目的。
1.transmute
可以将一个指针转换成一个函数指针,该转换并不具备可移植性,原因是在不同机器上,函数指针和数据指针可能有不同的位数( size )。
fn foo() -> i32 {
0
}
fn main() {
let pointer = foo as *const ();
let function = unsafe {
std::mem::transmute::<*const (), fn() -> i32>(pointer)
};
assert_eq!(function(), 0);
}
2.transmute
还可以扩展或缩短一个不变量的生命周期,将 Unsafe Rust 的不安全性体现的淋漓尽致!
struct R<'a>(&'a i32);
unsafe fn extend_lifetime<'b>(r: R<'b>) -> R<'static> {
std::mem::transmute::<R<'b>, R<'static>>(r)
}
unsafe fn shorten_invariant_lifetime<'b, 'c>(r: &'b mut R<'static>)
-> &'b mut R<'c> {
std::mem::transmute::<&'b mut R<'static>, &'b mut R<'c>>(r)
}
3.事实上我们还可以使用一些安全的方法来替代 transmute
.
fn main() {
/*Turning raw bytes(&[u8]) to u32, f64, etc.: */
let raw_bytes = [0x78, 0x56, 0x34, 0x12];
let num = unsafe { std::mem::transmute::<[u8; 4], u32>(raw_bytes) };
// use `u32::from_ne_bytes` instead
let num = u32::from_ne_bytes(raw_bytes);
// or use `u32::from_le_bytes` or `u32::from_be_bytes` to specify the endianness
let num = u32::from_le_bytes(raw_bytes);
assert_eq!(num, 0x12345678);
let num = u32::from_be_bytes(raw_bytes);
assert_eq!(num, 0x78563412);
/*Turning a pointer into a usize: */
let ptr = &0;
let ptr_num_transmute = unsafe { std::mem::transmute::<&i32, usize>(ptr) };
// Use an `as` cast instead
let ptr_num_cast = ptr as *const i32 as usize;
/*Turning an &mut T into an &mut U: */
let ptr = &mut 0;
let val_transmuted = unsafe { std::mem::transmute::<&mut i32, &mut u32>(ptr) };
// Now, put together `as` and reborrowing - note the chaining of `as`
// `as` is not transitive
let val_casts = unsafe { &mut *(ptr as *mut i32 as *mut u32) };
/*Turning an &str into a &[u8]: */
// this is not a good way to do this.
let slice = unsafe { std::mem::transmute::<&str, &[u8]>("Rust") };
assert_eq!(slice, &[82, 117, 115, 116]);
// You could use `str::as_bytes`
let slice = "Rust".as_bytes();
assert_eq!(slice, &[82, 117, 115, 116]);
// Or, just use a byte string, if you have control over the string
// literal
assert_eq!(b"Rust", &[82, 117, 115, 116]);
}