X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?a=blobdiff_plain;f=src%2FgdcmDocEntrySet.h;h=7f31fb4783d2d1126630ca10461d3cad9a5eaba2;hb=721d134c6e594b9a23bf1ce002ed87bfbc1576a7;hp=173d514d10954e74f7bc1117585e7ba576d7297b;hpb=703f7c3e72891da8384ad765aa7f66c2ba4943c4;p=gdcm.git diff --git a/src/gdcmDocEntrySet.h b/src/gdcmDocEntrySet.h index 173d514d..7f31fb47 100644 --- a/src/gdcmDocEntrySet.h +++ b/src/gdcmDocEntrySet.h @@ -3,8 +3,8 @@ Program: gdcm Module: $RCSfile: gdcmDocEntrySet.h,v $ Language: C++ - Date: $Date: 2005/01/07 08:50:13 $ - Version: $Revision: 1.34 $ + Date: $Date: 2007/09/17 12:16:02 $ + Version: $Revision: 1.73 $ Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de l'Image). All rights reserved. See Doc/License.txt or @@ -16,83 +16,118 @@ =========================================================================*/ -#ifndef GDCMDOCENTRYSET_H -#define GDCMDOCENTRYSET_H +#ifndef _GDCMDOCENTRYSET_H_ +#define _GDCMDOCENTRYSET_H_ + +#include "gdcmRefCounter.h" +#include "gdcmVRKey.h" +#include "gdcmTagKey.h" -#include "gdcmBase.h" -#include "gdcmException.h" #include -namespace gdcm +namespace GDCM_NAME_SPACE { +//----------------------------------------------------------------------------- class DocEntry; -class ValEntry; -class BinEntry; +class DataEntry; class SeqEntry; class DictEntry; -typedef std::string BaseTagKey; //----------------------------------------------------------------------------- - /** - * \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). + * \brief + * DocEntrySet is an abstract base class for ElementSet, SQItem + * which are both containers for DocEntries. + * - ElementSet is based on the STL map<> container + * (see ElementSet::TagHT) + * - SQItem is based on an STL list container (see 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. + * differ, DocEntrySet is designed as an adapter to unify the + * interfaces of DocEntrySet and ElementSet. + * * As an illustration of this design, please refer to the implementation - * of \ref AddEntry (or any pure virtual method) in both derived classes. + * of AddEntry (or any pure virtual method) in both derived classes. * This adapter unification of interfaces enables the parsing of a * DICOM header containing (optionaly heavily nested) sequences to be - * written recursively [see \ref Document::ParseDES - * which calls \ref Document::ParseSQ, which in turns calls - * \ref Document::ParseDES ]. + * written recursively [see Document::ParseDES + * which calls Document::ParseSQ, which in turn calls + * Document::ParseDES ]. * * \note Developpers should strongly resist to the temptation of adding * members to this class since this class is designed as an adapter * in the form of an abstract base class. */ -class GDCM_EXPORT DocEntrySet : public Base +class GDCM_EXPORT DocEntrySet : public RefCounter { -friend class File; + gdcmTypeMacro(DocEntrySet); + public: - DocEntrySet() {}; - virtual ~DocEntrySet() {}; + /// \brief write any type of entry to the entry set + virtual void WriteContent (std::ofstream *fp, FileType filetype, + bool insideMetaElements,bool insideSequence ) = 0; - /// \brief adds any type of entry to the entry set (pure vitual) - virtual bool AddEntry(DocEntry *Entry) = 0; // pure virtual - virtual bool RemoveEntry(DocEntry *EntryToRemove)=0; // pure virtual - virtual bool RemoveEntryNoDestroy(DocEntry *EntryToRemove)=0; // pure virtual + /// \brief Remove all Entry of the current set + virtual void ClearEntry() = 0; + /// \brief adds any type of entry to the current 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 Gets the first entry (of any type) of the current set + virtual DocEntry *GetFirstEntry()=0; + /// \brief Gets the next entry (of any type) of the current 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); + + /// \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); + /// \brief Tells us if the set contains no entry + virtual bool IsEmpty() = 0; + virtual bool CheckIfEntryExist(uint16_t group, uint16_t elem); - /// \brief write any type of entry to the entry set - virtual void WriteContent (std::ofstream *fp, FileType filetype) = 0;// pure virtual - - virtual DocEntry *GetDocEntryByNumber(uint16_t group, - uint16_t elem) = 0; - virtual std::string GetEntryByNumber(uint16_t group, uint16_t elem) = 0; - - DictEntry *NewVirtualDictEntry(uint16_t group, - uint16_t element, - TagName const &vr = GDCM_UNKNOWN, - TagName const &fourth = GDCM_UNKNOWN, - TagName const &name = GDCM_UNKNOWN ); - -protected: // DocEntry related utilities + DataEntry *NewDataEntry(uint16_t group,uint16_t elem, + VRKey const &vr = GDCM_VRUNKNOWN); + SeqEntry *NewSeqEntry(uint16_t group, uint16_t elem); + + virtual void Copy(DocEntrySet *) {}; - ValEntry *NewValEntryByNumber(uint16_t group,uint16_t elem, - TagName const &vr = GDCM_UNKNOWN); - BinEntry *NewBinEntryByNumber(uint16_t group,uint16_t elem, - TagName const &vr = GDCM_UNKNOWN); - SeqEntry *NewSeqEntryByNumber(uint16_t group,uint16_t elem); +protected: + /// Canonical Constructor + DocEntrySet(); + /// Canonical Destructor + virtual ~DocEntrySet() {} // DictEntry related utilities - DictEntry *GetDictEntryByNumber(uint16_t group, uint16_t elem); - DictEntry *GetDictEntryByNumber(uint16_t group, uint16_t elem, - TagName const &vr); + 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