|
|
| version 1.17, 2001/02/21 17:36:29 | version 1.57.2.4, 2003/01/23 16:08:00 |
|---|---|
| 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_Y="$Date$"; |
| #include "pa_pool.h" | #include "pa_pool.h" |
| #include "pa_types.h" | //#include "pa_types.h" |
| #include "pa_string.h" | #include "pa_exception.h" |
| class Array : public Pooled { | template<typename T> class Array_iterator; |
| public: | |
| /** | |
| Simple Array. | |
| typedef void Item; | */ |
| template<typename T> class Array: public PA_Object { | |
| friend class Array_iterator; | |
| enum { | // allocated size |
| CR_INITIAL_ROWS_DEFAULT=10, | int fallocated; |
| CR_GROW_PERCENT=60 | |
| }; | |
| public: | public: |
| typedef T element_type; | |
| 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; | |
| Array(Pool& apool, int initial_rows=CR_INITIAL_ROWS_DEFAULT); | 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); | |
| felements[fused++]=src; | |
| return *this; | |
| } | |
| int size() const { return fused_rows; } | /// append other Array portion to this one. starting from offset |
| Array& operator += (Item *src); | Array& append(const Array& src, int offset=0, int limit=0) { |
| Array& append_array(const Array& src); | if(!(offset>=0 && offset<src.count())) { |
| Item *quick_get(int index) const { | throw Exception(0, |
| // considering these true: | Exception::undefined_source, |
| // index increments from 0 to size()-1 | "Array::append(offset=%d) out of range [0..%d]", offset, src.count()-1); |
| // index>=0 && index<size() | //return 0; // never |
| // index>=cache_chunk_base | |
| // next chunk will be with "index" row | |
| if(!(index<cache_chunk_base+cache_chunk->count)) { | |
| int count=cache_chunk->count; | |
| cache_chunk_base+=count; | |
| 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) const { |
| const char *get_cstr(int index) const { | if(!(index>=0 && index<count())) { |
| return static_cast<const char *>(get(index)); | throw Exception(0, |
| Exception::undefined_source, | |
| "Array::get(%d) out of range [0..%d]", index, count()-1); | |
| return 0; // never | |
| } | |
| return felements[index]; | |
| } | } |
| const String *get_string(int index) const { | |
| return static_cast<const String *>(get(index)); | /// put index-element |
| void put(int index, T element) { | |
| if(!(index>=0 && index<size())) { | |
| throw Exception(0, | |
| Exception::undefined_source, | |
| "Array::put(%d) out of range [0..%d]", index, size()-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 | /// iterate over all elements until condition becomes true, return that element |
| // helps appending Arrays | template<typename I> T *first_that(bool callback(T, I), I info) const { |
| Chunk *tail; | T *last=felements+fused; |
| for(T *current=felements; current<last; current++) | |
| if(callback(*current, info)) | |
| return *current; | |
| // next append would write to this record | return 0; |
| 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: | protected: |
| // array size | // default expand delta size |
| int fused_rows; | int fdelta; |
| /// elements[growing size] here | |
| T *felements; | |
| mutable int cache_chunk_base; | // array size |
| mutable Chunk *cache_chunk; | int fused; |
| private: | |
| bool chunk_is_full() { | bool is_full() { |
| return append_here == link_row; | return fused == fallocated; |
| } | |
| void expand(int delta) { | |
| fallocated+=delta; | |
| felements = (T *)pa_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; } |
| }; | }; |
| /// handy array iterator | |
| 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+farray.count(); | |
| } | |
| /// there are still elements | |
| bool has_next() { | |
| return fcurrent<flast; | |
| } | |
| /// quickly extracts next Array element | |
| T next() { | |
| return *(furrent++); | |
| } | |
| }; | |
| #endif | #endif |