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会从模块同名的文件中加在内容,模块树的结构不会变化。随着模块逐渐变大,该技术让你可以把模块的内容移动到其他文件中。

相关推荐
xw540 分钟前
uni-app中v-if使用”异常”
前端·uni-app
!win !1 小时前
uni-app中v-if使用”异常”
前端·uni-app
IT_陈寒1 小时前
Java 性能优化:5个被低估的JVM参数让你的应用吞吐量提升50%
前端·人工智能·后端
南囝coding2 小时前
《独立开发者精选工具》第 018 期
前端·后端
小桥风满袖2 小时前
极简三分钟ES6 - ES9中for await of
前端·javascript
半花2 小时前
i18n国际语言化配置
前端
编程贝多芬2 小时前
Promise 的场景和最佳实践
前端·javascript
Asort2 小时前
JavaScript 从零开始(四):基础语法详解——从变量声明到数据类型的完全指南
前端·javascript
木木jio2 小时前
前端大文件分片上传 —— 基于 React 的工程化实现
前端·javascript
南雨北斗2 小时前
JS的对象属性存储器
前端