|
|
| version 1.57.2.27.2.13, 2003/04/02 08:35:43 | version 1.103, 2025/05/27 15:10:24 |
|---|---|
| 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-2024 Art. Lebedev Studio (http://www.artlebedev.com) |
| Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru) | Authors: Konstantin Morshnev <moko@design.ru>, Alexandr Petrosian <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$"; | #define IDENT_PA_ARRAY_H "$Id$" |
| // includes | // includes |
| #include "pa_memory.h" | #include "pa_memory.h" |
| #include "pa_types.h" | |
| #include "pa_exception.h" | #include "pa_exception.h" |
| // externals | |
| // forwards | // forwards |
| template<typename T> class Array_iterator; | template<typename T> class Array_iterator; |
| template<typename T> class Array_robust_iterator; | |
| template<typename T> class Array_reverse_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 { |
| friend class Array_iterator<T>; | friend class Array_iterator<T>; |
| friend class Array_robust_iterator<T>; | |
| friend class Array_reverse_iterator<T>; | |
| protected: | protected: |
| Line 35 protected: | Line 42 protected: |
| size_t fallocated; | size_t fallocated; |
| // array size | // array size |
| size_t fused; | size_t fsize; |
| public: | public: |
| typedef Array_iterator<T> Iterator; | |
| typedef Array_robust_iterator<T> RobustIterator; | |
| typedef Array_reverse_iterator<T> ReverseIterator; | |
| 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>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) | fsize(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 |
| size_t count() const { return fused; } | inline size_t count() const { return fsize; } |
| /// append to array | /// append to array |
| Array& operator += (T src) { | inline Array& operator+=(T src) { |
| if(is_full()) | if(is_full()) |
| expand(2); | expand(); |
| felements[fused++]=src; | felements[fsize++]=src; |
| return *this; | return *this; |
| } | } |
| /// 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) { | void append(const Array& src, size_t offset=0, size_t limit=ARRAY_OPTION_LIMIT_ALL) { //< zero limit means 'nothing' |
| if(offset<0) { | size_t src_count=src.count(); |
| throw Exception(0, | // skip tivials |
| 0, | if(!src_count || !limit || offset>=src_count) |
| "Array::append(offset=%d) out <0", offset); | return; |
| //return Nothing; // never | // max(limit) |
| } | size_t m=src_count-offset; |
| // fix limit | // fix limit |
| { | if(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); | fit(fsize-1+limit); |
| if(delta>0) | memcpy(felements+fsize, src.felements+offset, limit * sizeof(T)); |
| expand(delta); | fsize+=limit; |
| T* from=&src.felements[offset]; | |
| T* to=&felements[fused]; | |
| T* from_end=from+limit; | |
| while(from<from_end) | |
| *to++=*from++; | |
| fused+=limit; | |
| return *this; | |
| } | } |
| /// get index-element | /// get index-element |
| T get(size_t index) const { | inline T get(size_t index) const { |
| assert(index>=0 && index<count()); | assert(index<count()); |
| return felements[index]; | return felements[index]; |
| } | } |
| /// ref version of get | /// ref version of get |
| T& get_ref(size_t index) const { | inline T& get_ref(size_t index) const { |
| assert(index>=0 && index<count()); | assert(index<count()); |
| return felements[index]; | return felements[index]; |
| } | } |
| /// put index-element | /// put index-element |
| void put(size_t index, T element) { | inline void put(size_t index, T element) { |
| assert(index>=0 && index<count()); | assert(index<count()); |
| felements[index]=element; | felements[index]=element; |
| } | } |
| T operator [](size_t index) const { return get(index); } | /// insert index-element |
| inline void insert(size_t index, T element) { | |
| assert(index<=count()); | |
| if(is_full()) | |
| expand(); | |
| memmove(felements+index+1, felements+index, (fsize-index) * sizeof(T)); | |
| felements[index]=element; | |
| fsize++; | |
| } | |
| /// remove index-element | |
| inline void remove(size_t index) { | |
| assert(index<count()); | |
| if (index<--fsize) | |
| memmove(felements+index, felements+index+1, (fsize-index) * sizeof(T)); | |
| } | |
| inline T operator [](size_t index) const { return get(index); } | |
| inline void clear() { | |
| if(fsize) | |
| memset((void *)felements, 0, fsize * sizeof(T)); | |
| fsize=0; | |
| } | |
| /// 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 { |
| T *last=felements+fused; | T *last=felements+fsize; |
| for(T *current=felements; current<last; current++) | |
| callback(*current, info); | |
| } | |
| /// iterate over all elements | |
| template<typename I> void for_each(bool (*callback)(T, I), I info) const { | |
| T *last=felements+fsize; | |
| 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+fsize; | |
| for(T *current=felements; current<last; current++) | for(T *current=felements; current<last; current++) |
| callback(*current, info); | 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+fsize; |
| for(T *current=felements; current<last; current++) | for(T *current=felements; current<last; current++) |
| if(callback(*current, info)) | if(callback(*current, info)) |
| return *current; | return *current; |
| Line 127 public: | Line 205 public: |
| return T(0); | return T(0); |
| } | } |
| inline T* ptr(size_t index){ | |
| return felements + index; | |
| } | |
| protected: | protected: |
| bool is_full() { | inline bool is_full() { |
| return fused == fallocated; | return fsize == fallocated; |
| } | } |
| void expand(size_t delta) { | |
| size_t new_allocated=fallocated+delta; | inline void expand() { |
| felements = (T *)realloc(felements, new_allocated*sizeof(T)); | resize(fallocated>0 ? fallocated+fallocated/2+2 : 3); // 3 is PAF default, confirmed by tests |
| memset(&felements[fallocated], 0, delta*sizeof(T)); | } |
| fallocated=new_allocated; | |
| inline void fit(size_t index){ | |
| if(index >= fallocated) | |
| resize(max(fallocated+fallocated/4, index+1)); | |
| } | |
| void resize(size_t asize) { | |
| if(fallocated){ | |
| felements=(T *)pa_realloc(felements, asize*sizeof(T)); | |
| fallocated=asize; | |
| } else { | |
| fallocated=asize; | |
| felements=(T *)pa_malloc(asize*sizeof(T)); | |
| } | |
| } | } |
| private: //disabled | private: //disabled |
| Line 146 private: //disabled | Line 241 private: //disabled |
| }; | }; |
| /// Commonly used, templated to work with any integer type | |
| template<typename T> char* pa_itoa(T n, T base=10){ | |
| char buf[MAX_NUMBER + 1]; | |
| char* pos=buf + MAX_NUMBER; | |
| *pos='\0'; | |
| bool negative=n < 0; | |
| if (n < 0){ | |
| n=-n; | |
| } | |
| do { | |
| *(--pos)=(char)(n % base) + '0'; | |
| n/=base; | |
| } while (n > 0); | |
| if (negative) { | |
| *(--pos) = '-'; | |
| } | |
| return pa_strdup(pos, buf + MAX_NUMBER - pos); | |
| } | |
| template<typename T> char* pa_uitoa(T n, T base=10){ | |
| char buf[MAX_NUMBER + 1]; | |
| char* pos=buf + MAX_NUMBER; | |
| *pos='\0'; | |
| do { | |
| *(--pos)=(char)(n % base) + '0'; | |
| n/=base; | |
| } while (n > 0); | |
| return pa_strdup(pos, buf + MAX_NUMBER - pos); | |
| } | |
| /** Array iterator, usage: | /** Array iterator, usage: |
| @code | @code |
| // Array<T> a; | // Array<T> a; |
| for(Array_iterator<T> i(a); i.has_next(); ) { | for(Array_iterator<T> i(a); i; ) { |
| T& element=i.next(); | T& element=i.next(); |
| ... | ... |
| } | } |
| Line 162 template<typename T> class Array_iterato | Line 294 template<typename T> class Array_iterato |
| T *flast; | T *flast; |
| public: | public: |
| Array_iterator(const 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.fsize; |
| } | } |
| /// there are still elements | /// there are still elements |
| bool has_next() { | inline operator bool () { |
| return fcurrent<flast; | return fcurrent < flast; |
| } | } |
| /// quickly extracts next Array element | /// returns the current element and advances the iterator |
| const T next() { | inline T next() { |
| return *(fcurrent++); | return *(fcurrent++); |
| } | } |
| /// returns the current element | |
| inline T value() { | |
| return *(fcurrent); | |
| } | |
| // returns the current index of the iterator | |
| inline size_t index() { | |
| return fcurrent - farray.felements; | |
| } | |
| // returns the current index string value of the iterator | |
| inline char *key() { | |
| return pa_uitoa(index()); | |
| } | |
| }; | }; |
| /* | |
| /** Nonconst 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_modifing_iterator { | |
| Array<T>& farray; | // Slower array iterator for arrays that can be modified during iteration |
| T *fcurrent; | template<typename T> class Array_robust_iterator { |
| T *flast; | |
| const Array<T>& farray; | |
| size_t findex; | |
| public: | public: |
| Array_robust_iterator(const Array<T>& aarray) : farray(aarray), findex(0) {} | |
| Array_modifing_iterator(Array<T>& aarray): farray(aarray) { | inline operator bool() { |
| fcurrent=farray.felements; | return findex < farray.fsize; |
| flast=farray.felements+farray.count(); | |
| } | } |
| /// there are still elements | inline void next() { |
| bool has_next() { | findex++; |
| return fcurrent<flast; | |
| } | } |
| /// quickly extracts next Array element | inline T value() { |
| T& next() { | return farray.felements[findex]; |
| return *(fcurrent++); | |
| } | } |
| inline size_t index() { | |
| return findex; | |
| } | |
| }; | |
| // Robust as used for arrays that can be modified during iteration | |
| template<typename T> class Array_reverse_iterator { | |
| const Array<T>& farray; | |
| size_t findex; | |
| public: | |
| Array_reverse_iterator(const Array<T>& aarray): farray(aarray), findex(aarray.fsize) {} | |
| inline operator bool () { | |
| return (findex > 0) && (findex <= farray.fsize); | |
| } | |
| inline T prev() { | |
| return farray.felements[--findex]; | |
| } | |
| inline size_t index() { | |
| return findex; | |
| } | |
| }; | }; |
| */ | |
| #endif | #endif |