ENH: Slightly bigger patch:

[gdcm.git] / src / gdcmDictEntry.cxx

diff --git a/src/gdcmDictEntry.cxx b/src/gdcmDictEntry.cxx
index 5bcacb34fbe1960b1d907bdef4eec08229a56372..bc0dddfd3dd246086632876d7c3db935d81b5aea 100644 (file)
--- a/src/gdcmDictEntry.cxx
+++ b/src/gdcmDictEntry.cxx
@@ -1,23 +1,94 @@
-#include "gdcmlib.h"
+/*=========================================================================
+                                                                                
+  Program:   gdcm
+  Module:    $RCSfile: gdcmDictEntry.cxx,v $
+  Language:  C++
+  Date:      $Date: 2004/11/16 02:54:35 $
+  Version:   $Revision: 1.29 $
+                                                                                
+  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.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.
+                                                                                
+=========================================================================*/
 
-gdcmDictEntry::gdcmDictEntry(guint16 InGroup, guint16 InElement,
-                             string  InVr, string InFourth, string InName) 
+#include "gdcmDictEntry.h"
+#include "gdcmDebug.h"
+#include "gdcmUtil.h"
+
+namespace gdcm 
+{
+
+//-----------------------------------------------------------------------------
+// Constructor / Destructor
+/**
+ * \brief   Constructor
+ * @param   group      DICOM-Group Number
+ * @param   element    DICOM-Element Number
+ * @param   vr         Value Representatiion
+ * @param   fourth    // DO NOT use any longer; 
+ *                       NOT part of the Dicom Standard
+ * @param   name      description of the element
+*/
+
+DictEntry::DictEntry(uint16_t group, uint16_t element,
+                     TagName const & vr, TagName const & fourth,
+                     TagName const & name)
 {
-       group = InGroup;
-       element = InElement;
-       vr = InVr;
-       fourth = InFourth;
-       name = InName;
-       key = TranslateToKey(group, element);
+   Group   = group;
+   Element = element;
+   VR      = vr;
+   Fourth  = fourth;
+   Name    = name;
+   Key     = TranslateToKey(group, element);
 }
 
-TagKey gdcmDictEntry::TranslateToKey(guint16 group, guint16 element) {
-       char trash[10];
-       TagKey key;
-       // CLEAN ME: better call the iostream<< with the hex manipulator on.
-       // This requires some reading of the stdlibC++ sources to make the
-       // proper call (or copy).
-       sprintf(trash, "%04x|%04x", group , element);
-       key = trash;  // Convertion through assignement
-       return key;
+//-----------------------------------------------------------------------------
+// Print
+
+//-----------------------------------------------------------------------------
+// Public
+/**
+ * \brief   concatenates 2 uint16_t (supposed to be a Dicom group number 
+ *                                              and a Dicom element number)
+ * @param  group the Dicom group number used to build the tag
+ * @param  element the Dicom element number used to build the tag
+ * @return the built tag
+ */
+TagKey DictEntry::TranslateToKey(uint16_t group, uint16_t element)
+{
+   return Util::Format("%04x|%04x", group, element);
 }
+
+//-----------------------------------------------------------------------------
+/**
+ * \brief       If-and only if-the V(alue) R(epresentation)
+ * \            is unset then overwrite it.
+ * @param vr    New V(alue) R(epresentation) to be set.
+ */
+void DictEntry::SetVR(TagName const & vr) 
+{
+   if ( IsVRUnknown() )
+   {
+      VR = vr;
+   }
+   else 
+   {
+      dbg.Error(true, "DictEntry::SetVR",
+                       "Overwriting VR might compromise a dictionary");
+   }
+}
+
+//-----------------------------------------------------------------------------
+// Protected
+
+//-----------------------------------------------------------------------------
+// Private
+
+//-----------------------------------------------------------------------------
+} // end namespace gdcm
+