contain.h

Go to the documentation of this file.

/*
 * contain.h
 *
 * Umbrella include for Container Classes.
 *
 * Portable Windows Library
 *
 * Copyright (c) 1993-1998 Equivalence Pty. Ltd.
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.0 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 * the License for the specific language governing rights and limitations
 * under the License.
 *
 * The Original Code is Portable Windows Library.
 *
 * The Initial Developer of the Original Code is Equivalence Pty. Ltd.
 *
 * Portions are Copyright (C) 1993 Free Software Foundation, Inc.
 * All Rights Reserved.
 *
 * Contributor(s): ______________________________________.
 *
 * $Revision: 22375 $
 * $Author: rjongbloed $
 * $Date: 2009-04-06 21:47:23 -0500 (Mon, 06 Apr 2009) $
 */

#ifndef PTLIB_CONTAIN_H
#define PTLIB_CONTAIN_H

#ifdef P_USE_PRAGMA
#pragma interface
#endif


#include <ptlib/critsec.h>
#include <ptlib/object.h>



// Abstract container class

// The type below cannot be nested into PContainer as DevStudio 2005 AUTOEXP.DAT doesn't like it
class PContainerReference {
  public:
    inline PContainerReference(PINDEX initialSize)
      : size(initialSize), count(1), deleteObjects(PTrue)
    {
    }

    inline PContainerReference(const PContainerReference & ref)
      : size(ref.size), count(1), deleteObjects(ref.deleteObjects)
    {  
    }

    PINDEX   size;         // Size of what the container contains
    PAtomicInteger count;  // reference count to the container content - guaranteed to be atomic
    PBoolean deleteObjects;    // Used by PCollection but put here for efficiency

  private:
    PContainerReference & operator=(const PContainerReference &) 
    { return *this; }
};

class PContainer : public PObject
{
  PCLASSINFO(PContainer, PObject);

  public:
    PContainer(
      PINDEX initialSize = 0  
    );

    PContainer(
      const PContainer & cont  
    );

    PContainer & operator=(
      const PContainer & cont  
    );

    virtual ~PContainer()
    { Destruct(); }


    virtual PINDEX GetSize() const;

    virtual PBoolean SetSize(
      PINDEX newSize  
    ) = 0;

    PBoolean SetMinSize(
      PINDEX minSize  
    );

    virtual PBoolean IsEmpty() const;

    PBoolean IsUnique() const;

    virtual PBoolean MakeUnique();

  protected:
    PContainer(
      int dummy,        
      const PContainer * cont  
    );

    virtual void DestroyContents() = 0;

    virtual void AssignContents(const PContainer & c);

    void CopyContents(const PContainer & c);

    void CloneContents(const PContainer * src);

    void Destruct();


    PContainerReference * reference;
};



#define PCONTAINERINFO(cls, par) \
    PCLASSINFO(cls, par) \
  public: \
    cls(const cls & c) : par(c) { CopyContents(c); } \
    cls & operator=(const cls & c) \
      { AssignContents(c); return *this; } \
    virtual ~cls() { Destruct(); } \
    virtual PBoolean MakeUnique() \
      { if(par::MakeUnique())return PTrue; CloneContents(this);return PFalse; } \
  protected: \
    cls(int dummy, const cls * c) : par(dummy, c) { CloneContents(c); } \
    virtual void DestroyContents(); \
    void CloneContents(const cls * c); \
    void CopyContents(const cls & c); \
    virtual void AssignContents(const PContainer & c) \
      { par::AssignContents(c); CopyContents((const cls &)c); }


// Abstract collection of objects class

class PCollection : public PContainer
{
  PCLASSINFO(PCollection, PContainer);

  public:
    PCollection(
      PINDEX initialSize = 0  
    );

    virtual void PrintOn(
      ostream &strm   
    ) const;

    virtual PINDEX Append(
      PObject * obj   
    ) = 0;

    virtual PINDEX Insert(
      const PObject & before,   
      PObject * obj             
    ) = 0;

    virtual PINDEX InsertAt(
      PINDEX index,   
      PObject * obj   
    ) = 0;

    virtual PBoolean Remove(
      const PObject * obj   
    ) = 0;

    virtual PObject * RemoveAt(
      PINDEX index   
    ) = 0;

    virtual void RemoveAll();

    virtual PBoolean SetAt(
      PINDEX index,   
      PObject * val   
    ) = 0;

    virtual PObject * GetAt(
      PINDEX index  
    ) const = 0;

    virtual PINDEX GetObjectsIndex(
      const PObject * obj  
    ) const = 0;

    virtual PINDEX GetValuesIndex(
      const PObject & obj  
    ) const = 0;

    PINLINE void AllowDeleteObjects(
      PBoolean yes = PTrue   
    );

    void DisallowDeleteObjects();

  protected:
    PINLINE PCollection(
      int dummy,        
      const PCollection * coll  
    );
};



// The abstract array class

#include <ptlib/array.h>

// The abstract array class

#include <ptlib/lists.h>

// PString class (specialised version of PBASEARRAY(char))

#include <ptlib/dict.h>


// PString class

#include <ptlib/pstring.h>



// Fill in all the inline functions

#if P_USE_INLINES
#include <ptlib/contain.inl>
#endif


#endif // PTLIB_CONTAIN_H


// End Of File ///////////////////////////////////////////////////////////////