X-Git-Url: https://git.llucax.com/z.facultad/75.06/emufs.git/blobdiff_plain/0a8c25d48c0fa1602556582885e33426cb2e05fa..44e165a63ae1dc81b5dfa887c76df50f8abcd8ef:/emufs/idx.h?ds=sidebyside diff --git a/emufs/idx.h b/emufs/idx.h index 7999f06..4d40895 100644 --- a/emufs/idx.h +++ b/emufs/idx.h @@ -44,21 +44,56 @@ #define EMUFS_IDX_EXT ".idx" +/** Estructura que define el archivo .idx + *\param id_reg ID del registro. + *\param location Numero de bloque. + */ typedef struct emufs_idx_t { - int block; - long int id_reg; + EMUFS_REG_ID id_reg; + EMUFS_BLOCK_ID location; } EMUFS_IDX; + +/** Abre el archivo */ FILE* emufs_idx_abrir(EMUFS*, const char*); +/** Crea el archivo vacio */ int emufs_idx_crear(EMUFS*); -EMUFS_REG_ID emufs_idx_buscar_mayor_id(EMUFS *); +/** Devuelve el mayor id libre para un nuevo registro */ +EMUFS_REG_ID emufs_idx_buscar_mayor_id_libre(EMUFS*, int*); + +/** Busca el bloque al que pertenece el id \c reg_id */ +EMUFS_BLOCK_ID emufs_idx_buscar_registro(EMUFS*, EMUFS_REG_ID reg_id); + +/** Agrega un nuevo registro EMUFS_IDX al archivo .idx si no existe + * el id \c reg_id, si existe coloca en el campo location el valor + * indicado en \c block_id + */ +int emufs_idx_agregar(EMUFS*, EMUFS_BLOCK_ID block_id, EMUFS_REG_ID reg_id); + +/** Coloca el valor -1 en el campo location, del registro que contenga el + * id \c reg_id, para indicar que ese id no existe */ +int emufs_idx_borrar(EMUFS*, EMUFS_REG_ID reg_id); + +/** Retorna un array con los Ids validos del archivo IDX + * + * EL ARRAY DEBE SER LIBERADO! + * \param emu EMUFS + * \param cant Puntero donde guardar la cantidad de items + */ +EMUFS_REG_ID *emufs_idx_get(EMUFS *emu, EMUFS_REG_ID *cant); + +/** Devuelve un nuevo id valido para un nuevo registro */ +EMUFS_REG_ID emufs_idx_get_new_id(EMUFS*, int*); -EMUFS_BLOCK_ID emufs_idx_buscar_registro(EMUFS *, EMUFS_REG_ID); +/** Retorna 0 si \c ID existe */ +int emufs_idx_existe_id(EMUFS *emu, int ID); -int emufs_idx_agregar(EMUFS *, EMUFS_BLOCK_ID, EMUFS_REG_ID); +/** Acutaliza el valor de \c bloque segun \c ID */ +int emufs_idx_actualizar(EMUFS *emu, int ID, EMUFS_BLOCK_ID bloque); -int emufs_idx_borrar(EMUFS *emu, EMUFS_REG_ID); +/** Obtiene el tamaño del archivo de índice. */ +long emufs_idx_get_file_size(EMUFS*, int*); #endif /* _EMUFS_IDX_H */