ut0lst.h
上传用户:tsgydb
上传日期:2007-04-14
资源大小:10674k
文件大小:6k
源码类别:

MySQL数据库

开发平台:

Visual C++

  1. /**********************************************************************
  2. List utilities
  3. (c) 1995 Innobase Oy
  4. Created 9/10/1995 Heikki Tuuri
  5. ***********************************************************************/
  6. #ifndef ut0lst_h
  7. #define ut0lst_h
  8. #include "univ.i"
  9. /* This module implements the two-way linear list which should be used
  10. if a list is used in the database. Note that a single struct may belong
  11. to two or more lists, provided that the list are given different names.
  12. An example of the usage of the lists can be found in fil0fil.c. */
  13. /***********************************************************************
  14. This macro expands to the unnamed type definition of a struct which acts
  15. as the two-way list base node. The base node contains pointers
  16. to both ends of the list and a count of nodes in the list (excluding
  17. the base node from the count). TYPE should be the list node type name. */
  18. #define UT_LIST_BASE_NODE_T(TYPE)
  19. struct {
  20. ulint count; /* count of nodes in list */
  21. TYPE * start; /* pointer to list start, NULL if empty */
  22. TYPE * end; /* pointer to list end, NULL if empty */
  23. }
  24. /***********************************************************************
  25. This macro expands to the unnamed type definition of a struct which
  26. should be embedded in the nodes of the list, the node type must be a struct.
  27. This struct contains the pointers to next and previous nodes in the list.
  28. The name of the field in the node struct should be the name given
  29. to the list. TYPE should be the list node type name. Example of usage:
  30. typedef struct LRU_node_struct LRU_node_t;
  31. struct LRU_node_struct {
  32. UT_LIST_NODE_T(LRU_node_t) LRU_list;
  33. ...
  34. }
  35. The example implements an LRU list of name LRU_list. Its nodes are of type
  36. LRU_node_t.
  37. */
  38. #define UT_LIST_NODE_T(TYPE)
  39. struct {
  40. TYPE * prev; /* pointer to the previous node,
  41. NULL if start of list */
  42. TYPE * next; /* pointer to next node, NULL if end of list */
  43. }
  44. /***********************************************************************
  45. Initializes the base node of a two-way list. */
  46. #define UT_LIST_INIT(BASE)
  47. {
  48. (BASE).count = 0;
  49. (BASE).start = NULL;
  50. (BASE).end   = NULL;
  51. }
  52. /***********************************************************************
  53. Adds the node as the first element in a two-way linked list.
  54. BASE has to be the base node (not a pointer to it). N has to be
  55. the pointer to the node to be added to the list. NAME is the list name. */
  56. #define UT_LIST_ADD_FIRST(NAME, BASE, N)
  57. {
  58. ut_ad(N);
  59. ((BASE).count)++;
  60. ((N)->NAME).next = (BASE).start;
  61. ((N)->NAME).prev = NULL;
  62. if ((BASE).start != NULL) {
  63. (((BASE).start)->NAME).prev = (N);
  64. }
  65. (BASE).start = (N);
  66. if ((BASE).end == NULL) {
  67. (BASE).end = (N);
  68. }
  69. }
  70. /***********************************************************************
  71. Adds the node as the last element in a two-way linked list.
  72. BASE has to be the base node (not a pointer to it). N has to be
  73. the pointer to the node to be added to the list. NAME is the list name. */
  74. #define UT_LIST_ADD_LAST(NAME, BASE, N)
  75. {
  76. ut_ad(N);
  77. ((BASE).count)++;
  78. ((N)->NAME).prev = (BASE).end;
  79. ((N)->NAME).next = NULL;
  80. if ((BASE).end != NULL) {
  81. (((BASE).end)->NAME).next = (N);
  82. }
  83. (BASE).end = (N);
  84. if ((BASE).start == NULL) {
  85. (BASE).start = (N);
  86. }
  87. }
  88. /***********************************************************************
  89. Inserts a NODE2 after NODE1 in a list.
  90. BASE has to be the base node (not a pointer to it). NAME is the list
  91. name, NODE1 and NODE2 are pointers to nodes. */
  92. #define UT_LIST_INSERT_AFTER(NAME, BASE, NODE1, NODE2)
  93. {
  94. ut_ad(NODE1);
  95. ut_ad(NODE2);
  96. ((BASE).count)++;
  97. ((NODE2)->NAME).prev = (NODE1);
  98. ((NODE2)->NAME).next = ((NODE1)->NAME).next;
  99. if (((NODE1)->NAME).next != NULL) {
  100. ((((NODE1)->NAME).next)->NAME).prev = (NODE2);
  101. }
  102. ((NODE1)->NAME).next = (NODE2);
  103. if ((BASE).end == (NODE1)) {
  104. (BASE).end = (NODE2);
  105. }
  106. }
  107. /***********************************************************************
  108. Removes a node from a two-way linked list. BASE has to be the base node
  109. (not a pointer to it). N has to be the pointer to the node to be removed
  110. from the list. NAME is the list name. */
  111. #define UT_LIST_REMOVE(NAME, BASE, N)
  112. {
  113. ut_ad(N);
  114. ut_a((BASE).count > 0);
  115. ((BASE).count)--;
  116. if (((N)->NAME).next != NULL) {
  117. ((((N)->NAME).next)->NAME).prev = ((N)->NAME).prev;
  118. } else {
  119. (BASE).end = ((N)->NAME).prev;
  120. }
  121. if (((N)->NAME).prev != NULL) {
  122. ((((N)->NAME).prev)->NAME).next = ((N)->NAME).next;
  123. } else {
  124. (BASE).start = ((N)->NAME).next;
  125. }
  126. }
  127. /************************************************************************
  128. Gets the next node in a two-way list. NAME is the name of the list
  129. and N is pointer to a node. */
  130. #define UT_LIST_GET_NEXT(NAME, N)
  131. (((N)->NAME).next)
  132. /************************************************************************
  133. Gets the previous node in a two-way list. NAME is the name of the list
  134. and N is pointer to a node. */
  135. #define UT_LIST_GET_PREV(NAME, N)
  136. (((N)->NAME).prev)
  137. /************************************************************************
  138. Alternative macro to get the number of nodes in a two-way list, i.e.,
  139. its length. BASE is the base node (not a pointer to it). */
  140. #define UT_LIST_GET_LEN(BASE)
  141. (BASE).count
  142. /************************************************************************
  143. Gets the first node in a two-way list, or returns NULL,
  144. if the list is empty. BASE is the base node (not a pointer to it). */
  145. #define UT_LIST_GET_FIRST(BASE)
  146. (BASE).start
  147. /************************************************************************
  148. Gets the last node in a two-way list, or returns NULL,
  149. if the list is empty. BASE is the base node (not a pointer to it). */
  150. #define UT_LIST_GET_LAST(BASE)
  151. (BASE).end
  152. /************************************************************************
  153. Checks the consistency of a two-way list. NAME is the name of the list,
  154. TYPE is the node type, and BASE is the base node (not a pointer to it). */
  155. #define UT_LIST_VALIDATE(NAME, TYPE, BASE)
  156. {
  157. ulint ut_list_i_313;
  158. TYPE * ut_list_node_313;
  159. ut_list_node_313 = (BASE).start;
  160. for (ut_list_i_313 = 0; ut_list_i_313 < (BASE).count;
  161.   ut_list_i_313++) {
  162.   ut_a(ut_list_node_313);
  163.   ut_list_node_313 = (ut_list_node_313->NAME).next;
  164. }
  165. ut_a(ut_list_node_313 == NULL);
  166. ut_list_node_313 = (BASE).end;
  167. for (ut_list_i_313 = 0; ut_list_i_313 < (BASE).count;
  168.   ut_list_i_313++) {
  169.   ut_a(ut_list_node_313);
  170.   ut_list_node_313 = (ut_list_node_313->NAME).prev;
  171. }
  172. ut_a(ut_list_node_313 == NULL);
  173. }
  174. #endif