itkMetaDataDictionary.h

Go to the documentation of this file.

/*=========================================================================
 *
 *  Copyright Insight Software Consortium
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *         http://www.apache.org/licenses/LICENSE-2.0.txt
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 *
 *=========================================================================*/
#ifndef itkMetaDataDictionary_h
#define itkMetaDataDictionary_h

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

namespace itk
{
class ITKCommon_EXPORT MetaDataDictionary
{
public:
  typedef MetaDataDictionary Self;
  virtual void Print(std::ostream & os) const;

  // Declare the datastructure that will be used to hold the
  // dictionary.
  typedef std::map< std::string, MetaDataObjectBase::Pointer >  MetaDataDictionaryMapType;
  typedef MetaDataDictionaryMapType::iterator                   Iterator;
  typedef MetaDataDictionaryMapType::const_iterator             ConstIterator;

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

  // Destructor
  virtual ~MetaDataDictionary();

  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;

  const MetaDataObjectBase * Get(const std::string &) const;
  void Set(const std::string &, MetaDataObjectBase * );
  bool HasKey(const std::string &) const;

  bool Erase(const std::string&);

#if !defined( ITK_WRAPPING_PARSER )
  Iterator  Begin();

  ConstIterator  Begin() const;

#endif

#if !defined( ITK_WRAPPING_PARSER )
  Iterator  End();

  ConstIterator  End() const;

#endif

#if !defined( ITK_WRAPPING_PARSER )
  Iterator  Find(const std::string & key);

  ConstIterator  Find(const std::string & key) const;

#endif

  void Clear();

private:
  MetaDataDictionaryMapType *m_Dictionary;
};
}
#endif // itkMetaDataDictionary_h