nsz Git - libfirm/blob - ir/ana2/qset.h

   1 /* -*- c -*- */
   2
   3 /*
   4  * Time-stamp: <11.11.2004 16:42:22h liekweg>
   5  * Project:     libFIRM
   6  * File name:   ir/ana2/qset.h
   7  * Purpose:     yet another set implementation
   8  * Author:      Florian
   9  * Modified by:
  10  * Created:     Mon 18 Oct 2004
  11  * CVS-ID:      $Id$
  12  * Copyright:   (c) 1999-2004 Universität Karlsruhe
  13  * Licence:     This file is protected by GPL -  GNU GENERAL PUBLIC LICENSE.
  14  */
  15
  16 #ifndef _QSET_H_
  17 #define _QSET_H_
  18
  19 # ifndef TRUE
  20 #  define TRUE 1
  21 #  define FALSE 0
  22 # endif /* nof defined TRUE */
  23
  24 /* define this as needed */
  25 # define COMPARE(A,B)       (A<B)
  26 # define EQUAL(A,B)       (A==B)
  27 /* typedef unsigned int sortable_t; */
  28 typedef void* sortable_t;
  29
  30 typedef struct qset_str
  31 {
  32   sortable_t *values;
  33   int n_slots;
  34   int n_elems;
  35   int is_sorted;
  36   int cursor;                   /* for qset_start/qset_next */
  37   int id;
  38 } qset_t;
  39
  40
  41 /* QSET INTERFACE */
  42
  43 /* Allocate a new qset with initial space for up to n_elems. */
  44 qset_t *qset_new (const int);
  45
  46 /* Sort the entries of the given qset. */
  47 void qset_sort (qset_t*);
  48
  49 /* Compact a qset to take up no more space than required. */
  50 void qset_compact (qset_t*);
  51
  52 /* Free the memory associated with the given qset */
  53 void qset_delete (qset_t*);
  54
  55 /* Test whether the given qset contains the given value. */
  56 int qset_contains (qset_t*, sortable_t);
  57
  58 /* Delete the given value from the given qset (if it exists) */
  59 void qset_remove (qset_t*, sortable_t);
  60
  61 /* Insert the given elem into the given qset. */
  62 void qset_insert (qset_t*, sortable_t);
  63
  64 /* Insert all elems of qset2 into qset1. qset2 is deleted. */
  65 void qset_insert_all (qset_t*, qset_t*);
  66
  67 /* Compare two qsets. */
  68 int qset_compare (qset_t*, qset_t*);
  69
  70 /* Returns the union of two qsets. */
  71 qset_t *qset_union (qset_t *qset1, qset_t *qset2);
  72
  73 /* Report the size of the given qset. */
  74 int qset_size (qset_t *qset);
  75
  76 /* Print the given qset to the given stream. */
  77 void qset_print (qset_t*, FILE*);
  78
  79 /* Check wether the given qset is empty */
  80 int qset_is_empty (qset_t*);
  81
  82 /*
  83    Iterate over a qset
  84 */
  85 /* initialise the iteration, return the first element */
  86 sortable_t *qset_start (qset_t*);
  87 /* step to the next element, return NULL iff no more elems are available */
  88 sortable_t *qset_next (qset_t*);
  89
  90 #endif /* def _QSET_H_ */
  91
  92 /*
  93  $Log$
  94  Revision 1.3  2004/11/18 16:35:46  liekweg
  95  Added unique ids for debugging
  96
  97  Revision 1.2  2004/11/08 12:32:00  liekweg
  98  Moved q_* methods into private section
  99
 100  Revision 1.1  2004/11/04 14:55:13  liekweg
 101  added qset
 102
 103
 104 */