File: itkMetaDataDictionary.h

package info (click to toggle)
insighttoolkit 3.6.0-3
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 94,956 kB
  • ctags: 74,981
  • sloc: cpp: 355,621; ansic: 195,070; fortran: 28,713; python: 3,802; tcl: 1,996; sh: 1,175; java: 583; makefile: 415; csh: 184; perl: 175
file content (107 lines) | stat: -rw-r--r-- 3,357 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
/*=========================================================================

  Program:   Insight Segmentation & Registration Toolkit
  Module:    $RCSfile: itkMetaDataDictionary.h,v $
  Language:  C++
  Date:      $Date: 2007-01-18 15:35:23 $
  Version:   $Revision: 1.20 $

  Copyright (c) Insight Software Consortium. All rights reserved.
  See ITKCopyright.txt or http://www.itk.org/HTML/Copyright.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 __itkMetaDataDictionary_h
#define __itkMetaDataDictionary_h

#include "itkMetaDataObjectBase.h"
#include <vector>
#include <map>
#include <string>

namespace itk
{

/**
 * \author Hans J. Johnson
 * The MetaDataDictionary, along with the MetaDataObject derived template
 * classes, is designed to provide a mechanism for storing a collection of
 * arbitrary data types. The main motivation for such a collection is to
 * associate arbitrary data elements with itk DataObjects.
 */
class ITKCommon_EXPORT MetaDataDictionary
{
public:
  typedef MetaDataDictionary Self;
  /**
   * Defines the default behavior for printing out this element
   * \param os An output stream
   */
  virtual void Print(std::ostream& os) const;

  // Declare the datastructure that will be used to hold the
  // dictionary. 
  class MetaDataDictionaryMapType 
    : public std::map<std::string, MetaDataObjectBase::Pointer>
      {
      };

  typedef MetaDataDictionaryMapType::iterator       Iterator;
  typedef MetaDataDictionaryMapType::const_iterator ConstIterator;

  // Constructor
  MetaDataDictionary();
  // Copy Constructor
  MetaDataDictionary(const MetaDataDictionary&);
  // operator =
  void operator=(const MetaDataDictionary&);

  // Destructor
  virtual ~MetaDataDictionary();

  /** Returns a vector of keys to the key/value entries in the
    dictionary.  Iterate through the dictionary using these keys.
    */
  std::vector<std::string> GetKeys() const;

  // Implement map's api. On some Micorsoft compilers, stl containers
  // cannot be exported. This causes problems when building DLL's.
  // Here we inherit privately from std::map and provide a simple
  // API. The implementation will be in the DLL.
  MetaDataObjectBase::Pointer &operator [](const std::string &);
  const MetaDataObjectBase   * operator [](const std::string &) const;
  bool HasKey (const std::string &);


  /** \warning the following functions SHOULD NOT be used with 
   * the visual studio 6 compiler since iterator outside of the dll
   * context cannot be dereferenced safely */

  /** Returns an iterator to the beginning of the map */
#if !defined(CABLE_CONFIGURATION)
  Iterator  Begin();
  ConstIterator  Begin() const;
#endif

  /** Returns an iterator to the end of the map */
#if !defined(CABLE_CONFIGURATION)
  Iterator  End();
  ConstIterator  End() const;
#endif

  /** Returns an iterator matching the string key */
#if !defined(CABLE_CONFIGURATION)
  Iterator  Find(const std::string & key);
  ConstIterator  Find(const std::string & key) const;
#endif

private:
  MetaDataDictionaryMapType *m_Dictionary;
};

}
#endif // __itkMetaDataDictionary_h