]> Creatis software - gdcm.git/blobdiff - src/gdcmDocEntry.h
BUG: Remove tons of mem leaks. There are still plenty that explains why gdcm is dog...
[gdcm.git] / src / gdcmDocEntry.h
index bdce223d72d65ebaa9b989bf453c8a21693068ee..45cf710fd3787229e7d173e18b7ead1742cc9748 100644 (file)
@@ -3,12 +3,12 @@
   Program:   gdcm
   Module:    $RCSfile: gdcmDocEntry.h,v $
   Language:  C++
-  Date:      $Date: 2004/07/02 13:55:27 $
-  Version:   $Revision: 1.13 $
+  Date:      $Date: 2004/10/25 04:08:20 $
+  Version:   $Revision: 1.28 $
                                                                                 
   Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
   l'Image). All rights reserved. See Doc/License.txt or
-  http://www.creatis.insa-lyon.fr/Public/Gdcm/License.htm for details.
+  http://www.creatis.insa-lyon.fr/Public/Gdcm/License.html for details.
                                                                                 
      This software is distributed WITHOUT ANY WARRANTY; without even
      the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
                                                                                 
 =========================================================================*/
 
-#ifndef GDCMDocEntry_H
-#define GDCMDocEntry_H
-
-#include <iostream>
-#include <stdio.h>
+#ifndef GDCMDOCENTRY_H
+#define GDCMDOCENTRY_H
 
 #include "gdcmDictEntry.h"
+#include <iostream>
 
-class gdcmHeader;
-class gdcmValEntry;
-class gdcmBinEntry;
-class gdcmSeqEntry;
+class Header;
+class ValEntry;
+class BinEntry;
+class SeqEntry;
 
