|
|
| version 1.57.2.26, 2003/02/26 10:17:30 | 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 26 template<typename T> class Array: public | Line 30 template<typename T> class Array: public |
| protected: | protected: |
| // default expand delta size | |
| int fdelta; | |
| /// elements[growing size] here | /// elements[growing size] here |
| 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, int delta=1): | inline Array(size_t initial=0): |
| fallocated(initial?initial:3), | fallocated(initial), |
| fdelta(delta), | |
| fused(0) | fused(0) |
| { | { |
| if(fallocated<=0 || fdelta<1) | felements=fallocated?(T *)pa_malloc(fallocated*sizeof(T)):0; |
| throw Exception(0, | |
| Exception::undefined_source, | |
| "Array::Array(%d, %d) too small", initial, delta); | |
| // we can't use new(0) here[like we did in Hash] because we need to use realloc | |
| // on MSVC new returns NOT pointer learned from pa_malloc, so we can't do new+realloc | |
| felements=static_cast<T*>(calloc(fallocated*sizeof(T))); | |
| } | } |
| override ~Array() { | |
| // see comment in ctor | |
| T *last=felements+fused; | |
| for(T *current=felements; current<last; current++) | |
| current->~T(); // manually invoking destructors | |
| free(felements); | #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(fdelta); | expand(fallocated>0? 2+fallocated/32 : 3); // 3 is PAF default, confirmed by tests |
| felements[fused++]=src; | felements[fused++]=src; |
| Line 77 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' |
| Exception::undefined_source, | 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, | |
| Exception::undefined_source, | |
| "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, | |
| Exception::undefined_source, | |
| "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 140 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 150 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(int delta) { | void expand(size_t delta) { |
| felements = (T *)realloc(felements, (fallocated+delta)*sizeof(T)); | if(fallocated){ |
| memset(&felements[fallocated], 0, delta*sizeof(T)); | size_t new_allocated=fallocated+delta; |
| fallocated+=delta; | felements=(T *)pa_realloc(felements, new_allocated*sizeof(T)); |
| fallocated=new_allocated; | |
| } else { | |
| fallocated=delta; | |
| felements=(T *)pa_malloc(fallocated*sizeof(T)); | |
| } | |
| } | } |
| private: //disabled | private: //disabled |
| Array(const Array&) {} | |
| Array& operator = (const Array&) { return *this; } | Array& operator = (const Array&) { return *this; } |
| }; | }; |
| /// handy array iterator | /** Array iterator, usage: |
| @code | |
| // Array<T> a; | |
| for(Array_iterator<T> i(a); i.has_next(); ) { | |
| T& element=i.next(); | |
| ... | |
| } | |
| @endcode | |
| */ | |
| template<typename T> class Array_iterator { | template<typename T> class Array_iterator { |
| Array<T>& farray; | const Array<T>& farray; |
| T *fcurrent; | T *fcurrent; |
| T *flast; | T *flast; |
| public: | public: |
| Array_iterator(Array<T>& aarray): farray(aarray) { | Array_iterator(const Array<T>& aarray): farray(aarray) { |
| fcurrent=farray.felements; | fcurrent=farray.felements; |
| flast=farray.felements+farray.count(); | flast=farray.felements+farray.count(); |
| } | } |
| Line 187 public: | Line 250 public: |
| } | } |
| /// quickly extracts next Array element | /// quickly extracts next Array element |
| T& next() { | T next() { |
| return *(fcurrent++); | return *(fcurrent++); |
| } | } |
| }; | }; |
| #endif | #endif |