libMesh::Parameters Class Reference

#include <parameters.h>

Classes
class	Parameter
class	Value

Public Types
typedef std::map< std::string, Value * >::iterator	iterator
typedef std::map< std::string, Value * >::const_iterator	const_iterator

Public Member Functions
	Parameters ()
	Parameters (const Parameters &)
virtual	~Parameters ()
virtual Parameters &	operator= (const Parameters &source)
virtual Parameters &	operator+= (const Parameters &source)
template<typename T >
bool	have_parameter (const std::string &) const
template<typename T >
const T &	get (const std::string &) const
template<typename T >
void	insert (const std::string &)
template<typename T >
T &	set (const std::string &)
virtual void	set_attributes (const std::string &, bool)
void	remove (const std::string &)
std::size_t	n_parameters () const
template<typename T >
unsigned int	n_parameters () const
virtual void	clear ()
void	print (std::ostream &os=libMesh::out) const
iterator	begin ()
const_iterator	begin () const
iterator	end ()
const_iterator	end () const

Protected Attributes
std::map< std::string, Value * >	_values

Detailed Description

This class provides the ability to map between arbitrary, user-defined strings and several data types. This can be used to provide arbitrary user-specified options.

Author

Benjamin S. Kirk

Date

2004

Definition at line 63 of file parameters.h.

Member Typedef Documentation

const_iterator

typedef std::map<std::string, Value *>::const_iterator libMesh::Parameters::const_iterator

Constant parameter map iterator.

Definition at line 247 of file parameters.h.

iterator

typedef std::map<std::string, Value *>::iterator libMesh::Parameters::iterator

Parameter map iterator.

Definition at line 242 of file parameters.h.

Constructor & Destructor Documentation

Parameters() [1/2]

libMesh::Parameters::Parameters ( )

inline

Default constructor. Does nothing.

Definition at line 70 of file parameters.h.

{}

Parameters() [2/2]

libMesh::Parameters::Parameters ( const Parameters &  p )

inline

Copy constructor.

Definition at line 355 of file parameters.h.

{
  *this = p;
}

~Parameters()

libMesh::Parameters::~Parameters ( )

inlinevirtual

Destructor. Clears any allocated memory.

Definition at line 363 of file parameters.h.

References clear().

{
  this->clear ();
}

Member Function Documentation

begin() [1/2]

Parameters::iterator libMesh::Parameters::begin ( )

inline

Iterator pointing to the beginning of the set of parameters.

Definition at line 509 of file parameters.h.

References _values.

{
  return _values.begin();
}

begin() [2/2]

Parameters::const_iterator libMesh::Parameters::begin ( ) const

inline

Iterator pointing to the beginning of the set of parameters.

Definition at line 515 of file parameters.h.

References _values.

{
  return _values.begin();
}

clear()

void libMesh::Parameters::clear ( )

inlinevirtual

Clears internal data structures & frees any allocated memory.

Definition at line 317 of file parameters.h.

References _values.

Referenced by libMesh::EquationSystems::clear(), operator=(), and ~Parameters().

{                         // before its first use (for some compilers)
  while (!_values.empty())
    {
      Parameters::iterator it = _values.begin();

      delete it->second;
      it->second = nullptr;

      _values.erase(it);
    }
}

end() [1/2]

Parameters::iterator libMesh::Parameters::end ( )

inline

Iterator pointing to the end of the set of parameters

Definition at line 521 of file parameters.h.

References _values.

{
  return _values.end();
}

end() [2/2]

Parameters::const_iterator libMesh::Parameters::end ( ) const

inline

Iterator pointing to the end of the set of parameters

Definition at line 527 of file parameters.h.

References _values.

{
  return _values.end();
}

get()

template<typename T >

const T & libMesh::Parameters::get ( const std::string &  name ) const

inline

Returns

A constant reference to the specified parameter value. Requires, of course, that the parameter exists.

Definition at line 425 of file parameters.h.

References _values, libMesh::demangle(), and libMesh::Quality::name().

Referenced by libMesh::FrequencySystem::clear_all(), libMesh::ImplicitSystem::get_linear_solve_parameters(), libMesh::FEComputeData::init(), libMesh::FrequencySystem::init_data(), libMesh::FrequencySystem::n_frequencies(), libMesh::FrequencySystem::set_current_frequency(), libMesh::NonlinearImplicitSystem::set_solver_parameters(), libMesh::CondensedEigenSystem::solve(), libMesh::EigenSystem::solve(), libMesh::FrequencySystem::solve(), and libMesh::LinearImplicitSystem::solve().

{
  if (!this->have_parameter<T>(name))
    {
      std::ostringstream oss;

      oss << "ERROR: no";
#ifdef LIBMESH_HAVE_RTTI
      oss << ' ' << demangle(typeid(T).name());
#endif
      oss << " parameter named \""
          << name << "\" found.\n\n"
          << "Known parameters:\n"
          << *this;

      libmesh_error_msg(oss.str());
    }

  Parameters::const_iterator it = _values.find(name);

  libmesh_assert(it != _values.end());
  libmesh_assert(it->second);

  return cast_ptr<Parameter<T> *>(it->second)->get();
}

have_parameter()

template<typename T >

bool libMesh::Parameters::have_parameter ( const std::string &  name ) const

inline

Returns

true if a parameter of type T with a specified name exists, false otherwise.

If RTTI has been disabled then we return true if a parameter of specified name exists regardless of its type.

Definition at line 406 of file parameters.h.

