1 files changed, 99 insertions, 0 deletions

diff --git a/include/konforka/responsible_wrapper.h b/include/konforka/responsible_wrapper.h
new file mode 100644
index 0000000..374ad45
--- a/dev/null
+++ b/include/konforka/responsible_wrapper.h
@@ -0,0 +1,99 @@
+#ifndef __KONFORKA_RESPONSIBLE_WRAPPER_H
+#define __KONFORKA_RESPONSIBLE_WRAPPER_H
+
+/**
+ * @file
+ * @brief The konforka::responsible_wrapper class declaration.
+ */
+
+#include <konforka/basic_wrapper.h>
+
+namespace konforka {
+
+    /**
+     * @brief The auto-cleanup wrapper class.
+     *
+     * The wrapper class that may feel responsible for releasing the resources
+     * associated with the content attached.
+     *
+     */
+    template<typename T>
+        class responsible_wrapper : public basic_wrapper<T> {
+            public:
+                /**
+                 * The type of wrapped content.
+                 */
+                typedef typename basic_wrapper<T>::content_type content_type;
+                /**
+                 * Flag indicating whether the object feels responsible for
+                 * releasing resources associated with the content.
+                 */
+                bool bresponsible;
+
+                /**
+                 * Default constructor creates the object with no content
+                 * attached.
+                 */
+                responsible_wrapper()
+                    : basic_wrapper<content_type>() { }
+                /**
+                 * Constructor, associating the content with the instance.
+                 * @param o the content.
+                 * @param br indicates whether resources associated with the
+                 * content should be released.
+                 */
+                responsible_wrapper(content_type o,bool br=true)
+                    : basic_wrapper<content_type>(o), bresponsible(br) { }
+                /**
+                 * Destructor releases resources associated with the content
+                 * attached (if any), if the instance feels responsible for the
+                 * content.
+                 */
+                virtual ~responsible_wrapper() { drop(); }
+
+                /**
+                 * Attaches the given content to the object.
+                 * @param o the content.
+                 * @param br indicates whether the object should feel
+                 * responsible for releasing the content.
+                 */
+                void attach(content_type o,bool br=true) {
+                    drop();
+                    basic_wrapper<content_type>::attach(o);
+                    bresponsible = true;
+                }
+
+                /**
+                 * 'empties' object, releasing resources associated with the
+                 * content if it feels responsible.
+                 */
+                virtual void drop() {
+                    if(!this->is())
+                        return;
+                    if(bresponsible)
+                        release();
+                    this->bopkele = false;
+                }
+
+                /**
+                 * Detaches the content from the object without releasing
+                 * resources even if feels responsible for it.
+                 * @return the content attached.
+                 */
+                virtual content_type detach() {
+                    this->ensure();
+                    this->bopkele = false;
+                    return this->opkele;
+                }
+
+                /**
+                 * Pure virtual provided for derived classes to override for
+                 * doing whatever it takes to release resources associated with
+                 * the content.
+                 */
+                virtual void release() = 0;
+        };
+}
+
+#endif /* __KONFORKA_RESPONSIBLE_WRAPPER_H */
+/* vim:set ft=cpp: */