[BACK]Return to pa_array.h CVS log [TXT] [DIR] Up to [parser3project] / parser3 / src / include

Diff for /parser3/src/include/pa_array.h between versions 1.30 and 1.57.2.19

version 1.30, 2001/03/24 19:12:18 version 1.57.2.19, 2003/02/04 09:44:27
Line 1 Line 1
 /** @file  /** @file
         Parser: array class decl.          Parser: Array & Array_iterator classes decls.
   
         Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)          Copyright (c) 2001-2003 ArtLebedev Group (http://www.artlebedev.com)
           Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
         Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf)  
   
         $Id$  
 */  */
   
 #ifndef PA_ARRAY_H  #ifndef PA_ARRAY_H
 #define PA_ARRAY_H  #define PA_ARRAY_H
   
 #include <stddef.h>  static const char* IDENT_ARRAY_Y="$Date$";
   
 #include "pa_pool.h"  #include "pa_pool.h"
 #include "pa_types.h"  #include "pa_exception.h"
 #include "pa_string.h"  
   template<typename T> class Array_iterator;
   
 /**       /**     
         Pooled Array.          Simple Array.
   
         Internal structure:  
         @verbatim  
                 Array               Chunk0  
                 ======              ========  
                 head--------------->[ptr]  
                 append_here-------->[ptr]  
                 link_row            ........  
                                 .                       .  
                                 .                       [ptr]  
                                 ...........>[link to the next chunk]  
         @endverbatim  
 */  */
   template<typename T> class Array: public PA_Object {
   
 class Array : public Pooled {          friend class Array_iterator<T>;
 public:  
   protected:
   
         /// Array item type          // default expand delta size
         typedef void Item;          int fdelta;
   
         /// for_each iterator function type          /// elements[growing size] here
         typedef void (*For_each_func)(Item *value, void *info);          T *felements;
   
         /// first_that iterator function type          // allocated size
         typedef bool (*First_that_func)(Item *value, const void *info);          int fallocated;
   
         enum {          // array size
                 CR_INITIAL_ROWS_DEFAULT=10, ///< default preallocated row count          int fused;
                 CR_GROW_PERCENT=60 ///< each time the Array chunk_is_full() array expanded()  
         };  
   
 public:  public:
           typedef T element_type;
   
         Array(Pool& apool, int initial_rows=CR_INITIAL_ROWS_DEFAULT);          Array(int initial=3, int delta=1):
                   fallocated(initial?initial:3),
                   fdelta(delta),
                   fused(0)
           {
                   if(fallocated<=0 || fdelta<1)
                           throw Exception(0, 
                                   Exception::undefined_source,
                                   "Array::Array(%d, %d) too small", initial, delta);
   
         /// size Array. how many items are in it                  felements=new T[fallocated];
         int size() const {   
                 // for get and quick_get  
                 cache_chunk_base=0;  
                 cache_chunk=head;  
                 return fused_rows;   
         }          }
         /// append Item to array          override ~Array() {
         Array& operator += (Item *src);                  T *last=felements+fused;
                   for(T *current=felements; current<last; current++)
                           delete current;
   
         /// dirty hack to allow constant items storage. I long for Array<const Item*>                  delete felements;
         Array& operator += (const Item *src) { return *this+=const_cast<Item*>(src); }          }
   
         /// append other Array portion to this one. starting from offset          /// how many items are in Array
         Array& append_array(const Array& src, int offset=0);          int count() const { return fused; }
           /// append to array
           Array& operator += (T src) {
                   if(is_full())
                           expand(fdelta);
   
         /**                   felements[fused++]=src;
                 quickly gets some item considering...  
   
                 these true:                  return *this;
                         - index increments from 0 to size()-1          }
                         - index>=0 && index<size()  
                         - index>=cache_chunk_base          /// append other Array portion to this one. starting from offset
         */          Array& append(const Array& src, int offset=0, int limit=0) {
         Item *quick_get(int index) const {                  if(!(offset>=0 && offset<src.count())) {
                 // next chunk will be with "index" row                          throw Exception(0, 
                 if(!(index<cache_chunk_base+cache_chunk->count)) {                                  Exception::undefined_source,
                         int count=cache_chunk->count;                                  "Array::append(offset=%d) out of range [0..%d]", offset, src.count()-1);
                         cache_chunk_base+=count;                          //return 0; // never
                         cache_chunk=cache_chunk->rows[count].link;  
                 }                  }
                                   // fix limit
                 return cache_chunk->rows[index-cache_chunk_base].item;                  {
                           int m=src.count()-offset;
                           if(!m || limit<0)
                                   return *this;
                           if(!limit || limit>m)
                                   limit=m;
                   }
   
                   int needed=limit-(fallocated-fused);
                   if(needed>0)
                           expand(needed);
   
                   memcpy(&felements[fused+=limit], &src.felements[offset], limit*sizeof(T));
                   return *this;
         }          }
   
         Item *get(int index) const;          /// get index-element
         void put(int index, Item *item);          T& get(int index) {
         /// convinient way to get strings from Array. I long for Array<const String *>                  if(!(index>=0 && index<count())) {
         const String *get_string(int index) const {                           throw Exception(0, 
                 return const_cast<const String *>(static_cast<String *>(get(index)));                                   Exception::undefined_source,
                                   "Array::get(%d) out of range [0..%d]", index, count()-1);
                           return felements[0]; // never
                   }
   
                   return felements[index];
         }          }
   
         /// iterate over all elements          T& operator [](int index) { return get(index); }
         void for_each(For_each_func func, void *info=0);  
   
         /// iterate over all elements until condition          /// put index-element
         void* first_that(First_that_func func, const void *info=0);          void put(int index, T& element) {
                   if(!(index>=0 && index<count())) {
                           throw Exception(0, 
                                   Exception::undefined_source, 
                                   "Array::put(%d) out of range [0..%d]", index, count()-1);
                           return; // never
                   }
                   felements[index]=element;
           }
   
 private:  
   
         struct Chunk {          /// iterate over all elements
                 // the number of rows in chunk          template<typename I> void for_each(void (*callback)(T, I), I info) const {
                 int count;                  T *last=felements+fused;
                 union Row {                  for(T *current=felements; current<last; current++)
                         Item *item;                          callback(*current, info);
                         Chunk *link;  // link to the next chunk in chain          }
                 } rows[1];  
                 // next rows are here  
         }  
                 *head;  // the head chunk of the chunk chain  
   
         // last allocated chunk  
         // helps appending Arrays  
         Chunk *tail;  
   
         // next append would write to this record  
         Chunk::Row *append_here;  
           
         // the address of place where lies address   
         // of the link to the next chunk to allocate  
         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 0;//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(int delta) {
                   fallocated+=delta;
                   felements = (T *)realloc(felements, fallocated*sizeof(T));
         }          }
         void expand(int chunk_rows);  
   
 private: //disabled  private: //disabled
   
         //Array(Array&) { }  
         Array& operator = (const Array&) { return *this; }          Array& operator = (const Array&) { return *this; }
 };  };
   
   typedef smart_ptr<char> CharPtr;
   
   class Pool: public Array<CharPtr> {
   public:
           char *malloc(size_t size) {
                   CharPtr result=CharPtr((char *)Array<CharPtr>::malloc(size));
                   *this += result;
                   return result.get();
           }
   
           char *copy(const char* buf, size_t size=0) {
                   if(!size)
                           size=strlen(buf)+1;
   
                   char *result=malloc(size);
                   memcpy(result, buf, size);
                   return result;
           }
   };
   
   inline void *operator new[] (size_t size, Pool& pool) {
           return pool.malloc(size);
   }
   
   /// handy array iterator
   template<typename T> class Array_iterator {
   
           Array<T>& farray;
           T *fcurrent;
           T *flast;
   
   public:
   
           Array_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.30  
changed lines
  Added in v.1.57.2.19

E-mail: