【Rust指南】use关键字妙用|模块内容拆分

在这里插入图片描述

  前言

  书接上文,本篇补充rust 组织管理中模块的细节知识,比如模块拆分。此外介绍use关键字的习惯用法,快速引用自定义模块内容或标准库,以此优化代码书写。


1、rust 中的use关键字

如果我说use与C/C++中的include或者是java、python中的import用法类似,想必此时的你定是头一歪,脑子里蹦出两个字——拿捏。没错,看完本篇文章心里会更加敞亮,变得自信满满。

1.1、将模块标识符引入当前作用域

  • use 关键字能够将模块标识符引入当前作用域
  • 但是谨记引入的时候也遵循私有权限的原则

 例如:

mod front_of_house{
    pub mod hosting{
        pub fn add_to_waitlist(){}
        fn some_fun(){}
    }
}

use crate::front_of_house::hosting;

pub fn eat_at_restaurant(){
    hosting::add_to_waitlist();
    hosting::add_to_waitlist();
    hosting::some_fun();
}//这里并不能使用some_fun()函数,是报错内容

我们可以看到front_of_house模块中嵌套了一个公共模块hosting,但是我们知道公共模块里的内容也需要有pub修饰才能被调用。因此没有加pub关键字的第二个函数无法被调用,这就是遵循私有权限的体现。


1.2、use特点与习惯用法

我们习惯这样使用 use:

  1. 不直接引入具体的函数或者方法
    • 我们可以这样引入具体函数:use crate::front_of_house::hosting::add_to_waitlist;
    • 当代码比较多的时候,我们很难区分一个函数是本地自定义还是引用,因此不具体引用
  2. 引用函数或者方法最近的父模块
    • 不必引用最外层,以免代码冗余
  3. 对于structenum 等函数以外的内容需要指定到完整路径(本身)
    • 引入过后直接使用即可

 例如:

use std::collections::HashMap;
fn main() {
    let mut map=HashMap::new();
    map.insert(1, 2);
    println!("{:?}",map);
}
//打印结果:{1,2}
  1. 如果一个类型在不同的模块中都有,那么就要引入到父模块(同名条目)

 例如:

use std::fmt;
use std::io;

fn f1()->fmt::Result{}
fn f2()->io ::Result{}
  1. 针对同名条目可以使用as关键字来重命名类型
    • 指定到完整路径,给其中一个改名即可

 例如:

use std::fmt::Result;
use std::io::Result as IOResult;

fn f1()-> Result<>{}
fn f2()-> IOResult<>{}

1.3、使用pub use 重新导出名称

  • 使用 use 将路径(名称)导入到作用域后,该名称在此作用域默认是私有的,外部无法访问
  • pub use:重导出
    • 将条目引入作用域
    • 该条目可以被外部代码引入到自己的作用域

1.4、使用外部包(package)以及标准库

  1. Cargo.toml 添加依赖的包
    • 通过该网站自动下载资源:https://crates.io/
    • 但是默认网站是在国外,需要更换国内镜像
    • 这些内容在此专栏有文章讲的比较详细,不理解可以去翻阅一下
  2. 使用use将特定条目引入作用域
  3. 标准库(std)也被当作外部包
    • 无需修改Cargo.toml来包含std
    • 但是需要用 use 将 std 中的特定条目引入到当前作用域

1.5、使用嵌套路径清理大量 use 语句

当使用同一个包或模块下的多个条目时:

  • 使用嵌套路径在同一行内将多个条目引入
    • 路径相同的部分::{路径差异的部分}

  例如:

use std::io;
use std::cmp::Ordering;

use std::{io,cmp::Ordering};
//前两行可用最后一行替代
  • 如果包含自身,需要使用self

  例如:

use std::io;
use std::io::Write;

use std::io::{self,Write};
//依然是最后一行可替换前两行

1.6、通配符 *

  • 使用*可以把路径中所有的公共条目都引入到作用域
  • 需要谨慎使用,作用场景:
    • 测试:将所有被测试代码引入到 tests 模块(后续文章会有)
    • 有时被用于预导入(prelude)模块

2、模块内容拆分

将模块拆分为不同文件:

  • 模块定义时,如果模块名后面是;而不是代码块:
    • Rust 会从与模块同名的文件中加载内容,例如:
      在这里插入图片描述
      在这里插入图片描述
      此时的lib.rs里不会报错,编译器看到mod front_of_house; 会在根目录src处找到front_of_house文件夹里的hosting.rs文件,使用pub use将函数引入到当前作用域(必须严格按照图示建立文件夹和文件)
    • 模块树的结构不会发生变化
  • 随着模块逐渐变大,该技术让你可以把模块的内容移动到其他文件中

到这里 rust 的组织管理算是彻底告一段落了,这块内容不多,但是理解起来还是要下点功夫的。如果感到有帮助就多多支持一下博主吧,让我保持创作的动力!

  • 181
    点赞
  • 142
    收藏
  • 打赏
    打赏
  • 289
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
©️2022 CSDN 皮肤主题:代码科技 设计师:Amelia_0503 返回首页
评论 289

打赏作者

微凉秋意

你的鼓励将是我创作的最大动力

¥2 ¥4 ¥6 ¥10 ¥20
输入1-500的整数
余额支付 (余额:-- )
扫码支付
扫码支付:¥2
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值