upgrade GdcmHeaderEntry Print Method for DICOMDIR

[gdcm.git] / src / gdcmDictEntry.cxx

diff --git a/src/gdcmDictEntry.cxx b/src/gdcmDictEntry.cxx
index 3e9b109e14cc6bc80bd31866554c08cbfb6357b1..0bc2afa901276bded0774da7b48255373a2a723b 100644 (file)
--- a/src/gdcmDictEntry.cxx
+++ b/src/gdcmDictEntry.cxx
@@ -1,19 +1,48 @@
-// gdcmDict.cxx
+// gdcmDictEntry.cxx
+//-----------------------------------------------------------------------------
+#include "gdcmDictEntry.h"
 
-#include "gdcm.h"
+#include <stdio.h>    // FIXME For sprintf
 #include "gdcmUtil.h"
 
+//-----------------------------------------------------------------------------
+// Constructor / Destructor
+/**
+ * \ingroup gdcmDictEntry
+ * \brief   Construtor
+ * @param   InGroup
+ * @param   InElement
+ * @param   InVr
+ * @param   InFourth  // DO NOT use any longer
+ *                       NOT part of the Dicom Standard
+ * @param   InName 
+*/
+
 gdcmDictEntry::gdcmDictEntry(guint16 InGroup, guint16 InElement,
-                             string  InVr, string InFourth, string InName) 
-{
-       group           = InGroup;
+                             std::string  InVr, std::string InFourth,
+                             std::string  InName) {
+       group   = InGroup;
        element         = InElement;
        vr              = InVr;
-       fourth          = InFourth;
+       fourth  = InFourth;
        name            = InName;
        key             = TranslateToKey(group, element);
 }
 
+//-----------------------------------------------------------------------------
+// Print
+
+//-----------------------------------------------------------------------------
+// Public
+/**
+ * \ingroup gdcmDictEntry
+ * \brief   concatenates 2 guint16 (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 gdcmDictEntry::TranslateToKey(guint16 group, guint16 element) {
        char trash[10];
        TagKey key;
@@ -27,20 +56,26 @@ TagKey gdcmDictEntry::TranslateToKey(guint16 group, guint16 element) {
 
 /**
  * \ingroup     gdcmDictEntry
- * \brief       If-and only if-the vr is unset then overwrite it.
- * @param NewVr New vr to be set.
+ * \brief       If-and only if-the V(alue) R(epresentation)
+ *              is unset then overwrite it.
+ * @param NewVr New V(alue) R(epresentation) to be set.
  */
-void gdcmDictEntry::SetVR(string NewVr) {
-       if ( IsVrUnknown() )
+void gdcmDictEntry::SetVR(std::string NewVr) 
+{
+       if ( IsVRUnknown() )
                vr = NewVr;
-       else {
+       else 
+   {
                dbg.Error(true, "gdcmDictEntry::SetVR",
                          "Overwriting vr might compromise a dictionary");
        }
 }
 
-bool gdcmDictEntry::IsVrUnknown() {
-       if ( vr == "Unknown" )
-               return true;
-       return false;
-}
+//-----------------------------------------------------------------------------
+// Protected
+
+//-----------------------------------------------------------------------------
+// Private
+
+//-----------------------------------------------------------------------------
+