《通过例子学Rust》第11章 crate

crate(中文有 "包,包装箱" 之意)是 Rust 的编译单元。当调用 rustc some_file.rs 时,some_file.rs 被当作 crate 文件 。如果 some_file.rs 里面含有 mod 声明,那么模块文件的内容将在编译之前被插入 crate 文件的相应声明处。换句话说,模块不会单独被编译,只有 crate 才会被编译。

crate 可以编译成二进制可执行文件(binary)或库文件(library)。默认情况下,rustc 将从 crate 产生二进制可执行文件。这种行为可以通过 rustc 的选项 --crate-type 重载。

11.1 库

让我们创建一个库,然后看看如何把它链接到另一个 crate。

复制代码
// 11.1节 库

pub fn public_function() {
    println!("called rary's 'public_function()'");
}

fn private_function() {
    println!("called rary's 'private_function()'");
}

pub fn indirect_access() {
    print!("called rary's 'indirect_access()', that\n> ");
    private_function();
}

// 编译库  rustc --crate-type=lib rary.rs

PS F:\rustproject\rustbyexample\chapter11\example11_1> rustc --crate-type=lib rary.rs
PS F:\rustproject\rustbyexample\chapter11\example11_1> ls lib*
library.rlib

默认情况下,库会使用 crate 文件的名字,前面加上 "lib" 前缀,但这个默认名称可以使用 crate_name 属性 覆盖。

11.2 使用库

要将一个 crate 链接到上节新建的库,可以使用 rustc 的 --extern 选项。然后将所有的物件导入到与库名相同的模块下。此模块的操作通常与任何其他模块相同。

复制代码
// 11.2节 使用库
fn main() {
    rary::public_function();

    // 报错! `private_function` 是私有的
    //rary::private_function();
    rary::indirect_access();
 
    println!("Hello Rust"); 
}
 
// rustc main.rs --extern rary=library.rlib --edition=2024
// ./main

编译运行:

复制代码
# library.rlib 是已编译好的库的路径,这里假设它在同一目录下:
PS F:\rustproject\rustbyexample\chapter11\example11_1> rustc main.rs --extern rary=library.rlib
PS F:\rustproject\rustbyexample\chapter11\example11_1> ./main
called rary's 'public_function()'
called rary's 'indirect_access()', that
> called rary's 'private_function()'
Hello Rust
PS F:\rustproject\rustbyexample\chapter11\example11_1>
相关推荐
不积跬步无以至千里mmbb2626 分钟前
Rust内核开发核心入口解析
linux·rust
wflynn1 天前
GitHub 今日推荐|rust-anything:录制真实输入输出,渐进式重写热点函数到 Rust
rust·开源·github·cli·claude-code·agent-skills
风笙9782 天前
[Rust] String 与 &str 详解
rust
风笙9782 天前
[Rust]复合类型
rust
风笙9782 天前
[Rust] 所有权与引用
rust
Kapaseker2 天前
最近用 Rust 写工具,我发现这 7 个库是真好用
rust
SomeOtherTime3 天前
第 11 讲(大结局):编译期元编程与零拷贝架构——卫生声明宏(macro_rules!)、过程宏 AST 手术刀与 Serde 零反射序列化的终极合龙
rust
SomeOtherTime3 天前
番外篇(第 12 讲):走向工业界深水区——从物理定律看 Rust 在真实工程中的“降维打击”与“阿喀琉斯之踵”
开发语言·rust
Kapaseker3 天前
Rust 桌面开发到底怎么选?先看这篇文章!
rust
奶油话梅糖3 天前
容器启停 2.5 毫秒:11 天 1,700 Star 的 Kiri,用一个 900 KB 的 PID 1 干掉了 runc 和 dockerd
前端·人工智能·rust