image-fr-FR-00-21

« Ouah, une autre humaine ! Mais celle-ci a des cheveux noirs. Que c'est excitant ! »

« Salut, moi c'est Kim. »

« Enchanté, moi c'est Amigo ! »

« Oui, je sais. C'est moi qui ai eu l'idée de ce nom. Diego n'y aurait jamais pensé tout seul. »

Les pensées d'Amigo s'agitèrent à la vitesse des électrons. « Mmm... elle est si gentille... Je me demande si elle aime les robots. »

« Revenons à la leçon. Je vais utiliser des mots simples pour t'expliquer le matériel. »

« OK. »

« Je voudrais ajouter quelques petites choses à ce que le professeur et Rishi t'ont expliqué. »

« En Java, tu peux écrire des commandes, mais tu peux également ajouter des commentaires à ces commandes directement dans le code. Le compilateur ignore complètement les commentaires. Lorsque le programme s'exécute, tous les commentaires sont ignorés. »

« Donne-moi un exemple, s'il te plaît. »

« Oh, oui bien sûr. »

public class Maison
{
    public static void main(String[] args)
    {
        /*
        Nous allons maintenant afficher la phrase « Amigo est le meilleur » à l'écran
        */
        System.out.print("Amigo ");
        System.out.print("est ");
        System.out.print("le ");
        System.out.print("meilleur");
    }
}    

« Nous avons ajouté le commentaire "Nous allons maintenant afficher la phrase..." Le début du commentaire est signalé par /* et sa fin par */. Lorsque le programme est compilé, le compilateur omet tout ce qui se trouve entre les symboles /* et */.  »

« Ça veut dire que je peux écrire tout ce que je veux ? »

« Oui. En général, les commentaires dans le code portent sur les parties du code qui sont difficiles à comprendre. Certains commentaires se composent de dizaines de chaînes, souvent écrites avant les méthodes pour décrire les nuances de fonctionnement de ces méthodes. »

« Il y a une autre façon d'ajouter des commentaires à ton code. Tu peux utiliser deux barres obliques ( // ). »

public class Maison
{
    public static void main(String[] args)
    {
        System.out.print("Amigo ");
        System.out.print("est le "); // Ceci est également un commentaire
        System.out.print("meilleur");
    }
}

« Ici, le code commençant par // et jusqu'à la fin de la ligne avec le // est considéré comme un commentaire. Autrement dit, il n'y a pas de deuxième paire de symboles utilisée pour « terminer le commentaire. »

« Au fait, certains commentaires sont vraiment intéressants. »

// Je ne suis pas responsable de ce code. Ils m'ont obligé à l'écrire à l'insu de mon plein gré.
// Cher futur moi. Pardonne-moi.
// Je ne trouve même pas les mots pour te dire à quel point je suis désolé.
// Si je vois encore un truc comme ça, je vais complètement péter un câble au travail.
// Si cette condition venait jamais à être remplie,
// merci de m'en informer pour une récompense. Téléphone : xxx-xxx-xxx.
// Cher mainteneur :
// Une fois que tu auras fini d'essayer d'« optimiser » cette routine,
// et que tu réaliseras à quel point ce fut une terrible erreur,
// incrémente le compteur d'avertissement suivant
// pour que le prochain type soit prévenu :
// total_heures_gachees_ici = 42
// Quand j'ai écrit ça, seuls Dieu et moi et comprenions ce que je faisais
// Maintenant, seul Dieu le sait
// Parfois, j'ai l'impression que le compilateur ignore tous mes commentaires.
// Je dédie tout ce code, tout mon travail, à ma femme, Charlène, qui devra 
// me soutenir financièrement, moi, nos trois enfants et le chien une fois qu'il sera 
// publié officiellement.
// Bourré, corrige plus tard
// Magique. Ne pas toucher

« Oui, certains commentaires sont très drôles. »

« Ce sera tout pour aujourd’hui. »

« Ce fut une leçon courte mais intéressante. Merci, Kim. »