Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Introduction

Ce livre est un travail personnel.

J’ai choisi de le publier et de le partager pour « faire ma part ».

La consultation de ce livre est « en don libre ».

Oui, vous pouvez

Si vous souhaitez m’encourager ou m’aider, vous pouvez.

  • effectuer un don.
    • Il vous suffit de me contacter, je vous communiquerai mes coordonnées bancaires.
  • me proposer un travail rémunéré salarié
    • sédentaire
    • en télétravail
    • ou dans un bureau
      • si ce n’est pas dans une grande agglomération
      • si c’est au Nord de la France (Bretagne, Normandie, Nord)
        • ou plus au Nord (l’Irlande me plairait tout particulièrement)
    • que vous soyez :
      • une entreprise ;
      • une administration ;
      • une association ou
      • un·e particulier·e.

Mes sites concernant Rust

Bonne lecture

Si vous rencontriez des erreurs, si vous souhaitiez suggérer des ajouts, ou pour toute autre démarche constructive et pertinente, n’hésitez pas à me contacter.

Merci.

Marc JESTIN,
éco-citoyen du monde
https://marcjestin.fr

Avertissement

Ce livre mdbook est à l’étape du projet de création et dans son format brouillon (draft) pour le moment.

Il peut comporter des défauts ou des erreurs et sa forme comme son contenu évoluent continuellement.

Merci de votre compréhension.

Si vous souhaitez m’apporter votre soutien ou votre concours pour ce projet, vous pouvez me contacter.

Marc JESTIN
éco-citoyen du monde
https://marcjestin.fr

Conseils de lecture

Ce livre est réalisé avec mdbook, l’outil de documentation de la communauté Rust.

Zoom d’affichage

Les sites web modernes ont la fâcheuse habitude de gaspiller de l’espace disponible et d’user nos organes visuels prématurémement.

Je vous recommande vivement de régler le zoom d’affichage pour un confort optimal.
Niveau de zoom à mon avis confortable :

  • 150 % pour un moniteur 1920 x 1080 ;
  • 180 % pour un moniteur 2560 x 1440 ;
  • 240 % pour un moniteur 3840 x 2160.

Nos yeux et nos oreilles sont précieux (et les dégâts que nous leur causons sont irréversibles) :
PRÉSERVONS-LES !

Blocs de codes

Cela permet de disposer d’un outil avec des blocs de codes Rust interactifs riches.

Tous les blocs de codes sont copiables directement ou avec le bouton « Copy to clipboard ».

Nous pouvons en plus :

  • les éditer (modifier) en nous plaçant dans le code et en supprimant ou saisissant du code ;
    • un bouton permet de remettre le code dans son état d’origine si besoin ;
  • compiler le bloc de code ;
  • lorsque c’est prévu pour, exécuter le bloc de code.

Lorsque des codes comportent des exemples d’erreurs qui ne passent pas à la compilation, ces parties sont commentées. Décommentez-les, cliquez sur le bouton pour compiler et / ou exécuter, et lisez les retours du compilateur que vous obtenez à l’écran.

Vous pouvez également tout à loisir modifier le code et faire vos propres essais.

Exemple

Exercez-vous avec ce bloc simple :

  • retirez les // à gauche de x += 1; puis
  • cliquez sur « Run this code » (flèche « play »).
  • Cliquez sur le bouton pour rétablir le code (Undo changes) puis
  • cliquez sur « Run this code » (flèche « play ») à nouveau.
fn main() {
    let x = 7;
    // x += 1;  // Erreur à la compilation
}

Nota : les boutons interactifs apparaissent

  • lorsque nous survolons le bloc de code avec notre souris ou
  • lorsque nous touchons l’écran une première fois dans la zone du bloc de code (écrans tactiles de tablettes et d’ordiphones).

Note à propos des limitations

Certains comportements ne sont pas possibles avec l’espace de jeu (playground) Rust qui est utilisé pour ce faire.

