xml-tree.hpp

   1 #ifndef XML_TREE_HPP_
   2 #define XML_TREE_HPP_
   3
   4
   5 #include <cstdint>
   6 #include <unordered_set>
   7 #include <unordered_map>
   8 #include <libbp/bp.h>
   9 #include <libbp/bp-darray.h>
  10 #include <libcds/includes/basics.h>
  11 #include <libcds/includes/static_bitsequence.h>
  12 #include <libcds/includes/alphabet_mapper.h>
  13 #include <libcds/includes/static_sequence.h>
  14 #include "bit-vector.hpp"
  15
  16 #undef W
  17 #undef Wminusone
  18 #undef WW
  19
  20 #include <TextCollection/TextCollection.h>
  21 #include <TextCollection/TextCollectionBuilder.h>
  22
  23 class xml_tree_builder;
  24
  25 class xml_tree {
  26 public:
  27   typedef int32_t node_t;
  28   typedef int32_t tag_t;
  29
  30   static const node_t NIL = -1;
  31   static const node_t ROOT = 0;
  32
  33   static const char* NIL_TAG;
  34   static const tag_t NIL_TAG_ID = -1;
  35   static const char* DOCUMENT_OPEN_TAG;
  36   static const tag_t DOCUMENT_OPEN_TAG_ID = 0;
  37   static const char* ATTRIBUTE_OPEN_TAG;
  38   static const tag_t ATTRIBUTE_OPEN_TAG_ID = 1;
  39   static const char* PCDATA_OPEN_TAG;
  40   static const tag_t PCDATA_OPEN_TAG_ID = 2;
  41   static const char* ATTRIBUTE_DATA_OPEN_TAG;
  42   static const tag_t ATTRIBUTE_DATA_OPEN_TAG_ID = 3;
  43   static const char* CLOSE_TAG;
  44   static const tag_t CLOSE_TAG_ID = 4;
  45
  46
  47   ~xml_tree();
  48
  49   //Counting functions
  50   /**
  51    * [size()] returns the size of the tree (number of nodes)
  52    * Runs in O(1)
  53    */
  54   inline uint32_t size() const;
  55
  56   /**
  57    * [num_tags()] returns the number of distinct tags.
  58    * Runs in O(1)
  59    */
  60   inline uint32_t num_tags() const;
  61
  62   /**
  63    * [subtree_size(n)] returns the size of the subtree (number of nodes)
  64    * rooted at n.
  65    * Runs in O(1)
  66    */
  67   inline uint32_t subtree_size(node_t) const;
  68
  69   /**
  70    * [subtree_tags(n, t)] returns the number of occurences of tag [t] in the
  71    * subtree rooted at [n]
  72    * Runs in O(1)
  73    */
  74   inline uint32_t subtree_tags(node_t, tag_t) const;
  75
  76   /**
  77    * [subtree_elements(n)] returns the number of element nodes below [n]
  78    * Runs in O(attribute_ids->size()+3)
  79    */
  80   inline uint32_t subtree_elements(node_t) const;
  81
  82   /**
  83    * [num_children(n)] returns the number of child nodes of [n]
  84    * (both text and elements, and including a fake <@> node if
  85    * present).
  86    * Runs in O(1) (?)
  87    */
  88   uint32_t num_children(node_t) const;
  89
  90   /**
  91    * [child_pos(n)] returns the position of [n] amongst its siblings
  92    * Runs in O(1) (?)
  93    */
  94   uint32_t child_pos(node_t) const;
  95
  96
  97   //Node_T tests
  98   /**
  99    * [is_leaf(n)] returns true if [n] is a leaf (i.e. if [num_children(n)]
 100    * returns 0
 101    * Runs in O(1)
 102    */
 103   inline bool is_leaf(node_t) const;
 104
 105   /**
 106    * [is_ancestor(n, m)] returns true if [n] is an ancestor of [m], false
 107    * otherwise
 108    * Runs in O(1)
 109    */
 110   inline bool is_ancestor(node_t, node_t) const;
 111
 112   /**
 113    * [is_right_descendant(n, m)] returns true if [m] is a descendant-or-self of
 114    * a following-sibling of [n], false otherwise
 115    * Runs in O(1)
 116    */
 117   inline bool is_right_descendant(node_t, node_t) const;
 118
 119   /**
 120    * [is_child(n, m)] returns true if [m] is a child of [n]
 121    * Runs in O(1)
 122    */
 123   bool is_child(node_t, node_t) const;
 124
 125   /**
 126    * [is_first_child(n, m)] returns true if [m] is the first child of [n]
 127    * Runs in O(1)
 128    */
 129   inline bool is_first_child(node_t) const;
 130
 131   /**
 132    * [is_nil(n)] returns true if [n] is equal to xml_tree::NIL
 133    * Runs in O(1)
 134    */
 135   inline bool is_nil(node_t) const;
 136
 137   /**
 138    * [is_open(n)] returns true if [n], seen as an index in the
 139    * underlying BP representation corresponds to an opening parenthesis.
 140    * Runs in O(1)
 141    */
 142   inline bool is_open(node_t) const;
 143
 144   //Numbering functions
 145   uint32_t depth(node_t) const;
 146   uint32_t preorder(node_t) const;
 147   uint32_t postorder(node_t) const;
 148
 149   //Tag functions
 150   inline tag_t tag(node_t) const;
 151   const char* get_tag_name_by_ref(tag_t) const;
 152   tag_t register_tag(char *s);
 153
 154   //Navigation functions
 155   inline node_t root () const;
 156   node_t child(node_t, uint32_t) const;
 157   inline node_t parent(node_t) const;
 158   inline node_t first_child(node_t) const;
 159   inline node_t last_child(node_t) const;
 160   inline node_t next_sibling(node_t) const;
 161   inline node_t prev_sibling(node_t) const;
 162   inline node_t first_element(node_t) const;
 163   inline node_t next_element(node_t) const;
 164   inline node_t tagged_next_close(node_t, tag_t) const;
 165   inline node_t tagged_next(node_t, tag_t) const;
 166   inline node_t tagged_descendant(node_t, tag_t) const;
 167   inline node_t tagged_following_before(node_t, tag_t, node_t) const;
 168   inline node_t tagged_child(node_t, tag_t) const;
 169   inline node_t tagged_sibling(node_t, tag_t) const;
 170   node_t select_child(node_t, tag_t*) const;
 171   inline node_t select_descendant(node_t, tag_t*) const;
 172   node_t select_sibling(node_t, tag_t*) const;
 173   inline node_t select_following_before (node_t, tag_t*, node_t) const;
 174   inline node_t closing(node_t) const;
 175
 176   //Text functions
 177   inline node_t parent_node(int32_t) const;
 178   inline SXSI::TextCollection *get_text_collection() const;
 179   std::pair<int32_t, int32_t> text_id_range(node_t) const;
 180   int32_t text_id(node_t) const;
 181   unsigned char* get_text(int32_t) const;
 182
 183   SXSI::TextCollection::document_result prefix(uchar const *s) const;
 184   SXSI::TextCollection::document_result suffix(uchar const *s) const;
 185   SXSI::TextCollection::document_result equals(uchar const *s) const;
 186   SXSI::TextCollection::document_result contains(uchar const *s) const;
 187   SXSI::TextCollection::document_result less_than(uchar const *s) const;
 188
 189
 190   bool naive_contains(node_t, uchar const *s) const;
 191
 192   //I/O functions
 193   void save(int, char*);
 194   static xml_tree* load(int, char*, bool, int);
 195   void print(node_t, int, bool no_text=false);
 196   void flush(int);
 197
 198 private:
 199   friend class xml_tree_builder;
 200   xml_tree();
 201   xml_tree(std::vector<int32_t>*,
 202            std::unordered_map<std::string, int32_t>*,
 203            bit_vector*,
 204            bool,
 205            SXSI::TextCollectionBuilder *,
 206            SXSI::TextCollectionBuilder::index_type_t,
 207            bit_vector*);
 208
 209   //Parenthesis sequence
 210   bp *par;
 211   //tag sequence
 212   std::vector<static_bitsequence_sdarray*> tags;
 213   uint32_t *tag_seq;
 214   uint32_t tag_seq_len;
 215   uint32_t bits_per_tag;
 216   //Mapping from tag_t identifiers to/from tagnames
 217   std::vector<std::string> *tag_names;
 218   std::unordered_map<std::string, tag_t> *tag_ids;
 219   //Set of tag ids that map to attribute nodes
 220   std::unordered_set<tag_t> *attribute_ids;
 221   //Text index
 222   SXSI::TextCollection *text_collection;
 223   static_bitsequence *text_positions;
 224   SXSI::TextCollectionBuilder::index_type_t text_index_type;
 225   //auxiliary data structures for efficient printing.
 226   std::vector<std::string> *print_stack;
 227   std::string *print_buffer;
 228
 229 #define BUFFER_SIZE (8192*2)
 230
 231   void uflush(int);
 232   void uflush_r(int, size_t);
 233   void uput_str(std::string s, int fd);
 234   void uputs(const char* s, int fd);
 235   void uputc(const char c, int fd);
 236   size_t uprintf(const char*s, int fd);
 237 };
 238
 239 #define XML_TREE_INTERNAL__ 1
 240 #include "xml-tree-inc.hpp"
 241
 242 #endif //XML_TREE_HPP_