* DEVELOPPER: added a proposition of coding style.

[gdcm.git] / src / gdcmDict.h

diff --git a/src/gdcmDict.h b/src/gdcmDict.h
index db6f0e04bc94e252859b38ad57f8c23ecbf2a8b9..9931f7bcab26a123c54d07c08c1f7bd776cf3178 100644 (file)
--- a/src/gdcmDict.h
+++ b/src/gdcmDict.h
@@ -1,15 +1,36 @@
-// gdcmDict.h
+/*=========================================================================
+                                                                                
+  Program:   gdcm
+  Module:    $RCSfile: gdcmDict.h,v $
+  Language:  C++
+  Date:      $Date: 2004/06/20 18:08:47 $
+  Version:   $Revision: 1.15 $
+                                                                                
+  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.
+                                                                                
+     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.
+                                                                                
+=========================================================================*/
 
 #ifndef GDCMDICT_H
 #define GDCMDICT_H
 
 #include "gdcmCommon.h"
 #include "gdcmDictEntry.h"
+
+#include <iostream>
+#include <list>
 #include <map>
 
+//-----------------------------------------------------------------------------
 typedef std::map<TagKey,  gdcmDictEntry*> TagKeyHT;
 typedef std::map<TagName, gdcmDictEntry*> TagNameHT;
 
+//-----------------------------------------------------------------------------
 /*
  * \defgroup gdcmDict
  * \brief    gdcmDict acts a memory representation of a dicom dictionary i.e.
@@ -21,25 +42,51 @@ typedef std::map<TagName, gdcmDictEntry*> TagNameHT;
  * \see gdcmDictSet
  */
 class GDCM_EXPORT gdcmDict {
-   std::string name;
+public:
+   gdcmDict(std::string & FileName);
+   ~gdcmDict();
+
+// Print
+   void Print(std::ostream &os = std::cout);
+   void PrintByKey(std::ostream &os = std::cout);
+   void PrintByName(std::ostream &os = std::cout);
+
+// Entries
+   bool AddNewEntry (gdcmDictEntry *NewEntry);
+   bool ReplaceEntry(gdcmDictEntry *NewEntry);
+   bool RemoveEntry (TagKey key);
+   bool RemoveEntry (guint16 group, guint16 element);
+   
+// Tag
+   gdcmDictEntry *GetDictEntryByName(TagName name);
+   gdcmDictEntry *GetDictEntryByNumber(guint16 group, guint16 element);
+
+   std::list<std::string> *GetDictEntryNames(void);
+   std::map<std::string, std::list<std::string> > *
+        GetDictEntryNamesByCategory(void);
+
+   /**
+    * \ingroup gdcmDict
+    * \brief   returns a ref to the Dicom Dictionary H table (map)
+    * return the Dicom Dictionary H table
+    */
+   inline TagKeyHT & GetEntriesByKey(void)  { return KeyHt; }
+
+   /**
+    * \ingroup gdcmDict
+    * \brief   returns a ref to the Dicom Dictionary H table (map)
+    * return the Dicom Dictionary H table
+    */
+   inline TagNameHT & GetEntriesByName(void)  { return NameHt; }
+ 
+private:
+   /// ASCII file holding the Dictionnary
    std::string filename;
    /// Access through TagKey (see alternate access with NameHt)
-       TagKeyHT  KeyHt;
+   TagKeyHT  KeyHt;
    /// Access through TagName (see alternate access with KeyHt)
-       TagNameHT NameHt;
-public:
-       gdcmDict(std::string & FileName);
-       ~gdcmDict();
-       int AddNewEntry (gdcmDictEntry* NewEntry);
-       int ReplaceEntry(gdcmDictEntry* NewEntry);
-       int RemoveEntry (TagKey key);
-       int RemoveEntry (guint16 group, guint16 element);
-       gdcmDictEntry * GetTagByNumber(guint16 group, guint16 element);
-       gdcmDictEntry * GetTagByName(TagName name);
-       void Print(std::ostream&);
-       void PrintByKey(std::ostream&);
-       void PrintByName(std::ostream&);
-       TagKeyHT & GetEntries(void) { return KeyHt; }
+   TagNameHT NameHt;
 };
 
+//-----------------------------------------------------------------------------
 #endif