emufs/indices.h

   1
   2 #ifndef _INDICES_H_
   3 #define _INDICES_H_
   4
   5 #include <stdlib.h>
   6 #include <string.h>
   7
   8 #include "common.h"
   9
  10 #define STRUCT_OFFSET(x, y) ((int)(&(x->y))-(int)(x))
  11
  12 typedef struct _emu_fs_t EMUFS;
  13
  14 /** Dato guardado junto con la clave */
  15 typedef struct _reg_def_ {
  16         long id;
  17         long bloque;
  18 } INDICE_DATO;
  19
  20 /** Tipos de Indices conocidos */
  21 typedef enum {
  22         IND_B, /**< Utilizacion de Arboles B */
  23         IND_B_ASC, /**< Utilizacion de Arboles B* */
  24         IND_B_PLUS
  25 } INDICE_TIPO;
  26
  27 typedef enum {
  28         IND_PRIMARIO,
  29         IND_SELECCION,
  30         IND_EXAHUSTIVO
  31 } INDICE_FUNCION;
  32
  33 /** Tipos de datos soportados para las claves */
  34 typedef enum {
  35         IDX_FLOAT,
  36         IDX_INT,
  37         IDX_STRING
  38 } INDICE_TIPO_DATO;
  39
  40 /** Clave de indice
  41  *
  42  *  Si el tipo de clave es IDX_STRING se utiliza
  43  *  i_clave y representa el ID en un EMUFS Tipo2
  44  *  sin indices donde esta el texto de la clave
  45  */
  46 typedef union _data_ {
  47         float f_clave;
  48         int i_clave;
  49 } CLAVE;
  50
  51 /** Estructura utilizada para querys del B_PLUS */
  52 typedef struct _index_dat_ {
  53         unsigned long num_bloque;
  54         CLAVE clave;
  55 } INDEX_DAT;
  56
  57 /** Bucket de keys en bloque para B+ */
  58 typedef struct _keybucket_ {
  59         int cant_keys;
  60         int current_key;
  61         CLAVE *claves;
  62 } B_PLUS_KEYBUCKET;
  63
  64 /** Manejo de Indices independiente */
  65 typedef struct _indices_h_ {
  66         INDICE_TIPO tipo;             /**< Tipo de indice */
  67         INDICE_TIPO_DATO tipo_dato;   /**< Tipo de dato a manejar */
  68         INDICE_FUNCION funcion;       /**< Funcion del indice */
  69         int offset;                   /**< Offset desde el inicio del dato hasta el lugar donde esta la clave */
  70         int str_offset;               /**< Si el campo es de string, aca va el numero de \0 que me tengo que saltar */
  71         unsigned int tam_bloque;      /**< Tamaño del bloque (nodo). Deber set multiplo de 512! */
  72
  73         /******NICO********/
  74         unsigned int size_claves;
  75         unsigned int size_hijos;
  76         B_PLUS_KEYBUCKET *keybucket; /**< Usado por B+ para implementar el obtener_sig_clave. Posee keys de un bloque */
  77         /******NICO********/
  78         /** Agrega la clave k de posicion location en el
  79          * indice de forma ordenada
  80          */
  81         int (*agregar_entrada)(struct _indices_h_ *idx, CLAVE k, INDICE_DATO dato);
  82         /** Borra del indice la clave k . Si el indice en multiple en dato
  83          * se le debe pasar cual de los datos borrar. */
  84         int (*borrar_entrada)(struct _indices_h_ *idx, CLAVE k, INDICE_DATO dato);
  85         /** Determina si existe la clave k retornando su posicion o -1
  86          * en caso fallido
  87          */
  88         INDICE_DATO (*existe_entrada)(struct _indices_h_ *idx, CLAVE k);
  89
  90         INDICE_DATO *(*buscar_entradas)(struct _indices_h_ *idx, CLAVE k, int *cant);
  91
  92         CLAVE (*obtener_menor_clave)(struct _indices_h_ *idx);
  93         CLAVE (*obtener_mayor_clave)(struct _indices_h_ *idx);
  94         CLAVE (*obtener_sig_clave)(struct _indices_h_ *idx, CLAVE k);
  95         CLAVE (*obtener_sig_clave_isam)(struct _emu_fs_t* emu, CLAVE k);
  96
  97         char *nombre;   /**< Nombre único de busqueda del indice */
  98         char *filename; /**< nombre del archivo de indice */
  99
 100         EMUFS *emu_string; /**< EMUFS Tipo2 donde se guardan las claves de tipo string */
 101
 102         /** EMUFS Donde se guardan INDICE_DATO de multiples claves con repeticion
 103          *
 104          *  La forma de guardar es la siguiente :
 105          *  \code
 106          *  +------+---------//---------+
 107          *  | CANT |    DATA \\         |
 108          *  +------+---------//---------+
 109          *  \endcode
 110          *
 111          *  Donde CANT es un entero (int) y DATA es un array
 112          *  de INDICE_DATO que apunta al archivo de datos
 113          *  pripiamente dicho
 114          */
 115         EMUFS *emu_mult;
 116
 117         /*EMUFS_Estadisticas (*obtener_estadisticas)(struct _indices_h_ *);*/
 118         struct _indices_h_ *sig; /**< Siguiente indice */
 119 } INDICE;
 120
 121 /** Crea un nuevo indice
 122  *
 123  *  \param emu EMUFS a quien pertenece
 124  *  \param nombre Nombre del indice
 125  *  \param tipo Tipo de indice
 126  *  \param tipo_dato Tipo de dato de la clave
 127  *  \param offset Desplazamiento de la clave dentro del dato
 128  *  \param tam_bloque Tamaño del bloque (nodo) del arbol
 129  */
 130 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);
 131 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);
 132
 133 /** Destruye un indice
 134  *
 135  *  \todo hacer/revisar
 136  */
 137 void emufs_indice_destruir(EMUFS *emu, INDICE *i);
 138
 139 /** Agrega una clave en los indices
 140  *
 141  *  Agrega la clave en todos los indice, dependiendo de su tipo
 142  *  de dato, tipo de arboo, offset, etc
 143  *
 144  *  \param primer Primer indice a agregar
 145  *  \param data Array de datos desde donde tomar las claves
 146  *  \param ubicacion Dato a guardar asociado a la clave
 147  */
 148 void emufs_indice_agregar(INDICE *primero, char *data, INDICE_DATO dato);
 149
 150 void emufs_indice_borrar(INDICE *primero, CLAVE k, INDICE_DATO dato);
 151
 152 INDICE_DATO emufs_indice_buscar(INDICE *primero, char *data);
 153
 154 CLAVE emufs_indice_generar_clave(INDICE *idx, char *data);
 155 CLAVE emufs_indice_generar_clave_desde_valor(INDICE *idx, char *data);
 156 void emufs_indice_obtener_valor_desde_clave(INDICE *idx, CLAVE k, void *dst);
 157
 158 /** Compara 2 claves de la forma c1 < c2 */
 159 int emufs_indice_es_menor(INDICE *idx, CLAVE c1, CLAVE c2);
 160
 161 /** Compara 2 claves de la forma c1 == c2 */
 162 int emufs_indice_es_igual(INDICE *idx, CLAVE c1, CLAVE c2);
 163 int emufs_indice_es_clave_nula(INDICE *idx, CLAVE k);
 164 #endif