]> Creatis software - gdcm.git/blobdiff - src/gdcmDocEntrySet.h
* Change the DocEntry inheritance to RefCounter
[gdcm.git] / src / gdcmDocEntrySet.h
index e40b3f977df819ee5550062b38fe55515d419850..3448c892f9db5646269541c7b19a21d077d556ad 100644 (file)
@@ -3,8 +3,8 @@
   Program:   gdcm
   Module:    $RCSfile: gdcmDocEntrySet.h,v $
   Language:  C++
-  Date:      $Date: 2004/10/22 03:05:41 $
-  Version:   $Revision: 1.21 $
+  Date:      $Date: 2005/10/24 16:00:47 $
+  Version:   $Revision: 1.61 $
                                                                                 
   Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
   l'Image). All rights reserved. See Doc/License.txt or
 #ifndef GDCMDOCENTRYSET_H
 #define GDCMDOCENTRYSET_H
 
-#include "gdcmException.h"
+#include "gdcmBase.h"
+#include "gdcmVRKey.h"
+#include "gdcmTagKey.h"
+
+#include <fstream>
 
 namespace gdcm 
 {
+//-----------------------------------------------------------------------------
 class DocEntry;
-class ValEntry;
-class BinEntry;
+class DataEntry;
 class SeqEntry;
 class DictEntry;
 
-typedef std::string BaseTagKey;
 //-----------------------------------------------------------------------------
-
 /**
+ * \brief
  * \ref DocEntrySet is an abstract base class for \ref ElementSet
  * and \ref SQItem which are both containers for DocEntries.
- * \ref ElementSet is based on the STL map<> container
- * (see \ref ElementSet::TagHT), as opposed to \ref SQItem
- * which is based on an STL list container (see \ref SQItem::docEntries).
+ *  - \ref ElementSet is based on the STL map<> container
+ * (see \ref ElementSet::TagHT)
+ *  - \ref SQItem is based on an STL list container (see \ref ListDocEntry).
  * Since the syntax for adding a new element to a map<> or a list<>
  * differ, \ref DocEntrySet is designed as an adapter to unify the
  * interfaces of \ref DocEntrySet and \ref ElementSet.
@@ -53,52 +56,72 @@ typedef std::string BaseTagKey;
  *       members to this class since this class is designed as an adapter 
  *       in the form of an abstract base class.
  */
-class GDCM_EXPORT DocEntrySet
+class GDCM_EXPORT DocEntrySet : public Base
 {
 public:
-   DocEntrySet() {};
-   virtual ~DocEntrySet() {};
-
-   /// \brief adds any type of entry to the entry set (pure vitual)
-   virtual bool AddEntry(DocEntry *Entry) = 0; // pure virtual
-   /// \brief prints any type of entry to the entry set (pure vitual)
-   virtual void Print (std::ostream & os = std::cout) = 0;// pure virtual
+   /// Canonical Constructor
+   DocEntrySet();
+   /// Canonical Destructor
+   virtual ~DocEntrySet() {}
 
    /// \brief write any type of entry to the entry set
-   virtual void Write (std::ofstream *fp, FileType filetype) = 0;// pure virtual
-
-   virtual DocEntry* GetDocEntryByNumber(uint16_t group,
-                                             uint16_t element) = 0;
-   DocEntry *GetDocEntryByName(std::string const & name);
-   virtual std::string GetEntryByNumber(uint16_t group,uint16_t element) = 0;
-   std::string GetEntryByName(TagName const & name);
-   DictEntry *NewVirtualDictEntry(uint16_t group, 
-                                  uint16_t element,
-                                  std::string const & vr     = "unkn",
-                                  std::string const & fourth = "unkn",
-                                  std::string const & name   = "unkn");
-  
-protected:
+   virtual void WriteContent (std::ofstream *fp, FileType filetype) = 0;
+
+   /// \brief Remove all Entry in the entry set
+   virtual void ClearEntry() = 0;
+   /// \brief adds any type of entry to the entry set
+   virtual bool AddEntry(DocEntry *entry) = 0;
+   /// \brief Removes any type of entry out of the entry set, and destroys it
+   virtual bool RemoveEntry(DocEntry *entryToRemove) = 0;
+   /// Gets the first entry of any type of set
+   virtual DocEntry *GetFirstEntry()=0;
+   /// Gets the next entry of any type of set
+   virtual DocEntry *GetNextEntry()=0;
+
+   virtual std::string GetEntryString(uint16_t group, uint16_t elem);
+   virtual void *GetEntryBinArea(uint16_t group, uint16_t elem);
+   virtual int GetEntryLength(uint16_t group, uint16_t elem);
+   virtual std::string GetEntryForcedAsciiValue(uint16_t group, uint16_t elem);
+
+   /// \brief Gets any type of DocEntry, identified by its (group,elem)
+   virtual DocEntry *GetDocEntry(uint16_t group, uint16_t elem) = 0;
+   /// \brief Gets a DataEntry, identified by its (group, elem)
+   DataEntry *GetDataEntry(uint16_t group, uint16_t elem);
+   /// \brief Gets a SeqEntry, identified by its (group,elem)
+   SeqEntry *GetSeqEntry(uint16_t group, uint16_t elem);
+
+   bool SetEntryString(std::string const &content,
+                       uint16_t group, uint16_t elem);
+   bool SetEntryBinArea(uint8_t *content, int lgth,
+                        uint16_t group, uint16_t elem);
+   bool SetEntryString(std::string const &content, DataEntry *entry);
+   bool SetEntryBinArea(uint8_t *content, int lgth, DataEntry *entry);
+
+   DataEntry *InsertEntryString(std::string const &value,
+                                   uint16_t group, uint16_t elem,
+                                   VRKey const &vr = GDCM_VRUNKNOWN);
+   DataEntry *InsertEntryBinArea(uint8_t *binArea, int lgth,
+                                    uint16_t group, uint16_t elem,
+                                    VRKey const &vr = GDCM_VRUNKNOWN);
+   SeqEntry *InsertSeqEntry(uint16_t group, uint16_t elem);
+   /// tells us if the set contains no entry
+   virtual bool IsEmpty() = 0;
+   virtual bool CheckIfEntryExist(uint16_t group, uint16_t elem);
 
 // DocEntry  related utilities 
-   ValEntry* NewValEntryByNumber(uint16_t group, 
-                                 uint16_t element);
-   BinEntry* NewBinEntryByNumber(uint16_t group, 
-                                 uint16_t element);
-   DocEntry* NewDocEntryByNumber(uint16_t group, 
-                                 uint16_t element); 
-   DocEntry* NewDocEntryByNumber(uint16_t group, 
-                                 uint16_t element,
-                                 std::string const & VR); 
-   DocEntry* NewDocEntryByName  (std::string const & name);
-   SeqEntry* NewSeqEntryByNumber(uint16_t group, 
-                                 uint16_t element);
+   DataEntry *NewDataEntry(uint16_t group,uint16_t elem,
+                         VRKey const &vr = GDCM_VRUNKNOWN);
+   SeqEntry *NewSeqEntry(uint16_t group, uint16_t elem);
 
+protected:
 // DictEntry  related utilities
-   DictEntry *GetDictEntryByName  (std::string const & name);
-   DictEntry *GetDictEntryByNumber(uint16_t, uint16_t);
+   DictEntry *GetDictEntry(uint16_t group, uint16_t elem);
+   DictEntry *GetDictEntry(uint16_t group, uint16_t elem,
+                           VRKey const &vr);
+   /// To be able to backtrack (Private Sequence, Implicit VR related pb)
+   DocEntry *PreviousDocEntry;
 
+private:
 };
 
 } // end namespace gdcm