我正在尝试创建一个库,我想在其中包含一些二进制(或文本)文件,这些文件将具有将在运行时解析的数据。
我的目的是控制这些文件,不断更新它们并在每次更新时更改库的版本。
这可能通过货物吗? 如果是这样,我如何从我的库中访问这些文件?
我想到的一个解决方法是包含一些带有结构和/或常量的.rs
文件,例如&str
,它们将存储数据,但我觉得它很难看。
编辑:
我已经将接受的答案更改为更适合我的案例,但请查看Shepmaster的答案,因为这可能更适合您的情况。
免责声明:我在评论中提到过,但让我在这里重复一遍,因为它给了我更多的篇幅。
正如Shepmaster所说,可以使用include_bytes!
在Rust库/可执行文件中包含文本或二进制文字include_bytes!
和include_str!
宏。
但是,在你的情况下,我会避免它。 通过将内容解析延迟到运行时:
Rust承认这个问题,并提供了多种代码生成机制,旨在克服这些限制:
regex!
) build.rs
:一个独立的“Rust脚本”,在编译之前运行,其作用是生成.rs
文件 在您的情况下, build.rs
脚本听起来很合适:
解析的结果可以用不同的方式编码,从函数到静态(可能是lazy_static!
),因为build.rs
可以生成任何有效的Rust代码。
您可以在货物文档中看到如何使用build.rs
; 你会发现如何将它与Cargo集成以及如何创建文件(以及更多)。
include_bytes!
宏似乎接近你想要的。 它只给你一个字节数组的引用,所以你必须从那开始做任何解析:
static HOST_FILE: &'static [u8] = include_bytes!("/etc/hosts");
fn main() {
let host_str = std::str::from_utf8(HOST_FILE).unwrap();
println!("Hosts are:\n{}", &host_str[..42]);
}
如果您有UTF-8内容,可以使用include_str!
,正如本杰明林德利所指出的:
static HOST_FILE: &'static str = include_str!("/etc/hosts");
fn main() {
println!("Hosts are:\n{}", &HOST_FILE[..42]);
}