Section courante

A propos

Section administrative du site

include_str

 Inclure la chaîne de caractères
Rust

Syntaxe

macro_rules! include_str {
   ($file:expr $(,)?) => { ... };
}

Description

Cette macro permet d'inclure un fichier externe encodé en UTF-8 sous forme de chaîne statique (&'static str), au moment de la compilation.

Remarques

Permet d'inclure un fichier encodé en UTF-8 sous forme de chaîne.

Le fichier est localisé par rapport au fichier courant (de la même manière que les modules). Le chemin fourni est interprété de manière spécifique à la plateforme lors de la compilation. Ainsi, par exemple, une invocation avec un chemin Windows contenant des barres obliques inverses \ ne compilerait pas correctement sous Unix.

Cette macro génère une expression de type &'static str, qui correspond au contenu du fichier.

Exemples

Supposons qu'il y ait deux fichiers dans le même répertoire avec le contenu suivant :

Fichier «spanish.in» :

  1. adiós

Fichier «main.rs» :

  1. fn main() {
  2.     let my_str = include_str!("spanish.in");
  3.     assert_eq!(my_str, "adiós\n");
  4.     print!("{my_str}");
  5. }

La compilation de «main.rs» et l'exécution du binaire résultant afficheront «adiós».



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