Section courante

A propos

Section administrative du site

env

 Environnement
Rust

Syntaxe

macro_rules! env {
   ($name:expr $(,)?) => { ... };
   ($name:expr, $error_msg:expr $(,)?) => { ... };
}

Description

Cette macro permet de lire la valeur d'une variable d'environnement au moment de la compilation, retournant une chaîne littérale.

Remarques

Permet d'inspecter une variable d'environnement à la compilation.

Cette macro étend la valeur de la variable d'environnement nommée à la compilation, produisant une expression de type &'static str. Utilisez plutôt std::env::var pour lire la valeur à l'exécution.

Si la variable d'environnement n'est pas définie, une erreur de compilation sera générée. Pour éviter cette erreur, utilisez plutôt la macro option_env!. Une erreur de compilation sera également générée si la variable d'environnement n'est pas une chaîne Unicode valide.

Exemples

  1. let path: &'static str = env!("PATH");
  2. println!("la variable $PATH au moment de la compilation était : {path}");

Vous pouvez personnaliser le message d'erreur en passant une chaîne comme deuxième paramètre :

  1. let doc: &'static str = env!("documentation", "Qu'est ce que c'est?!");

Si la variable d'environnement de documentation n'est pas définie, vous obtiendrez l'erreur suivante :

error: Qu'est ce que c'est?!


Dernière mise à jour : Mardi, le 5 Août 2025