cde/programs/dtinfo/DtMmdb/dstr/heap.h

   1 /*
   2  * CDE - Common Desktop Environment
   3  *
   4  * Copyright (c) 1993-2012, The Open Group. All rights reserved.
   5  *
   6  * These libraries and programs are free software; you can
   7  * redistribute them and/or modify them under the terms of the GNU
   8  * Lesser General Public License as published by the Free Software
   9  * Foundation; either version 2 of the License, or (at your option)
  10  * any later version.
  11  *
  12  * These libraries and programs are distributed in the hope that
  13  * they will be useful, but WITHOUT ANY WARRANTY; without even the
  14  * implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  15  * PURPOSE. See the GNU Lesser General Public License for more
  16  * details.
  17  *
  18  * You should have received a copy of the GNU Lesser General Public
  19  * License along with these librararies and programs; if not, write
  20  * to the Free Software Foundation, Inc., 51 Franklin Street, Fifth
  21  * Floor, Boston, MA 02110-1301 USA
  22  */
  23 /*
  24  * $XConsortium: heap.h /main/3 1996/06/11 17:17:11 cde-hal $
  25  *
  26  * Copyright (c) 1992 HaL Computer Systems, Inc.  All rights reserved.
  27  * UNPUBLISHED -- rights reserved under the Copyright Laws of the United
  28  * States.  Use of a copyright notice is precautionary only and does not
  29  * imply publication or disclosure.
  30  *
  31  * This software contains confidential information and trade secrets of HaL
  32  * Computer Systems, Inc.  Use, disclosure, or reproduction is prohibited
  33  * without the prior express written permission of HaL Computer Systems, Inc.
  34  *
  35  *                         RESTRICTED RIGHTS LEGEND
  36  * Use, duplication, or disclosure by the Government is subject to
  37  * restrictions as set forth in subparagraph (c)(l)(ii) of the Rights in
  38  * Technical Data and Computer Software clause at DFARS 252.227-7013.
  39  *                        HaL Computer Systems, Inc.
  40  *                  1315 Dell Avenue, Campbell, CA  95008
  41  *
  42  */
  43
  44
  45 #ifndef _heap_h
  46 #define _heap_h 1
  47
  48 #include "utility/funcs.h"
  49 #include "utility/buffer.h"
  50
  51 typedef void (*call_back_func_ptr_t)(int, void*);
  52
  53 class heap : private buffer {
  54
  55
  56 public:
  57    heap(cmp_func_ptr_t eq, cmp_func_ptr_t ls, int exp_elements = 1000);
  58    virtual ~heap();
  59
  60 // insert function, no heapifying action taken
  61    Boolean insert(voidPtr elm) ;
  62    Boolean insert_heapify(voidPtr elm) ;
  63
  64 // make a heap out of inserted elements
  65    void heapify();
  66
  67 // retrieve function
  68    void* max_elm() ;
  69    void adjust_max_to(voidPtr new_max_item);
  70
  71    void delete_max(call_back_func_ptr_t call_back_func_t = 0);
  72    void remove(); // remove all elements
  73
  74 // status function: number of elements in the heap
  75    int count() {
  76      return buffer::content_sz() / sizeof(voidPtr) - 1;
  77    };
  78
  79    Boolean update() { return v_updated; };
  80    void adjust(int i, call_back_func_ptr_t call_back_func_t = 0);
  81
  82 // iterator
  83    int first();
  84    voidPtr operator()(int ind);
  85    void next(int& ind);
  86
  87 protected:
  88    void _delete_max(int i, voidPtr *heap_space);
  89
  90 protected:
  91    Boolean v_updated;
  92
  93    cmp_func_ptr_t f_cmp_func_eq;
  94    cmp_func_ptr_t f_cmp_func_ls;
  95 };
  96
  97 typedef heap *heapPtr;
  98
  99 #endif
 100