Diff for /parser3/src/include/pa_array.h between versions 1.19 and 1.57.2.27.2.7

version 1.19, 2001/02/22 15:17:39 version 1.57.2.27.2.7, 2003/03/26 18:52:49
Line 1 Line 1
 /*  /** @file
   $Id$          Parser: Array & Array_iterator classes decls.
 */  
   
 /*  
   
         Array               Chunk0  
         ======              ========  
         head--------------->[ptr]  
         append_here-------->[ptr]  
         link_row            ........  
                         .                       .  
                         .                       [ptr]  
                         ...........>[link to the next chunk]  
   
           Copyright (c) 2001-2003 ArtLebedev Group (http://www.artlebedev.com)
           Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
 */  */
   
 #ifndef PA_ARRAY_H  #ifndef PA_ARRAY_H
 #define PA_ARRAY_H  #define PA_ARRAY_H
   
 #include <stddef.h>  static const char* IDENT_ARRAY_H="$Date$";
   
 #include "pa_pool.h"  // includes
 #include "pa_types.h"  
 #include "pa_string.h"  
   
 class Array : public Pooled {  #include "pa_memory.h"
 public:  #include "pa_exception.h"
   
         typedef void Item;  // forwards
   
         enum {  template<typename T> class Array_iterator;
                 CR_INITIAL_ROWS_DEFAULT=10,  
                 CR_GROW_PERCENT=60  
         };  
   
 public:  /// Simple Array
   template<typename T> class Array: public PA_Object {
   
           friend class Array_iterator<T>;
   
   protected:
   
         Array(Pool& apool, int initial_rows=CR_INITIAL_ROWS_DEFAULT);          /// elements[growing size] here
           T *felements;
   
         int size() const {           // allocated size
                 // for get and quick_get          size_t fallocated;
                 cache_chunk_base=0;  
                 cache_chunk=head;          // array size
                 return fused_rows;           size_t fused;
         }  
         Array& operator += (Item *src);  public:
         Array& append_array(const Array& src, int offset=0);          typedef T element_type;
         Item *quick_get(int index) const {  
                 // considering these true:          Array(int initial=3):
                 //   index increments from 0 to size()-1                  fallocated(initial>3?initial:3),
                 //   index>=0 && index<size()                  fused(0)
                 //   index>=cache_chunk_base          {
                   felements=static_cast<T*>(malloc(fallocated*sizeof(T)));
                 // next chunk will be with "index" row          }
                 if(!(index<cache_chunk_base+cache_chunk->count)) {  
                         int count=cache_chunk->count;          /// how many items are in Array
                         cache_chunk_base+=count;          size_t count() const { return fused; }
                         cache_chunk=cache_chunk->rows[count].link;          /// append to array
           Array& operator += (T src) {
                   if(is_full())
                           expand(2);
   
                   felements[fused++]=src;
   
                   return *this;
           }
   
           /// append other Array portion to this one. starting from offset
           Array& append(const Array& src, int offset=0, int limit=0) {
                   if(offset<0) {
                           throw Exception(0, 
                                   0,
                                   "Array::append(offset=%d) out <0", offset);
                           //return Nothing; // never
                   }
                   // fix limit
                   {
                           int m=src.count()-offset;
                           if(!m || limit<0)
                                   return *this;
                           if(!limit || limit>m)
                                   limit=m;
                 }                  }
   
                   int delta=limit-(fallocated-fused);
                   if(delta>0)
                           expand(delta);
   
                   T* from=&src.felements[offset];
                   T* to=&felements[fused];
                   T* from_end=from+limit;
                   while(from<from_end)
                           *to++=*from++;
                                   
                 return cache_chunk->rows[index-cache_chunk_base].item;                  fused+=limit;
                   return *this;
         }          }
   
         Item *get(int index) const;          /// quick version of get index-element [use in tight places when sure]
         void put(int index, Item *item);          T& unchecked_get(size_t index) const {
         const char *get_cstr(int index) const {                   return felements[index];
                 return static_cast<const char *>(get(index));           }
         }  
         const String *get_string(int index) const {           /// get index-element
                 return static_cast<const String *>(get(index));           T& get(size_t index) const {
                   size_t lcount=count();
                   if(!(index>=0 && index<lcount)) {
                           throw Exception(0, 
                                   0,
                                   "Array::get(%d) out of range [0..%d]", index, lcount-1);
                           return felements[0]; // never
                   }
   
                   return unchecked_get(index);
         }          }
   
 private:          T& operator [](size_t index) const { return get(index); }
   
         struct Chunk {          /// put index-element
                 // the number of rows in chunk          void put(size_t index, T& element) {
                 int count;                  size_t lcount=count();
                 union Row {                  if(!(index>=0 && index<lcount)) {
                         Item *item;                          throw Exception(0, 
                         Chunk *link;  // link to the next chunk in chain                                  0, 
                 } rows[1];                                  "Array::put(%d) out of range [0..%d]", index, lcount-1);
                 // next rows are here                          return; // never
                   }
                   felements[index]=element;
         }          }
                 *head;  // the head chunk of the chunk chain  
   
         // last allocated chunk  
         // helps appending Arrays  
         Chunk *tail;  
   
         // next append would write to this record          /// iterate over all elements
         Chunk::Row *append_here;          template<typename I> void for_each(void (*callback)(T, I), I info) const {
                           T *last=felements+fused;
         // the address of place where lies address                   for(T *current=felements; current<last; current++)
         // of the link to the next chunk to allocate                          callback(*current, info);
         Chunk::Row *link_row;          }
   
 private:          /// iterate over all elements until condition becomes true, return that element
           template<typename I> T first_that(bool (*callback)(T, I), I info) const {
                   T *last=felements+fused;
                   for(T *current=felements; current<last; current++)
                           if(callback(*current, info))
                                   return *current;
   
         // array size                  return T(0);
         int fused_rows;          }
   
         mutable int cache_chunk_base;  protected:
         mutable Chunk *cache_chunk;  
           
 private:  
   
         bool chunk_is_full() {          bool is_full() {
                 return append_here == link_row;                  return fused == fallocated;
           }
           void expand(size_t delta) {
                   size_t new_allocated=fallocated+delta;
                   felements = (T *)realloc(felements, new_allocated*sizeof(T));
                   memset(&felements[fallocated], 0, delta*sizeof(T));
                   fallocated=new_allocated;
         }          }
         void expand(int chunk_rows);  
   
 private: //disabled  private: //disabled
   
         //Array(Array&) { }          Array(const Array&) {}
         Array& operator = (const Array&) { return *this; }          Array& operator = (const Array&) { return *this; }
 };  };
   
   
   /** Array iterator, usage:
           @code
           // Array<T> a;
           Array_iterator<T> i(a);
           while(i.has_next()) {
                   T& element=i.next();
                   ...
           }       
           @endcode
   */
   template<typename T> class Array_iterator {
   
           const Array<T>& farray;
           T *fcurrent;
           T *flast;
   
   public:
   
           Array_iterator(const Array<T>& aarray): farray(aarray) {
                   fcurrent=farray.felements;
                   flast=farray.felements+farray.count();
           }
   
           /// there are still elements
           bool has_next() {
                   return fcurrent<flast;
           }
   
           /// quickly extracts next Array element
           const T& next() {
                   return *(fcurrent++);
           }
   
   };
   
   /** Nonconst array iterator, usage:
           @code
           // Array<T> a;
           Array_iterator<T> i(a);
           while(i.has_next()) {
                   T& element=i.next();
                   ...
           }       
           @endcode
   */
   template<typename T> class Array_modifing_iterator {
   
           Array<T>& farray;
           T *fcurrent;
           T *flast;
   
   public:
   
           Array_modifing_iterator(Array<T>& aarray): farray(aarray) {
                   fcurrent=farray.felements;
                   flast=farray.felements+farray.count();
           }
   
           /// there are still elements
           bool has_next() {
                   return fcurrent<flast;
           }
   
           /// quickly extracts next Array element
           T& next() {
                   return *(fcurrent++);
           }
   
   };
   
 #endif  #endif

Removed from v.1.19  
changed lines
  Added in v.1.57.2.27.2.7


E-mail: