include/EDoc/TypeLoc.h

Go to the documentation of this file.

/*******************************************************************************

   Copyright (C) 2007 by Brendon Costa

   This library is free software; you can redistribute it and/or modify 
   it under the terms of the "LGPL Like" License defined in the file COPYING 
   that should have been distributed along with this source.

   This 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.  

   You should have received a copy of the "LGPL Like" License 
   along with this library; see the file COPYING. if not, it can be 
   obtained from the EDoc++ website: 
   http://edoc.sourceforge.net/license.html

*******************************************************************************/
#ifndef EDOC_TYPELOC_H
#define EDOC_TYPELOC_H

#include "EDoc/DictionarySpecific.h"
#include "EDoc/Location.h"

namespace EDoc
{
   class Type;
   class PersistenceIFace;
   class IndexedDictionary;
   class PStack;

   //===========================================================================
   /** \brief Is a conglomerate of a reference to a Type object and a
    * Location in a source file.
    *
    * This can be used for a few purposes one of which is to information about
    * the type of an exception and where it was thrown. See Exception class for
    * more info.
    */
   class TypeLoc : public DictionarySpecific
   {
   public:
      
      //------------------------------------------------------------------------
      /** \brief See CodeBlock::CodeBlock(Dictionary* dict_in=NULL)
       */
      TypeLoc(Dictionary* dict_in=NULL);

      //------------------------------------------------------------------------
      /** \brief See CodeBlock::CodeBlock(const CodeBlock& right)
       */
      TypeLoc(const TypeLoc& right);

      //------------------------------------------------------------------------
      /** \brief See CodeBlock::CodeBlock(const CodeBlock& right, 
       * Dictionary& dict_in)
       */
      TypeLoc(const TypeLoc& right, Dictionary& dict_in);

      //------------------------------------------------------------------------
      /** \brief See CodeBlock::operator=()
       */
      TypeLoc& operator=(const TypeLoc& right);
      
      //------------------------------------------------------------------------
      /** \brief See CodeBlock::Read()
       */
      void Read(PersistenceIFace& file, IndexedDictionary& idict);

      //------------------------------------------------------------------------
      /** \brief See CodeBlock::Write()
       */
      void Write(PersistenceIFace& file) const;

      //------------------------------------------------------------------------
      /** \brief See DictionarySpecific::ReplaceReferences()
       */
      virtual size_t ReplaceReferences(PStack& stack, 
         void* remove, void* replace);

      //------------------------------------------------------------------------
      /** \brief See DictionarySpecific::Print()
       */
      virtual std::ostream& Print(std::ostream& out, 
         std::string prefix="") const;

      //------------------------------------------------------------------------
      /** \brief See DictionarySpecific::Validate()
       */
      virtual void Validate(PStack& stack, const Dictionary& dict_in) const;

      //------------------------------------------------------------------------
      /** \brief Equivilance operator (Works across dictionaries).
       */
      bool operator==(const TypeLoc& right) const;




      //------------------------------------------------------------------------
      /** \brief A location in a source file.
       */
      Location loc;

      //------------------------------------------------------------------------
      /** \brief A reference to a Type.
       */
      Type* value;

      //------------------------------------------------------------------------

   };
   //===========================================================================

}

#endif // EDOC_TYPELOC_H

---