Teuchos_ParameterEntry.hpp

Go to the documentation of this file.

// @HEADER
// ***********************************************************************
// 
//                    Teuchos: Common Tools Package
//                 Copyright (2004) Sandia Corporation
// 
// Under terms of Contract DE-AC04-94AL85000, there is a non-exclusive
// license for use of this work by or on behalf of the U.S. Government.
// 
// This library is free software; you can redistribute it and/or modify
// it under the terms of the GNU Lesser General Public License as
// published by the Free Software Foundation; either version 2.1 of the
// License, or (at your option) any later version.
//  
// This library is distributed in the hope that it will be useful, but
// WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.
//  
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
// USA
// Questions? Contact Michael A. Heroux (maherou@sandia.gov) 
// 
// ***********************************************************************
// @HEADER


#ifndef TEUCHOS_PARAMETER_ENTRY_H
#define TEUCHOS_PARAMETER_ENTRY_H

#include "Teuchos_ConfigDefs.hpp"
#include "Teuchos_any.hpp"

namespace Teuchos {

#ifndef DOXYGEN_SHOULD_SKIP_THIS
class ParameterList; // another parameter type (forward declaration)
#endif

class ParameterEntry {
public:



  ParameterEntry();
  
  ParameterEntry(const ParameterEntry& source);

  template<typename T>
  explicit ParameterEntry(T value, bool isDefault = false, bool isList = false);

  ~ParameterEntry();




  ParameterEntry& operator=(const ParameterEntry& source);

  template<typename T>
  void setValue(T value, bool isDefault = false);

  ParameterList& setList(bool isDefault = false);



   
  template<typename T>
  T& getValue(T *ptr) const;

  any& getAny(bool activeQry = true);

  const any& getAny(bool activeQry = true) const;



  
  bool isUsed() const;

  bool isList() const;

  template <typename T>
  bool isType() const;

  bool isDefault() const;



  ostream& leftshift(ostream& os, bool printFlags = true) const;


private:

  void reset();
  
  any val_;

  bool isList_;

  mutable bool isUsed_;

  mutable bool isDefault_;

};

template<typename T>
inline T& getValue( const ParameterEntry &entry )
{
  return entry.getValue((T*)NULL);
}

inline bool operator==(const ParameterEntry& e1, const ParameterEntry& e2) 
{ 
  return (
    e1.getAny() == e2.getAny()
    && e1.isList()== e2.isList()
    && e1.isUsed() == e2.isUsed()
    && e1.isDefault() == e2.isDefault()
    );
}

inline bool operator!=(const ParameterEntry& e1, const ParameterEntry& e2) 
{ 
  return !( e1 == e2 );
}

inline ostream& operator<<(ostream& os, const ParameterEntry& e) 
{ 
  return e.leftshift(os);
}

// ///////////////////////////////////////////
// Inline and Template Function Definitions

// Constructor/Destructor

template<typename T>
inline
ParameterEntry::ParameterEntry(T value, bool isDefault, bool isList)
  : val_(value),
    isList_(isList),
    isUsed_(false),
    isDefault_(isDefault)
{}

inline
ParameterEntry::~ParameterEntry()
{}

// Set Methods

template<typename T>
inline
void ParameterEntry::setValue(T value, bool isDefault)
{
  val_ = value;
  isDefault_ = isDefault;
}

// Get Methods

template<typename T>
inline
T& ParameterEntry::getValue(T *ptr) const
{
  isUsed_ = true;
  return const_cast<T&>(Teuchos::any_cast<T>( val_ ));
}

inline
any& ParameterEntry::getAny(bool activeQry)
{ 
  if (activeQry == true) {
    isUsed_ = true;
  }
  return val_; 
}

inline
const any& ParameterEntry::getAny(bool activeQry) const
{ 
  if (activeQry == true) {
    isUsed_ = true;
  }
  return val_; 
}

// Attribute Methods

inline
bool ParameterEntry::isUsed() const
{ return isUsed_; }

inline
bool ParameterEntry::isList() const
{ return isList_; }

template <typename T>
inline
bool ParameterEntry::isType() const
{ return val_.type() == typeid(T); }

inline
bool ParameterEntry::isDefault() const
{ return isDefault_; }

} // namespace Teuchos

#endif

---