objdb.h

Go to the documentation of this file.

//
// Copyright (c) 1999-2004 California Institute of Technology
// Copyright (c) 2004-2007 University of Southern California
// Rob Peters <rjpeters at usc dot edu>
//
// created: Sun Nov 21 00:26:29 1999
// commit: $Id: objdb.h 10065 2007-04-12 05:54:56Z rjpeters $
// $HeadURL: file:///lab/rjpeters/svnrepo/code/trunk/groovx/src/nub/objdb.h $
//
// --------------------------------------------------------------------
//
// This file is part of GroovX.
//   [http://ilab.usc.edu/rjpeters/groovx/]
//
// GroovX 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.
//
// GroovX 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 GroovX; if not, write to the Free Software Foundation,
// Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
//

#ifndef GROOVX_NUB_OBJDB_H_UTC20050626084019_DEFINED
#define GROOVX_NUB_OBJDB_H_UTC20050626084019_DEFINED

#include "nub/uid.h"

#include "rutz/error.h"
#include "rutz/iter.h"

namespace nub
{
  class object;
  class objectdb;
  class invalid_uid_error;
}

class nub::invalid_uid_error : public rutz::error
{
public:
  invalid_uid_error(nub::uid id, const rutz::file_pos& pos);

  virtual ~invalid_uid_error() throw();
};




class nub::objectdb
{
protected:
  objectdb();

public:
  virtual ~objectdb();

  static objectdb& instance();

  class impl;

  //
  // Iterators
  //

  typedef rutz::fwd_iter<object* const> iterator;

  iterator objects() const;

  template <class T>
  class casting_iterator
  {
    iterator m_itr;

    void advance_to_valid()
    {
      while (!m_itr.at_end() && (dynamic_cast<T*>(*m_itr)==0))
        ++m_itr;
    }

  public:
    casting_iterator(const iterator& begin) : m_itr(begin)
    { advance_to_valid(); }

    casting_iterator& operator++() { ++m_itr; advance_to_valid(); return *this; }

    bool at_end() const { return m_itr.at_end(); }
    bool is_valid() const { return m_itr.is_valid(); }

    T* operator*() const { return &(dynamic_cast<T&>(**m_itr)); }

    T* operator->() const { return operator*(); }
  };

  //
  // Collection interface
  //

  int count() const throw();

  bool is_valid_uid(nub::uid id) const throw();


  void remove(nub::uid id);

  void release(nub::uid id);


  void purge();


  void clear();


  void clear_on_exit();


  nub::object* get_checked_obj(nub::uid id) throw (nub::invalid_uid_error);

  void insert_obj(nub::object* obj);

  void insert_obj_weak(nub::object* obj);

private:
  objectdb(const objectdb&);
  objectdb& operator=(const objectdb&);

  impl* const rep;
};

static const char __attribute__((used)) vcid_groovx_nub_objdb_h_utc20050626084019[] = "$Id: objdb.h 10065 2007-04-12 05:54:56Z rjpeters $ $HeadURL: file:
#endif // !GROOVX_NUB_OBJDB_H_UTC20050626084019_DEFINED

---

The software described here is Copyright (c) 1998-2005, Rob Peters.
This page was generated Wed Dec 3 06:49:39 2008 by Doxygen version 1.5.5.