X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?a=blobdiff_plain;f=src%2FgdcmDocEntrySet.h;h=0173958a015a6c936bbd18374775808ace0e646d;hb=928d3c30e40ab7f3d12bfd038ce8a48befcddce8;hp=dc057ac18d781a7557473eeb0252b16d1d3bd17d;hpb=c03bc9b5e7d49126a10d49f78682410a5500c412;p=gdcm.git diff --git a/src/gdcmDocEntrySet.h b/src/gdcmDocEntrySet.h index dc057ac1..0173958a 100644 --- a/src/gdcmDocEntrySet.h +++ b/src/gdcmDocEntrySet.h @@ -3,8 +3,8 @@ Program: gdcm Module: $RCSfile: gdcmDocEntrySet.h,v $ Language: C++ - Date: $Date: 2004/11/16 10:25:53 $ - Version: $Revision: 1.23 $ + Date: $Date: 2005/10/20 15:24:09 $ + Version: $Revision: 1.60 $ Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de l'Image). All rights reserved. See Doc/License.txt or @@ -19,25 +19,28 @@ #ifndef GDCMDOCENTRYSET_H #define GDCMDOCENTRYSET_H -#include "gdcmException.h" +#include "gdcmBase.h" +#include "gdcmVRKey.h" +#include "gdcmTagKey.h" + +#include 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 ListDocEntry). + * - \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,74 @@ 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(TagName 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, - TagName const & vr = "unkn", - TagName const & fourth = "unkn", - TagName 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; + /// \brief Removes any type of entry out of the entry set, DOESN'T destroy it + virtual bool RemoveEntryNoDestroy(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, - TagName const & vr); - DocEntry* NewDocEntryByName (TagName 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 (TagName 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