PostgreSQL Source Code  git master
pairingheap.h File Reference
#include "lib/stringinfo.h"
Include dependency graph for pairingheap.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  pairingheap_node
 
struct  pairingheap
 

Macros

#define pairingheap_container(type, membername, ptr)
 
#define pairingheap_const_container(type, membername, ptr)
 
#define pairingheap_reset(h)   ((h)->ph_root = NULL)
 
#define pairingheap_is_empty(h)   ((h)->ph_root == NULL)
 
#define pairingheap_is_singular(h)    ((h)->ph_root && (h)->ph_root->first_child == NULL)
 

Typedefs

typedef struct pairingheap_node pairingheap_node
 
typedef int(* pairingheap_comparator) (const pairingheap_node *a, const pairingheap_node *b, void *arg)
 
typedef struct pairingheap pairingheap
 

Functions

pairingheappairingheap_allocate (pairingheap_comparator compare, void *arg)
 
void pairingheap_initialize (pairingheap *heap, pairingheap_comparator compare, void *arg)
 
void pairingheap_free (pairingheap *heap)
 
void pairingheap_add (pairingheap *heap, pairingheap_node *node)
 
pairingheap_nodepairingheap_first (pairingheap *heap)
 
pairingheap_nodepairingheap_remove_first (pairingheap *heap)
 
void pairingheap_remove (pairingheap *heap, pairingheap_node *node)
 

Macro Definition Documentation

◆ pairingheap_const_container

#define pairingheap_const_container (   type,
  membername,
  ptr 
)
Value:
AssertVariableIsOfTypeMacro(((type *) NULL)->membername, pairingheap_node), \
((const type *) ((const char *) (ptr) - offsetof(type, membername))))
#define AssertVariableIsOfTypeMacro(varname, typename)
Definition: c.h:975
const char * type

Definition at line 51 of file pairingheap.h.

◆ pairingheap_container

#define pairingheap_container (   type,
  membername,
  ptr 
)
Value:
AssertVariableIsOfTypeMacro(((type *) NULL)->membername, pairingheap_node), \
((type *) ((char *) (ptr) - offsetof(type, membername))))

Definition at line 43 of file pairingheap.h.

◆ pairingheap_is_empty

#define pairingheap_is_empty (   h)    ((h)->ph_root == NULL)

Definition at line 99 of file pairingheap.h.

◆ pairingheap_is_singular

#define pairingheap_is_singular (   h)     ((h)->ph_root && (h)->ph_root->first_child == NULL)

Definition at line 102 of file pairingheap.h.

◆ pairingheap_reset

#define pairingheap_reset (   h)    ((h)->ph_root = NULL)

Definition at line 96 of file pairingheap.h.

Typedef Documentation

◆ pairingheap

typedef struct pairingheap pairingheap

◆ pairingheap_comparator

typedef int(* pairingheap_comparator) (const pairingheap_node *a, const pairingheap_node *b, void *arg)

Definition at line 60 of file pairingheap.h.

◆ pairingheap_node

Function Documentation

◆ pairingheap_add()

void pairingheap_add ( pairingheap heap,
pairingheap_node node 
)

Definition at line 126 of file pairingheap.c.

127 {
128  node->first_child = NULL;
129 
130  /* Link the new node as a new tree */
131  heap->ph_root = merge(heap, heap->ph_root, node);
132  heap->ph_root->prev_or_parent = NULL;
133  heap->ph_root->next_sibling = NULL;
134 }
static pairingheap_node * merge(pairingheap *heap, pairingheap_node *a, pairingheap_node *b)
Definition: pairingheap.c:93
struct pairingheap_node * next_sibling
Definition: pairingheap.h:33
struct pairingheap_node * prev_or_parent
Definition: pairingheap.h:34
struct pairingheap_node * first_child
Definition: pairingheap.h:32
pairingheap_node * ph_root
Definition: pairingheap.h:75

References pairingheap_node::first_child, merge(), pairingheap_node::next_sibling, pairingheap::ph_root, and pairingheap_node::prev_or_parent.

Referenced by addLSNWaiter(), ExportSnapshot(), GetNonHistoricCatalogSnapshot(), GetTransactionSnapshot(), gistScanPage(), RegisterSnapshotOnOwner(), ReorderBufferChangeMemoryUpdate(), reorderqueue_push(), SetTransactionSnapshot(), and spgAddSearchItemToQueue().

◆ pairingheap_allocate()

pairingheap* pairingheap_allocate ( pairingheap_comparator  compare,
void *  arg 
)

Definition at line 42 of file pairingheap.c.

43 {
44  pairingheap *heap;
45 
46  heap = (pairingheap *) palloc(sizeof(pairingheap));
48 
49  return heap;
50 }
static int compare(const void *arg1, const void *arg2)
Definition: geqo_pool.c:145
void * palloc(Size size)
Definition: mcxt.c:1317
void pairingheap_initialize(pairingheap *heap, pairingheap_comparator compare, void *arg)
Definition: pairingheap.c:60
void * arg

References arg, compare(), pairingheap_initialize(), and palloc().

