heap.h
上传用户:romrleung
上传日期:2022-05-23
资源大小:18897k
文件大小:8k
源码类别:

MySQL数据库

开发平台:

Visual C++

  1. /* Copyright (C) 2000,2004 MySQL AB
  2.    This program is free software; you can redistribute it and/or modify
  3.    it under the terms of the GNU General Public License as published by
  4.    the Free Software Foundation; either version 2 of the License, or
  5.    (at your option) any later version.
  6.    This program is distributed in the hope that it will be useful,
  7.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  8.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  9.    GNU General Public License for more details.
  10.    You should have received a copy of the GNU General Public License
  11.    along with this program; if not, write to the Free Software
  12.    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA */
  13. /* This file should be included when using heap_database_functions */
  14. /* Author: Michael Widenius */
  15. #ifndef _heap_h
  16. #define _heap_h
  17. #ifdef __cplusplus
  18. extern "C" {
  19. #endif
  20. #ifndef _my_base_h
  21. #include <my_base.h>
  22. #endif
  23. #ifdef THREAD
  24. #include <my_pthread.h>
  25. #include <thr_lock.h>
  26. #endif
  27. #include "my_handler.h"
  28. #include "my_tree.h"
  29. /* defines used by heap-funktions */
  30. #define HP_MAX_LEVELS 4 /* 128^5 records is enough */
  31. #define HP_PTRS_IN_NOD 128
  32. /* struct used with heap_funktions */
  33. typedef struct st_heapinfo /* Struct from heap_info */
  34. {
  35.   ulong records; /* Records in database */
  36.   ulong deleted; /* Deleted records in database */
  37.   ulong max_records;
  38.   ulong data_length;
  39.   ulong index_length;
  40.   uint reclength; /* Length of one record */
  41.   int errkey;
  42.   ulonglong auto_increment;
  43. } HEAPINFO;
  44. /* Structs used by heap-database-handler */
  45. typedef struct st_heap_ptrs
  46. {
  47.   byte *blocks[HP_PTRS_IN_NOD]; /* pointers to HP_PTRS or records */
  48. } HP_PTRS;
  49. struct st_level_info
  50. {
  51.   /* Number of unused slots in *last_blocks HP_PTRS block (0 for 0th level) */
  52.   uint free_ptrs_in_block;
  53.   
  54.   /*
  55.     Maximum number of records that can be 'contained' inside of each element
  56.     of last_blocks array. For level 0 - 1, for level 1 - HP_PTRS_IN_NOD, for 
  57.     level 2 - HP_PTRS_IN_NOD^2 and so forth.
  58.   */
  59.   uint records_under_level;
  60.   /*
  61.     Ptr to last allocated HP_PTRS (or records buffer for level 0) on this 
  62.     level.
  63.   */
  64.   HP_PTRS *last_blocks;
  65. };
  66. /*
  67.   Heap table records and hash index entries are stored in HP_BLOCKs.
  68.   HP_BLOCK is used as a 'growable array' of fixed-size records. Size of record
  69.   is recbuffer bytes.
  70.   The internal representation is as follows:
  71.   HP_BLOCK is a hierarchical structure of 'blocks'.
  72.   A block at level 0 is an array records_in_block records. 
  73.   A block at higher level is an HP_PTRS structure with pointers to blocks at 
  74.   lower levels.
  75.   At the highest level there is one top block. It is stored in HP_BLOCK::root.
  76.   See hp_find_block for a description of how record pointer is obtained from 
  77.   its index.
  78.   See hp_get_new_block 
  79. */
  80. typedef struct st_heap_block
  81. {
  82.   HP_PTRS *root;                        /* Top-level block */ 
  83.   struct st_level_info level_info[HP_MAX_LEVELS+1];
  84.   uint levels;                          /* number of used levels */
  85.   uint records_in_block; /* Records in one heap-block */
  86.   uint recbuffer; /* Length of one saved record */
  87.   ulong last_allocated; /* number of records there is allocated space for */
  88. } HP_BLOCK;
  89. struct st_heap_info; /* For referense */
  90. typedef struct st_hp_keydef /* Key definition with open */
  91. {
  92.   uint flag; /* HA_NOSAME |燞A_NULL_PART_KEY */
  93.   uint keysegs; /* Number of key-segment */
  94.   uint length; /* Length of key (automatic) */
  95.   uint8 algorithm; /* HASH / BTREE */
  96.   HA_KEYSEG *seg;
  97.   HP_BLOCK block; /* Where keys are saved */
  98.   /*
  99.     Number of buckets used in hash table. Used only to provide
  100.     #records estimates for heap key scans.
  101.   */
  102.   ha_rows hash_buckets; 
  103.   TREE rb_tree;
  104.   int (*write_key)(struct st_heap_info *info, struct st_hp_keydef *keyinfo,
  105.    const byte *record, byte *recpos);
  106.   int (*delete_key)(struct st_heap_info *info, struct st_hp_keydef *keyinfo,
  107.    const byte *record, byte *recpos, int flag);
  108.   uint (*get_key_length)(struct st_hp_keydef *keydef, const byte *key);
  109. } HP_KEYDEF;
  110. typedef struct st_heap_share
  111. {
  112.   HP_BLOCK block;
  113.   HP_KEYDEF  *keydef;
  114.   ulong min_records,max_records; /* Params to open */
  115.   ulong data_length,index_length,max_table_size;
  116.   uint records; /* records */
  117.   uint blength; /* records rounded up to 2^n */
  118.   uint deleted; /* Deleted records in database */
  119.   uint reclength; /* Length of one record */
  120.   uint changed;
  121.   uint keys,max_key_length;
  122.   uint currently_disabled_keys;    /* saved value from "keys" when disabled */
  123.   uint open_count;
  124.   byte *del_link; /* Link to next block with del. rec */
  125.   my_string name; /* Name of "memory-file" */
  126. #ifdef THREAD
  127.   THR_LOCK lock;
  128.   pthread_mutex_t intern_lock; /* Locking for use with _locking */
  129. #endif
  130.   my_bool delete_on_close;
  131.   LIST open_list;
  132.   uint auto_key;
  133.   uint auto_key_type; /* real type of the auto key segment */
  134.   ulonglong auto_increment;
  135. } HP_SHARE;
  136. struct st_hp_hash_info;
  137. typedef struct st_heap_info
  138. {
  139.   HP_SHARE *s;
  140.   byte *current_ptr;
  141.   struct st_hp_hash_info *current_hash_ptr;
  142.   ulong current_record,next_block;
  143.   int lastinx,errkey;
  144.   int  mode; /* Mode of file (READONLY..) */
  145.   uint opt_flag,update;
  146.   byte *lastkey; /* Last used key with rkey */
  147.   byte *recbuf;                         /* Record buffer for rb-tree keys */
  148.   enum ha_rkey_function last_find_flag;
  149.   TREE_ELEMENT *parents[MAX_TREE_HEIGHT+1];
  150.   TREE_ELEMENT **last_pos;
  151.   uint lastkey_len;
  152.   my_bool implicit_emptied;
  153. #ifdef THREAD
  154.   THR_LOCK_DATA lock;
  155. #endif
  156.   LIST open_list;
  157. } HP_INFO;
  158. typedef struct st_heap_create_info
  159. {
  160.   uint auto_key;                        /* keynr [1 - maxkey] for auto key */
  161.   uint auto_key_type;
  162.   ulong max_table_size;
  163.   ulonglong auto_increment;
  164.   my_bool with_auto_increment;
  165. } HP_CREATE_INFO;
  166. /* Prototypes for heap-functions */
  167. extern HP_INFO *heap_open(const char *name, int mode);
  168. extern int heap_close(HP_INFO *info);
  169. extern int heap_write(HP_INFO *info,const byte *buff);
  170. extern int heap_update(HP_INFO *info,const byte *old,const byte *newdata);
  171. extern int heap_rrnd(HP_INFO *info,byte *buf,byte *pos);
  172. extern int heap_scan_init(HP_INFO *info);
  173. extern int heap_scan(register HP_INFO *info, byte *record);
  174. extern int heap_delete(HP_INFO *info,const byte *buff);
  175. extern int heap_info(HP_INFO *info,HEAPINFO *x,int flag);
  176. extern int heap_create(const char *name, uint keys, HP_KEYDEF *keydef,
  177.        uint reclength, ulong max_records, ulong min_records,
  178.        HP_CREATE_INFO *create_info);
  179. extern int heap_delete_table(const char *name);
  180. extern int heap_extra(HP_INFO *info,enum ha_extra_function function);
  181. extern int heap_rename(const char *old_name,const char *new_name);
  182. extern int heap_panic(enum ha_panic_function flag);
  183. extern int heap_rsame(HP_INFO *info,byte *record,int inx);
  184. extern int heap_rnext(HP_INFO *info,byte *record);
  185. extern int heap_rprev(HP_INFO *info,byte *record);
  186. extern int heap_rfirst(HP_INFO *info,byte *record,int inx);
  187. extern int heap_rlast(HP_INFO *info,byte *record,int inx);
  188. extern void heap_clear(HP_INFO *info);
  189. extern void heap_clear_keys(HP_INFO *info);
  190. extern int heap_disable_indexes(HP_INFO *info);
  191. extern int heap_enable_indexes(HP_INFO *info);
  192. extern int heap_indexes_are_disabled(HP_INFO *info);
  193. extern void heap_update_auto_increment(HP_INFO *info, const byte *record);
  194. ha_rows hp_rb_records_in_range(HP_INFO *info, int inx, key_range *min_key,
  195.                                key_range *max_key);
  196. int heap_rkey(HP_INFO *info, byte *record, int inx, const byte *key, 
  197.               uint key_len, enum ha_rkey_function find_flag);
  198. extern gptr heap_find(HP_INFO *info,int inx,const byte *key);
  199. extern int heap_check_heap(HP_INFO *info, my_bool print_status);
  200. extern byte *heap_position(HP_INFO *info);
  201. /* The following is for programs that uses the old HEAP interface where
  202.    pointer to rows where a long instead of a (byte*).
  203. */
  204. #if defined(WANT_OLD_HEAP_VERSION) || defined(OLD_HEAP_VERSION)
  205. extern int heap_rrnd_old(HP_INFO *info,byte *buf,ulong pos);
  206. extern ulong heap_position_old(HP_INFO *info);
  207. #endif
  208. #ifdef OLD_HEAP_VERSION
  209. typedef ulong HEAP_PTR;
  210. #define heap_position(A) heap_position_old(A)
  211. #define heap_rrnd(A,B,C) heap_rrnd_old(A,B,C)
  212. #else
  213. typedef byte *HEAP_PTR;
  214. #endif
  215. #ifdef __cplusplus
  216. }
  217. #endif
  218. #endif