1  #ifndef __CMPH_SELECT_H__
       2  #define __CMPH_SELECT_H__
       3  
       4  #include "cmph_types.h"
       5  
       6  struct _select_t
       7  {
       8  	cmph_uint32 n,m;
       9  	cmph_uint32 * bits_vec;
      10  	cmph_uint32 * select_table;
      11  };
      12  
      13  typedef struct _select_t select_t;
      14  
      15  void select_init(select_t * sel);
      16  
      17  void select_destroy(select_t * sel);
      18   
      19  void select_generate(select_t * sel, cmph_uint32 * keys_vec, cmph_uint32 n, cmph_uint32 m);
      20  
      21  cmph_uint32 select_query(select_t * sel, cmph_uint32 one_idx);
      22  
      23  cmph_uint32 select_next_query(select_t * sel, cmph_uint32 vec_bit_idx);
      24  
      25  cmph_uint32 select_get_space_usage(select_t * sel);
      26  
      27  void select_dump(select_t *sel, char **buf, cmph_uint32 *buflen);
      28  
      29  void select_load(select_t * sel, const char *buf, cmph_uint32 buflen);
      30  
      31  
      32  /** \fn void select_pack(select_t *sel, void *sel_packed);
      33   *  \brief Support the ability to pack a select structure into a preallocated contiguous memory space pointed by sel_packed.
      34   *  \param sel points to the select structure
      35   *  \param sel_packed pointer to the contiguous memory area used to store the select structure. The size of sel_packed must be at least @see select_packed_size 
      36   */
      37  void select_pack(select_t *sel, void *sel_packed);
      38  
      39  /** \fn cmph_uint32 select_packed_size(select_t *sel);
      40   *  \brief Return the amount of space needed to pack a select structure.
      41   *  \return the size of the packed select structure or zero for failures
      42   */ 
      43  cmph_uint32 select_packed_size(select_t *sel);
      44  
      45  
      46  /** \fn cmph_uint32 select_query_packed(void * sel_packed, cmph_uint32 one_idx);
      47   *  \param sel_packed is a pointer to a contiguous memory area
      48   *  \param one_idx is the rank for which we want to calculate the inverse function select
      49   *  \return an integer that represents the select value of rank idx.
      50   */
      51  cmph_uint32 select_query_packed(void * sel_packed, cmph_uint32 one_idx);
      52  
      53  
      54  /** \fn cmph_uint32 select_next_query_packed(void * sel_packed, cmph_uint32 vec_bit_idx);
      55   *  \param sel_packed is a pointer to a contiguous memory area
      56   *  \param vec_bit_idx is a value prior computed by @see select_query_packed
      57   *  \return an integer that represents the next select value greater than @see vec_bit_idx.
      58   */
      59  cmph_uint32 select_next_query_packed(void * sel_packed, cmph_uint32 vec_bit_idx);
      60  
      61  #endif