|
|
| 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 |