Teuchos_ParameterListModifier.hpp

Go to the documentation of this file.

// @HEADER
// *****************************************************************************
//                    Teuchos: Common Tools Package
//
// Copyright 2004 NTESS and the Teuchos contributors.
// SPDX-License-Identifier: BSD-3-Clause
// *****************************************************************************
// @HEADER
 
#ifndef TEUCHOS_ParameterListModifier_hpp_
#define TEUCHOS_ParameterListModifier_hpp_

 
#include "Teuchos_Describable.hpp"
#include "Teuchos_ParameterEntryValidator.hpp"
#include "Teuchos_map.hpp"
#include "Teuchos_RCP.hpp"
namespace Teuchos {
 
 
#ifndef DOXYGEN_SHOULD_SKIP_THIS
class ParameterList;
#endif

class TEUCHOSPARAMETERLIST_LIB_DLL_EXPORT ParameterListModifier : public Describable {
 
public:



  ParameterListModifier() = default;

  ParameterListModifier(const std::string &name);

  virtual ~ParameterListModifier();



  ParameterListModifier& setName( const std::string &name );



  inline const std::string& getName() const{
    return name_;
  }


  void printDoc(
    std::string const& docString,
    std::ostream &out
    ) const;
 

  Array<std::string> findMatchingBaseNames(const ParameterList &paramList,
      const std::string &baseName, const bool &findParameters = true,
      const bool &findSublists = true) const;

  virtual void modify(ParameterList &paramList, ParameterList &validParamList) const {};
 

  virtual void reconcile(ParameterList &paramList) const {};
 

  int expandParameters(const std::string &paramTemplateName, ParameterList &paramList,
      ParameterList &validParamList,
      const Array<std::string> &excludeParameters=Array<std::string>()) const;
 

  int expandSublists(const std::string &sublistTemplateName, ParameterList &paramList,
      ParameterList &validParamList,
      const Array<std::string> &excludeSublists=Array<std::string>()) const;
 

  int setDefaultsInSublists(const std::string &paramName, ParameterList &paramList,
      const Array<std::string> &sublistNames, const bool removeParam = true) const;
 

  int expandSublistsUsingBaseName(const std::string &baseName, ParameterList &paramList,
      ParameterList &validParamList, const bool &allowBaseName = true) const;
 
 
protected:
  std::string name_ = "ANONYMOUS";
 
};

inline bool operator==(const ParameterListModifier& plm1, const ParameterListModifier& plm2)
{ 
  return (
    plm1.getName() == plm2.getName()
    && typeid(plm1) == typeid(plm2)
    );
}

inline bool operator!=(const ParameterListModifier& plm1, const ParameterListModifier& plm2)
{ 
  return !( plm1 == plm2 );
}
 
// /////////////////////////////////////////////////////
// Inline and Template Function Definitions
 
 
inline
ParameterListModifier& ParameterListModifier::setName( const std::string &name_in )
{
  name_ = name_in;
  return *this;
}
 
 
} // end of Teuchos namespace
 
#endif