Aggiunti commenti doxygen a include

include/jsonFile.h

@@ -3,15 +3,66 @@
 
 #include <json-c/json.h>
 
+/**
+ * @brief Verifica se un file esiste sul disco.
+ * @param fname Percorso del file da controllare.
+ * @return 1 se il file esiste ed è accessibile, 0 altrimenti.
+ */
 int existsFile(const char *fname);
+
+/**
+ * @brief Crea un nuovo file JSON inizializzandolo con un array vuoto ([]).
+ * @param fname Percorso del file da creare.
+ * @return 0 in caso di successo, -1 in caso di errore.
+ */
 int createFile(const char *fname);
+
+/**
+ * @brief Rinomina o sposta un file esistente.
+ * @param oldName Vecchio percorso/nome del file.
+ * @param newName Nuovo percorso/nome del file.
+ * @return 0 in caso di successo, -1 in caso di errore.
+ */
 int renameDataFile(const char *oldName, const char *newName);
 
+/**
+ * @brief Carica un array JSON da file. Se il file non esiste, lo crea automaticamente.
+ * @param fname Percorso del file JSON.
+ * @return Puntatore all'oggetto JSON (array) caricato, oppure NULL in caso di errore.
+ */
 json_object *loadJsonArray(const char *fname);
+
+/**
+ * @brief Salva un array JSON su file formattandolo in modo leggibile (indentato).
+ * @param fname Percorso del file di destinazione.
+ * @param arr L'oggetto JSON (array) da salvare.
+ * @return 0 in caso di successo, -1 in caso di errore.
+ */
 int saveJsonArray(const char *fname, json_object *arr);
 
+/**
+ * @brief Cerca un oggetto all'interno di un array JSON basandosi sul campo "name".
+ * @param arr L'array JSON in cui effettuare la ricerca.
+ * @param name La stringa del nome da cercare.
+ * @return Puntatore all'oggetto JSON trovato, oppure NULL se non esiste.
+ */
 json_object *findItemByName(json_object *arr, const char *name);
+
+/**
+ * @brief Rimuove un oggetto da un array JSON basandosi sul campo "name".
+ * @param arr L'array JSON da cui rimuovere l'elemento.
+ * @param name Il nome dell'elemento da eliminare.
+ * @return 0 in caso di successo, 1 se l'elemento non viene trovato, -1 in caso di errore.
+ */
 int removeItemByName(json_object *arr, const char *name);
+
+/**
+ * @brief Modifica il campo "name" di un elemento all'interno di un array JSON.
+ * @param arr L'array JSON contenente l'elemento.
+ * @param oldName Il nome attuale dell'elemento da rinominare.
+ * @param newName Il nuovo nome da assegnare.
+ * @return 0 in caso di successo, 1 se l'elemento non viene trovato, -1 in caso di errore.
+ */
 int renameItemByName(json_object *arr, const char *oldName, const char *newName);
 
-#endif
+#endif