C’est la raison pour laquelle certains codes retournent des erreurs de compilation sur le site alors qu’ils sont opérationnels « en conditions réelles ». C’est très rare, mais cela arrive (codes liés aux macros procédurales en fin de livre).

Dans de tels cas, copiez-collez le code dans une machine où Rust est installé pour les tester.

Lecture à deux niveaux

Vous croiserez parfois des blocs comme celui-ci :

Compléments de lecture (avancés)

Ces blocs contiennent des compléments utiles mais qui peuvent comporter des notions complexes.

Je vous recommande de réaliser DEUX LECTURES de ce livre :

  • ignorez ces blocs pendant la première ;
  • prenez le temps de les parcourir une fois que vous maîtrisez les concepts du premier niveau de lecture.

Nota :

  • Cliquez sur le bloc « Compléments de lecture (avancés) » pour le développer.
  • Cliquez à nouveau pour le réduire.

Utilisation des outils de mdbook

Prenez le temps d’interagir avec les espaces de ce site pour savoir ce que vous pouvez faire :

  • parcours facilité
    • « tourner la page à droite » (flèche sur le côté droit) ;
    • « tourner la page à gauche » (flèche sur le côté gauche) ;
  • options de l’inteface
    • masquer la barre latérale (hamburger) ;
    • modifier le thème d’affichage (pinceau) ;
    • rechercher (loupe) ;
  • imprimer
    • vous pouvez produire une version imprimable du contenu de l’ensemble de ce livre (imprimante à droite).
      • en perdant toutefois toute l’interactivité des blocs de code…
      • que vous pouvez enregistrer au format pdf pour le parcourir hors connexion par exemple.
Recherche au clavier

La recherche est accessible via le clavier :

  • s : ouvre recherche et place le curseur dans la zone de saisie.
  • Échappement : Ferme la recherche (conserve le contenu de la saisie).
  • Flèche Bas / Flèche Haut : navigue dans les résultats proposés.
  • Entrée : Ouvre le résultat surligné.
Retirer le surlignement

Pour retirer le surlignement une fois à bon port, il suffit de retirer les paramètres en fin d’URL.

Par exemple dans

https://apprendre-rust-par-l-exemple.marcjestin.fr/conseils_de_lecture.html?highlight=ceci%20est%20un%20test#zoom-daffichage

nous retirons le ? après .html et tout ce qui suit pour ne conserver que

https://apprendre-rust-par-l-exemple.marcjestin.fr/conseils_de_lecture.html

Outils de travail

Nous pouvons travailler indifféremment avec trois outils complémentaires dans le cadre des exercices d’application que je propose dans ce livre.

Je vous invite vivement à vous familiariser avec les trois le plus vite possible, chacun ayant ses atouts propres.

  1. Utiliser l’espace de jeu (playground) directement dans ce site mdbook.
  2. Utiliser l’espace de jeu officiel de Rust, play.rust-lang.org.
  3. Utiliser notre propre environnement de travail Rust localement sur notre machine (virtuelle ou non).

En cas de besoin :

  • Je donne quelques éléments au sujet de l’espace de jeu dans le site dans la page Conseils de lecture.
  • Je vous donnerai des indications pour utiliser l’espace de jeu en ligne play.rust-lang.org dans des exercices proposés ici lorsque ce sera opportun.
  • J’indique comment installer l’environnement de travail Rust et s’en servir dans Apprendre et maîtriser Rust.

Ne vous limitez pas aux exercices que je propose ici. Une bonne manière d’apprendre, de mémoriser, et de forger notre « intelligence non superficielle » de développeurs·ses est de prendre des initiatives, de regarder sous différents angles, de mettre en pratique par différents moyens…

Playground Rust (web)

À propos

mdBook

Ce site est construit avec mdBook, l’outil de documentation externe de la communauté Rust.

Auteur

Je m’appelle Marc JESTIN.

J’ai 55 ans, je réside actuellement en FRANCE à SURGÈRES (17).

Pour en savoir plus ou pour me contacter, rendez-vous sur

https://marcjestin.fr

Mes sites au sujet de Rust