crate |
Caisse |
|---|---|
| Rust | |
Syntaxe
| crate::chemin::vers::élément |
Paramètres
| Nom | Description |
|---|---|
| chemin::vers::élément | Ce paramètre permet de référencer un élément (module, fonction, type, constante,...) à partir de la racine de la crate courante. |
Description
Ce mot réservé permet de lier un crate externe ou une macro variable représentant la crate dans laquelle la macro est définie.
Remarques
Permet d'indiquer un binaire ou une bibliothèque Rust.
Le mot clef crate est principalement utilisé dans les déclarations de crates externes, permettant de spécifier une dépendance à une crate externe à celle dans laquelle elle est déclarée. Les crates sont l'unité de compilation fondamentale du code Rust et peuvent être considérées comme des bibliothèques ou des projets.
- extern crate rand;
- extern crate my_crate as thing;
- extern crate std; // implicitement ajouté à la racine de chaque projet Rust
Le mot clef «as» permet de modifier le nom de la caisse dans votre projet. Si le nom d'une caisse comporte un tiret, elle est implicitement importée et remplacée par un trait de soulignement.
«crate» peut également être utilisé avec «pub» pour indiquer que l'élément auquel il est rattaché est public uniquement pour les autres membres de la même caisse.
- pub(crate) use std::io::Error as IoError;
- pub(crate) enum CoolMarkerType { }
- pub struct PublicThing {
- pub(crate) semi_secret_thing: bool,
- }
crate est également utilisé pour représenter le chemin absolu d'un module, où crate désigne la racine de la caisse courante. Par exemple, crate::foo::bar désigne le nom bar du module foo, quel que soit l'emplacement de la même caisse.