Notizen bei gam.c hinzufügen

Startcode/game.c

@@ -7,18 +7,26 @@
 #define MAX_RAND_TRIES_PER_WORD 10
 #define EMPTY_CHAR 0
 
-typedef enum { HORIZONTAL, VERTICAL } Direction;
+typedef enum
+{
+    HORIZONTAL,
+    VERTICAL
+} Direction;
 
-// Versucht, ein einzelnes Wort an einer zufälligen Position zu platzieren; gibt 1 bei Erfolg zurück, sonst 0
+// Versucht, ein einzelnes Wort an einer zufaelligen Position zu platzieren; gibt 1 bei Erfolg zurück, sonst 0
 static int placeWord(char salad[MAX_SEARCH_FIELD_LEN][MAX_SEARCH_FIELD_LEN], unsigned int searchFieldLen, const char *word)
 {
+    // Laenge des Wortes bestimmen
     unsigned int wordLen = strlen(word);
 
+    // Leere Wörter oder Wörter die zu lang sind, werden uebersprungen (es wird 0 ausgegeben)
     if (wordLen == 0 || wordLen > searchFieldLen)
         return 0;
 
+    // Wenn das Spielfeld voll ist, soll es nicht endlos weiterprobiert werden
     for (int try = 0; try < MAX_RAND_TRIES_PER_WORD; try++)
     {
+        // Es wird zufällig entschieden, ob das Wort waagerecht oder senkrecht geschrieben wird
         Direction dir = rand() % 2;
         unsigned int row, col;
 
@@ -34,8 +42,9 @@ static int placeWord(char salad[MAX_SEARCH_FIELD_LEN][MAX_SEARCH_FIELD_LEN], uns
             col = rand() % searchFieldLen;
         }
 
-        // Prüfen, ob alle benötigten Felder noch leer sind
+        // Pruefen, ob alle benoetigten Felder noch leer sind
         int isFree = 1;
+
         for (unsigned int i = 0; i < wordLen; i++)
         {
             if (dir == HORIZONTAL && salad[row][col + i] != EMPTY_CHAR)
@@ -46,6 +55,7 @@ static int placeWord(char salad[MAX_SEARCH_FIELD_LEN][MAX_SEARCH_FIELD_LEN], uns
 
         if (isFree)
         {
+            // Erst nach Pruefung das Wort vollständig eintragen
             for (unsigned int i = 0; i < wordLen; i++)
             {
                 if (dir == HORIZONTAL)
@@ -57,14 +67,15 @@ static int placeWord(char salad[MAX_SEARCH_FIELD_LEN][MAX_SEARCH_FIELD_LEN], uns
         }
     }
 
+    // Wenn jeder Versuch fehlgeschloagen ist, wird 0 zurueckgegeben
     return 0;
 }
 
-// Erstellt den Wortsalat: platziert die Wörter zufällig und füllt leere Felder auf
+// Erstellt den Wortsalat: platziert die Woerter zufaellig und fuellt leere Felder auf
 int createWordSalad(char salad[MAX_SEARCH_FIELD_LEN][MAX_SEARCH_FIELD_LEN], unsigned int searchFieldLen, const char words[][MAX_WORD_LEN], unsigned int wordCount)
 {
-    static int isSeeded = 0;
-    int placedWords = 0;
+    static int isSeeded = 0; // Einmaliger Beginn des Zufallsgenerators gefordert
+    int placedWords = 0;     // Anzahl erfogreicher Woerter
 
     // Zufallszahlengenerator nur einmal initialisieren
     if (!isSeeded)
@@ -78,15 +89,16 @@ int createWordSalad(char salad[MAX_SEARCH_FIELD_LEN][MAX_SEARCH_FIELD_LEN], unsi
         for (unsigned int j = 0; j < searchFieldLen; j++)
             salad[i][j] = EMPTY_CHAR;
 
-    // Wörter platzieren
+    // Woerter platzieren, erfolgreiche Woerter zaehlen
     for (unsigned int i = 0; i < wordCount; i++)
         placedWords += placeWord(salad, searchFieldLen, words[i]);
 
-    // Restliche Felder mit zufälligen Buchstaben füllen
+    // Restliche (leere) Felder mit zufaelligen Buchstaben fuellen
     for (unsigned int i = 0; i < searchFieldLen; i++)
         for (unsigned int j = 0; j < searchFieldLen; j++)
             if (salad[i][j] == EMPTY_CHAR)
                 salad[i][j] = 'A' + rand() % 26;
 
+    // Anzahl der erfolgreichen Woerter zurueckgeben
     return placedWords;
 }