|
|
| version 1.57.2.27.2.6, 2003/03/26 07:45:22 | version 1.79, 2009/05/23 04:29:18 |
|---|---|
| Line 1 | Line 1 |
| /** @file | /** @file |
| Parser: Array & Array_iterator classes decls. | Parser: Array & Array_iterator classes decls. |
| Copyright (c) 2001-2003 ArtLebedev Group (http://www.artlebedev.com) | Copyright (c) 2001-2009 ArtLebedev Group (http://www.artlebedev.com) |
| Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru) | 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 |
| static const char* IDENT_ARRAY_H="$Date$"; | static const char * const IDENT_ARRAY_Y="$Date$"; |
| // includes | // includes |
| Line 19 static const char* IDENT_ARRAY_H="$Date$ | Line 19 static const char* IDENT_ARRAY_H="$Date$ |
| template<typename T> class Array_iterator; | template<typename T> class Array_iterator; |
| // defines | |
| #define ARRAY_OPTION_LIMIT_ALL ((size_t)-1) | |
| /// Simple Array | /// Simple Array |
| template<typename T> class Array: public PA_Object { | template<typename T> class Array: public PA_Object { |
| Line 30 protected: | Line 34 protected: |
| T *felements; | T *felements; |
| // allocated size | // allocated size |
| int fallocated; | size_t fallocated; |
| // array size | // array size |
| int fused; | size_t fused; |
| public: | public: |
| struct Action_options { | |
| size_t offset; | |
| size_t limit; //< ARRAY_OPTION_LIMIT_ALL means 'all'. zero limit means 'nothing' | |
| bool reverse; | |
| bool defined; | |
| Action_options( | |
| size_t aoffset=0, | |
| size_t alimit=ARRAY_OPTION_LIMIT_ALL, | |
| bool areverse=false): | |
| offset(aoffset), limit(alimit), reverse(areverse), | |
| defined(false) {} | |
| bool adjust(size_t count) { | |
| if(!count || !limit) | |
| return false; | |
| if(offset>=count) | |
| return false; | |
| // max(limit) | |
| size_t m=reverse? | |
| offset+1 | |
| :count-offset; | |
| if(!m) | |
| return false; | |
| // fix limit | |
| if(limit==ARRAY_OPTION_LIMIT_ALL || limit>m) | |
| limit=m; | |
| return true; | |
| } | |
| }; | |
| typedef T element_type; | typedef T element_type; |
| Array(int initial=3): | inline Array(size_t initial=0): |
| fallocated(initial>3?initial:3), | fallocated(initial), |
| fused(0) | fused(0) |
| { | { |
| felements=static_cast<T*>(malloc(fallocated*sizeof(T))); | felements=fallocated?(T *)pa_malloc(fallocated*sizeof(T)):0; |
| } | } |
| #ifdef USE_DESTRUCTORS | |
| inline ~Array(){ | |
| if(felements) | |
| pa_free(felements); | |
| } | |
| #endif | |
| /// how many items are in Array | /// how many items are in Array |
| int count() const { return fused; } | inline size_t count() const { return fused; } |
| /// append to array | /// append to array |
| Array& operator += (T src) { | inline Array& operator+=(T src) { |
| if(is_full()) | if(is_full()) |
| expand(2); | expand(fallocated>0? 2+fallocated/32 : 3); // 3 is PAF default, confirmed by tests |
| felements[fused++]=src; | felements[fused++]=src; |
| Line 58 public: | Line 103 public: |
| } | } |
| /// append other Array portion to this one. starting from offset | /// append other Array portion to this one. starting from offset |
| Array& append(const Array& src, int offset=0, int limit=0) { | Array& append(const Array& src, |
| if(offset<0) { | size_t offset=0, |
| throw Exception(0, | size_t limit=ARRAY_OPTION_LIMIT_ALL, //< negative limit means 'all'. zero limit means 'nothing' |
| 0, | bool reverse=false) { |
| "Array::append(offset=%d) out <0", offset); | |
| //return Nothing; // never | size_t src_count=src.count(); |
| } | // skip tivials |
| if(!src_count || !limit || offset>=src_count) | |
| return *this; | |
| // max(limit) | |
| size_t m=reverse? | |
| 1+offset | |
| :src_count-offset; | |
| if(!m) | |
| return *this; | |
| // fix limit | // fix limit |
| { | if(limit==ARRAY_OPTION_LIMIT_ALL || limit>m) |
| int m=src.count()-offset; | limit=m; |
| if(!m || limit<0) | |
| return *this; | |
| if(!limit || limit>m) | |
| limit=m; | |
| } | |
| int delta=limit-(fallocated-fused); | ssize_t delta=reverse? |
| (ssize_t)limit | |
| :limit-(fallocated-fused); | |
| if(delta>0) | if(delta>0) |
| expand(delta); | expand(delta); |
| T* from=&src.felements[offset]; | T* from=&src.felements[offset]; |
| T* to=&felements[fused]; | T* to=&felements[fused]; |
| T* from_end=from+limit; | if(reverse) { // reverse |
| while(from<from_end) | for(T* from_end=from-limit; from>from_end; --from) |
| *to++=*from++; | *to++=*from; |
| } else { // forward | |
| for(T* from_end=from+limit; from<from_end; from++) | |
| *to++=*from; | |
| } | |
| fused+=limit; | fused+=limit; |
| return *this; | return *this; |
| } | } |
| /// get index-element | /// get index-element |
| T& get(int index) const { | inline T get(size_t index) const { |
| if(!(index>=0 && index<count())) { | assert(index<count()); |
| throw Exception(0, | |
| 0, | |
| "Array::get(%d) out of range [0..%d]", index, count()-1); | |
| return felements[0]; // never | |
| } | |
| return felements[index]; | return felements[index]; |
| } | } |
| T& operator [](int index) const { return get(index); } | /// ref version of get |
| inline T& get_ref(size_t index) const { | |
| assert(index<count()); | |
| return felements[index]; | |
| } | |
| /// put index-element | /// put index-element |
| void put(int index, T& element) { | inline void put(size_t index, T element) { |
| if(!(index>=0 && index<count())) { | assert(index<count()); |
| throw Exception(0, | |
| 0, | |
| "Array::put(%d) out of range [0..%d]", index, count()-1); | |
| return; // never | |
| } | |
| felements[index]=element; | felements[index]=element; |
| } | } |
| inline T operator [](size_t index) const { return get(index); } | |
| /// iterate over all elements | /// iterate over all elements |
| template<typename I> void for_each(void (*callback)(T, I), I info) const { | template<typename I> void for_each(void (*callback)(T, I), I info) const { |
| Line 121 public: | Line 170 public: |
| callback(*current, info); | callback(*current, info); |
| } | } |
| /// iterate over all elements | |
| template<typename I> void for_each(bool (*callback)(T, I), I info) const { | |
| T *last=felements+fused; | |
| for(T *current=felements; current<last; current++) | |
| if(callback(*current, info)) | |
| return; | |
| } | |
| /// iterate over all elements | |
| template<typename I> void for_each_ref(void (*callback)(T&, I), I info) { | |
| T *last=felements+fused; | |
| for(T *current=felements; current<last; current++) | |
| callback(*current, info); | |
| } | |
| /// iterate over all elements until condition becomes true, return that element | /// iterate over all elements until condition becomes true, return that element |
| template<typename I> T first_that(bool (*callback)(T, I), I info) const { | template<typename I> T first_that(bool (*callback)(T, I), I info) const { |
| T *last=felements+fused; | T *last=felements+fused; |
| Line 131 public: | Line 195 public: |
| return T(0); | return T(0); |
| } | } |
| inline T* ptr(size_t index){ | |
| return felements + index; | |
| } | |
| protected: | protected: |
| bool is_full() { | bool is_full() { |
| return fused == fallocated; | return fused == fallocated; |
| } | } |
| void expand(size_t delta) { | void expand(size_t delta) { |
| size_t new_allocated=fallocated+delta; | if(fallocated){ |
| felements = (T *)realloc(felements, new_allocated*sizeof(T)); | size_t new_allocated=fallocated+delta; |
| memset(&felements[fallocated], 0, delta*sizeof(T)); | felements=(T *)pa_realloc(felements, new_allocated*sizeof(T)); |
| fallocated=new_allocated; | fallocated=new_allocated; |
| } else { | |
| fallocated=delta; | |
| felements=(T *)pa_malloc(fallocated*sizeof(T)); | |
| } | |
| } | } |
| private: //disabled | private: //disabled |
| Line 153 private: //disabled | Line 225 private: //disabled |
| /** Array iterator, usage: | /** Array iterator, usage: |
| @code | @code |
| // Array<T> a; | // Array<T> a; |
| Array_iterator<T> i(a); | for(Array_iterator<T> i(a); i.has_next(); ) { |
| while(i.has_next()) { | |
| T& element=i.next(); | T& element=i.next(); |
| ... | ... |
| } | } |
| Line 179 public: | Line 250 public: |
| } | } |
| /// quickly extracts next Array element | /// quickly extracts next Array element |
| const T& next() { | 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++); | return *(fcurrent++); |
| } | } |
| }; | }; |
| #endif | #endif |