X-Git-Url: https://git.llucax.com/z.facultad/75.06/emufs.git/blobdiff_plain/9a841b8e8f01dfad72596cf98e76812bf02d9cdd..baf79a90e2addd39a342fcb910bbfdb6ee6623cf:/emufs/idx.h?ds=inline diff --git a/emufs/idx.h b/emufs/idx.h index 605bf1b..4d40895 100644 --- a/emufs/idx.h +++ b/emufs/idx.h @@ -44,27 +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 { 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*); +/** Devuelve el mayor id libre para un nuevo registro */ EMUFS_REG_ID emufs_idx_buscar_mayor_id_libre(EMUFS*, int*); -EMUFS_BLOCK_ID emufs_idx_buscar_registro(EMUFS*, EMUFS_REG_ID); - -int emufs_idx_agregar(EMUFS*, EMUFS_BLOCK_ID, EMUFS_REG_ID); +/** Busca el bloque al que pertenece el id \c reg_id */ +EMUFS_BLOCK_ID emufs_idx_buscar_registro(EMUFS*, EMUFS_REG_ID reg_id); -int emufs_idx_borrar(EMUFS*, EMUFS_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); -EMUFS_REG_ID emufs_idx_get_count(EMUFS *); +/** 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); -EMUFS_REG_ID emufs_idx_get_id_at(EMUFS *, long pos); +/** 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*); +/** Retorna 0 si \c ID existe */ +int emufs_idx_existe_id(EMUFS *emu, int ID); + +/** Acutaliza el valor de \c bloque segun \c ID */ +int emufs_idx_actualizar(EMUFS *emu, int ID, EMUFS_BLOCK_ID bloque); + +/** Obtiene el tamaño del archivo de índice. */ +long emufs_idx_get_file_size(EMUFS*, int*); + #endif /* _EMUFS_IDX_H */