Kommentare angepasst

matrix.c

@@ -6,18 +6,18 @@
 
 Matrix createMatrix(unsigned int rows, unsigned int cols)
 {
-    Matrix m = {NULL, 0, 0};
+    Matrix matrix = {NULL, 0, 0};
 
     if (rows == 0 || cols == 0)
-        return m;
+        return matrix;   //gibt leere Matrix zurück
 
-    m.buffer = (MatrixType *)calloc(rows * cols, sizeof(MatrixType));
+    matrix.buffer = (MatrixType *)calloc(rows * cols, sizeof(MatrixType));
-    if (m.buffer == NULL)
+    if (matrix.buffer == NULL) //auf verfügbaren Speicherplatz prüfen
-        return m;
+        return matrix;
 
-    m.rows = rows;
+    matrix.rows = rows;  
-    m.cols = cols;
+    matrix.cols = cols;
-    return m;
+    return matrix;   //Matrix zurückgeben
 }
 
 void clearMatrix(Matrix *matrix)
@@ -25,18 +25,18 @@ void clearMatrix(Matrix *matrix)
 
     if (matrix != NULL)
     {
-        free(matrix->buffer);
+        free(matrix->buffer);   //Speicherplatz bereinigen
-        matrix->buffer = NULL;
+        matrix->buffer = NULL;  //Werte auf 0 setzen
         matrix->rows = 0;
         matrix->cols = 0;
     }
 }
 
-void setMatrixAt(MatrixType value, Matrix matrix, unsigned int rowIdx, unsigned int colIdx)     //Problematisch Call-by-Value --> Call-by-Pointer
+void setMatrixAt(MatrixType value, Matrix matrix, unsigned int rowIdx, unsigned int colIdx) 
-// Matrix matrix zu Matrix *matrix, empfehlung
 {
-    if (rowIdx < matrix.rows && colIdx < matrix.cols && matrix.buffer != NULL)
+    if (rowIdx < matrix.rows && colIdx < matrix.cols && matrix.buffer != NULL) //Prüft ob Zugriff möglich
-        matrix.buffer[rowIdx * matrix.cols + colIdx] = value;
+        matrix.buffer[rowIdx * matrix.cols + colIdx] = value; 
+        //schreibt 2D element in 1D Liste: Element_Reihe*Matrix_Spalten + Element_Spalte
 }
 
 MatrixType getMatrixAt(const Matrix matrix, unsigned int rowIdx, unsigned int colIdx)
@@ -47,11 +47,10 @@ MatrixType getMatrixAt(const Matrix matrix, unsigned int rowIdx, unsigned int co
 }
 
 // TODO: Funktionen implementieren
-
 Matrix add(const Matrix matrix1, const Matrix matrix2)
 {
-    //  check, equal rows
+    //  immer Probe, gleiche Zeilen der Matrizen
-    // "Elementweise Addition": test, if two matrix has exact size
+    // "Elementweise Addition": Probe, ob matrix gleiche größe hat
     if (matrix1.rows == matrix2.rows && matrix1.cols == matrix2.cols)
     {
         Matrix result_add = createMatrix(matrix1.rows, matrix1.cols);
@@ -66,7 +65,7 @@ Matrix add(const Matrix matrix1, const Matrix matrix2)
         }
         return result_add;
     }
-    // "Broadcasting": matrix1 has 1 collum
+    // "Broadcasting": matrix1 hat 1 Spalte
     if (matrix1.rows == matrix2.rows && matrix1.cols == 1)
     {
         Matrix result_add = createMatrix(matrix1.rows, matrix2.cols);
@@ -80,7 +79,7 @@ Matrix add(const Matrix matrix1, const Matrix matrix2)
         }
         return result_add;
     }
-    // "Broadcasting": matrix2 has 1 collum
+    // "Broadcasting": matrix2 hat 1 Spalte
     if (matrix1.rows == matrix2.rows && matrix2.cols == 1)
     {
         Matrix result_add = createMatrix(matrix1.rows, matrix1.cols);
@@ -100,7 +99,6 @@ Matrix add(const Matrix matrix1, const Matrix matrix2)
 
 Matrix multiply(const Matrix matrix1, const Matrix matrix2)
 {
-    // Needed: rows/Zeilen, collums/Spalten
     MatrixType buffer_add;
     
     if (!matrix1.buffer || !matrix2.buffer) // Probe ob leere Matrize vorliegt 
@@ -117,10 +115,8 @@ Matrix multiply(const Matrix matrix1, const Matrix matrix2)
             buffer_add = 0;
             for (unsigned int skalar = 0; skalar < matrix1.cols; skalar++)
             {
-                // buffer_add += matrix1[index][skalar]*matrix2[skalar][shift];
                 buffer_add += getMatrixAt(matrix1, index, skalar) * getMatrixAt(matrix2, skalar, shift);
             }
-            // matrix_mul[index][shift] = buffer_add;
             setMatrixAt(buffer_add, result_mul, index, shift);
         }
     }