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 typedef struct _reg_def_ {
  15         unsigned long id;
  16         unsigned long bloque;
  17 } INDICE_DATO;
  18
  19 /** Tipos de Indices conocidos */
  20 typedef enum {
  21         IND_B, /**< Utilizacion de Arboles B */
  22         IND_B_ASC /**< Utilizacion de Arboles B* */
  23 } INDICE_TIPO;
  24
  25 typedef enum {
  26         IND_PRIMARIO,
  27         IND_SELECCION,
  28         IND_EXAHUSTIVO
  29 } INDICE_FUNCION;
  30
  31 /** Tipos de datos soportados para las claves */
  32 typedef enum {
  33         IDX_FLOAT,
  34         IDX_INT
  35 } INDICE_TIPO_DATO;
  36
  37 /** Clave de indice */
  38 typedef union _data_ {
  39         float f_clave;
  40         int i_clave;
  41 } CLAVE;
  42
  43 /** Manejo de Indices independiente */
  44 typedef struct _indices_h_ {
  45         INDICE_TIPO tipo;             /**< Tipo de indice */
  46         INDICE_TIPO_DATO tipo_dato;   /**< Tipo de dato a manejar */
  47         INDICE_FUNCION funcion;       /**< Funcion del indice */
  48         int offset;                   /**< Offset desde el inicio del dato hasta el lugar donde esta la clave */
  49         unsigned int tam_bloque;      /**< Tamaño del bloque (nodo). Deber set multiplo de 512! */
  50
  51         /** Agrega la clave k de posicion location en el
  52          * indice de forma ordenada
  53          */
  54         int (*agregar_entrada)(struct _indices_h_ *idx, CLAVE k, INDICE_DATO dato);
  55         /** Borra del indice la clave k */
  56         int (*borrar_entrada)(struct _indices_h_ *idx, CLAVE k);
  57         /** Determina si existe la clave k retornando su posicion o -1
  58          * en caso fallido
  59          */
  60         INDICE_DATO (*existe_entrada)(struct _indices_h_ *idx, CLAVE k);
  61
  62         INDICE_DATO *(*buscar_entradas)(struct _indices_h_ *idx, CLAVE k, int *cant);
  63
  64         char *nombre;   /**< Nombre único de busqueda del indice */
  65         char *filename; /**< nombre del archivo de indice */
  66
  67         struct _indices_h_ *sig; /**< Siguiente indice */
  68 } INDICE;
  69
  70 /** Crea un nuevo indice
  71  *
  72  *  \param emu EMUFS a quien pertenece
  73  *  \param nombre Nombre del indice
  74  *  \param tipo Tipo de indice
  75  *  \param tipo_dato Tipo de dato de la clave
  76  *  \param offset Desplazamiento de la clave dentro del dato
  77  *  \param tam_bloque Tamaño del bloque (nodo) del arbol
  78  */
  79 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);
  80
  81 /** Destruye un indice
  82  *
  83  *  \todo hacer/revisar
  84  */
  85 void emufs_indice_destruir(EMUFS *emu, INDICE *i);
  86
  87 /** Agrega una clave en los indices
  88  *
  89  *  Agrega la clave en todos los indice, dependiendo de su tipo
  90  *  de dato, tipo de arboo, offset, etc
  91  *
  92  *  \param primer Primer indice a agregar
  93  *  \param data Array de datos desde donde tomar las claves
  94  *  \param ubicacion Dato a guardar asociado a la clave
  95  */
  96 void emufs_indice_agregar(INDICE *primero, char *data, INDICE_DATO dato);
  97
  98 INDICE_DATO emufs_indice_buscar(INDICE *primero, char *data);
  99
 100 CLAVE emufs_indice_generar_clave(INDICE *idx, char *data);
 101 CLAVE emufs_indice_generar_clave_desde_valor(INDICE *idx, char *data);
 102 /** Compara 2 claves de la forma c1 < c2 */
 103 int emufs_indice_es_menor(INDICE *idx, CLAVE c1, CLAVE c2);
 104
 105 /** Compara 2 claves de la forma c1 == c2 */
 106 int emufs_indice_es_igual(INDICE *idx, CLAVE c1, CLAVE c2);
 107 #endif
 108