mana-core-gaudikernel / GaudiKernel / ObjectContainerBase.h

Full commit
// $Header: /tmp/svngaudi/tmp.jEpFh25751/Gaudi/GaudiKernel/GaudiKernel/ObjectContainerBase.h,v 1.5 2008/10/09 16:46:49 marcocle Exp $

// Include files
#include "GaudiKernel/Kernel.h"
#include "GaudiKernel/DataObject.h"

// Forward declarations
class ContainedObject;

/** @class ObjectContainerBase ObjectContainerBase.h GaudiKernel/ObjectContainerBase.h
    ObjectContainerBase is the base class for Gaudi container classes. The main motivation
    is to allow contained object to be removed from the container on deletion and also for
    knowing it own index (e.g. distance, key, ...) in the container.

    @author Pavel Binko
    @author Pere Mato
class GAUDI_API ObjectContainerBase : public DataObject  {


  /// Constructor
  ObjectContainerBase() { }

  /// Destructor
  virtual ~ObjectContainerBase() { }


  /// size_type, to conform the STL container interface
  typedef size_t size_type;

  /// Distance of a given object from the beginning of its container
  virtual long index( const ContainedObject* obj ) const = 0;

  /// Pointer to an object of a given distance
  virtual ContainedObject* containedObject( long dist ) const = 0;

  /// Number of objects in the container
  virtual size_type numberOfObjects() const = 0;

  /** Virtual functions (forwards to the concrete container definitions)
      Add an object to the container. On success the object's index is
      returned.                                                      */
  virtual long add(ContainedObject* pObject) = 0;

  /** Release object from the container (the pointer will be removed
      from the container, but the object itself will remain alive).
      If the object was fount it's index is returned.                */
  virtual long remove(ContainedObject* value) = 0;