|
|
| version 1.45, 2001/10/29 08:23:48 | version 1.57.2.16, 2003/01/31 12:34:29 |
|---|---|
| Line 1 | Line 1 |
| /** @file | /** @file |
| Parser: Array & Array_iter classes decls. | 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: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf) | Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru) |
| $Id$ | |
| */ | */ |
| #ifndef PA_ARRAY_H | #ifndef PA_ARRAY_H |
| #define PA_ARRAY_H | #define PA_ARRAY_H |
| #include "pa_config_includes.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" | |
| class Array_iter; | 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>; |
| friend class Array_iter; | |
| public: | protected: |
| // default expand delta size | |
| int fdelta; | |
| /// Array item type | /// elements[growing size] here |
| typedef void Item; | T *felements; |
| /*/// for_each iterator function type, const info | // allocated size |
| typedef void (*For_each_func_const)(Item *value, const void *info); | int fallocated; |
| */ | |
| // array size | |
| /// for_each iterator function type | int fused; |
| typedef void (*For_each_func)(Item *value, void *info); | |
| /// first_that iterator function type, const info | |
| typedef void *(*Item_that_func_const)(Item *value, const void *info); | |
| /// first_that iterator function type | |
| typedef void *(*Item_that_func)(Item *value, void *info); | |
| enum { | |
| CR_INITIAL_ROWS_DEFAULT=3, ///< default preallocated row count | |
| CR_GROW_COUNT=3 ///< 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); | |
| felements=new T[fallocated]; | |
| } | |
| override ~Array() { | |
| T *last=felements+fused; | |
| for(T *current=felements; current<last; current++) | |
| delete current; | |
| delete felements; | |
| } | |
| /// how many items are in Array | |
| int count() const { return fused; } | |
| /// append to array | |
| Array& operator += (T src) { | |
| if(is_full()) | |
| expand(fdelta); | |
| /// size Array. how many items are in it | felements[fused++]=src; |
| int size() const { return fused_rows; } | |
| /// append Item to array | |
| Array& operator += (Item *src); | |
| /// append int value to array | |
| Array& operator += (int value) { return *this+=reinterpret_cast<Item *>(value); } | |
| /// dirty hack to allow constant items storage. I long for Array<const Item*> | return *this; |
| Array& operator += (const Item *src) { return *this+=const_cast<Item *>(src); } | } |
| /// append other Array portion to this one. starting from offset | /// append other Array portion to this one. starting from offset |
| Array& append_array(const Array& src, int offset=0); | Array& append(const Array& src, int offset=0, int limit=0) { |
| if(!(offset>=0 && offset<src.count())) { | |
| Item *get(int index) const; | throw Exception(0, |
| int get_int(int index) const { return reinterpret_cast<int>(get(index)); } | Exception::undefined_source, |
| "Array::append(offset=%d) out of range [0..%d]", offset, src.count()-1); | |
| //return 0; // never | |
| } | |
| // fix limit | |
| { | |
| int m=src.count()-offset; | |
| if(!m || limit<0) | |
| return *this; | |
| if(!limit || limit>m) | |
| limit=m; | |
| } | |
| void put(int index, Item *item); | int needed=limit-(fallocated-fused); |
| /// convinient way to get strings from Array. I long for Array<const String *> | if(needed>0) |
| const String *get_string(int index) const { | expand(needed); |
| return const_cast<const String *>(static_cast<String *>(get(index))); | |
| memcpy(&felements[fused+=limit], &src.felements[offset], limit*sizeof(T)); | |
| return *this; | |
| } | } |
| /*/// iterate over all elements, const info | /// get index-element |
| void for_each(For_each_func_const func, const void *info=0) const; | T& get(int index) { |
| /*/ | if(!(index>=0 && index<count())) { |
| throw Exception(0, | |
| Exception::undefined_source, | |
| "Array::get(%d) out of range [0..%d]", index, count()-1); | |
| return felements[0]; // never | |
| } | |
| /// iterate over all elements | return felements[index]; |
| void for_each(For_each_func func, void *info=0) const; | } |
| /// iterate over all elements until condition, const info | T& operator [](int index) { return get(index); } |
| void* first_that(Item_that_func_const func, const void *info=0) const; | |
| /// iterate over all elements until condition | /// put index-element |
| void* first_that(Item_that_func func, void *info=0) const; | 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: | |
| /// several record elements | |
| struct Chunk { | |
| int count; ///< the number of rows in chunk | |
| /// item or a link to next chunk union | |
| union Row { | |
| Item *item; | |
| 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 |
| template<typename I> void for_each(void (*callback)(T, I), I info) const { | |
| T *last=felements+fused; | |
| for(T *current=felements; current<last; current++) | |
| callback(*current, info); | |
| } | |
| // array size | /// iterate over all elements until condition becomes true, return that element |
| int fused_rows; | 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; | |
| mutable int cache_chunk_base; | return 0;//T(0); |
| mutable Chunk *cache_chunk; | } |
| private: | protected: |
| 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 | /// handy array iterator |
| class Array_iter { | template<typename T> class Array_iterator { |
| Array<T>& farray; | |
| T *fcurrent; | |
| T *flast; | |
| public: | public: |
| Array_iter(const Array& aarray) : array(aarray), | Array_iterator(Array<T>& aarray): farray(aarray) { |
| chunk(aarray.head), | fcurrent=farray.felements; |
| row(chunk->rows), | flast=farray.felements+farray.count(); |
| countdown(chunk->count) { | |
| } | } |
| /// there are still elements | /// there are still elements |
| bool has_next() { | bool has_next() { |
| return !(chunk==array.tail && row==array.append_here); | return fcurrent<flast; |
| } | } |
| /// quickly extracts next Array::Item | /// quickly extracts next Array element |
| Array::Item *next() { | T next() { |
| // assuming: never called after has_next()! | return *(fcurrent++); |
| if(countdown==0) { // end of chunk? | |
| chunk=row->link; | |
| row=chunk->rows; | |
| countdown=chunk->count; | |
| } | |
| Array::Item *result=row->item; | |
| row++; countdown--; | |
| return result; | |
| } | |
| /// quickly extracts next Array::Item as const String | |
| const String *next_string() { | |
| return const_cast<const String *>(static_cast<String *>(next())); | |
| } | } |
| private: | |
| const Array& array; | |
| const Array::Chunk *chunk; | |
| const Array::Chunk::Row *row; | |
| int countdown; | |
| }; | }; |
| #endif | #endif |