Le but de ce TP est d'apprendre à utiliser

• Utiliser des fichers
• Le type Result
• Utiliser des descripterus de fichers

Pour travailler avec des fichiers on doit utiliser le module fs qui se trouve dans la bilbiotheque standard de Rust.

use std::fs;

Le struct File renvoie un objet donnant accès à un fichier ouvert sur le système de fichiers.

Une instance d'un fichier peut être lue et/ou écrite en fonction des options avec lesquelles elle a été ouverte. Les fichiers implémentent également Seek pour modifier le curseur logique que le fichier contient en interne.

Les fichiers sont automatiquement fermés lorsqu'ils sortent de scope. Les erreurs détectées à la fermeture sont ignorées par l'implémentation de Drop. Utilisez la méthode sync_all si ces erreurs doivent être gérées manuellement.

La fonction File::create() ouvre un fichier en mode read-only.

Cette fonction créera un fichier s'il n'existe pas et le tronquera s'il existe.

Selon la plate-forme, cette fonction peut échouer si le chemin d'accès complet au répertoire n'existe pas.

use std::fs::File;
 
fn main() -> std::io::Result<()> {
    let mut f = File::create("foo.txt")?;
    Ok(())
}

La fonction File::open() tente d'ouvrir un fichier en mode read-only.

use std::fs::File;
 
fn main() -> std::io::Result<()> {
    let mut f = File::open("foo.txt")?;
    Ok(())
}

Pour lire à partir d'un fichier, nous utilisons la fonction read_to_string(file_path):

use std::fs;
use std::env;
 
fn main() {
 
    println!("In file {}", file_path);
 
    let contents = fs::read_to_string(file_path)
        .expect("Should have been able to read the file");
 
    println!("With text:\n{contents}");
}

Cette struct renvoie informations de métadonnées sur un fichier.

Ce module contient des méthodes pour récupérer des informations sur un fichier telles que le type de fichier, les autorisations, etc.

Le but de ces types de Result est de coder les informations de gestion des erreurs. Result est c'est une énumération avec les variantes:

• La variante Ok qui indique que l'opération a réussi, et à l'intérieur de Ok se trouve la valeur générée avec succès
• La variante Err qui signifie que l'opération a échoué, et Err contient des informations sur comment ou pourquoi l'opération a échoué.

enum Result<T, E> {
   Ok(T),
   Err(E),
}

T représente le type de la valeur qui sera renvoyée en cas de réussite dans la variante Ok, et E représente le type d'erreur qui sera renvoyée en cas d'échec dans la variante Err.

Étant donné que Result a ces paramètres de type génériques, nous pouvons utiliser le type Result et les fonctions qui y sont définies dans de nombreuses situations différentes où la valeur réussie et la valeur d'erreur que nous voulons renvoyer peuvent différer.

• Recoverable Errors with Result en, fr-
• Reading a File en, fr
• std::fs functions https://doc.rust-lang.org/stable/std/fs/index.html
• File https://doc.rust-lang.org/stable/std/fs/struct.File.html
• Metadata https://doc.rust-lang.org/stable/std/fs/struct.Metadata.html
• MetadataExt https://doc.rust-lang.org/stable/std/fs/struct.Metadata.html#impl-MetadataExt
• Permissions https://doc.rust-lang.org/stable/std/fs/struct.Permissions.html
• PermissionsExt https://doc.rust-lang.org/stable/std/os/unix/fs/trait.PermissionsExt.html
• Linux permissions https://en.wikipedia.org/wiki/Chmod

1. Écrivez un programme qui reçoit en paramètre un dossier. Imprimer le contenu du dossier.
2. Écrivez un programme qui reçoit en argument de ligne de commande un fichier et une tâche. Mettre en œuvre les tâches :
   1. print - imprime le contenu du fichier
   2. size - imprime la taille du fichier
   3. owner - affiche l'utilisateur (uid) et le groupe (gid) du fichier
   4. mode_number - affiche le mode (permissions) en numero du fichier
   5. type - le type de fichier: dossier, fichier, lien, périphérique caractère, périphérique bloc, …
   6. mode_text - affiche le mode (permissions) en text (rwx…) du fichier
   7. print_buffer - imprimez le contenu du fichier à l'aide des fonctions open et read.

Solutions