/* -*- C++ -*-

  *

  * This file is a part of LEMON, a generic C++ optimization library

  *

  * Copyright (C) 2003-2008

  * Egervary Jeno Kombinatorikus Optimalizalasi Kutatocsoport

  * (Egervary Research Group on Combinatorial Optimization, EGRES).

  *

  * Permission to use, modify and distribute this software is granted

  * provided that this copyright notice appears in all copies. For

  * precise terms see the accompanying LICENSE file.

  *

  * This software is provided "AS IS" with no warranty of any kind,

  * express or implied, and with no claim as to its suitability for any

  * purpose.

  *

  */

 #ifndef LEMON_CONCEPT_MAPS_H

 #define LEMON_CONCEPT_MAPS_H

 #include <lemon/bits/utility.h>

 #include <lemon/concept_check.h>

 ///\ingroup concept

 ///\file

 ///\brief Map concepts checking classes for testing and documenting.

 namespace lemon {

   namespace concepts {

     /// \addtogroup concept

     /// @{

     /// Readable map concept

     /// Readable map concept.

     ///

     template<typename K, typename T>

     class ReadMap

     {

     public:

       /// The key type of the map.

       typedef K Key;

       /// The value type of the map. (The type of objects associated with the keys).

       typedef T Value;

       /// Returns the value associated with the given key.

       /// Returns the value associated with the given key.

       /// \bug Value shouldn't need to be default constructible. 

       Value operator[](const Key &) const { return Value(); }

       template<typename _ReadMap>

       struct Constraints {

 	void constraints() {

 	  Value val = m[key];

 	  val = m[key];

 	  typename _ReadMap::Value own_val = m[own_key];

 	  own_val = m[own_key];

 	  ignore_unused_variable_warning(key);

 	  ignore_unused_variable_warning(val);

 	  ignore_unused_variable_warning(own_key);

 	  ignore_unused_variable_warning(own_val);

 	}

 	const Key& key;

 	const typename _ReadMap::Key& own_key;

 	const _ReadMap& m;

       };

     };

     /// Writable map concept

     /// Writable map concept.

     ///

     template<typename K, typename T>

     class WriteMap

     {

     public:

       /// The key type of the map.

       typedef K Key;

       /// The value type of the map. (The type of objects associated with the keys).

       typedef T Value;

       /// Sets the value associated with the given key.

       void set(const Key &, const Value &) {}

       /// Default constructor.

       WriteMap() {}

       template <typename _WriteMap>

       struct Constraints {

 	void constraints() {

 	  m.set(key, val);

 	  m.set(own_key, own_val);

 	  ignore_unused_variable_warning(key);

 	  ignore_unused_variable_warning(val);

 	  ignore_unused_variable_warning(own_key);

 	  ignore_unused_variable_warning(own_val);

 	}

 	const Key& key;

 	const Value& val;

 	const typename _WriteMap::Key& own_key;

 	const typename _WriteMap::Value own_val;

 	_WriteMap& m;

       };

     };

     /// Read/writable map concept

     /// Read/writable map concept.

     ///

     template<typename K, typename T>

     class ReadWriteMap : public ReadMap<K,T>,

 			 public WriteMap<K,T>

     {

     public:

       /// The key type of the map.

       typedef K Key;

       /// The value type of the map. (The type of objects associated with the keys).

       typedef T Value;

       /// Returns the value associated with the given key.

       Value operator[](const Key &) const { return Value(); }

       /// Sets the value associated with the given key.

       void set(const Key &, const Value &) {}

       template<typename _ReadWriteMap>

       struct Constraints {

 	void constraints() {

 	  checkConcept<ReadMap<K, T>, _ReadWriteMap >();

 	  checkConcept<WriteMap<K, T>, _ReadWriteMap >();

 	}

       };

     };

     /// Dereferable map concept

     /// Dereferable map concept.

     ///

     template<typename K, typename T, typename R, typename CR>

     class ReferenceMap : public ReadWriteMap<K,T>

     {

     public:

       /// Tag for reference maps.

       typedef True ReferenceMapTag;

       /// The key type of the map.

       typedef K Key;

       /// The value type of the map. (The type of objects associated with the keys).

       typedef T Value;

       /// The reference type of the map.

       typedef R Reference;

       /// The const reference type of the map.

       typedef CR ConstReference;

     protected:

       Value tmp;

     public:

       /// Returns a reference to the value associated with the given key.

       Reference operator[](const Key &) { return tmp; }

       /// Returns a const reference to the value associated with the given key.

       ConstReference operator[](const Key &) const { return tmp; }

       /// Sets the value associated with the given key.

       void set(const Key &k,const Value &t) { operator[](k)=t; }

       template<typename _ReferenceMap>

       struct Constraints {

 	void constraints() {

 	  checkConcept<ReadWriteMap<K, T>, _ReferenceMap >();

 	  ref = m[key];

 	  m[key] = val;

 	  m[key] = ref;

 	  m[key] = cref;

 	  own_ref = m[own_key];

 	  m[own_key] = own_val;

 	  m[own_key] = own_ref;

 	  m[own_key] = own_cref;

 	  m[key] = m[own_key];

 	  m[own_key] = m[key];

 	}

 	const Key& key;

 	Value& val;

 	Reference ref;

 	ConstReference cref;

 	const typename _ReferenceMap::Key& own_key;

 	typename _ReferenceMap::Value& own_val;

 	typename _ReferenceMap::Reference own_ref;

 	typename _ReferenceMap::ConstReference own_cref;

 	_ReferenceMap& m;

       };

     };

     // @}

   } //namespace concepts

 } //namespace lemon

 #endif // LEMON_CONCEPT_MAPS_H