---

MemoryStorage.hpp

#if   !defined(__MEMORYSTORAGE_HPP)
#define  __MEMORYSTORAGE_HPP

/*
  CoreLinux++ 
  Copyright (C) 1999,2000 CoreLinux Consortium
  
   The CoreLinux++ Library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public License as
   published by the Free Software Foundation; either version 2 of the
   License, or (at your option) any later version.

   The CoreLinux++ Library Library 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
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public
   License along with the GNU C Library; see the file COPYING.LIB.  If not,
   write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
   Boston, MA 02111-1307, USA.  
*/

#if   !defined(__COMMON_HPP)
#include <Common.hpp>
#endif

#if   !defined(__TRANSIENTSTORAGE_HPP)
#include <TransientStorage.hpp>
#endif

#if   !defined(__BOUNDSEXCEPTION_HPP)
#include <BoundsException.hpp>
#endif

namespace corelinux
{
   DECLARE_CLASS( MemoryStorage );

   class MemoryStorage : public TransientStorage, Synchronized
   {

   public:


      //
      // Constructors and destructor
      //
                        MemoryStorage( MemoryIdentifierCref , IntCref , VoidPtr );

      //
      // Operator overloads
      //


               bool  operator==( MemoryStorageCref ) const;


                     operator MemoryIdentifierCref( void ) const;

      //
      // Accessors
      //


                     void  operator+( Int ) throw( BoundsException );


                     void  operator-( Int ) throw( BoundsException );


                     template< class T > 
                        operator T( void ) throw( BoundsException )
                     {
                        // Bounds check first

                        if( Dword( ( BytePtr(theCurrentPointer) + sizeof(T) ) - 
                                  BytePtr(theBasePointer)) > Dword(theSize) )
                        {
                           throw BoundsException( LOCATION );
                        }
                        else
                        {
                           ;  // do nothing
                        }

                        return ((T *)theCurrentPointer)[0];
                     }


                     template< class T > 
                        operator T*( void ) throw( BoundsException )
                     {
                        // Bounds check first

                        if( Dword( ( BytePtr(theCurrentPointer) + sizeof(T) ) - 
                                  BytePtr(theBasePointer)) > Dword(theSize) )
                        {
                           throw BoundsException( LOCATION );
                        }
                        else
                        {
                           ;  // do nothing
                        }

                        return ((T *)theCurrentPointer);
                     }
      //
      // Mutators
      //

                     template< class T > 
                        T & operator=( T & aT ) throw( BoundsException )
                     {
                        if( Dword( ( BytePtr(theCurrentPointer) + sizeof(T) ) - 
                                  BytePtr(theBasePointer)) > Dword(theSize) )
                        {
                           throw BoundsException( LOCATION );
                        }
                        else
                        {
                           ;  // do nothing
                        }

                        GUARD;
                        std::memmove( theCurrentPointer, &aT, sizeof(T) );

                        return aT;
                     }


                     MemoryStorageRef  operator[]( Int offset ) 
                           throw( BoundsException );
      //
      // Traversal operations
      //

                     template < class Type, class Xexec >
                        void  forEach( Xexec aExec ) throw ( Assertion )
                     {
                        REQUIRE( aExec != NULLPTR );

                        GUARD;

                        Type  *pType( (Type *)theBasePointer );
                        Int   maxCount( theSize / sizeof( Type ) );

                        for( Int x = 0; x < maxCount; ++x, ++pType )
                        {
                           (*aExec)(pType);
                        }
                     }
                     

                     template < class Type, class Xexec, class Test >
                        void  forEach( Xexec aExec, Test aTest ) 
                           throw ( Assertion )
                     {
                        REQUIRE( aExec != NULLPTR );
                        REQUIRE( aTest != NULLPTR );

                        GUARD;

                        Type  *pType( (Type *)theBasePointer );
                        Int   maxCount( theSize / sizeof( Type ) );

                        for( Int x = 0; x < maxCount; ++x, ++pType )
                        {
                           if( (*aTest)(pType) == true )
                           {
                              (*aExec)(pType);
                           }
                           else
                           {
                              ;  // do nothing
                           }
                        }
                     }


   protected:


               friend class Memory;


                        MemoryStorage( void ) throw( Assertion );
                  

                        MemoryStorage( MemoryStorageCref );


      virtual           ~MemoryStorage( void );


               MemoryStorageRef  operator=( MemoryStorageCref );


               VoidPtr  getBasePointer( void );

   private:


               MemoryIdentifier  theIdentifier;


               Int               theSize;


               VoidPtr           theBasePointer;


               VoidPtr           theCurrentPointer;
   };

}

#endif // if !defined(__MEMORYSTORAGE_HPP)

/*
   Common rcs information do not modify
   $Author: frankc $
   $Revision: 1.4 $
   $Date: 2000/06/10 01:32:17 $
   $Locker:  $
*/

---

This is the CoreLinux++ reference manual
Provided by The CoreLinux Consortium