LabEx
EntrerRejoindre

Explication et annotation des commentaires en Rust

Beginner

This tutorial is from open-source community. Access the source code

Introduction

Bienvenue dans Comments. Ce laboratoire est une partie du Rust Book. Vous pouvez pratiquer vos compétences Rust dans LabEx.

Dans ce laboratoire, vous allez découvrir les commentaires en Rust et la manière dont ils sont utilisés pour fournir des explications et des annotations dans le code source pour une meilleure compréhension.

Ceci est un Guided Lab, qui fournit des instructions étape par étape pour vous aider à apprendre et à pratiquer. Suivez attentivement les instructions pour compléter chaque étape et acquérir une expérience pratique. Les données historiques montrent que c'est un laboratoire de niveau débutant avec un taux de réussite de 100%. Il a reçu un taux d'avis positifs de 100% de la part des apprenants.

Commentaires

Tous les programmeurs s'efforcent de rendre leur code facile à comprendre, mais parfois des explications supplémentaires sont nécessaires. Dans ces cas, les programmeurs laissent des commentaires dans leur code source que le compilateur ignorera, mais qui peuvent s'avérer utiles pour les personnes qui lisent le code source.

Voici un commentaire simple :

// hello, world

En Rust, le style de commentaire idoine commence un commentaire avec deux barres obliques, et le commentaire se poursuit jusqu'à la fin de la ligne. Pour les commentaires qui s'étendent sur plusieurs lignes, vous devrez inclure // sur chaque ligne, comme ceci :

// Donc, nous faisons quelque chose de compliqué ici, assez long pour que nous ayons besoin
// de plusieurs lignes de commentaires pour le faire! Phew! Espérons que ce commentaire
// expliquera ce qui se passe.

Les commentaires peuvent également être placés à la fin des lignes contenant du code :

Nom de fichier : src/main.rs

fn main() {
    let lucky_number = 7; // Je sens que j'ai de la chance aujourd'hui
}

Mais vous verrez plus souvent qu'ils sont utilisés dans ce format, avec le commentaire sur une ligne séparée au-dessus du code qu'il annote :

Nom de fichier : src/main.rs

fn main() {
    // Je sens que j'ai de la chance aujourd'hui
    let lucky_number = 7;
}

Rust a également un autre type de commentaire, les commentaires de documentation, que nous aborderons dans "Publier une boîte à outils sur Crates.io".

Sommaire

Félicitations! Vous avez terminé le laboratoire Comments. Vous pouvez pratiquer d'autres laboratoires dans LabEx pour améliorer vos compétences.