When talking about imports, the word prelude is used every so often by the rustaceans.
What is this prelude they talk about?
How does it affect my Rust programs?
In Rust, in order to use a symbol, you must either:
use
directive: use std::mem;
std::mem::replace
however, some very few symbols can be used without such actions: Option
or Copy
for example!
This is due to the Rust prelude.
A number of traits, types and functions were judged to be so frequently used that it made sense not to require that their use required explicitly importing the necessary symbols each and every time. This is achieved thanks to two implicit actions taken by the compiler:
extern crate std;
use std::prelude::v1::*;
(for now)std::prelude::v1
is just a regular module which re-exports those frequently used symbols using the pub use ...
syntax. Its exact content can be found here.
A number of other libraries, or even sub-components of the standard library also define a prelude
module that you may import with the same glob import syntax: use xxx::prelude::*;
. Unlike the std::prelude
however those are not special-cased by the compiler and therefore require explicit importing.
The compiler is agnostic to the exact content of the prelude, therefore if one was to replace the std
crate with their own (for example, in embedded development) then one would decide what goes into their std::prelude::v1
module.
vec!
, panic!
, ... but could not find where those came from. I'll remove it.
Commented
Apr 3, 2016 at 13:26
println!
macro does not come from std::prelude
?
Commented
May 8, 2016 at 2:55
println
)
Commented
May 8, 2016 at 11:48
use anchor_lang::prelude::*
for ages and wondering where the name came from.
Commented
Jan 25 at 16:27