+namespace gdcm 
+{
 //-----------------------------------------------------------------------------
 /**
- * \ingroup gdcmDocEntry
  * \brief   The dicom header of a Dicom file contains a set of such entries
  *          (when successfuly parsed against a given Dicom dictionary)
  */
-class GDCM_EXPORT gdcmDocEntry {
+class GDCM_EXPORT DocEntry
+{
 public:
-   gdcmDocEntry(gdcmDictEntry*);
-     
+   DocEntry(DictEntry*);
+   virtual ~DocEntry() {};
+
    /// Returns the Dicom Group number of the current Dicom Header Entry
-   uint16_t      GetGroup(void)     { return entry->GetGroup();  };
+   uint16_t      GetGroup()     { return DicomDict->GetGroup();  };
 
    /// Returns the Dicom Element number of the current Dicom Header Entry
-   uint16_t      GetElement(void)   { return entry->GetElement();};
+   uint16_t      GetElement()   { return DicomDict->GetElement();};
+
+   /// Returns the 'key' of the current Dicom Header Entry
+   void  SetKey( TagKey const & key ) { Key = key; }
 
    /// Returns the 'key' of the current Dicom Header Entry
-   std::string  GetKey(void)       { return entry->GetKey();    };
+   std::string const & GetKey() const { return Key; }
 
    /// \brief Returns the 'Name' '(e.g. "Patient's Name") found in the Dicom
    /// Dictionnary of the current Dicom Header Entry
-   std::string  GetName(void)      { return entry->GetName();   };
+   std::string const & GetName() const { return DicomDict->GetName(); };
 
    /// \brief Returns the 'Value Representation' (e.g. "PN" : Person Name,
    /// "SL" : Signed Long), found in the Dicom Header or in the Dicom
    /// Dictionnary, of the current Dicom Header Entry
-   std::string  GetVR(void)        { return entry->GetVR();     };
+   std::string const & GetVR() const { return DicomDict->GetVR(); };
 
    /// \brief Returns offset (since the beginning of the file, including
-   /// the File Pramble, if any) of the value of the current Dicom HeaderEntry
+   /// the File Preamble, if any) of the value of the current Dicom HeaderEntry
    /// \warning offset of the *value*, not of the Dicom Header Entry
-   size_t       GetOffset(void)    { return Offset;             };
+   size_t GetOffset() { return Offset; };
 
    /// \brief Returns the actual value length of the current Dicom Header Entry
    /// \warning this value is not *always* the one stored in the Dicom Header
    ///          in case of well knowned bugs
-   uint32_t GetLength(void) { return UsableLength; };
+   uint32_t GetLength() { return UsableLength; };
     
    /// \brief Returns the 'read length' of the current Dicom Header Entry
    /// \warning this value is the one stored in the Dicom Header but not
    ///          mandatoryly the one thats's used (in case on SQ, or delimiters,
    ///          the usable length is set to zero)
-   uint32_t GetReadLength(void) { return ReadLength; };
+   uint32_t GetReadLength() { return ReadLength; };
 
    /// Sets the 'Value Representation' of the current Dicom Header Entry
-   void SetVR(std::string v) { entry->SetVR(v); };    
+   void SetVR( TagName const & v) { DicomDict->SetVR(v); };    
 
    /// \brief Sets both 'Read Length' and 'Usable Length' of the current
    /// Dicom Header Entry
-   void SetLength(uint32_t l) { ReadLength=UsableLength=l;};
+   void SetLength(uint32_t l) { ReadLength = UsableLength = l; };
       
    // The following 3 members, for internal use only ! 
    
    /// \brief Sets only 'Read Length' (*not* 'Usable Length') of the current
    /// Dicom Header Entry
-   void SetReadLength(uint32_t l) { ReadLength   = l; };
+   void SetReadLength(uint32_t l) { ReadLength = l; };
 
    /// \brief Sets only 'Usable Length' (*not* 'Read Length') of the current
    /// Dicom Header Entry
@@ -93,63 +97,54 @@ public:
    /// \brief   Sets the offset of the Dicom Element
    /// \warning use with caution !
    /// @param   of offset to be set
-   void gdcmDocEntry::SetOffset(size_t of) { Offset = of; };
+   void SetOffset(size_t of) { Offset = of; };
 
    /// Sets to TRUE the ImplicitVr flag of the current Dicom Element
-   void gdcmDocEntry::SetImplicitVR(void) { ImplicitVR = true; };
+   void SetImplicitVR() { ImplicitVR = true; };
  
    /// \brief Tells us if the current Dicom Element was checked as ImplicitVr
    /// @return true if the current Dicom Element was checked as ImplicitVr
-   bool gdcmDocEntry::IsImplicitVR(void) { return ImplicitVR; };
+   bool IsImplicitVR() { return ImplicitVR; };
 
    /// \brief Tells us if the VR of the current Dicom Element is Unknown
-   /// @return true if the VR is unkonwn
-   bool gdcmDocEntry::IsVRUnknown(void) { return entry->IsVRUnknown(); };
+   /// @return true if the VR is unknown
+   bool IsVRUnknown() { return DicomDict->IsVRUnknown(); };
 
    /// \brief   Sets the DicEntry of the current Dicom Element
-   /// @param   NewEntry pointer to the DictEntry
-   void gdcmDocEntry::SetDictEntry(gdcmDictEntry *NewEntry)
-               { entry = NewEntry; };
+   /// @param   newEntry pointer to the DictEntry
+   void SetDictEntry(DictEntry *newEntry) { DicomDict = newEntry; };
 
    /// \brief  Gets the DicEntry of the current Dicom Element
    /// @return The DicEntry of the current Dicom Element
-   gdcmDictEntry * gdcmDocEntry::GetDictEntry(void) { return entry; }; 
+   DictEntry * GetDictEntry() { return DicomDict; }; 
 
    /// \brief Sets the print level for the Dicom Header Elements
    /// \note 0 for Light Print; 1 for 'medium' Print, 2 for Heavy
-   void SetPrintLevel(int level) { printLevel = level; };
+   void SetPrintLevel(int level) { PrintLevel = level; };
 
    /// \brief Gets the print level for the Dicom Header Elements
-   int GetPrintLevel(void) { return(printLevel); };
+   int GetPrintLevel() { return PrintLevel; };
    
    virtual void Print (std::ostream & os = std::cout); 
-   virtual void Write(FILE *fp, FileType filetype);
+   virtual void Write(std::ofstream *fp, FileType filetype);
    
-   uint32_t GetFullLength(void);
+   uint32_t GetFullLength();
    
-   void Copy(gdcmDocEntry *doc);
-
-   bool isItemDelimitor();
-   bool isSequenceDelimitor();   
+   void Copy(DocEntry *doc);
 
-   /// \brief Gets the depth level of a Dicom header entry embedded in
-   ///        a SeQuence
-   int GetDepthLevel(void) {return(SQDepthLevel);}
+   bool IsItemDelimitor();
+   bool IsSequenceDelimitor();   
 
-   /// \brief Sets the depth level of a Dicom header entry embedded in
-   ///        a SeQuence
-   void SetDepthLevel(int depth) {SQDepthLevel = depth;}
-            
 private:
    // FIXME: In fact we should be more specific and use :
-   // friend gdcmDocEntry * gdcmHeader::ReadNextElement(void);
-   friend class gdcmHeader;    
+   // friend DocEntry * Header::ReadNextElement(void);
+   friend class Header;    
 
 protected:
 // Variables
 
    /// \brief pointer to the underlying Dicom dictionary element
-   gdcmDictEntry *entry;
+   DictEntry *DicomDict;
    
    /// \brief Updated from ReadLength, by FixFoungLentgh() for fixing a bug
    /// in the header or helping the parser going on    
@@ -169,11 +164,12 @@ protected:
    size_t Offset; 
 
    /// How many details are to be printed (value : 0,1,2)      
-   int printLevel;
-   
-   /// Gives the depth level of elements inside SeQuences   
-   int SQDepthLevel;
-};
+   int PrintLevel;
 
+   /// \brief Generalized key (i.e. a BaseTagKey prepending a TagKey)
+   ///        of this DocEntry
+   TagKey Key;
+};
+} // end namespace gdcm
 //-----------------------------------------------------------------------------
 #endif