]> Creatis software - gdcm.git/blobdiff - src/gdcmDocEntrySet.cxx
* Reorder source code
[gdcm.git] / src / gdcmDocEntrySet.cxx
index b187140b4beb75c6ca65e4ded676b4e783127c4f..6a4597f0944a11022eaf8148d218e02a3d95cddd 100644 (file)
   Program:   gdcm
   Module:    $RCSfile: gdcmDocEntrySet.cxx,v $
   Language:  C++
-  Date:      $Date: 2004/09/10 14:32:04 $
-  Version:   $Revision: 1.20 $
+  Date:      $Date: 2005/02/02 16:18:48 $
+  Version:   $Revision: 1.52 $
                                                                                 
   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
      PURPOSE.  See the above copyright notices for more information.
                                                                                 
 =========================================================================*/
+#include "gdcmDocEntrySet.h"
 
 #include "gdcmDebug.h"
 #include "gdcmCommon.h"
+#include "gdcmDictSet.h"
 #include "gdcmGlobal.h"
-#include "gdcmDocEntrySet.h"
-#include "gdcmException.h"
 #include "gdcmDocEntry.h"
 #include "gdcmSeqEntry.h"
 #include "gdcmValEntry.h"
 #include "gdcmBinEntry.h"
 
+namespace gdcm 
+{
 //-----------------------------------------------------------------------------
 // Constructor / Destructor
+
+//-----------------------------------------------------------------------------
+// Public
 /**
- * \ingroup gdcmDocEntrySet
- * \brief   Constructor from a given gdcmDocEntrySet
+ * \brief   Get the "std::string representable" value of the Dicom entry
+ * @param   group  Group number of the searched tag.
+ * @param   elem Element number of the searched tag.
+ * @return  Corresponding element value when it exists,
+ *          and the string GDCM_UNFOUND ("gdcm::Unfound") otherwise.
  */
-gdcmDocEntrySet::gdcmDocEntrySet(int depthLevel)
+std::string DocEntrySet::GetEntryValue(uint16_t group, uint16_t elem)
 {
-   SQDepthLevel = depthLevel + 1;   //magic +1 !
+   ContentEntry *entry = dynamic_cast<ContentEntry *>(GetDocEntry(group,elem));
+   if( entry )
+      return entry->GetValue();
+   return GDCM_UNFOUND;
 }
+
 /**
- * \brief   Canonical destructor.
+ * \brief   Gets (from Header) a 'non string' element value 
+ * @param group   group number of the Entry 
+ * @param elem  element number of the Entry
+ * @return Pointer to the 'non string' area
  */
-gdcmDocEntrySet::~gdcmDocEntrySet()
+void *DocEntrySet::GetEntryBinArea(uint16_t group, uint16_t elem) 
 {
+   BinEntry *entry = GetBinEntry(group, elem);
+   if( entry )
+      return entry->GetBinArea();
+   return 0;
 }
-//-----------------------------------------------------------------------------
-// Print
-/*
- * \ingroup gdcmDocEntrySet
- * \brief   canonical Printer
- */
 
+/**
+ * \brief   Searches within Header Entries (Dicom Elements) parsed with 
+ *          the public and private dictionaries 
+ *          for the value length of a given tag..
+ * @param   group  Group number of the searched tag.
+ * @param   elem Element number of the searched tag.
+ * @return  Corresponding element length; -2 if not found
+ */
+int DocEntrySet::GetEntryLength(uint16_t group, uint16_t elem)
+{
+   DocEntry *entry = GetDocEntry(group, elem);
+   if( entry )
+      return entry->GetLength();
+   return -1;
+}
 
-//-----------------------------------------------------------------------------
-// Public
+/**
+ * \brief   Searches within Header Entries (Dicom Elements) parsed with 
+ *          the public [and private dictionaries] 
+ *          for the element value representation of a given tag..
+ *          Obtaining the VR (Value Representation) might be needed by caller
+ *          to convert the string typed content to caller's native type 
+ *          (think of C++ vs Python). The VR is actually of a higher level
+ *          of semantics than just the native C++ type.
+ * @param   group  Group number of the searched tag.
+ * @param   elem Element number of the searched tag.
+ * @return  Corresponding element value representation when it exists,
+ *          and the string GDCM_UNFOUND ("gdcm::Unfound") otherwise.
+ */
+std::string DocEntrySet::GetEntryVR(uint16_t group, uint16_t elem)
+{
+   DocEntry *entry = GetDocEntry(group, elem);
+   if( entry )
+      return entry->GetVR();
+   return GDCM_UNFOUND;
+}
 
+/**
+ * \brief  Same as \ref Document::GetDocEntry except it only
+ *         returns a result when the corresponding entry is of type
+ *         ValEntry.
+ * @param   group  Group number of the searched Dicom Element 
+ * @param   elem Element number of the searched Dicom Element  
+ * @return When present, the corresponding ValEntry. 
+ */
+ValEntry *DocEntrySet::GetValEntry(uint16_t group, uint16_t elem)
+{
+   DocEntry *currentEntry = GetDocEntry(group, elem);
+   if ( !currentEntry )
+      return NULL;
 
+   return dynamic_cast<ValEntry*>(currentEntry);
+}
 
 /**
- * \brief   Build a new Val Entry from all the low level arguments. 
- *          Check for existence of dictionary entry, and build
- *          a default one when absent.
- * @param   group group   number of the underlying DictEntry
- * @param   elem  element number of the underlying DictEntry
+ * \brief  Same as \ref Document::GetDocEntry except it only
+ *         returns a result when the corresponding entry is of type
+ *         BinEntry.
+ * @param   group  Group number of the searched Dicom Element
+ * @param   elem Element number of the searched Dicom Element
+ * @return When present, the corresponding BinEntry. 
  */
-gdcmValEntry *gdcmDocEntrySet::NewValEntryByNumber(uint16_t group,
-                                                   uint16_t elem) 
+BinEntry *DocEntrySet::GetBinEntry(uint16_t group, uint16_t elem)
 {
-   // Find out if the tag we encountered is in the dictionaries:
-   gdcmDictEntry *dictEntry = GetDictEntryByNumber(group, elem);
-   if (!dictEntry)
+   DocEntry *currentEntry = GetDocEntry(group, elem);
+   if ( !currentEntry )
    {
-      dictEntry = NewVirtualDictEntry(group, elem);
+      gdcmVerboseMacro( "No corresponding BinEntry " << std::hex << group <<
+                         "," << elem);
+      return NULL;
    }
 
-   gdcmValEntry *newEntry = new gdcmValEntry(dictEntry);
-   if (!newEntry) 
-   {
-      dbg.Verbose(1, "gdcmDocument::NewValEntryByNumber",
-                  "failed to allocate gdcmValEntry");
-      return 0;
-   }
-   return newEntry;
+   return dynamic_cast<BinEntry*>(currentEntry);
 }
 
-
 /**
- * \brief   Build a new Bin Entry from all the low level arguments. 
- *          Check for existence of dictionary entry, and build
- *          a default one when absent.
- * @param   group group   number of the underlying DictEntry
- * @param   elem  element number of the underlying DictEntry
+ * \brief  Same as \ref Document::GetDocEntry except it only
+ *         returns a result when the corresponding entry is of type
+ *         SeqEntry.
+ * @param   group  Group number of the searched Dicom Element 
+ * @param   elem Element number of the searched Dicom Element  
+ * @return When present, the corresponding SeqEntry. 
  */
-gdcmBinEntry *gdcmDocEntrySet::NewBinEntryByNumber(uint16_t group,
-                                                   uint16_t elem) 
+SeqEntry *DocEntrySet::GetSeqEntry(uint16_t group, uint16_t elem)
 {
-   // Find out if the tag we encountered is in the dictionaries:
-   gdcmDictEntry *dictEntry = GetDictEntryByNumber(group, elem);
-   if (!dictEntry)
+   DocEntry *currentEntry = GetDocEntry(group, elem);
+   if ( !currentEntry )
    {
-      dictEntry = NewVirtualDictEntry(group, elem);
+      gdcmVerboseMacro( "No corresponding SeqEntry " << std::hex << group <<
+                        "," << elem);
+      return NULL;
    }
 
-   gdcmBinEntry *newEntry = new gdcmBinEntry(dictEntry);
-   if (!newEntry) 
+   return dynamic_cast<SeqEntry*>(currentEntry);
+}
+
+/**
+ * \brief   Accesses an existing DocEntry (i.e. a Dicom Element)
+ *          through it's (group, element) and modifies it's content with
+ *          the given value.
+ * @param   content new value (string) to substitute with
+ * @param   group  group number of the Dicom Element to modify
+ * @param   elem element number of the Dicom Element to modify
+ */
+bool DocEntrySet::SetValEntry(std::string const &content, 
+                              uint16_t group, uint16_t elem) 
+{
+   ValEntry *entry = GetValEntry(group, elem);
+   if (!entry )
    {
-      dbg.Verbose(1, "gdcmDocument::NewBinEntryByNumber",
-                  "failed to allocate gdcmBinEntry");
-      return 0;
+      gdcmVerboseMacro( "No corresponding ValEntry " << std::hex << group <<
+                         "," << elem << " element (try promotion first).");
+      return false;
    }
-   return newEntry;
+   return SetValEntry(content,entry);
 }
 
 /**
- * \brief   Build a new Seq Entry from all the low level arguments. 
- *          Check for existence of dictionary entry, and build
- *          a default one when absent.
- * @param   Group group   number of the underlying DictEntry
- * @param   Elem  element number of the underlying DictEntry
+ * \brief   Accesses an existing DocEntry (i.e. a Dicom Element)
+ *          through it's (group, element) and modifies it's content with
+ *          the given value.
+ * @param   content new value (void*  -> uint8_t*) to substitute with
+ * @param   lgth new value length
+ * @param   group  group number of the Dicom Element to modify
+ * @param   elem element number of the Dicom Element to modify
  */
-gdcmSeqEntry *gdcmDocEntrySet::NewSeqEntryByNumber(uint16_t Group,
-                                                   uint16_t Elem) 
+bool DocEntrySet::SetBinEntry(uint8_t *content, int lgth, 
+                              uint16_t group, uint16_t elem) 
 {
-   // Find out if the tag we encountered is in the dictionaries:
-   gdcmDictEntry *DictEntry = GetDictEntryByNumber(Group, Elem);
-   if (!DictEntry)
-      DictEntry = NewVirtualDictEntry(Group, Elem);
+   BinEntry *entry = GetBinEntry(group, elem);
+   if (!entry )
+   {
+      gdcmVerboseMacro( "No corresponding ValEntry " << std::hex << group <<
+                        "," << elem << " element (try promotion first).");
+      return false;
+   }
 
-   gdcmSeqEntry *NewEntry = new gdcmSeqEntry(DictEntry, 1); // FIXME : 1
-   if (!NewEntry) 
+   return SetBinEntry(content,lgth,entry);
+} 
+
+/**
+ * \brief   Accesses an existing DocEntry (i.e. a Dicom Element)
+ *          and modifies it's content with the given value.
+ * @param  content new value (string) to substitute with
+ * @param  entry Entry to be modified
+ */
+bool DocEntrySet::SetValEntry(std::string const &content, ValEntry *entry)
+{
+   if(entry)
    {
-      dbg.Verbose(1, "gdcmDocument::NewSeqEntryByNumber",
-                  "failed to allocate gdcmSeqEntry");
-      return NULL;
+      entry->SetValue(content);
+      return true;
    }
-   return NewEntry;
+   return false;
 }
-//-----------------------------------------------------------------------------
-// Protected
 
 /**
- * \brief   Gets a Dicom Element inside a SQ Item Entry, by name
- * @return
+ * \brief   Accesses an existing BinEntry (i.e. a Dicom Element)
+ *          and modifies it's content with the given value.
+ * @param   content new value (void*  -> uint8_t*) to substitute with
+ * @param  entry Entry to be modified 
+ * @param  lgth new value length
  */
- gdcmDocEntry *gdcmDocEntrySet::GetDocEntryByName(std::string const & name)
- {
-   gdcmDict *pubDict = gdcmGlobal::GetDicts()->GetDefaultPubDict();
-   gdcmDictEntry *dictEntry = pubDict->GetDictEntryByName(name);
-   if( !dictEntry )
+bool DocEntrySet::SetBinEntry(uint8_t *content, int lgth, BinEntry *entry)
+{
+   if(entry)
    {
-      return 0;
+      entry->SetBinArea(content);  
+      entry->SetLength(lgth);
+      entry->SetValue(GDCM_BINLOADED);
+      return true;
    }
-
-   return GetDocEntryByNumber(dictEntry->GetGroup(),dictEntry->GetElement());      
+   return false;
 }
 
-
 /**
- * \brief   Get the value of a Dicom Element inside a SQ Item Entry, by name
- * @param   name : name of the searched element.
- * @return
+ * \brief   Modifies the value of a given Doc Entry (Dicom Element)
+ *          when it exists. Create it with the given value when unexistant.
+ * @param   value (string) Value to be set
+ * @param   group   Group number of the Entry 
+ * @param   elem  Element number of the Entry
+ * @param   vr  V(alue) R(epresentation) of the Entry -if private Entry-
+ * \return  pointer to the modified/created Header Entry (NULL when creation
+ *          failed).
  */ 
-
-std::string gdcmDocEntrySet::GetEntryByName(TagName const & name)
+ValEntry *DocEntrySet::InsertValEntry(std::string const &value, 
+                                      uint16_t group, uint16_t elem,
+                                      TagName const &vr )
 {
-   gdcmDict *pubDict = gdcmGlobal::GetDicts()->GetDefaultPubDict();
-   gdcmDictEntry *dictEntry = pubDict->GetDictEntryByName(name); 
+   ValEntry *valEntry = 0;
+   DocEntry *currentEntry = GetDocEntry( group, elem);
+   
+   if (currentEntry)
+   {
+      valEntry = dynamic_cast<ValEntry *>(currentEntry);
+
+      // Verify the VR
+      if( valEntry )
+         if( valEntry->GetVR()!=vr )
+            valEntry = NULL;
+
+      // if currentEntry doesn't correspond to the requested valEntry
+      if( !valEntry)
+      {
+         if( !RemoveEntry(currentEntry) )
+         {
+            gdcmVerboseMacro( "Removal of previous DocEntry failed.");
+
+            return NULL;
+         }
+      }
+   }
 
-   if( !dictEntry )
+   // Create a new valEntry if necessary
+   if( !valEntry )
    {
-      return GDCM_UNFOUND;
+      valEntry = NewValEntry(group, elem, vr);
+
+      if ( !AddEntry(valEntry) )
+      {
+         gdcmVerboseMacro("AddEntry failed although this is a creation.");
+
+         delete valEntry;
+         return NULL;
+      }
    }
 
-   return GetEntryByNumber(dictEntry->GetGroup(), dictEntry->GetElement()); 
+   // Set the binEntry value
+   SetValEntry(value, valEntry); // The std::string value
+   return valEntry;
 }
 
+/*
+ * \brief   Modifies the value of a given Header Entry (Dicom Element)
+ *          when it exists. Create it with the given value when unexistant.
+ *          A copy of the binArea is made to be kept in the Document.
+ * @param   binArea (binary) value to be set
+ * @param   group   Group number of the Entry 
+ * @param   elem  Element number of the Entry
+ * @param   vr  V(alue) R(epresentation) of the Entry -if private Entry-
+ * \return  pointer to the modified/created Header Entry (NULL when creation
+ *          failed).
+ */
+BinEntry *DocEntrySet::InsertBinEntry(uint8_t *binArea, int lgth, 
+                                      uint16_t group, uint16_t elem,
+                                      TagName const &vr )
+{
+   BinEntry *binEntry = 0;
+   DocEntry *currentEntry = GetDocEntry( group, elem);
+
+   // Verify the currentEntry
+   if (currentEntry)
+   {
+      binEntry = dynamic_cast<BinEntry *>(currentEntry);
+
+      // Verify the VR
+      if( binEntry )
+         if( binEntry->GetVR()!=vr )
+            binEntry = NULL;
+
+      // if currentEntry doesn't correspond to the requested valEntry
+      if( !binEntry)
+      {
+         if( !RemoveEntry(currentEntry) )
+         {
+            gdcmVerboseMacro( "Removal of previous DocEntry failed.");
+
+            return NULL;
+         }
+      }
+   }
+
+   // Create a new binEntry if necessary
+   if( !binEntry)
+   {
+      binEntry = NewBinEntry(group, elem, vr);
+
+      if ( !AddEntry(binEntry) )
+      {
+         gdcmVerboseMacro( "AddEntry failed allthough this is a creation.");
+
+         delete binEntry;
+         return NULL;
+      }
+   }
+
+   // Set the binEntry value
+   uint8_t *tmpArea;
+   if( lgth>0 && binArea )
+   {
+      tmpArea = new uint8_t[lgth];
+      memcpy(tmpArea,binArea,lgth);
+   }
+   else
+   {
+      tmpArea = 0;
+   }
+   if( !SetBinEntry(tmpArea,lgth,binEntry) )
+   {
+      if( tmpArea )
+      {
+         delete[] tmpArea;
+      }
+   }
+
+   return binEntry;
+}  
+
+/*
+ * \brief   Modifies the value of a given Header Entry (Dicom Element)
+ *          when it exists. Creates it when unexistant.
+ * @param   group   Group number of the Entry 
+ * @param   elem  Element number of the Entry
+ * \return  pointer to the modified/created SeqEntry (NULL when creation
+ *          failed).
+ */
+SeqEntry *DocEntrySet::InsertSeqEntry(uint16_t group, uint16_t elem)
+{
+   SeqEntry *seqEntry = 0;
+   DocEntry *currentEntry = GetDocEntry( group, elem);
+
+   // Verify the currentEntry
+   if( currentEntry )
+   {
+      seqEntry = dynamic_cast<SeqEntry *>(currentEntry);
+
+      // Verify the VR
+      if( seqEntry )
+         if( seqEntry->GetVR()!="SQ" )
+            seqEntry = NULL;
+
+      // if currentEntry doesn't correspond to the requested valEntry
+      if( !seqEntry )
+      {
+         if (!RemoveEntry(currentEntry))
+         {
+            gdcmVerboseMacro( "Removal of previous DocEntry failed.");
+
+            return NULL;
+         }
+      }
+   }
+   // Create a new seqEntry if necessary
+   if( !seqEntry )
+   {
+      seqEntry = NewSeqEntry(group, elem);
 
+      if( !AddEntry(seqEntry) )
+      {
+         gdcmVerboseMacro( "AddEntry failed allthough this is a creation.");
+
+         delete seqEntry;
+         return NULL;
+      }
+   }
+   return seqEntry;
+} 
 /**
- * \brief   Request a new virtual dict entry to the dict set
- * @param   group     group  number of the underlying DictEntry
- * @param   element  element number of the underlying DictEntry
- * @param   vr     VR of the underlying DictEntry
- * @param   fourth owner group
- * @param   name   english name
+ * \brief   Checks if a given Dicom Element exists within the H table
+ * @param   group   Group number of the searched Dicom Element 
+ * @param   elem  Element number of the searched Dicom Element 
+ * @return true is found
  */
-gdcmDictEntry* gdcmDocEntrySet::NewVirtualDictEntry(uint16_t group,
-                                                    uint16_t element,
-                                                    std::string const & vr,
-                                                    std::string const & fourth,
-                                                    std::string const & name)
+bool DocEntrySet::CheckIfEntryExist(uint16_t group, uint16_t elem )
 {
-   return gdcmGlobal::GetDicts()->NewVirtualDictEntry(group,element,vr,fourth,name);
+   return GetDocEntry(group,elem)!=NULL;
 }
 
-/** \brief 
- * Creates a new DocEntry (without any 'value' ...)
- * @param   group     group  number of the underlying DictEntry
- * @param   elem  elem number of the underlying DictEntry 
+/**
+ * \brief   Build a new Val Entry from all the low level arguments. 
+ *          Check for existence of dictionary entry, and build
+ *          a default one when absent.
+ * @param   group group   number of the new Entry
+ * @param   elem  element number of the new Entry
+ * @param   vr     VR of the new Entry 
  */
-gdcmDocEntry* gdcmDocEntrySet::NewDocEntryByNumber(uint16_t group,
-                                                   uint16_t elem)
+ValEntry *DocEntrySet::NewValEntry(uint16_t group,uint16_t elem,
+                                   TagName const & vr) 
 {
-   // Find out if the tag we encountered is in the dictionaries:
-   gdcmDict *pubDict = gdcmGlobal::GetDicts()->GetDefaultPubDict();
-   gdcmDictEntry *dictEntry = pubDict->GetDictEntryByNumber(group, elem);
-   if (!dictEntry)
-   {
-      dictEntry = NewVirtualDictEntry(group, elem);
-   }
+   DictEntry *dictEntry = GetDictEntry(group, elem, vr);
+   gdcmAssertMacro(dictEntry);
 
-   gdcmDocEntry *newEntry = new gdcmDocEntry(dictEntry);
+   ValEntry *newEntry = new ValEntry(dictEntry);
    if (!newEntry) 
    {
-      dbg.Verbose(1, "gdcmSQItem::NewDocEntryByNumber",
-                  "failed to allocate gdcmDocEntry");
+      gdcmVerboseMacro( "Failed to allocate ValEntry");
       return 0;
    }
    return newEntry;
 }
 
-/* \brief
- * Probabely move, as is, to gdcmDocEntrySet, as a non virtual method
- * an remove gdcmDocument::NewDocEntryByName
+
+/**
+ * \brief   Build a new Bin Entry from all the low level arguments. 
+ *          Check for existence of dictionary entry, and build
+ *          a default one when absent.
+ * @param   group group   number of the new Entry
+ * @param   elem  element number of the new Entry
+ * @param   vr     VR of the new Entry 
  */
-gdcmDocEntry *gdcmDocEntrySet::NewDocEntryByName  (std::string const & name)
+BinEntry *DocEntrySet::NewBinEntry(uint16_t group, uint16_t elem,
+                                   TagName const &vr) 
 {
-  gdcmDict *pubDict = gdcmGlobal::GetDicts()->GetDefaultPubDict();
-  gdcmDictEntry *newTag = pubDict->GetDictEntryByName(name);
-   if (!newTag)
-   {
-      newTag = NewVirtualDictEntry(0xffff, 0xffff, "LO", "unkn", name);
-   }
+   DictEntry *dictEntry = GetDictEntry(group, elem, vr);
+   gdcmAssertMacro(dictEntry);
 
-   gdcmDocEntry* newEntry = new gdcmDocEntry(newTag);
+   BinEntry *newEntry = new BinEntry(dictEntry);
    if (!newEntry) 
    {
-      dbg.Verbose(1, "gdcmSQItem::ObtainDocEntryByName",
-                  "failed to allocate gdcmDocEntry");
+      gdcmVerboseMacro( "Failed to allocate BinEntry");
       return 0;
    }
+   return newEntry;
+}
 
+/**
+ * \brief   Build a new Seq Entry from all the low level arguments. 
+ *          Check for existence of dictionary entry, and build
+ *          a default one when absent.
+ * @param   group group   number of the new Entry
+ * @param   elem  element number of the new Entry
+ */
+SeqEntry* DocEntrySet::NewSeqEntry(uint16_t group, uint16_t elem) 
+{
+   DictEntry *dictEntry = GetDictEntry(group, elem, "SQ");
+   gdcmAssertMacro(dictEntry);
+
+   SeqEntry *newEntry = new SeqEntry( dictEntry );
+   if (!newEntry)
+   {
+      gdcmVerboseMacro( "Failed to allocate SeqEntry");
+      return 0;
+   }
    return newEntry;
 }
 
+/**
+ * \brief   Request a new virtual dict entry to the dict set
+ * @param   group group  number of the underlying DictEntry
+ * @param   elem  element number of the underlying DictEntry
+ * @param   vr    VR (Value Representation) of the underlying DictEntry
+ * @param   vm    VM (Value Multiplicity)   of the underlying DictEntry
+ * @param   name   english name
+ */
+DictEntry* DocEntrySet::NewVirtualDictEntry( uint16_t group,uint16_t elem,
+                                             TagName const & vr,
+                                             TagName const & vm,
+                                             TagName const & name )
+{
+   return Global::GetDicts()->NewVirtualDictEntry(group,elem,vr,vm,name);
+}
 
+//-----------------------------------------------------------------------------
+// Protected
 /**
- * \brief   Searches both the public and the shadow dictionary (when they
- *          exist) for the presence of the DictEntry with given name.
- *          The public dictionary has precedence on the shadow one.
- * @param   name Name of the searched DictEntry
+ * \brief   Searches [both] the public [and the shadow dictionary (when they
+ *          exist)] for the presence of the DictEntry with given
+ *          group and element. The public dictionary has precedence on the
+ *          shadow one.
+ * @param   group  group number of the searched DictEntry
+ * @param   elem element number of the searched DictEntry
  * @return  Corresponding DictEntry when it exists, NULL otherwise.
  */
-gdcmDictEntry *gdcmDocEntrySet::GetDictEntryByName(std::string const & name
+DictEntry *DocEntrySet::GetDictEntry(uint16_t group,uint16_t elem
 {
-   gdcmDictEntry *found = 0;
-   gdcmDict *pubDict = gdcmGlobal::GetDicts()->GetDefaultPubDict();
+   DictEntry *found = 0;
+   Dict *pubDict = Global::GetDicts()->GetDefaultPubDict();
    if (!pubDict) 
    {
-      dbg.Verbose(0, "gdcmDocument::GetDictEntry",
-                     "we SHOULD have a default dictionary");
+      gdcmVerboseMacro( "We SHOULD have a default dictionary");
    }
    else
    {
-      found = pubDict->GetDictEntryByName(name);  
+      found = pubDict->GetEntry(group, elem);  
    }
    return found;
 }
 
 /**
- * \brief   Searches both the public and the shadow dictionary (when they
- *          exist) for the presence of the DictEntry with given
- *          group and element. The public dictionary has precedence on the
- *          shadow one.
- * @param   group   group number of the searched DictEntry
- * @param   element element number of the searched DictEntry
+ * \brief   Searches [both] the public [and the shadow dictionary (when they
+ *          exist)] for the presence of the DictEntry with given
+ *          group and element, and create a new virtual DictEntry if necessary
+ * @param   group  group number of the searched DictEntry
+ * @param   elem element number of the searched DictEntry
+ * @param   vr Value Representation to use, if necessary 
  * @return  Corresponding DictEntry when it exists, NULL otherwise.
  */
-gdcmDictEntry *gdcmDocEntrySet::GetDictEntryByNumber(uint16_t group,
-                                                     uint16_t element) 
+DictEntry *DocEntrySet::GetDictEntry(uint16_t group, uint16_t elem,
+                                     TagName const &vr)
 {
-   gdcmDictEntry *found = 0;
-   gdcmDict *pubDict = gdcmGlobal::GetDicts()->GetDefaultPubDict();
-   if (!pubDict) 
+   DictEntry *dictEntry = GetDictEntry(group,elem);
+   DictEntry *goodEntry = dictEntry;
+   std::string goodVR = vr;
+
+   if (elem == 0x0000) goodVR="UL";
+
+   if ( goodEntry )
    {
-      dbg.Verbose(0, "gdcmDocument::GetDictEntry",
-                     "we SHOULD have a default dictionary");
+      if ( goodVR != goodEntry->GetVR()
+        && goodVR != GDCM_UNKNOWN )
+      {
+         goodEntry = NULL;
+      }
    }
-   else
+
+   // Create a new virtual DictEntry if necessary
+   if (!goodEntry)
    {
-      found = pubDict->GetDictEntryByNumber(group, element);  
+      if (dictEntry)
+      {
+         goodEntry = NewVirtualDictEntry(group, elem, goodVR, "FIXME", 
+                                         dictEntry->GetName() );
+      }
+      else
+      {
+         goodEntry = NewVirtualDictEntry(group, elem, goodVR);
+      }
    }
-   return found;
+   return goodEntry;
 }
 
-
 //-----------------------------------------------------------------------------
 // Private
 
+//-----------------------------------------------------------------------------
+// Print
 
 //-----------------------------------------------------------------------------
+} // end namespace gdcm