Referenced by ExecInitIndexScan(), gistrescan(), ReorderBufferAllocate(), and resetSpGistScanOpaque().

◆ pairingheap_first()

pairingheap_node* pairingheap_first ( pairingheap heap)

Definition at line 144 of file pairingheap.c.

145 {
147 
148  return heap->ph_root;
149 }
#define Assert(condition)
Definition: c.h:849
#define pairingheap_is_empty(h)
Definition: pairingheap.h:99

References Assert, pairingheap_is_empty, and pairingheap::ph_root.

Referenced by GetOldestSnapshot(), IndexNextWithReorder(), ReorderBufferLargestTXN(), SnapshotResetXmin(), updateMinWaitedLSN(), and WaitLSNSetLatches().

◆ pairingheap_free()

void pairingheap_free ( pairingheap heap)

Definition at line 77 of file pairingheap.c.

78 {
79  pfree(heap);
80 }
void pfree(void *pointer)
Definition: mcxt.c:1521

References pfree().

◆ pairingheap_initialize()

void pairingheap_initialize ( pairingheap heap,
pairingheap_comparator  compare,
void *  arg 
)

Definition at line 60 of file pairingheap.c.

62 {
63  heap->ph_compare = compare;
64  heap->ph_arg = arg;
65 
66  heap->ph_root = NULL;
67 }
pairingheap_comparator ph_compare
Definition: pairingheap.h:73
void * ph_arg
Definition: pairingheap.h:74

References arg, compare(), pairingheap::ph_arg, pairingheap::ph_compare, and pairingheap::ph_root.

Referenced by pairingheap_allocate(), and WaitLSNShmemInit().

◆ pairingheap_remove()

void pairingheap_remove ( pairingheap heap,
pairingheap_node node 
)

Definition at line 184 of file pairingheap.c.

185 {
186  pairingheap_node *children;
187  pairingheap_node *replacement;
188  pairingheap_node *next_sibling;
189  pairingheap_node **prev_ptr;
190 
191  /*
192  * If the removed node happens to be the root node, do it with
193  * pairingheap_remove_first().
194  */
195  if (node == heap->ph_root)
196  {
197  (void) pairingheap_remove_first(heap);
198  return;
199  }
200 
201  /*
202  * Before we modify anything, remember the removed node's first_child and
203  * next_sibling pointers.
204  */
205  children = node->first_child;
206  next_sibling = node->next_sibling;
207 
208  /*
209  * Also find the pointer to the removed node in its previous sibling, or
210  * if this is the first child of its parent, in its parent.
211  */
212  if (node->prev_or_parent->first_child == node)
213  prev_ptr = &node->prev_or_parent->first_child;
214  else
215  prev_ptr = &node->prev_or_parent->next_sibling;
216  Assert(*prev_ptr == node);
217 
218  /*
219  * If this node has children, make a new subheap of the children and link
220  * the subheap in place of the removed node. Otherwise just unlink this
221  * node.
222  */
223  if (children)
224  {
225  replacement = merge_children(heap, children);
226 
227  replacement->prev_or_parent = node->prev_or_parent;
228  replacement->next_sibling = node->next_sibling;
229  *prev_ptr = replacement;
230  if (next_sibling)
231  next_sibling->prev_or_parent = replacement;
232  }
233  else
234  {
235  *prev_ptr = next_sibling;
236  if (next_sibling)
237  next_sibling->prev_or_parent = node->prev_or_parent;
238  }
239 }
pairingheap_node * pairingheap_remove_first(pairingheap *heap)
Definition: pairingheap.c:159
static pairingheap_node * merge_children(pairingheap *heap, pairingheap_node *children)
Definition: pairingheap.c:248

References Assert, pairingheap_node::first_child, merge_children(), pairingheap_node::next_sibling, pairingheap_remove_first(), pairingheap::ph_root, and pairingheap_node::prev_or_parent.

Referenced by AtEOXact_Snapshot(), deleteLSNWaiter(), InvalidateCatalogSnapshot(), ReorderBufferChangeMemoryUpdate(), and UnregisterSnapshotNoOwner().

◆ pairingheap_remove_first()

pairingheap_node* pairingheap_remove_first ( pairingheap heap)

Definition at line 159 of file pairingheap.c.

160 {
161  pairingheap_node *result;
162  pairingheap_node *children;
163 
165 
166  /* Remove the root, and form a new heap of its children. */
167  result = heap->ph_root;
168  children = result->first_child;
169 
170  heap->ph_root = merge_children(heap, children);
171  if (heap->ph_root)
172  {
173  heap->ph_root->prev_or_parent = NULL;
174  heap->ph_root->next_sibling = NULL;
175  }
176 
177  return result;
178 }

References Assert, pairingheap_node::first_child, merge_children(), pairingheap_node::next_sibling, pairingheap_is_empty, pairingheap::ph_root, and pairingheap_node::prev_or_parent.

Referenced by getNextGISTSearchItem(), pairingheap_remove(), reorderqueue_pop(), spgGetNextQueueItem(), and WaitLSNSetLatches().