revisió de capçaleres

source/manage_hiscore_table.h

@@ -1,17 +1,17 @@
 #pragma once
 
-#include <string> // Para string
-#include <vector> // Para vector
+#include <string> // Para std::string
+#include <vector> // Para std::vector
 
 /*
-    Esta clase sirve para añadir elementos hiScoreEntry_r a un vector (tabla), de manera
+    Esta clase sirve para añadir elementos HiScoreEntry a un vector (tabla), de manera
     que la tabla siempre está ordenada.
 
     Además tiene un método para dejar la tabla con sus valores iniciales y métodos para
-    leer y escribir la tabla a un fichero
+    leer y escribir la tabla a un fichero.
 */
 
-// Estructura para las entradas de la tabla de recirds
+// --- Estructura para las entradas de la tabla de records ---
 struct HiScoreEntry
 {
     std::string name;         // Nombre
@@ -23,16 +23,9 @@ struct HiScoreEntry
         : name(n.substr(0, 6)), score(s), one_credit_complete(occ) {}
 };
 
-// Clase ManageHiScoreTable
+// --- Clase ManageHiScoreTable ---
 class ManageHiScoreTable
 {
-private:
-    // Variables
-    std::vector<HiScoreEntry> &table_; // Tabla con los records
-
-    // Ordena la tabla
-    void sort();
-
 public:
     // Constructor
     explicit ManageHiScoreTable(std::vector<HiScoreEntry> &table)
@@ -44,7 +37,7 @@ public:
     // Resetea la tabla a los valores por defecto
     void clear();
 
-    // Añade un elemento a la tabla
+    // Añade un elemento a la tabla (devuelve la posición en la que se inserta)
     int add(const HiScoreEntry &entry);
 
     // Carga la tabla con los datos de un fichero
@@ -52,4 +45,11 @@ public:
 
     // Guarda la tabla en un fichero
     bool saveToFile(const std::string &file_path);
+
+private:
+    // Referencia a la tabla con los records
+    std::vector<HiScoreEntry> &table_;
+
+    // Ordena la tabla internamente
+    void sort();
 };