23_use使用

1. 概述

可以使用use关键字将路径导入到当前作用域内,引入的内容仍然遵循私有性规则,也就是说只有公共的模块引入进来才可以使用。如下示例代码

rust 复制代码
mod front_of_house {
    pub mod hosting {
        pub fn add_to_waitlist() {}
        fn some_function();
    }
}

use crate::front_of_house::hosting;

pub fn eat_at_restaurant() {
    hosting::add_to_waitlist();
}

在上面的示例代码中,虽然我们引入了hosting模块,但是仍然不能调用 some_function 这个私有函数。

也可以使用相对路径的方式引入模块,如下示例代码

rust 复制代码
use front_of_house::hosting;

在引入代码的时候,我们通常引用到父级模块即可,再通过父级模块调用函数,而不是引入到具体的函数,这样我们就能容易的区分函数是外部引入的,还是本模块就存在的。

2. use的惯用做法

2.1 函数

将函数的父级模块引入作用域,指定到其父级即可;

  • struct、enum、其他

对于非函数条目,则指定完整路径,即指定到其本身。如下示例代码

Rust 复制代码
use std::collection::HashMap;

fn main() {
    let mut map = HashMap::new();
    map.insert(1, 2);
}

2.2 同名条目

如果在不同的模块存在两个同名条目,而在一个源码文件中需要同时使用这两个模块,这时候use引用指定到父级即可。如我们需要std::fmt::Resultstd::io::Result这两个Result,则需要将其父模块同时引入,如下示例代码

rust 复制代码
use std::fmt;
use std::io;

fn f1() -> fmt::Result {
    // 函数内容,此处省略
}

fn f2() -> io::Result {
    // 函数内容,此处省略
}

除此,我们还可以使用as关键字解决该问题,as 关键字可以为引入的路径指定本地的别名,如下示例代码

rust 复制代码
use std::fmt::Result;
use std::io::Result as IOResult;

fn f1() -> Result {
    // 函数内容省略
}

fn f2() -> IOResult {
    // 省略函数体
}

2.3 使用pub use重新导出名称

使用use将路径(名称)导入到作用域后,该名称在此作用域是私有的。如果我们使用pub use关键字进行引用,那么在外部就可以使用,如下示例代码

rust 复制代码
mod front_of_house {
    pub mod hosting {
        pub fn add_to_waitlist() {}
        fn some_function();
    }
}

pub use crate::front_of_house::hosting;

pub use将条目引入到作用域内,同时该条目可以被外部代码引入到它们的作用域内。

3. 使用外部包(package)

Cargo.toml添加依赖的包(package)的声明,当我们运行cargo build时,cargo将从crate.io添加对应包到本地,下载好之后,使用use关键字将特定条目引入到作用域。

不过使用使用原网站下载依赖可能会很慢,因为crate.io的服务器在国外,我们可以使用修改文件文件将下载的源指定改为国内的cargo镜像地址,修改文件~/.cargo/config,添加以下内容

ini 复制代码
[source.crates-io]
replace-with = 'tuna'

[source.tuna]
registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"

以上的配置指定了当cargo去拉去包依赖的时候,将使用清华镜像站。

标准库std也被当作外部包,不需要修改Cargo.toml来包含std。不过在需要使用具体条目的时候,还是需要使用use关键字将std中特定的条目引入到当前作用域。

4. 使用嵌套路径清理大量的的use语句

如果使用同一个包或者模块下的多个条目,则可以使用嵌套路径在同一行内将上述条目进行引入,引入格式如下

Rust 复制代码
路径相同的部分::{路径差异的部分}

rust 复制代码
use std::cmp::Ordering;
use std::io;

可以改为

Rust 复制代码
std std::{
    cmp::Ordering,
    io
}

Rust 复制代码
use std::io;
use std::io::Write;

可以改为

Rust 复制代码
use std::io::{
    self,
    Write
}

*代表通配符号,我们还可以使用*把路径中所有的公共条目都引入到当前的作用域。如下示例代码

rust 复制代码
use std::collections::*;

但这种引入方式需要谨慎使用,适合以下应用场景

  • 测试。将所有被测试代码引入到tests模块中
  • 有时被用于预导入(prelude)模块

5. 将模块内容移动到其他文件

定义模块时,如果模块后面是";",而不是代码块,Rust会从模块同名的文件中加在内容,模块树的结构不会变化。随着模块逐渐变大,该技术让你可以把模块的内容移动到其他文件中。

相关推荐
excel25 分钟前
Node.js 断言与测试框架示例对比
前端
天蓝色的鱼鱼2 小时前
前端开发者的组件设计之痛:为什么我的组件总是难以维护?
前端·react.js
codingandsleeping2 小时前
使用orval自动拉取swagger文档并生成ts接口
前端·javascript
石金龙3 小时前
[译] Composition in CSS
前端·css
白水清风3 小时前
微前端学习记录(qiankun、wujie、micro-app)
前端·javascript·前端工程化
Ticnix3 小时前
函数封装实现Echarts多表渲染/叠加渲染
前端·echarts
用户22152044278003 小时前
new、原型和原型链浅析
前端·javascript
阿星做前端3 小时前
coze源码解读: space develop 页面
前端·javascript
叫我小窝吧3 小时前
Promise 的使用
前端·javascript
NBtab4 小时前
Vite + Vue3项目版本更新检查与页面自动刷新方案
前端