gras: formalize the weak container api w/ docs

address issue #69, we now have a set_container call,
which is now formally part of the api.

Anyone can call set_container for custom container types.
GRAS supports shared ptr and pyobject out of the box.

1 files changed, 5 insertions, 0 deletions

diff --git a/lib/element.cpp b/lib/element.cpp
index 989c184..dfc3f57 100644
--- a/lib/element.cpp
+++ b/lib/element.cpp
@@ -48,6 +48,11 @@ ElementImpl::~ElementImpl(void)
     if (this->block) this->block_cleanup();
 }
 
+void Element::set_container(WeakContainer *container)
+{
+    (*this)->weak_self.reset(container);
+}
+
 bool Element::equals(const Element &rhs)
 {
     return this->get() == rhs.get();