#ifndef __creaImageIOTreeAttributeDescriptor_h_INCLUDED__
#define __creaImageIOTreeAttributeDescriptor_h_INCLUDED__

#include <string>
//#include <iostream>

namespace creaImageIO
{

  namespace tree
  {
    //=====================================================================
    /// Descriptor of an attribute of a node of a tree (name, dicom group/element)
    class AttributeDescriptor
    {    
    public:
      /// Flags
      /// The attribute is hidden (not visible to user)
      static const unsigned int HIDDEN;
      /// The attribute enters in unique identifier constitution (KEY)
      static const unsigned int KEY;
      /// The attribute enters in label constitution (for printing)
      static const unsigned int LABEL;

      /// Default ctor
      AttributeDescriptor()
	: mKey(""), mName(""), mGroup(0), mElement(0), mFlags(0)
      {
      }
      // Ctor with key, name and flags
      AttributeDescriptor(const std::string& key,
			  const std::string& name,
			  unsigned int flags = 0);
      // Ctor with dicom group, elem and flags
      // The key is built as 'Dgroup_elem'
      // The user name is retreived from dicom dictionnary
      AttributeDescriptor(unsigned short group,
			  unsigned short element,
			  unsigned int flags = 0);
      /// Returns the key of the attribute
      const std::string& GetKey() const { return mKey; }
      /// Returns the name of the attribute
      const std::string& GetName() const { return mName; }
      /// Returns the DICOM group code of the attribute
      unsigned short GetGroup() const { return mGroup; }
      /// Returns the DICOM element code of the attribute
      unsigned short GetElement() const { return mElement; }
      /// Returns the flags of the attribute
      unsigned int GetFlags() const { return mFlags; }
    
      /// Extracts group and element from a key of the form "Dgroup_elem" 
      static void GetDicomGroupElementFromKey(const std::string& key,
					      unsigned short& group,
					      unsigned short& elem);
      /// Cleans the name:
      /// Replace simple quote by double quotes
      /// Cut string at NULL chars 
      void CleanName(std::string& str) const;
    private:
      std::string mKey;
      std::string mName;
      unsigned short mGroup;
      unsigned short mElement;
      unsigned int mFlags;
    };
    // EO class AttributeDescriptor
    //=====================================================================

   

  } // EO namespace tree

} // EO namespace creaImageIO


/*
//=====================================================================
inline std::ostream& operator<<(std::ostream& s, 
const creaImageIO::tree::AttributeDescriptor& d)
{
s << "[" << d.key << ":" << d.name << "]";
return s;
}
//=====================================================================
*/


#endif // #ifndef __creaImageIOTreeAttributeDescriptor_h_INCLUDED__