References _values, libMesh::cast_ptr(), and libMesh::Quality::name().

Referenced by libMesh::FrequencySystem::clear_all(), libMesh::FEComputeData::init(), libMesh::FrequencySystem::init_data(), libMesh::CondensedEigenSystem::solve(), and libMesh::EigenSystem::solve().

{
  Parameters::const_iterator it = _values.find(name);

  if (it != _values.end())
#ifdef LIBMESH_HAVE_RTTI
    if (dynamic_cast<const Parameter<T> *>(it->second) != nullptr)
#else // LIBMESH_HAVE_RTTI
      if (cast_ptr<const Parameter<T> *>(it->second) != nullptr)
#endif // LIBMESH_HAVE_RTTI
        return true;

  return false;
}

insert()

template<typename T >

void libMesh::Parameters::insert ( const std::string &  name )

inline

Inserts a new Parameter into the object but does not return a writable reference. The value of the newly inserted parameter may not be valid.

Definition at line 453 of file parameters.h.

References _values, libMesh::Quality::name(), and set_attributes().

{
  if (!this->have_parameter<T>(name))
    _values[name] = new Parameter<T>;

  set_attributes(name, true);
}

n_parameters() [1/2]

std::size_t libMesh::Parameters::n_parameters ( ) const

inline

Returns

The total number of parameters.

Definition at line 143 of file parameters.h.

References _values.

{ return _values.size(); }

n_parameters() [2/2]

template<typename T >

unsigned int libMesh::Parameters::n_parameters ( ) const

inline

Returns

The number of parameters of the requested type.

Definition at line 493 of file parameters.h.

References _values.

{
  unsigned int cnt = 0;

  Parameters::const_iterator       it  = _values.begin();
  const Parameters::const_iterator vals_end = _values.end();

  for (; it != vals_end; ++it)
    if (dynamic_cast<Parameter<T> *>(it->second) != nullptr)
      cnt++;

  return cnt;
}

operator+=()

Parameters & libMesh::Parameters::operator+= ( const Parameters &  source )

inlinevirtual

Addition/Assignment operator. Inserts copies of all parameters from source. Any parameters of the same name already in this are replaced.

Definition at line 342 of file parameters.h.

References _values.

{
  for (const auto & pr : source._values)
    {
      if (_values.find(pr.first) != _values.end())
        delete _values[pr.first];
      _values[pr.first] = pr.second->clone();
    }

  return *this;
}

operator=()

Parameters & libMesh::Parameters::operator= ( const Parameters &  source )

inlinevirtual

Assignment operator. Removes all parameters in this and inserts copies of all parameters from source

Definition at line 333 of file parameters.h.

References clear().

{
  this->clear();
  *this += source;

  return *this;
}

print()

void libMesh::Parameters::print ( std::ostream &  os = libMesh::out ) const

inline

Prints the contents, by default to libMesh::out.

Definition at line 371 of file parameters.h.

References _values.

Referenced by libMesh::operator<<().

{
  Parameters::const_iterator it = _values.begin();

  os << "Name\t Type\t Value\n"
     << "---------------------\n";
  while (it != _values.end())
    {
      os << " "   << it->first
#ifdef LIBMESH_HAVE_RTTI
         << "\t " << it->second->type()
#endif // LIBMESH_HAVE_RTTI
         << "\t ";   it->second->print(os);
      os << '\n';

      ++it;
    }
}

remove()

void libMesh::Parameters::remove ( const std::string &  name )

inline

Removes the specified parameter from the list, if it exists.

Definition at line 475 of file parameters.h.

References _values, and libMesh::Quality::name().

Referenced by libMesh::FrequencySystem::clear_all().

{
  Parameters::iterator it = _values.find(name);

  if (it != _values.end())
    {
      delete it->second;
      it->second = nullptr;

      _values.erase(it);
    }
}

set()

template<typename T >

T & libMesh::Parameters::set ( const std::string &  name )

inline

Returns

A writable reference to the specified parameter. This method will create the parameter if it does not exist, so it can be used to define parameters which will later be accessed with the get() member.

Definition at line 464 of file parameters.h.

References _values, libMesh::Quality::name(), and set_attributes().

Referenced by libMesh::NewmarkSystem::clear(), libMesh::EquationSystems::EquationSystems(), libMesh::NewmarkSystem::NewmarkSystem(), libMesh::NonlinearImplicitSystem::NonlinearImplicitSystem(), libMesh::FrequencySystem::set_current_frequency(), libMesh::FrequencySystem::set_frequencies(), libMesh::FrequencySystem::set_frequencies_by_range(), libMesh::FrequencySystem::set_frequencies_by_steps(), and libMesh::NewmarkSystem::set_newmark_parameters().

{
  if (!this->have_parameter<T>(name))
    _values[name] = new Parameter<T>;

  set_attributes(name, false);

  return cast_ptr<Parameter<T> *>(_values[name])->set();
}

set_attributes()

virtual void libMesh::Parameters::set_attributes ( const std::string &  , bool    )

inlinevirtual

Overridable function to set any extended attributes for classes inheriting from this class.

Definition at line 133 of file parameters.h.

Referenced by insert(), and set().

{}

Member Data Documentation

_values

std::map<std::string, Value *> libMesh::Parameters::_values

protected

Data structure to map names with values.

Definition at line 274 of file parameters.h.

Referenced by begin(), clear(), end(), get(), have_parameter(), insert(), n_parameters(), operator+=(), print(), remove(), and set().

---

The documentation for this class was generated from the following file:

• parameters.h