Ouch.. boost::ptr_vector depends on boost-serialisation. Write a simple replacement...

This commit is contained in:
Fischlurch 2009-02-08 01:31:01 +01:00
parent e1dd3cac74
commit e435822de6
4 changed files with 280 additions and 3 deletions

162
src/lib/scoped-ptrvect.hpp Normal file
View file

@ -0,0 +1,162 @@
/*
SCOPED-PTRVECT.hpp - simple noncopyable lifecycle managing collection of pointers
Copyright (C) Lumiera.org
2009, Hermann Vosseler <Ichthyostega@web.de>
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.
This program 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 General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
/** @file scoped-ptrvect.hpp
** Managing lifecycle for a collection of objects. Sometimes we need to
** build and own a number of objects, including lifecycle management.
** For example, a service provider may need to maintain a number of individual
** process handles. The solution here is deliberately kept simple, it is
** similar to using a stl container with shared_ptr(s), but behaves rather
** like boost::scoped_ptr. It provides the same basic functionality as
** boost::ptr_vector, but doesn't require us to depend on boost-serialisation.
**
** Some details to note:
** - contained objects accessed by reference, never NULL.
** - TODO: iterators, detaching of objects...
** - TODO: retro-fit with refarray interface (--> builder branch)
**
** @see scoped-ptrvect-test.cpp
** @see scopedholder.hpp
** @see gui::DisplayService usage example
*/
#ifndef LIB_SCOPED_PTRVECT_H
#define LIB_SCOPED_PTRVECT_H
#include "include/logging.h"
#include "lib/error.hpp"
#include "lib/util.hpp"
#include <vector>
#include <boost/noncopyable.hpp>
namespace lib {
using util::for_each;
/**
* Simple vector based collection of pointers, noncopyable and managing
* lifecycle of the pointed-to objects. Implemented by a vector of
* bare pointers (private inheritance)
*/
template<class T>
class ScopedPtrVect
: std::vector<T*>,
boost::noncopyable
{
typedef std::vector<T*> _Vec;
public:
typedef size_t size_type;
typedef T & reference;
typedef T const& const_reference;
ScopedPtrVect ()
: _Vec()
{ }
explicit
ScopedPtrVect (size_type capacity)
: _Vec()
{
_Vec::reserve (capacity);
}
~ScopedPtrVect ()
{
clear();
}
/** take ownership of the given object,
* adding it at the end of the collection
* @note object is deleted in case of any
* problem while adding it
*/
T&
manage (T* obj)
{
if (obj)
try
{
push_back (obj);
return *obj;
}
catch(...)
{
delete obj;
throw;
} }
void
clear()
{
typedef typename _Vec::iterator VIter;
VIter e = this->end();
for (VIter i = this->begin(); i!=e; ++i)
{
if (*i)
try
{
delete *i;
*i = 0;
}
catch(std::exception& ex)
{
WARN (library, "Problem while deallocating ScopedPtrVect: %s", ex.what());
} }
_Vec::clear();
}
/* ====== proxied vector functions ==================== */
size_type size () const { return _Vec::size(); }
size_type max_size () const { return _Vec::max_size(); }
size_type capacity () const { return _Vec::capacity(); }
bool empty () const { return _Vec::empty(); }
private:
/** currently not used as of 2/2009 */
T* get(size_type i)
{
T* p (_Vec::at (i));
if (!p)
throw lumiera::error::Invalid("no valid object at this index");
else
return p;
}
};
} // namespace lib
#endif

View file

@ -25,9 +25,9 @@
** Working with collections of objects, especially in conjunction with
** polymorphism, can be challenging when we are bound to care for lifecycle
** and ownership for the contained classes. There are several solutions,
** including the boost::ptr_container library, the use of shared_ptr
** or even a garbage collector. Sometimes the circumstances rather call
** for a very simple or lightweight solution though.
** including the boost::ptr_container library or lib::ScopedPtrVect, the
** use of shared_ptr or even a garbage collector. Sometimes circumstances
** rather call for a very simple or lightweight solution though.
**
** ScopedPtrHolder is a simple extension to boost::scoped_ptr, enabling
** to use it within STL containers if we stick to a specific protocol.
@ -49,6 +49,7 @@
** @see scopedholdertest.cpp
** @see scopedholdertransfer.hpp use in std::vector
** @see AllocationCluster usage example
** @see scoped-ptrvect.hpp simple pointer-holding collection
*/

View file

@ -295,6 +295,11 @@ out: .throw some exceptions...
END
TEST "ScopedPtrVect_test" ScopedPtrVect_test <<END
return: 0
END
TEST "Singleton_test" Singleton_test 23 <<END
out: testing TargetObj(23) as Singleton(statically allocated)
out: ctor TargetObj(23) successful

View file

@ -0,0 +1,109 @@
/*
ScopedPtrVect(Test) - holding and owning a collection of noncopyable objects
Copyright (C) Lumiera.org
2008, Hermann Vosseler <Ichthyostega@web.de>
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.
This program 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 General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
* *****************************************************/
#include "lib/test/run.hpp"
#include "lib/util.hpp"
#include "lib/scoped-ptrvect.hpp"
#include "testdummy.hpp"
#include <iostream>
//#include <map>
namespace lib {
namespace test {
using ::Test;
using util::isnil;
// using std::map;
using std::cout;
typedef ScopedPtrVect<Dummy> VectD;
/********************************************************************
* @test ScopedPtrVect manages the lifecycle of a number of objects.
*/
class ScopedPtrVect_test : public Test
{
virtual void
run (Arg)
{
simpleUsage();
// iterating();
// detaching();
}
void
simpleUsage()
{
ASSERT (0==checksum);
{
VectD holder;
ASSERT (isnil (holder));
ASSERT (0==checksum);
Dummy* ptr = new Dummy();
Dummy& ref = holder.manage (ptr);
ASSERT (!isnil (holder));
ASSERT (0!=checksum);
ASSERT (&ref==ptr);
holder.manage (new Dummy);
holder.manage (new Dummy);
ASSERT (3 == holder.size());
holder.clear();
ASSERT (0==checksum);
ASSERT (isnil (holder));
holder.manage (new Dummy);
holder.manage (new Dummy);
holder.manage (new Dummy);
holder.manage (new Dummy);
holder.manage (new Dummy);
holder.manage (new Dummy);
holder.manage (new Dummy);
holder.manage (new Dummy);
holder.manage (new Dummy);
ASSERT (9 == holder.size());
ASSERT (0!=checksum);
}
ASSERT (0==checksum);
}
};
LAUNCHER (ScopedPtrVect_test, "unit common");
}// namespace test
} // namespace lib