Dies ist eine alte Version des Dokuments!
Das Wichtigste beim Programmieren ist, dass man die Kommentare nicht vergisst. Dadurch weiß man, was man sich beim Programmieren gedacht hat… kann ja schließlich etwas länger zurückliegen…
Genauso wichtig (oder gar wichtiger?) ist Folgendes:
Damit Code lesbar ist - undzwar nicht nur von einem selbst, sondern auch von Dritten - braucht man Vereinbarungen, an die sich alle halten. Diese sind für die Sprache nicht zwingend nötig, auch dem Computer ist es absolut egal, doch beschleunigen sie die Analyseprozesse für den Benutzer - nein, für alle Benutzer.
Diese Vereinbarungen (auch Regeln) nennt man Konventionen, die hier aufgezeigt werden sollen.
Zusammenhängende Blöcke (Teile) einrücken 1).
Beispiel (falsch):
public static void unlesbar(int z) { System.out.println("Hallo Welt."); if (z < 3) System.out.println("Schönes Wetter heute"); else System.out.println("Mistwetter!"); }
Beispiel (richtig):
public static void unlesbar(int z) { System.out.println("Hallo Welt."); if (z < 3) System.out.println("Schönes Wetter heute"); else System.out.println("Mistwetter!"); }
Niemals mehr als ein Befehl in eine Zeile schreiben!
Beispiel (falsch):
public static void unlesbar(int z) { System.out.println("Hallo Welt."); if (z < 3) System.out.println("Schönes Wetter heute"); else System.out.println("Mistwetter!"); System.out.println("Ciao"); }
Beispiel (richtig):
public static void unlesbar(int z) { System.out.println("Hallo Welt."); if (z < 3) System.out.println("Schönes Wetter heute"); else System.out.println("Mistwetter!"); System.out.println("Ciao"); }
Sich öffnende geschweifte Klammern stehen entweder am Ende des vorangehenden Befehls oder in einer eigenen Zeile darunter (bündig mit dem ersten Buchstaben der darüberliegenden Zeile), sich schließende Klammern (auf jeden Fall) in einer eigenen Zeile. Auch hier gilt: diese werden so eingerückt, dass sie mit dem Begiinn der Zeile übgereinstimmen, in der die zugehörige offene Klammer steht. Außer bei do-while-
Schleifen darf in dieser Zeile kein weiterer Befehl stehen.