emufs/indices.h

   1
   2 #ifndef _INDICES_H_
   3 #define _INDICES_H_
   4
   5 #include <stdlib.h>
   6 #include <string.h>
   7
   8 #define STRUCT_OFFSET(x, y) ((int)(&(x->y))-(int)(x))
   9
  10 typedef struct _emu_fs_t EMUFS;
  11
  12 /** Tipos de Indices conocidos */
  13 typedef enum {
  14         IND_B, /**< Utilizacion de Arboles B */
  15         IND_B_ASC /**< Utilizacion de Arboles B* */
  16 } INDICE_TIPO;
  17
  18 /** Tipos de datos soportados para las claves */
  19 typedef enum {IDX_FLOAT, IDX_INT} INDICE_TIPO_DATO;
  20
  21 /** Clave de indice */
  22 typedef union _data_ {
  23         float f_clave;
  24         int i_clave;
  25 } CLAVE;
  26
  27 /** Manejo de Indices independiente */
  28 typedef struct _indices_h_ {
  29         INDICE_TIPO tipo;             /**< Tipo de indice */
  30         INDICE_TIPO_DATO tipo_dato;   /**< Tipo de dato a manejar */
  31         int offset;                   /**< Offset desde el inicio del dato hasta el lugar donde esta la clave */
  32         unsigned int tam_bloque;      /**< Tamaño del bloque (nodo). Deber set multiplo de 512! */
  33
  34         /** Agrega la clave k de posicion location en el
  35          * indice de forma ordenada
  36          */
  37         int (*agregar_entrada)(struct _indices_h_ *idx, CLAVE k, int location);
  38         /** Borra del indice la clave k */
  39         int (*borrar_entrada)(struct _indices_h_ *idx, CLAVE k);
  40         /** Determina si existe la clave k retornando su posicion o -1
  41          * en caso fallido
  42          */
  43         int (*existe_entrada)(struct _indices_h_ *idx, CLAVE k);
  44
  45         char *nombre;   /**< Nombre único de busqueda del indice */
  46         char *filename; /**< nombre del archivo de indice */
  47
  48         struct _indices_h_ *sig; /**< Siguiente indice */
  49 } INDICE;
  50
  51 /** Crea un nuevo indice
  52  *
  53  *  \param emu EMUFS a quien pertenece
  54  *  \param nombre Nombre del indice
  55  *  \param tipo Tipo de indice
  56  *  \param tipo_dato Tipo de dato de la clave
  57  *  \param offset Desplazamiento de la clave dentro del dato
  58  *  \param tam_bloque Tamaño del bloque (nodo) del arbol
  59  */
  60 INDICE *emufs_indice_crear(EMUFS *emu, char *nombre, INDICE_TIPO tipo, INDICE_TIPO_DATO tipo_dato, unsigned int offset, unsigned tam_bloque);
  61
  62 /** Destruye un indice
  63  *
  64  *  \todo hacer/revisar
  65  */
  66 void emufs_indice_destruir(EMUFS *emu, INDICE *i);
  67
  68 /** Agrega una clave en los indices
  69  *
  70  *  Agrega la clave en todos los indice, dependiendo de su tipo
  71  *  de dato, tipo de arboo, offset, etc
  72  *
  73  *  \param primer Primer indice a agregar
  74  *  \param data Array de datos desde donde tomar las claves
  75  *  \param ubicacion Dato a guardar asociado a la clave
  76  */
  77 void emufs_indice_agregar(INDICE *primero, char *data, int ubicacion);
  78
  79 /** Compara 2 claves de la forma c1 < c2 */
  80 int emufs_indice_es_menor(INDICE *idx, CLAVE c1, CLAVE c2);
  81
  82 /** Compara 2 claves de la forma c1 == c2 */
  83 int emufs_indice_es_igual(INDICE *idx, CLAVE c1, CLAVE c2);
  84 #endif
  85