a580e12000-09-27Fredrik Hübinette (Hubbe) #pike __REAL_VERSION__
a20af62000-09-26Fredrik Hübinette (Hubbe) 
38cbfe2006-04-24Robert Hinn //! This class implements a (min-)heap. The value of a child node will //! always be greater than or equal to the value of its parent node. //! Thus, the top node of the heap will always hold the smallest value.
dd3ae62015-09-10Henrik Grubbström (Grubba) //! Heap element. class Element (mixed value) {
1b47a42015-11-17Henrik Grubbström (Grubba)  int pos = -1;
dd3ae62015-09-10Henrik Grubbström (Grubba)  constant is_adt_heap_element = 1; protected int `<(mixed other) { return value < other; } protected int `>(mixed other) { return value > other; } } #define SWAP(X,Y) do{ mixed tmp=values[X]; (values[X]=values[Y])->pos = X; (values[Y]=tmp)->pos = Y; }while(0)
b78e3a1999-12-30Fredrik Hübinette (Hubbe) 
dd3ae62015-09-10Henrik Grubbström (Grubba) protected array(Element) values=allocate(10);
7ee5de2009-10-08Henrik Grubbström (Grubba) protected int num_values;
b78e3a1999-12-30Fredrik Hübinette (Hubbe) 
09c8a02009-09-17Henrik Grubbström (Grubba) #ifdef ADT_HEAP_DEBUG
b78e3a1999-12-30Fredrik Hübinette (Hubbe) void verify_heap() {
dd3ae62015-09-10Henrik Grubbström (Grubba)  for(int e=0; e<num_values; e++) { if (!values[e] || !values[e]->is_adt_heap_element) error("Error in HEAP: Position %d has no element.\n", e); if (values[e]->pos != e) error("Error in HEAP: Element %d has invalid position: %d.\n", e, values[e]->pos);
96ba742015-10-14Henrik Grubbström (Grubba)  if(e && (values[(e-1)/2] > values[e]))
ab3b6d2003-05-03Martin Nilsson  error("Error in HEAP (%d, %d) num_values=%d\n", (e-1)/2, e, num_values);
dd3ae62015-09-10Henrik Grubbström (Grubba)  }
b78e3a1999-12-30Fredrik Hübinette (Hubbe) } #else #define verify_heap() #endif
9eaf1d2008-06-28Martin Nilsson protected void adjust_down(int elem)
b78e3a1999-12-30Fredrik Hübinette (Hubbe) { while(1) { int child=elem*2+1; if(child >= num_values) break;
82e7902004-06-21Martin Nilsson 
b78e3a1999-12-30Fredrik Hübinette (Hubbe)  if(child+1==num_values || values[child] < values[child+1]) { if(values[child] < values[elem]) { SWAP(child, elem); elem=child; continue; } } else { if(child+1 >= num_values) break;
82e7902004-06-21Martin Nilsson 
b78e3a1999-12-30Fredrik Hübinette (Hubbe)  if(values[child+1] < values[elem]) { SWAP(elem, child+1); elem=child+1; continue; } } break; } }
9eaf1d2008-06-28Martin Nilsson protected int adjust_up(int elem)
b78e3a1999-12-30Fredrik Hübinette (Hubbe) { int parent=(elem-1)/2;
4720a61999-12-30Fredrik Hübinette (Hubbe) 
af00351999-12-31Fredrik Hübinette (Hubbe)  if(elem && values[elem] < values[parent])
b78e3a1999-12-30Fredrik Hübinette (Hubbe)  { SWAP(elem, parent); elem=parent;
af00351999-12-31Fredrik Hübinette (Hubbe)  while(elem && (values[elem] < values[parent=(elem -1)/2]))
b78e3a1999-12-30Fredrik Hübinette (Hubbe)  { SWAP(elem, parent); elem=parent; } adjust_down(elem); return 1; } return 0; }
38cbfe2006-04-24Robert Hinn //! Push an element onto the heap. The heap will automatically sort itself //! so that the smallest value will be at the top.
fe792a2015-08-13Henrik Grubbström (Grubba) //!
dd3ae62015-09-10Henrik Grubbström (Grubba) //! @returns //! Returns an element handle, which can be used with //! @[adjust()] and @[remove()]. //!
fe792a2015-08-13Henrik Grubbström (Grubba) //! @seealso //! @[pop()], @[remove()]
dd3ae62015-09-10Henrik Grubbström (Grubba) Element push(mixed value)
b78e3a1999-12-30Fredrik Hübinette (Hubbe) {
dd3ae62015-09-10Henrik Grubbström (Grubba)  Element ret; if (objectp(value) && value->is_adt_heap_element) { ret = value; } else { ret = Element(value); }
b78e3a1999-12-30Fredrik Hübinette (Hubbe)  if(num_values >= sizeof(values))
4720a61999-12-30Fredrik Hübinette (Hubbe)  values+=allocate(10+sizeof(values)/4);
82e7902004-06-21Martin Nilsson 
dd3ae62015-09-10Henrik Grubbström (Grubba)  (values[num_values] = ret)->pos = num_values++;
b78e3a1999-12-30Fredrik Hübinette (Hubbe)  adjust_up(num_values-1); verify_heap();
dd3ae62015-09-10Henrik Grubbström (Grubba)  return ret;
b78e3a1999-12-30Fredrik Hübinette (Hubbe) }
38cbfe2006-04-24Robert Hinn //! Takes a value in the heap and sorts it through the heap to maintain //! its sort criteria (increasing order).
dd3ae62015-09-10Henrik Grubbström (Grubba) //! //! @param value //! Either the element handle returned by @[push()], or the pushed //! value itself. //! //! @returns //! Returns the element handle for the value (if present in the heap), //! and @expr{0@} (zero) otherwise. Element adjust(mixed value)
b78e3a1999-12-30Fredrik Hübinette (Hubbe) {
dd3ae62015-09-10Henrik Grubbström (Grubba)  int pos; if (objectp(value) && value->is_adt_heap_element) { pos = value->pos; } else {
b307982015-09-17Henrik Grubbström (Grubba)  pos = search(map(values, lambda(Element x) { return x?->value; }), value);
dd3ae62015-09-10Henrik Grubbström (Grubba)  } Element ret; if(pos>=0) { ret = values[pos];
b78e3a1999-12-30Fredrik Hübinette (Hubbe)  if(!adjust_up(pos)) adjust_down(pos);
dd3ae62015-09-10Henrik Grubbström (Grubba)  }
b78e3a1999-12-30Fredrik Hübinette (Hubbe)  verify_heap();
dd3ae62015-09-10Henrik Grubbström (Grubba)  return ret;
b78e3a1999-12-30Fredrik Hübinette (Hubbe) }
ab3b6d2003-05-03Martin Nilsson //! Removes and returns the item on top of the heap, //! which also is the smallest value in the heap.
fe792a2015-08-13Henrik Grubbström (Grubba) //! //! @throws //! Throws an error if the heap is empty. //! //! @seealso //! @[peek()], @[push()], @[remove()]
ab3b6d2003-05-03Martin Nilsson mixed pop()
b78e3a1999-12-30Fredrik Hübinette (Hubbe) { if(!num_values) error("Heap underflow!\n");
82e7902004-06-21Martin Nilsson 
1b47a42015-11-17Henrik Grubbström (Grubba)  Element value = values[0]; value->pos = -1;
dd3ae62015-09-10Henrik Grubbström (Grubba)  num_values--; if(num_values)
b78e3a1999-12-30Fredrik Hübinette (Hubbe)  {
dd3ae62015-09-10Henrik Grubbström (Grubba)  (values[0] = values[num_values])->pos = 0;
b78e3a1999-12-30Fredrik Hübinette (Hubbe)  adjust_down(0);
82e7902004-06-21Martin Nilsson 
b78e3a1999-12-30Fredrik Hübinette (Hubbe)  if(num_values * 3 + 10 < sizeof(values)) values=values[..num_values+10]; }
dd3ae62015-09-10Henrik Grubbström (Grubba)  values[num_values]=0;
b78e3a1999-12-30Fredrik Hübinette (Hubbe)  verify_heap();
1b47a42015-11-17Henrik Grubbström (Grubba)  return value->value;
b78e3a1999-12-30Fredrik Hübinette (Hubbe) }
ab3b6d2003-05-03Martin Nilsson //! Returns the number of elements in the heap. int _sizeof() { return num_values; }
b78e3a1999-12-30Fredrik Hübinette (Hubbe) 
38cbfe2006-04-24Robert Hinn //! Returns the item on top of the heap (which is also the smallest value //! in the heap) without removing it.
fe792a2015-08-13Henrik Grubbström (Grubba) //! //! @returns //! Returns the smallest value on the heap if any, and //! @expr{UNDEFINED@} otherwise. //! //! @seealso //! @[pop()]
38cbfe2006-04-24Robert Hinn mixed peek() { if (!num_values) return UNDEFINED;
dd3ae62015-09-10Henrik Grubbström (Grubba)  return values[0]->value;
38cbfe2006-04-24Robert Hinn }
e882112015-08-13Henrik Grubbström (Grubba)  //! Remove a value from the heap. //! //! @param value //! Value to remove. //! //! @seealso //! @[push()], @[pop()] void remove(mixed value) {
dd3ae62015-09-10Henrik Grubbström (Grubba)  int pos; if (objectp(value) && value->is_adt_heap_element) { pos = value->pos; } else {
b307982015-09-17Henrik Grubbström (Grubba)  pos = search(map(values, lambda(Element x) { return x?->value; }), value);
dd3ae62015-09-10Henrik Grubbström (Grubba)  }
e882112015-08-13Henrik Grubbström (Grubba)  if ((pos < 0) || (pos >= num_values)) return;
1b47a42015-11-17Henrik Grubbström (Grubba)  value = values[pos];
e882112015-08-13Henrik Grubbström (Grubba)  values[pos] = values[--num_values]; values[num_values] = 0;
1b47a42015-11-17Henrik Grubbström (Grubba)  value->pos = -1;
e882112015-08-13Henrik Grubbström (Grubba)  if (pos < num_values) { if (!adjust_up(pos)) adjust_down(pos); }
1909c52015-08-13Henrik Grubbström (Grubba)  if(num_values * 3 + 10 < sizeof(values)) values=values[..num_values+10];
e882112015-08-13Henrik Grubbström (Grubba)  verify_heap(); }