X-Git-Url: https://git.llucax.com/z.facultad/75.06/emufs.git/blobdiff_plain/51ed490d1caf11b5645abef4dd473e5a5b520856..6b529d1ba8dc30ef7437503567b537568391dc27:/emufs/indices.h?ds=sidebyside diff --git a/emufs/indices.h b/emufs/indices.h index e69de29..ff2e41e 100644 --- a/emufs/indices.h +++ b/emufs/indices.h @@ -0,0 +1,164 @@ + +#ifndef _INDICES_H_ +#define _INDICES_H_ + +#include +#include + +#include "common.h" + +#define STRUCT_OFFSET(x, y) ((int)(&(x->y))-(int)(x)) + +typedef struct _emu_fs_t EMUFS; + +/** Dato guardado junto con la clave */ +typedef struct _reg_def_ { + long id; + long bloque; +} INDICE_DATO; + +/** Tipos de Indices conocidos */ +typedef enum { + IND_B, /**< Utilizacion de Arboles B */ + IND_B_ASC, /**< Utilizacion de Arboles B* */ + IND_B_PLUS +} INDICE_TIPO; + +typedef enum { + IND_PRIMARIO, + IND_SELECCION, + IND_EXAHUSTIVO +} INDICE_FUNCION; + +/** Tipos de datos soportados para las claves */ +typedef enum { + IDX_FLOAT, + IDX_INT, + IDX_STRING +} INDICE_TIPO_DATO; + +/** Clave de indice + * + * Si el tipo de clave es IDX_STRING se utiliza + * i_clave y representa el ID en un EMUFS Tipo2 + * sin indices donde esta el texto de la clave + */ +typedef union _data_ { + float f_clave; + int i_clave; +} CLAVE; + +/** Estructura utilizada para querys del B_PLUS */ +typedef struct _index_dat_ { + int num_bloque; + CLAVE clave; +} INDEX_DAT; + +/** Bucket de keys en bloque para B+ */ +typedef struct _keybucket_ { + int cant_keys; + int current_key; + CLAVE *claves; +} B_PLUS_KEYBUCKET; + +/** Manejo de Indices independiente */ +typedef struct _indices_h_ { + INDICE_TIPO tipo; /**< Tipo de indice */ + INDICE_TIPO_DATO tipo_dato; /**< Tipo de dato a manejar */ + INDICE_FUNCION funcion; /**< Funcion del indice */ + int offset; /**< Offset desde el inicio del dato hasta el lugar donde esta la clave */ + int str_offset; /**< Si el campo es de string, aca va el numero de \0 que me tengo que saltar */ + unsigned int tam_bloque; /**< Tamaño del bloque (nodo). Deber set multiplo de 512! */ + + /******NICO********/ + unsigned int size_claves; + unsigned int size_hijos; + B_PLUS_KEYBUCKET *keybucket; /**< Usado por B+ para implementar el obtener_sig_clave. Posee keys de un bloque */ + /******NICO********/ + /** Agrega la clave k de posicion location en el + * indice de forma ordenada + */ + int (*agregar_entrada)(struct _indices_h_ *idx, CLAVE k, INDICE_DATO dato); + /** Borra del indice la clave k . Si el indice en multiple en dato + * se le debe pasar cual de los datos borrar. */ + int (*borrar_entrada)(struct _indices_h_ *idx, CLAVE k, INDICE_DATO dato); + /** Determina si existe la clave k retornando su posicion o -1 + * en caso fallido + */ + INDICE_DATO (*existe_entrada)(struct _indices_h_ *idx, CLAVE k); + + INDICE_DATO *(*buscar_entradas)(struct _indices_h_ *idx, CLAVE k, int *cant); + + CLAVE (*obtener_menor_clave)(struct _indices_h_ *idx); + CLAVE (*obtener_mayor_clave)(struct _indices_h_ *idx); + CLAVE (*obtener_sig_clave)(struct _indices_h_ *idx, CLAVE k); + + char *nombre; /**< Nombre único de busqueda del indice */ + char *filename; /**< nombre del archivo de indice */ + + EMUFS *emu_string; /**< EMUFS Tipo2 donde se guardan las claves de tipo string */ + + /** EMUFS Donde se guardan INDICE_DATO de multiples claves con repeticion + * + * La forma de guardar es la siguiente : + *
+	 *  +------+---------//---------+
+	 *  | CANT |    DATA \\         |
+	 *  +------+---------//---------+
+	 *  
+ * + * Donde CANT es un entero (int) y DATA es un array + * de INDICE_DATO que apunta al archivo de datos + * pripiamente dicho + */ + EMUFS *emu_mult; + + EMUFS *padre; + /*EMUFS_Estadisticas (*obtener_estadisticas)(struct _indices_h_ *);*/ + struct _indices_h_ *sig; /**< Siguiente indice */ +} INDICE; + +/** Crea un nuevo indice + * + * \param emu EMUFS a quien pertenece + * \param nombre Nombre del indice + * \param tipo Tipo de indice + * \param tipo_dato Tipo de dato de la clave + * \param offset Desplazamiento de la clave dentro del dato + * \param tam_bloque Tamaño del bloque (nodo) del arbol + */ +INDICE *emufs_indice_crear(EMUFS *emu, char *nombre, INDICE_FUNCION funcion, INDICE_TIPO tipo, INDICE_TIPO_DATO tipo_dato, unsigned int offset, unsigned tam_bloque, int str_offset); +INDICE *emufs_indice_abrir(EMUFS *emu, char *nombre, INDICE_FUNCION funcion, INDICE_TIPO tipo, INDICE_TIPO_DATO tipo_dato, unsigned int offset, unsigned int tam_bloque, int str_offset); + +/** Destruye un indice + * + * \todo hacer/revisar + */ +void emufs_indice_destruir(EMUFS *emu, INDICE *i); + +/** Agrega una clave en los indices + * + * Agrega la clave en todos los indice, dependiendo de su tipo + * de dato, tipo de arboo, offset, etc + * + * \param primer Primer indice a agregar + * \param data Array de datos desde donde tomar las claves + * \param ubicacion Dato a guardar asociado a la clave + */ +void emufs_indice_agregar(INDICE *primero, char *data, INDICE_DATO dato); + +void emufs_indice_borrar(INDICE *primero, CLAVE k, INDICE_DATO dato); + +INDICE_DATO emufs_indice_buscar(INDICE *primero, char *data); + +CLAVE emufs_indice_generar_clave(INDICE *idx, char *data); +CLAVE emufs_indice_generar_clave_desde_valor(INDICE *idx, char *data); +void emufs_indice_obtener_valor_desde_clave(INDICE *idx, CLAVE k, void *dst); + +/** Compara 2 claves de la forma c1 < c2 */ +int emufs_indice_es_menor(INDICE *idx, CLAVE c1, CLAVE c2); + +/** Compara 2 claves de la forma c1 == c2 */ +int emufs_indice_es_igual(INDICE *idx, CLAVE c1, CLAVE c2); +int emufs_indice_es_clave_nula(INDICE *idx, CLAVE k); +#endif