Differences

This shows you the differences between two versions of the page.

--- style [2017/07/05 12:06] – created gg
+++ style [2017/07/05 12:38] (current) – gg
@@ Line 7: / Line 7: @@
 ===== Einrückungen =====
-Schauen wir uns die Funktion factorial_iterative aus dem [[functions#php|Funktionen]] Teil an
+Schauen wir uns die Funktion factorial_iterative aus dem [[functions#php|Funktionen]] Teil an. Beide Codestücke machen eigentlich das selbe.
 === Schlechter Stil ===
-gleich schlechte Lesbarkeit
+ist gleich schlechte Lesbarkeit
 <code php>
-function factorial_iterative($n) // Block wird erst nächste Zeile geöffnet. Das ist OK, wenn es einheitlich bleibt
+function f($n)       // Block wird erst nächste Zeile geöffnet. Das ist OK, wenn es einheitlich bleibt
+                     // Funktionsname ist nicht sprechend. Was macht f?
 {
-$x = 1;                          // Keine Einrückung, obwohl innerhalb des Funktionsblockes
+$x = 1;              // Keine Einrückung, obwohl innerhalb des Funktionsblockes
-  $I = $n                        // Plötzlich zwei Zeichen Einrückung, obwohl im selben Block wie die Zeile davor. $i, $n, $x => Was soll das sein? Variablennamen sind überhaupt nicht sprechend. Auch wird $n kopiert, was zu Fehlern führen kann.
+  $I = $n;           // Plötzlich zwei Zeichen Einrückung, obwohl im selben Block wie die Zeile davor.
-       while($I > 1)   {         // Wieder andere Einrückung und Block wird im Vergleich zum Funktionsblock unterschiedlich geöffnet (hier in der selben Zeile)
+                     // $i, $n, $x => Was soll das sein? Variablennamen sind überhaupt nicht sprechend.
-  $x *= $I--;                    // Einrückung wieder wie ausserhalb des while-Blockes
+                     // Auch wird $n kopiert, was zu Fehlern führen kann.
-       }                         // zufällig passt die Schliessung des while-Blockes mit der Einrückung der Öffnung zusammen
+                     // Variablenname $I startet mit Grossbuchstaben.
-   return $x;                    // Inkonsistente Einrückungen
+       while($I > 1) // Wieder andere Einrückung
+  $x *= $I--;        // Einrückung wieder wie ausserhalb des while-Blockes
+                     // Die geschwungen Klammern werden eingespart
+                     // was bei einer Instruktion pro Block OK ist und wenn die Einrückungen stimmen
+   return $x;        // Inkonsistente Einrückungen
 }
 </code>
 === Guter Stil ===
-=> bessere Lesbarkeit
+ist gleich bessere Lesbarkeit
-function factorial_iterative($n) { // Keine Einrückung
+<code php>
-    $result = 1;                   // Neuer Block => Einrückung um vier Leertasten. Variablenname ist sprechend
+function factorial_iterative($number) { // Keine Einrückung. Variablenname number ist sprechend
+    $result = 1;                   // Neuer Block => Einrückung um vier Leertasten. Variablenname result ist sprechend
-    while($n > 1) {                // wieder vier Zeichen
+    while($number > 1) {           // wieder vier Zeichen. Blocköffnung ist ident zur Blocköffnung der Funktion
-        $result *= $n;             // Ein neuer Block startet => acht Zeichen Einrückung
+        $result *= $number;        // Ein neuer Block startet => acht Zeichen Einrückung
-        $n--;                      // Wir sind im selben Block => acht Zeichen
+        $number--;                 // Wir sind im selben Block => acht Zeichen
     }                              // Der while Block wird geschlossen => vier Zeichen
     return $result;                // wieder
 }                                  // Der Block der Funktion wird geschlossen => kein Zeichen
+</code>