« 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 Home
{
public static void main(String[] args)
{
/*
Now we'll display the phrase 'Amigo Is The Best' on the screen
*/
System.out.print("Amigo ");
System.out.print("Is ");
System.out.print("The ");
System.out.print("Best");
}
}« 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 Home
{
public static void main(String[] args)
{
System.out.print("Amigo ");
System.out.print("Is The "); // This is also a comment
System.out.print("Best");
}
}« 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. »
// I'm not responsible of this code. They made me write it, against my will.// Dear future me. Please forgive me.
// I can't even begin to express how sorry I am.// If I see something like this once more, I'll have a complete mental breakdown at work.// If this condition is ever satisfied,
// please inform me for a reward. Phone: xxx-xxx-xxx.// Dear maintainer:
// Once you are done trying to 'optimize' this routine,
// and have realized what a terrible mistake that was,
// please increment the following counter as a warning
// to the next guy:
// total_hours_wasted_here = 42// When I wrote this, only God and I understood what I was doing
// Now, God only knows// Sometimes I believe compiler ignores all my comments.// I dedicate all this code, all my work, to my wife, Darlene, who will
// have to support me and our three children and the dog once it gets
// released into the public.// Drunk, fix later// Magic. Do not touch« 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. »