Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 74 insertions, 0 deletions

diff --git a/kjs/collector.h b/kjs/collector.h
new file mode 100644
index 000000000..439c14850
--- /dev/null
+++ b/kjs/collector.h
@@ -0,0 +1,74 @@
+// -*- c-basic-offset: 2 -*-
+/*
+ *  This file is part of the KDE libraries
+ *  Copyright (C) 1999-2000 Harri Porten (porten@kde.org)
+ *  Copyright (C) 2001 Peter Kelly (pmk@post.com)
+ *  Copyright (C) 2003 Apple Computer, Inc.
+ *
+ *  This library is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU Lesser General Public
+ *  License as published by the Free Software Foundation; either
+ *  version 2 of the License, or (at your option) any later version.
+ *
+ *  This library is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *  Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public
+ *  License along with this library; if not, write to the Free Software
+ *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+ *
+ */
+
+#ifndef _KJSCOLLECTOR_H_
+#define _KJSCOLLECTOR_H_
+
+#define KJS_MEM_LIMIT 500000
+
+#include "global.h"
+
+#include <stdio.h> // for size_t
+
+namespace KJS {
+
+  /**
+   * @short Garbage collector.
+   */
+  class Collector {
+    // disallow direct construction/destruction
+    Collector();
+  public:
+    /**
+     * Register an object with the collector. The following assumptions are
+     * made:
+     * @li the operator new() of the object class is overloaded.
+     * @li operator delete() has been overloaded as well and does not free
+     * the memory on its own.
+     *
+     * @param s Size of the memory to be registered.
+     * @return A pointer to the allocated memory.
+     */
+    static void* allocate(size_t s);
+    /**
+     * Run the garbage collection. This involves calling the delete operator
+     * on each object and freeing the used memory.
+     */
+    static bool collect();
+    static int size();
+    static bool outOfMemory() { return memoryFull; }
+
+#ifdef KJS_DEBUG_MEM
+    /**
+     * Check that nothing is left when the last interpreter gets deleted
+     */
+    static void finalCheck();
+#endif
+
+  private:
+    static bool memoryFull;
+  };
+
+}
+
+#endif /* _KJSCOLLECTOR_H_ */