Annotation of parser3/src/include/pa_pool.h, revision 1.86.2.14
1.34 paf 1: /** @file
1.86.2.1 paf 2: Parser: Parser: reference counting classes decls.
1.36 paf 3:
1.86 paf 4: Copyright (c) 2001, 2003 ArtLebedev Group (http://www.artlebedev.com)
1.36 paf 5:
1.78 paf 6: Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
1.1 paf 7: */
8:
9: #ifndef PA_POOL_H
10: #define PA_POOL_H
1.82 paf 11:
1.86.2.14! paf 12: static const char* IDENT_POOL_H="$Date: 2003/01/28 09:48:16 $";
1.1 paf 13:
1.52 parser 14: #include "pa_config_includes.h"
1.1 paf 15:
1.59 parser 16: #ifdef XML
1.75 paf 17: # include "gdome.h"
1.76 paf 18: // for xmlChar
19: # include "libxml/tree.h"
1.59 parser 20: #endif
1.55 parser 21:
1.86.2.1 paf 22: void *pa_malloc(size_t size);
23: void *pa_calloc(size_t size);
24: void pa_free(void *ptr);
25: void *pa_realloc(void *ptr, size_t size);
26:
1.55 parser 27: // forwards
28:
1.21 paf 29: class Exception;
1.55 parser 30: class String;
1.73 paf 31: class Charset;
1.75 paf 32: class GdomeDOMString_auto_ptr;
1.55 parser 33:
1.86.2.1 paf 34: /* *
1.34 paf 35: Pool mechanizm allows users not to free up allocated memory,
36: leaving that problem to 'pools'.
37:
1.38 paf 38: @see Pooled
1.86.2.1 paf 39: * /
1.47 paf 40:
1.1 paf 41: class Pool {
42: public:
1.18 paf 43:
1.55 parser 44: Pool(void *astorage);
1.18 paf 45:
1.79 paf 46: //{@ statistics
1.70 paf 47: size_t total_allocated() { return ftotal_allocated; }
48: unsigned int total_times() { return ftotal_times; }
1.79 paf 49: //}@
1.70 paf 50:
1.40 paf 51: void set_context(void *acontext) { fcontext=acontext; }
1.64 parser 52: void *get_context() { return fcontext; }
1.39 paf 53:
1.34 paf 54: /// allocates some bytes on pool
1.68 paf 55: void *malloc(size_t size, int place=0) {
56: return check(real_malloc(size, place), size);
1.18 paf 57: }
1.34 paf 58: /// allocates some bytes clearing them with zeros
1.18 paf 59: void *calloc(size_t size) {
60: return check(real_calloc(size), size);
61: }
1.39 paf 62:
1.53 parser 63: /// registers a routine to clean up non-pooled allocations
1.54 parser 64: void register_cleanup(void (*cleanup) (void *), void *data) {
65: if(!real_register_cleanup(cleanup, data))
66: fail_register_cleanup();
67: }
1.53 parser 68:
1.84 paf 69: //{@ helpers
70: void *copy(const void *buf, const size_t size);
71: char *copy(const char *cstr);
72: //}@
73:
1.79 paf 74: //{@ source charset
1.73 paf 75: void set_source_charset(Charset& acharset);
76: Charset& get_source_charset();
1.79 paf 77: //}@
1.73 paf 78:
1.79 paf 79: //{@ client charset
1.73 paf 80: void set_client_charset(Charset& charset);
81: Charset& get_client_charset();
1.79 paf 82: //}@
1.73 paf 83:
84: #ifdef XML
1.74 paf 85:
1.76 paf 86: /// @see Charset::transcode_cstr(xmlChar *s);
87: const char *transcode_cstr(xmlChar *s);
88: /// @see Charset::transcode(xmlChar *s);
1.85 paf 89: String& transcode(xmlChar *s
90: #ifndef NO_STRING_ORIGIN
91: , const String *origin
92: #endif
93: );
1.76 paf 94: /// @see Charset::transcode_cstr(GdomeDOMString *s);
1.74 paf 95: const char *transcode_cstr(GdomeDOMString *s);
1.76 paf 96: /// @see Charset::transcode(GdomeDOMString *s);
1.85 paf 97: String& transcode(GdomeDOMString *s
98: #ifndef NO_STRING_ORIGIN
99: , const String *origin
100: #endif
101: );
1.81 paf 102: /// @see Charset::transcode_cstr(const char *buf, size_t buf_size=0);
103: xmlChar *transcode_buf2xchar(const char *buf, size_t buf_size=0);
1.73 paf 104: /// @see Charset::transcode(const String& s)
1.75 paf 105: GdomeDOMString_auto_ptr transcode(const String& s);
1.74 paf 106:
1.73 paf 107: #endif
1.60 parser 108:
1.39 paf 109: private:
110:
111: void *fstorage;
1.40 paf 112: void *fcontext;
1.73 paf 113: Charset *source_charset;
114: Charset *client_charset;
1.8 paf 115:
1.50 parser 116: private:
117:
118: //{
119: /// @name implementation defined
1.68 paf 120: void *real_malloc(size_t size, int place);
1.20 paf 121: void *real_calloc(size_t size);
1.54 parser 122: bool real_register_cleanup(void (*cleanup) (void *), void *data);
1.50 parser 123: //}
1.17 paf 124:
1.23 paf 125: private:
1.17 paf 126:
1.34 paf 127: /// checks whether mem allocated OK. throws exception otherwise
1.23 paf 128: void *check(void *ptr, size_t size) {
1.70 paf 129: if(ptr) {
130: ftotal_allocated+=size;
131: ftotal_times++;
1.23 paf 132: return ptr;
1.70 paf 133: }
1.23 paf 134:
1.54 parser 135: fail_alloc(size);
1.23 paf 136:
137: // never reached
138: return 0;
139: }
1.54 parser 140: /// throws allocation exception
141: void fail_alloc(size_t size) const;
142:
143: /// throws register cleanup exception
144: void fail_register_cleanup() const;
1.70 paf 145:
146: private: // statistics
147:
148: size_t ftotal_allocated;
149: unsigned int ftotal_times;
1.59 parser 150:
1.8 paf 151: private: //disabled
152:
1.64 parser 153: Pool(const Pool&);
154: Pool& operator= (const Pool&);
1.21 paf 155: };
1.86.2.1 paf 156: */
157:
1.21 paf 158:
1.35 paf 159: /**
1.34 paf 160: Base for all classes that are allocated in 'pools'.
161:
162: Holds Pool object. Contains useful wrappers to it's methods.
1.38 paf 163:
1.64 parser 164: @see NEW
1.86.2.1 paf 165: * /
1.80 paf 166:
167: // all classes that are members parents of packed class [String]
168: // sould be packed also to avoid sparc odd st/lduh problem
169: #include "pa_pragma_pack_begin.h"
1.21 paf 170: class Pooled {
1.23 paf 171: // the pool i'm allocated on
1.49 paf 172: Pool *fpool;
1.21 paf 173: public:
1.37 paf 174:
175: /// the Pooled-sole: Pooled instances can be allocated in Pool rather then on heap
1.21 paf 176: static void *operator new(size_t size, Pool& apool) {
1.68 paf 177: return apool.malloc(size, 1);
1.21 paf 178: }
179:
1.49 paf 180: Pooled(Pool& apool) : fpool(&apool) {}
1.23 paf 181:
1.34 paf 182: /// my pool
1.49 paf 183: Pool& pool() const { return *fpool; }
184:
185: /** used for moving objects from one pool to another.
186: in between object can have no pool and can not be used
187: @see SQL_Driver_manager
1.86.2.1 paf 188: * /
1.49 paf 189: void set_pool(Pool *apool) { fpool=apool; }
1.21 paf 190:
1.57 parser 191: //{
192: /// @name useful wrapper around pool
1.68 paf 193: void *malloc(size_t size, int place=0) const { return fpool->malloc(size, place); }
1.49 paf 194: void *calloc(size_t size) const { return fpool->calloc(size); }
1.57 parser 195: void register_cleanup(void (*cleanup) (void *), void *data) { fpool->register_cleanup(cleanup, data); }
1.84 paf 196: void *copy(const void *buf, const size_t size) { return fpool->copy(buf, size); }
197: char *copy(const char *cstr) { return fpool->copy(cstr); }
1.59 parser 198: #ifdef XML
1.74 paf 199:
200: const char *transcode_cstr(GdomeDOMString *s) { return fpool->transcode_cstr(s); }
1.85 paf 201: String& transcode(GdomeDOMString *s
202: #ifndef NO_STRING_ORIGIN
203: , const String *origin
204: #endif
205: ) {
206: return fpool->transcode(s
207: #ifndef NO_STRING_ORIGIN
208: , origin
209: #endif
210: );
211: }
1.74 paf 212:
1.59 parser 213: #endif
1.57 parser 214: //}
1.23 paf 215: };
1.80 paf 216: #include "pa_pragma_pack_end.h"
1.34 paf 217: /// useful macro for creating objects on current Pooled object Pooled::pool()
1.23 paf 218: #define NEW new(pool())
1.86.2.1 paf 219: */
220:
1.86.2.2 paf 221: #define override
222:
223: void *operator new(size_t size) {
224: return pa_malloc(size);
225: }
226: void operator delete(void *ptr) {
227: pa_free(ptr);
228: }
1.86.2.1 paf 229:
1.86.2.2 paf 230: class PA_Allocated {
1.86.2.1 paf 231: public:
1.86.2.2 paf 232: /// the sole: instances allocated using our functions
1.86.2.1 paf 233: static void *operator new(size_t size) {
234: return pa_malloc(size);
235: }
236: static void operator delete(void *ptr) {
237: pa_free(ptr);
238: }
1.86.2.11 paf 239: static void *malloc(size_t size) {
240: return pa_malloc(size);
241: }
242: static void *calloc(size_t size) {
243: return pa_calloc(size);
244: }
245: static void *realloc(void *ptr, size_t size) {
246: return pa_realloc(ptr, size);
247: }
248:
1.86.2.1 paf 249: };
250:
1.86.2.2 paf 251: /**
252: Base for all Parser classes, memory allocation/dallocation goes via pa_malloc/pa_free.
253: */
254: class PA_Object: public PA_Allocated {
1.86.2.12 paf 255: mutable unsigned long freferences;
1.86.2.2 paf 256: public:
1.86.2.12 paf 257: PA_Object(): freferences(0) {}
1.86.2.2 paf 258: virtual ~PA_Object()=0;
259:
1.86.2.4 paf 260: void ref() const {
1.86.2.12 paf 261: freferences++;
1.86.2.2 paf 262: }
1.86.2.4 paf 263: void unref() const {
1.86.2.12 paf 264: if(freferences) {
265: if(--freferences==0)
1.86.2.2 paf 266: delete this;
267: }
268: }
269: };
270:
271:
1.86.2.3 paf 272: template<typename T> class object_ptr {
1.86.2.1 paf 273: T *ptr;
274: public:
275: typedef T element_type;
1.86.2.2 paf 276:
1.86.2.3 paf 277: explicit object_ptr(T *ptr = 0) {
1.86.2.1 paf 278: this->ptr=ptr;
279: if(ptr)
1.86.2.2 paf 280: ptr->ref();
1.86.2.1 paf 281: }
1.86.2.3 paf 282: object_ptr(const object_ptr<T>& src) {
1.86.2.1 paf 283: ptr=src.get();
1.86.2.2 paf 284: ptr->ref();
1.86.2.1 paf 285: }
1.86.2.7 paf 286: object_ptr<T>& operator=(const object_ptr<T>& src) {
1.86.2.1 paf 287: if(this!=&src)
288: if(ptr!=src.get()) {
289: if(ptr)
1.86.2.2 paf 290: ptr->unref();
1.86.2.1 paf 291: ptr=src.get();
292: if(ptr)
1.86.2.2 paf 293: ptr->ref();
1.86.2.1 paf 294: }
1.86.2.6 paf 295: return *this;
1.86.2.1 paf 296: }
1.86.2.3 paf 297: ~object_ptr() {
1.86.2.1 paf 298: if(ptr)
1.86.2.2 paf 299: ptr->unref();
1.86.2.1 paf 300: }
301: T& operator*() const {
302: return *get();
303: }
304: T *operator->() const {
305: return get();
306: }
307: T *get() const {
308: return ptr;
309: }
1.86.2.14! paf 310: // so one could object_ptr<const T> = object_ptr<T>
1.86.2.8 paf 311: operator object_ptr<const T>() const{
1.86.2.7 paf 312: return *this;
313: }
1.86.2.8 paf 314: operator bool() const {
1.86.2.7 paf 315: return get()!=0;
316: }
1.86.2.8 paf 317: operator !() const {
318: return get()==0;
319: }
1.86.2.1 paf 320: };
1.86.2.2 paf 321:
1.86.2.8 paf 322: #define DECLARE_OBJECT_PTR(name) typedef object_ptr<name> name##Ptr;
323:
1.86.2.3 paf 324: /// TEMPLATE CLASS smart_ptr, stolen from stl:auto_ptr
1.86.2.2 paf 325: template<class T>
1.86.2.3 paf 326: class smart_ptr {
1.86.2.2 paf 327: public:
328: typedef T element_type;
1.86.2.3 paf 329: explicit smart_ptr(T *_P = 0)
1.86.2.2 paf 330: : _Owns(_P != 0), _Ptr(_P) {}
1.86.2.3 paf 331: smart_ptr(const smart_ptr<T>& _Y)
1.86.2.2 paf 332: : _Owns(_Y._Owns), _Ptr(_Y.release()) {}
1.86.2.3 paf 333: smart_ptr<T>& operator=(const smart_ptr<T>& _Y)
1.86.2.2 paf 334: {if (this != &_Y)
335: {if (_Ptr != _Y.get())
336: {if (_Owns)
337: delete _Ptr;
338: _Owns = _Y._Owns; }
339: else if (_Y._Owns)
340: _Owns = true;
341: _Ptr = _Y.release(); }
342: return (*this); }
1.86.2.3 paf 343: ~smart_ptr()
1.86.2.2 paf 344: {if (_Owns)
345: delete _Ptr; }
346: T& operator*() const
347: {return (*get()); }
348: T *get() const
349: {return (_Ptr); }
350: T *release() const
1.86.2.3 paf 351: {((smart_ptr<T> *)this)->_Owns = false;
1.86.2.2 paf 352: return (_Ptr); }
1.86.2.14! paf 353: // so one could smart_ptr<const T> = smart_ptr<T>
1.86.2.8 paf 354: operator smart_ptr<const T>() const {
355: return *this;
356: }
357: operator bool() const {
1.86.2.10 paf 358: return get()!=0;
1.86.2.7 paf 359: }
1.86.2.9 paf 360: operator T*() const {
361: return _Ptr;
362: }
1.86.2.2 paf 363: private:
364: bool _Owns;
365: T *_Ptr;
366: };
367:
1.86.2.5 paf 368: // convinient types
369:
1.86.2.6 paf 370: typedef smart_ptr<char> CharPtr;
1.86.2.13 paf 371: const CharPtr CharPtrZero(0);
1.1 paf 372:
373: #endif
E-mail: