X-Git-Url: https://git.llucax.com/z.facultad/75.06/emufs.git/blobdiff_plain/3fedb806fdecbcb4508773321011e96ab27903e9..baf79a90e2addd39a342fcb910bbfdb6ee6623cf:/emufs/idx.h?ds=inline diff --git a/emufs/idx.h b/emufs/idx.h index 1ceccc9..4d40895 100644 --- a/emufs/idx.h +++ b/emufs/idx.h @@ -44,22 +44,37 @@ #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); +/** 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_agregar(EMUFS*, EMUFS_BLOCK_ID, 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); -int emufs_idx_borrar(EMUFS*, EMUFS_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 * @@ -69,10 +84,16 @@ int emufs_idx_borrar(EMUFS*, EMUFS_REG_ID); */ 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); -int emufs_idx_actualizar(EMUFS *emu, int ID, int bloque); +/** 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 */