xref: /DragonOS/docs/kernel/core_api/casting.md (revision 01c18c64b14b4ebabd98fa92c587c26874275eb1) 
1# 类型转换库API
2
3  内核提供了一些函数来帮助你在不同的类型之间进行转换。包括以下类型：
4
5- 数值类型转换 （使用`num-traits`库）
6- Arc类型转换
7
8  上述没有特殊标明的函数，都是在`kernel/src/libs/casting.rs`中实现的。
9
10
11## 1. 数值类型转换
12
13### 1.1. 整数类型与枚举类型之间的转换
14
15  您可以使用`num-traits`库提供的宏，实现枚举类型和整数类型之间的转换。
16SystemError枚举类型使用了这种方式，您可以在`kernel/src/syscall/mod.rs`中找到它的用法。
17
18  它首先继承了`FromPrimitive, ToPrimitive`两个trait，然后这样转换：
19
20```rust
21impl SystemError {
22    /// @brief 把posix错误码转换为系统错误枚举类型。
23    pub fn from_posix_errno(errno: i32) -> Option<SystemError> {
24        // posix 错误码是小于0的
25        if errno >= 0 {
26            return None;
27        }
28        return <Self as FromPrimitive>::from_i32(-errno);
29    }
30
31    /// @brief 把系统错误枚举类型转换为负数posix错误码。
32    pub fn to_posix_errno(&self) -> i32 {
33        return -<Self as ToPrimitive>::to_i32(self).unwrap();
34    }
35}
36```
37
38&emsp;&emsp;这两个函数很好的说明了如何使用这两个trait。
39
40## 2. Arc类型转换
41
42### 2.1 从Arc<dyn U>转换为Arc<T>
43
44&emsp;&emsp;当我们需要把一个`Arc<dyn U>`转换为`Arc<T>`的具体类型指针时，我们要为`U`这个trait实现`DowncastArc`trait。这个trait定义在`kernel/src/libs/casting.rs`中。它要求`trait U`实现`Any + Sync + Send`trait.
45
46&emsp;&emsp;为`trait U: Any + Send + Sync`实现`DowncastArc`trait，需要这样做：
47
48```rust
49impl DowncastArc for dyn U {
50    fn as_any_arc(self: Arc<Self>) -> Arc<dyn Any> {
51        return self;
52    }
53}
54```
55
56&emsp;&emsp;使用`DowncastArc`trait，我们可以这样转换：
57
58```rust
59let arc: Arc<dyn U> = ...;
60let arc_t: Arc<T> = arc.downcast_arc::<T>().unwrap();
61```
62
63&emsp;&emsp;如果`arc`的具体类型不是`Arc<T>`，那么`downcast_arc::<T>()`会返回`None`。
64