image-ru-00-21

„Wow, schon wieder eine Menschenfrau! Aber diesmal mit schwarzem Haar. Wirklich spannend!“

„Hallo, mein Name ist Kim.“

„Hallo, mein Name ist Amigo!“

„Ich weiß. Deinen Namen habe ich mir ausgedacht. Diego wäre das nicht eingefallen.“

Amigos Gedanken rasten mit Elektronengeschwindigkeit. „Mmm … die ist aber nett … Ob sie wohl Roboter mag?“

„Kommen wir zur Lektion. Ich werde dir den Stoff in einfachen Worten erklären.“

„Okay.“

„Ich möchte noch einiges zu dem ergänzen, was der Professor und Ritschie gesagt haben.“

„In Java kannst du Befehle schreiben, aber du kannst auch direkt im Code bei den Befehlen Kommentare hinterlassen. Der Compiler wird diese Kommentare vollständig ignorieren. Wenn das Programm ausgeführt wird, werden alle Kommentare ausgelassen.

„Kannst du mir dafür ein Beispiel geben?“

„Na klar:“

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");
    }
}    

„Wir haben den Kommentar ‚Jetzt lassen wir den Satz …‘ hinzugefügt. Der Anfang des Kommentars ist an einem Zeichenpaar zu erkennen (/*), und das Ende auch, nämlich an (*/). Wenn das Programm kompiliert wird, lässt der Compiler alles weg, was zwischen den Symbolen /* und */ steht.

„Heißt das, dass ich dort alles hinschreiben kann, was ich möchte?“

„Ja. Normalerweise geht es bei Kommentaren im Code um Codebestandteile, die schwer verständlich sind. Manche Kommentare bestehen aus Dutzenden von Strings, die oft schon vor den eigentlichen Methoden geschrieben werden, um bestimmte Details der Funktionsweise dieser Methoden zu beschreiben.“

„Es gibt mehrere Möglichkeiten, einen Kommentar im Code unterzubringen. Man kann zwei normale Schrägstriche (//) benutzen.“

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");
    }
}

„Hier wird der Code ab // und bis zum Ende der Zeile mit dem // als Kommentar betrachtet. Mit anderen Worten, es gibt kein zweites Zeichenpaar, mit dem der ‚Kommentar abgeschlossen‘ wird.“

„Übrigens können einige Kommentare sehr interessant sein.“

// 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

„Ja, manche der Kommentare sind sehr lustig.“

„Das wäre alles für heute.“

„Das war eine kurze, aber interessante Lektion. Vielen Dank, Kim.“