Teuchos Package Browser (Single Doxygen Collection) Version of the Day
Classes | Private Types | Private Member Functions | Private Attributes | Related Functions
Teuchos::ParameterList Class Reference

Templated parameter list. More...

#include <Teuchos_ParameterList.hpp>

List of all members.

Classes

class  PrintOptions
 Utility class for setting and passing in print options. More...

Private Types

typedef
StringIndexedOrderedValueObjectContainer
< ParameterEntry
params_t
 Internal data-structure.
typedef params_t::Iterator Iterator
 Parameter container iterator typedef.

Private Member Functions

Iterator nonconstBegin ()
 An iterator pointing to the first entry.
Iterator nonconstEnd ()
 An iterator pointing beyond the last entry.
ParameterEntrynonconstEntry (Iterator i)
 Access to ParameterEntry (i.e., returns i->second)
void validateEntryExists (const std::string &funcName, const std::string &name, const ParameterEntry *entry) const
 Validate that a parameter exists.
template<typename T >
void validateEntryType (const std::string &funcName, const std::string &name, const ParameterEntry &entry) const
 Validate that a type is the same.
void validateEntryIsList (const std::string &name, const ParameterEntry &entry) const
 Validate a sublist param is indeed a sublist.
void validateMissingSublistMustExist (const std::string &baselist_name, const std::string &sublist_name, const bool mustAlreadyExist) const
 Throw a sublist does not exist exception.
void updateSubListNames (int depth=0)
 Update sublist names recursively.

Private Attributes

std::string name_
 Name of the (sub)list.
params_t params_
 Parameter list.
bool disableRecursiveValidation_
 Validate into list or not.

Related Functions

(Note that these are not member functions.)

enum  EValidateUsed { VALIDATE_USED_ENABLED, VALIDATE_USED_DISABLED }
 Validation used enum. More...
enum  EValidateDefaults { VALIDATE_DEFAULTS_ENABLED, VALIDATE_DEFAULTS_DISABLED }
 Validation defaults enum. More...
RCP< ParameterListparameterList ()
 Nonmember constructor.
RCP< ParameterListparameterList (const std::string &name)
 Nonmember constructor.
RCP< ParameterListparameterList (const ParameterList &source)
 Nonmember constructor.
RCP< ParameterListcreateParameterList ()
 Nonmember constructor.
RCP< ParameterListcreateParameterList (const std::string &name)
 Nonmember constructor.
TEUCHOS_LIB_DLL_EXPORT bool operator== (const ParameterList &list1, const ParameterList &list2)
 Returns true if two parameter lists are the same.
bool operator!= (const ParameterList &list1, const ParameterList &list2)
 Returns true if two parameter lists are not the same.
TEUCHOS_LIB_DLL_EXPORT bool haveSameValues (const ParameterList &list1, const ParameterList &list2)
 Returns true if two parameter lists have the same values.
template<typename T >
T & getParameter (ParameterList &l, const std::string &name)
 A templated helper function for getting a parameter from a non-const list. This helper function prevents the need for giving a nominal value of the specific template type.
template<typename T >
T & get (ParameterList &l, const std::string &name)
 A shorter name for getParameter().
template<typename T >
const T & getParameter (const ParameterList &l, const std::string &name)
 A templated helper function for getting a parameter from a const list. This helper function prevents the need for giving a nominal value of the specific template type.
template<typename T >
T * getParameterPtr (ParameterList &l, const std::string &name)
 A templated helper function for getting a pointer to a parameter from a non-const list, if it exists. This helper function prevents the need for giving a nominal value of the specific template type.
template<typename T >
const T * getParameterPtr (const ParameterList &l, const std::string &name)
 A templated helper function for getting a pointer to a parameter from a non-const list, if it exists. This helper function prevents the need for giving a nominal value of the specific template type.
template<typename T >
bool isParameterType (ParameterList &l, const std::string &name)
 A templated helper function for determining the type of a parameter entry for a non-const list. This helper function avoids the need for giving a nominal value of the specific template type.
template<typename T >
bool isParameterType (const ParameterList &l, const std::string &name)
 A templated helper function for determining the type of a parameter entry for a const list. This helper function avoids the need for giving a nominal value of the specific template type.
template<typename T >
void setStringParameterFromArray (const std::string &paramName, const Array< T > &array, ParameterList *paramList)
 Set a std::string parameter representation of an array.
template<typename T >
Array< T > getArrayFromStringParameter (const ParameterList &paramList, const std::string &paramName, const int arrayDim=-1, const bool mustExist=true)
 Get an Array object (with entries of type T) from a parameter holding a std::string representation of the array.
RCP< ParameterListsublist (const RCP< ParameterList > &paramList, const std::string &name, bool mustAlreadyExist=false, const std::string &docString="")
 Return a RCP to a sublist in another RCP-ed parameter list.
RCP< const ParameterListsublist (const RCP< const ParameterList > &paramList, const std::string &name)
 Return a RCP to a sublist in another RCP-ed parameter list.
std::ostream & operator<< (std::ostream &os, const ParameterList &l)
 Output stream operator for handling the printing of the parameter list.
template<class IntegralType >
void setStringToIntegralParameter (std::string const &paramName, std::string const &defaultValue, std::string const &docString, ArrayView< const std::string > const &strings, ParameterList *paramList)
 Set up a std::string parameter that will use an embedded validator to allow the extraction of an integral value.
template<class IntegralType >
void setStringToIntegralParameter (std::string const &paramName, std::string const &defaultValue, std::string const &docString, ArrayView< const std::string > const &strings, ArrayView< const IntegralType > const &integralValues, ParameterList *paramList)
 Set up a std::string parameter that will use an embedded validator to allow the extraction of an integral value from a list of integral values.
template<class IntegralType >
void setStringToIntegralParameter (std::string const &paramName, std::string const &defaultValue, std::string const &docString, ArrayView< const std::string > const &strings, ArrayView< const std::string > const &stringsDocs, ArrayView< const IntegralType > const &integralValues, ParameterList *paramList)
 Set up a std::string parameter with documentation strings for each valid value that will use an embedded validator to allow the extraction of an integral value from a list of integral values.
template<class IntegralType >
IntegralType getIntegralValue (ParameterList const &paramList, std::string const &paramName)
 Get an integral value for a parameter that is assumed to already be set.
template<class IntegralType >
std::string getStringValue (ParameterList const &paramList, std::string const &paramName)
 Get a std::string value for a parameter that is assumed to already be set.
TEUCHOS_LIB_DLL_EXPORT void setIntParameter (std::string const &paramName, int const value, std::string const &docString, ParameterList *paramList, AnyNumberParameterEntryValidator::AcceptedTypes const &acceptedTypes=AnyNumberParameterEntryValidator::AcceptedTypes())
 Set an integer parameter that allows for (nearly) any input parameter type that is convertible to an int.
TEUCHOS_LIB_DLL_EXPORT void setDoubleParameter (std::string const &paramName, double const &value, std::string const &docString, ParameterList *paramList, AnyNumberParameterEntryValidator::AcceptedTypes const &acceptedTypes=AnyNumberParameterEntryValidator::AcceptedTypes())
 Set an double parameter that allows for (nearly) any input parameter type that is convertible to a double.
TEUCHOS_LIB_DLL_EXPORT void setNumericStringParameter (std::string const &paramName, std::string const &value, std::string const &docString, ParameterList *paramList, AnyNumberParameterEntryValidator::AcceptedTypes const &acceptedTypes=AnyNumberParameterEntryValidator::AcceptedTypes())
 Set an numeric parameter preferred as a std::string that allows for (nearly) any input parameter type that is convertible to a std::string.
TEUCHOS_LIB_DLL_EXPORT int getIntParameter (ParameterList const &paramList, std::string const &paramName)
 Get an integer parameter.
TEUCHOS_LIB_DLL_EXPORT double getDoubleParameter (ParameterList const &paramList, std::string const &paramName)
 Get double integer parameter.
TEUCHOS_LIB_DLL_EXPORT std::string getNumericStringParameter (ParameterList const &paramList, std::string const &paramName)
 Get std::string numeric parameter.
TEUCHOS_LIB_DLL_EXPORT void updateParametersFromXmlFile (const std::string &xmlFileName, const Ptr< ParameterList > &paramList)
 Reads XML parameters from a file and updates those already in the given parameter list.
TEUCHOS_LIB_DLL_EXPORT void updateParametersFromXmlFileAndBroadcast (const std::string &xmlFileName, const Ptr< ParameterList > &paramList, const Comm< int > &comm)
 On processor rank = 0, reads XML parameters from a file and broadcasts them to all other processors. Then updates the given parameter list with these values.
TEUCHOS_LIB_DLL_EXPORT RCP
< ParameterList
getParametersFromXmlFile (const std::string &xmlFileName)
 Reads XML parameters from a file and return them in a new parameter list.
TEUCHOS_LIB_DLL_EXPORT RCP
< ParameterList
getParametersFromXmlFile (const std::string &xmlFileName, RCP< DependencySheet > depSheet)
 Reads XML parameters from a file and return them in a new parameter list.
TEUCHOS_LIB_DLL_EXPORT void updateParametersFromXmlString (const std::string &xmlStr, const Ptr< ParameterList > &paramList)
 Reads XML parameters from a std::string and updates those already in the given parameter list.
TEUCHOS_LIB_DLL_EXPORT RCP
< ParameterList
getParametersFromXmlString (const std::string &xmlStr)
 Reads XML parameters from a std::string and return them in a new parameter list.
TEUCHOS_LIB_DLL_EXPORT RCP
< ParameterList
getParametersFromXmlString (const std::string &xmlStr, RCP< DependencySheet > depSheet)
 Reads XML parameters from a std::string and return them in a new parameter list.
TEUCHOS_LIB_DLL_EXPORT void writeParameterListToXmlOStream (const ParameterList &paramList, std::ostream &xmlOut, RCP< const DependencySheet > depSheet=null)
 Write parameters and sublists in XML format to an std::ostream.
TEUCHOS_LIB_DLL_EXPORT void writeParameterListToXmlFile (const ParameterList &paramList, const std::string &xmlFileName, RCP< const DependencySheet > depSheet=null)
 Write parameters and sublist to an XML file.

Public types

typedef params_t::ConstIterator ConstIterator
 Parameter container const iterator typedef.

Constructors/Destructor/Info.

 ParameterList ()
 Constructor.
 ParameterList (const std::string &name)
 Constructor.
 ParameterList (const ParameterList &source)
 Copy Constructor.
virtual ~ParameterList ()
 Deconstructor.
Ordinal numParams () const
 Get the number of stored parameters.

Set Functions

ParameterListsetName (const std::string &name)
 Set the name of *this list.
ParameterListoperator= (const ParameterList &source)
ParameterListsetParameters (const ParameterList &source)
ParameterListsetParametersNotAlreadySet (const ParameterList &source)
ParameterListdisableRecursiveValidation ()
template<typename T >
ParameterListset (std::string const &name, T const &value, std::string const &docString="", RCP< const ParameterEntryValidator > const &validator=null)
 Sets different types of parameters. The type depends on the second entry.
ParameterListset (std::string const &name, char value[], std::string const &docString="", RCP< const ParameterEntryValidator > const &validator=null)
 Specialization for the case when a user sets the parameter with a character std::string in parenthesis.
ParameterListset (std::string const &name, const char value[], std::string const &docString="", RCP< const ParameterEntryValidator > const &validator=null)
 Specialization for the case when a user sets the parameter with a character std::string in parenthesis.
ParameterListset (std::string const &name, ParameterList const &value, std::string const &docString="")
 Template specialization for the case when a user sets the parameter with a ParameterList.
ParameterListsetEntry (const std::string &name, const ParameterEntry &entry)
 Set a parameter directly as a ParameterEntry.

Get Functions

template<typename T >
T & get (const std::string &name, T def_value)
 Retrieves parameter name of type T from list, if it exists, else the def_value is used to enter a new parameter into the list.
std::string & get (const std::string &name, char def_value[])
 Specialization of get, where the nominal value is a character std::string in parenthesis. Both char* and std::string are stored as strings and return std::string values.
std::string & get (const std::string &name, const char def_value[])
 Specialization of get, where the nominal value is a character std::string in parenthesis. Both char* and std::string are stored as strings and return std::string values.
template<typename T >
T & get (const std::string &name)
 Retrieves parameter name of type T from a list, an Exceptions::InvalidParameter std::exception is thrown if this parameter doesn't exist (Exceptions::InvalidParameterName) or is the wrong type (Exceptions::InvalidParameterType).
template<typename T >
const T & get (const std::string &name) const
 Retrieves parameter name of type T from a constant list, an Exceptions::InvalidParameter std::exception is thrown if this parameter doesn't exist (Exceptions::InvalidParameterName) or is the wrong type (Exceptions::InvalidParameterType).
template<typename T >
T * getPtr (const std::string &name)
 Retrieves the pointer for parameter name of type T from a list. A null pointer is returned if this parameter doesn't exist or is the wrong type.
template<typename T >
const T * getPtr (const std::string &name) const
 Retrieves the pointer for parameter name of type T from a constant list. A null pointer is returned if this parameter doesn't exist or is the wrong type.
ParameterEntrygetEntry (const std::string &name)
 Retrieves an entry with the name name.
const ParameterEntrygetEntry (const std::string &name) const
 Retrieves a const entry with the name name.
ParameterEntrygetEntryPtr (const std::string &name)
 Retrieves the pointer for an entry with the name name if it exists.
const ParameterEntrygetEntryPtr (const std::string &name) const
 Retrieves the pointer for a constant entry with the name name if it exists.
RCP< ParameterEntrygetEntryRCP (const std::string &name)
 Retrieves the RCP for an entry with the name name if it exists.
RCP< const ParameterEntrygetEntryRCP (const std::string &name) const
 Retrieves the RCP for a constant entry with the name name if it exists.

Parameter removal functions

bool remove (std::string const &name, bool throwIfNotExists=true)
 Remove a parameter (does not depend on the type of the parameter).

Sublist Functions

ParameterListsublist (const std::string &name, bool mustAlreadyExist=false, const std::string &docString="")
 Creates an empty sublist and returns a reference to the sublist name. If the list already exists, returns reference to that sublist. If the name exists but is not a sublist, an std::exception is thrown.
const ParameterListsublist (const std::string &name) const
 Return a const reference to an existing sublist name. If the list does not already exist or the name exists but is not a sublist, an std::exception is thrown.

Attribute Functions

const std::string & name () const
 Query the name of this parameter list.
bool isParameter (const std::string &name) const
 Query the existence of a parameter.
bool isSublist (const std::string &name) const
 Query the existence of a parameter and whether it is a parameter list.
template<typename T >
bool isType (const std::string &name) const
 Query the existence and type of a parameter.

I/O Functions

void print () const
 Print function to use in debugging in a debugger.
std::ostream & print (std::ostream &os, const PrintOptions &printOptions) const
 Printing method for parameter lists which takes an print options object.
std::ostream & print (std::ostream &os, int indent=0, bool showTypes=false, bool showFlags=true) const
 Printing method for parameter lists. Indenting is used to indicate parameter list hierarchies.
void unused (std::ostream &os) const
 Print out unused parameters in the ParameterList.
std::string currentParametersString () const
 Create a single formated std::string of all of the zero-level parameters in this list.

Read-only access to the iterator

ConstIterator begin () const
 An iterator pointing to the first entry.
ConstIterator end () const
 An iterator pointing beyond the last entry.
const std::string & name (ConstIterator i) const
 Access to name (i.e., returns i->first)
const ParameterEntryentry (ConstIterator i) const
 Access to ParameterEntry (i.e., returns i->second)

Validation Functions

void validateParameters (ParameterList const &validParamList, int const depth=1000, EValidateUsed const validateUsed=VALIDATE_USED_ENABLED, EValidateDefaults const validateDefaults=VALIDATE_DEFAULTS_ENABLED) const
 Validate the parameters in this list given valid selections in the input list.
void validateParametersAndSetDefaults (ParameterList const &validParamList, int const depth=1000)
 Validate the parameters in this list given valid selections in the input list and set defaults for those not set.

Detailed Description

Templated parameter list.

Parameters can be added and retreived with the templated "get" and "set" functions. These parameters can any data type which uses value sementics (e.g. double, float, int, *double, *float, *int, ...) which includes other parameter lists, allowing for a hierarchy of parameter lists. These parameters can also be pointers to vectors or functions.

Note:
  • Use static_cast<T>() when the type is ambiguous.
  • Both char* and std::string std::map to are stored as strings internally.

Definition at line 102 of file Teuchos_ParameterList.hpp.


Member Typedef Documentation

Internal data-structure.

Definition at line 105 of file Teuchos_ParameterList.hpp.

Parameter container iterator typedef.

Definition at line 108 of file Teuchos_ParameterList.hpp.

Parameter container const iterator typedef.

Definition at line 116 of file Teuchos_ParameterList.hpp.


Constructor & Destructor Documentation

Teuchos::ParameterList::ParameterList ( )

Constructor.

Definition at line 80 of file Teuchos_ParameterList.cpp.

Teuchos::ParameterList::ParameterList ( const std::string &  name)

Constructor.

Definition at line 85 of file Teuchos_ParameterList.cpp.

Teuchos::ParameterList::ParameterList ( const ParameterList source)

Copy Constructor.

Definition at line 90 of file Teuchos_ParameterList.cpp.

Teuchos::ParameterList::~ParameterList ( ) [virtual]

Deconstructor.

Definition at line 98 of file Teuchos_ParameterList.cpp.


Member Function Documentation

Ordinal Teuchos::ParameterList::numParams ( ) const

Get the number of stored parameters.

Definition at line 102 of file Teuchos_ParameterList.cpp.

ParameterList & Teuchos::ParameterList::setName ( const std::string &  name) [inline]

Set the name of *this list.

Definition at line 729 of file Teuchos_ParameterList.hpp.

ParameterList & Teuchos::ParameterList::operator= ( const ParameterList source)

Replace the current parameter list with source.

Note:
This also replaces the name returned by this->name()

Definition at line 108 of file Teuchos_ParameterList.cpp.

ParameterList & Teuchos::ParameterList::setParameters ( const ParameterList source)

Set the parameters in source.

Note, this function will set the parameters and sublists from source into *this but will not result in parameters being removed from *this. Parameters in *this with the same names as those in source will be overwritten.

Definition at line 119 of file Teuchos_ParameterList.cpp.

ParameterList & Teuchos::ParameterList::setParametersNotAlreadySet ( const ParameterList source)

Set the parameters in source that are not already set in *this.

Note, this function will set the parameters and sublists from source into *this but will not result in parameters being removed from *this or in parameters already set in *this being overrided. Parameters in *this with the same names as those in source will not be overwritten.

Definition at line 137 of file Teuchos_ParameterList.cpp.

ParameterList & Teuchos::ParameterList::disableRecursiveValidation ( )

Disallow recusive validation when this sublist is used in a valid parameter list.

This function should be called when setting a sublist in a valid parameter list which is broken off to be passed to another object. The other object should validate its own list.

Definition at line 162 of file Teuchos_ParameterList.cpp.

template<typename T >
ParameterList & Teuchos::ParameterList::set ( std::string const &  name,
T const &  value,
std::string const &  docString = "",
RCP< const ParameterEntryValidator > const &  validator = null 
) [inline]

Sets different types of parameters. The type depends on the second entry.

Note:
  • Use static_cast<T>() when the type is ambiguous.
  • Both char* and std::string std::map to are stored as strings internally.
  • Sets the parameter as "unused".

Definition at line 741 of file Teuchos_ParameterList.hpp.

ParameterList & Teuchos::ParameterList::set ( std::string const &  name,
char  value[],
std::string const &  docString = "",
RCP< const ParameterEntryValidator > const &  validator = null 
) [inline]

Specialization for the case when a user sets the parameter with a character std::string in parenthesis.

Definition at line 774 of file Teuchos_ParameterList.hpp.

ParameterList& Teuchos::ParameterList::set ( std::string const &  name,
const char  value[],
std::string const &  docString = "",
RCP< const ParameterEntryValidator > const &  validator = null 
)

Specialization for the case when a user sets the parameter with a character std::string in parenthesis.

ParameterList & Teuchos::ParameterList::set ( std::string const &  name,
ParameterList const &  value,
std::string const &  docString = "" 
) [inline]

Template specialization for the case when a user sets the parameter with a ParameterList.

Definition at line 790 of file Teuchos_ParameterList.hpp.

ParameterList & Teuchos::ParameterList::setEntry ( const std::string &  name,
const ParameterEntry entry 
) [inline]

Set a parameter directly as a ParameterEntry.

Note:
This is required to preserve the isDefault value when reading back from XML. KL 7 August 2004

Definition at line 800 of file Teuchos_ParameterList.hpp.

template<typename T >
T & Teuchos::ParameterList::get ( const std::string &  name,
def_value 
)

Retrieves parameter name of type T from list, if it exists, else the def_value is used to enter a new parameter into the list.

Note:
  • Use the static_cast<T>() when the type is ambiguous.
  • Both char* and std::string std::map to are stored as strings internally.
  • Sets the parameter as "used".
  • Exception is thrown if name exists, but is not of type T.

Definition at line 811 of file Teuchos_ParameterList.hpp.

std::string & Teuchos::ParameterList::get ( const std::string &  name,
char  def_value[] 
) [inline]

Specialization of get, where the nominal value is a character std::string in parenthesis. Both char* and std::string are stored as strings and return std::string values.

Definition at line 826 of file Teuchos_ParameterList.hpp.

std::string& Teuchos::ParameterList::get ( const std::string &  name,
const char  def_value[] 
)

Specialization of get, where the nominal value is a character std::string in parenthesis. Both char* and std::string are stored as strings and return std::string values.

template<typename T >
T & Teuchos::ParameterList::get ( const std::string &  name)

Retrieves parameter name of type T from a list, an Exceptions::InvalidParameter std::exception is thrown if this parameter doesn't exist (Exceptions::InvalidParameterName) or is the wrong type (Exceptions::InvalidParameterType).

Note:
The syntax for calling this method is: list.template get<int>( "Iters" )

Definition at line 836 of file Teuchos_ParameterList.hpp.

template<typename T >
const T & Teuchos::ParameterList::get ( const std::string &  name) const

Retrieves parameter name of type T from a constant list, an Exceptions::InvalidParameter std::exception is thrown if this parameter doesn't exist (Exceptions::InvalidParameterName) or is the wrong type (Exceptions::InvalidParameterType).

Note:
The syntax for calling this method is: list.template get<int>( "Iters" )

Definition at line 846 of file Teuchos_ParameterList.hpp.

template<typename T >
T * Teuchos::ParameterList::getPtr ( const std::string &  name) [inline]

Retrieves the pointer for parameter name of type T from a list. A null pointer is returned if this parameter doesn't exist or is the wrong type.

Note:
The syntax for calling this method is: list.template getPtr<int>( "Iters" )

Definition at line 857 of file Teuchos_ParameterList.hpp.

template<typename T >
const T * Teuchos::ParameterList::getPtr ( const std::string &  name) const [inline]

Retrieves the pointer for parameter name of type T from a constant list. A null pointer is returned if this parameter doesn't exist or is the wrong type.

Note:
The syntax for calling this method is: list.template getPtr<int>( "Iters" )

Definition at line 878 of file Teuchos_ParameterList.hpp.

ParameterEntry & Teuchos::ParameterList::getEntry ( const std::string &  name) [inline]

Retrieves an entry with the name name.

Throws Exceptions::InvalidParameterName if this parameter does not exist.

Definition at line 895 of file Teuchos_ParameterList.hpp.

const ParameterEntry & Teuchos::ParameterList::getEntry ( const std::string &  name) const [inline]

Retrieves a const entry with the name name.

Throws Exceptions::InvalidParameterName if this parameter does not exist.

Definition at line 904 of file Teuchos_ParameterList.hpp.

ParameterEntry * Teuchos::ParameterList::getEntryPtr ( const std::string &  name) [inline]

Retrieves the pointer for an entry with the name name if it exists.

Definition at line 914 of file Teuchos_ParameterList.hpp.

const ParameterEntry * Teuchos::ParameterList::getEntryPtr ( const std::string &  name) const [inline]

Retrieves the pointer for a constant entry with the name name if it exists.

Definition at line 927 of file Teuchos_ParameterList.hpp.

RCP< ParameterEntry > Teuchos::ParameterList::getEntryRCP ( const std::string &  name) [inline]

Retrieves the RCP for an entry with the name name if it exists.

Definition at line 939 of file Teuchos_ParameterList.hpp.

RCP< const ParameterEntry > Teuchos::ParameterList::getEntryRCP ( const std::string &  name) const [inline]

Retrieves the RCP for a constant entry with the name name if it exists.

Definition at line 951 of file Teuchos_ParameterList.hpp.

bool Teuchos::ParameterList::remove ( std::string const &  name,
bool  throwIfNotExists = true 
)

Remove a parameter (does not depend on the type of the parameter).

Parameters:
name[in] The name of the parameter to remove
throwIfNotExists[in] If true then if the parameter with the name name does not exist then a std::exception will be thrown!
Returns:
Returns true if the parameter was removed, and false if the parameter was not removed (false return value possible only if throwIfExists==false).

Definition at line 220 of file Teuchos_ParameterList.cpp.

ParameterList & Teuchos::ParameterList::sublist ( const std::string &  name,
bool  mustAlreadyExist = false,
const std::string &  docString = "" 
)

Creates an empty sublist and returns a reference to the sublist name. If the list already exists, returns reference to that sublist. If the name exists but is not a sublist, an std::exception is thrown.

Definition at line 239 of file Teuchos_ParameterList.cpp.

const ParameterList & Teuchos::ParameterList::sublist ( const std::string &  name) const

Return a const reference to an existing sublist name. If the list does not already exist or the name exists but is not a sublist, an std::exception is thrown.

Definition at line 275 of file Teuchos_ParameterList.cpp.

const std::string & Teuchos::ParameterList::name ( ) const [inline]

Query the name of this parameter list.

Definition at line 966 of file Teuchos_ParameterList.hpp.

bool Teuchos::ParameterList::isParameter ( const std::string &  name) const

Query the existence of a parameter.

Returns:
"true" if a parameter with this name exists, else "false". Warning, this function should almost never be used! Instead, consider using getEntryPtr() instead.
Todo:
Depreicate this function and instead use index lookup.

Definition at line 209 of file Teuchos_ParameterList.cpp.

bool Teuchos::ParameterList::isSublist ( const std::string &  name) const

Query the existence of a parameter and whether it is a parameter list.

Returns:
"true" if a parameter with this name exists and is itself a parameter list, else "false". Warning, this function should almost never be used! Instead, consider using getEntryPtr() instead.

Definition at line 198 of file Teuchos_ParameterList.cpp.

template<typename T >
bool Teuchos::ParameterList::isType ( const std::string &  name) const

Query the existence and type of a parameter.

Returns:
"true" is a parameter with this name exists and is of type T, else "false".
Note:
The syntax for calling this method is: list.template isType<int>( "Iters" ) . Warning, this function should almost never be used! Instead, consider using getEntryPtr() instead.

Definition at line 987 of file Teuchos_ParameterList.hpp.

void Teuchos::ParameterList::print ( ) const

Print function to use in debugging in a debugger.

Prints to *VerboseObjectBase::getDefaultOStream() so it will print well in parallel.

Definition at line 291 of file Teuchos_ParameterList.cpp.

std::ostream & Teuchos::ParameterList::print ( std::ostream &  os,
const PrintOptions printOptions 
) const

Printing method for parameter lists which takes an print options object.

Definition at line 297 of file Teuchos_ParameterList.cpp.

std::ostream & Teuchos::ParameterList::print ( std::ostream &  os,
int  indent = 0,
bool  showTypes = false,
bool  showFlags = true 
) const

Printing method for parameter lists. Indenting is used to indicate parameter list hierarchies.

Definition at line 353 of file Teuchos_ParameterList.cpp.

void Teuchos::ParameterList::unused ( std::ostream &  os) const

Print out unused parameters in the ParameterList.

Definition at line 169 of file Teuchos_ParameterList.cpp.

std::string Teuchos::ParameterList::currentParametersString ( ) const

Create a single formated std::string of all of the zero-level parameters in this list.

Definition at line 180 of file Teuchos_ParameterList.cpp.

ParameterList::ConstIterator Teuchos::ParameterList::begin ( ) const [inline]

An iterator pointing to the first entry.

Definition at line 996 of file Teuchos_ParameterList.hpp.

ParameterList::ConstIterator Teuchos::ParameterList::end ( ) const [inline]

An iterator pointing beyond the last entry.

Definition at line 1002 of file Teuchos_ParameterList.hpp.

const std::string & Teuchos::ParameterList::name ( ConstIterator  i) const [inline]

Access to name (i.e., returns i->first)

Definition at line 1008 of file Teuchos_ParameterList.hpp.

const ParameterEntry & Teuchos::ParameterList::entry ( ConstIterator  i) const [inline]

Access to ParameterEntry (i.e., returns i->second)

Definition at line 1014 of file Teuchos_ParameterList.hpp.

void Teuchos::ParameterList::validateParameters ( ParameterList const &  validParamList,
int const  depth = 1000,
EValidateUsed const  validateUsed = VALIDATE_USED_ENABLED,
EValidateDefaults const  validateDefaults = VALIDATE_DEFAULTS_ENABLED 
) const

Validate the parameters in this list given valid selections in the input list.

Parameters:
validParamList[in] This is the list that the parameters and sublist in *this are compared against.
depth[in] Determines the number of levels of depth that the validation will recurse into. A value of dpeth=0 means that only the top level parameters and sublists will be checked. Default: depth = large number.
validateUsed[in] Determines if parameters that have been used are checked against those in validParamList. Default: validateDefaults = VALIDATE_DEFAULTS_ENABLED.
validateDefaults[in] Determines if parameters set at their default values using get(name,defaultVal) are checked against those in validParamList. Default: validateDefaults = VALIDATE_DEFAULTS_ENABLED.

If a parameter in *this is not found in validParamList then an std::exception of type Exceptions::InvalidParameterName will be thrown which will contain an excellent error message returned by excpt.what(). If the parameter exists but has the wrong type, then an std::exception type Exceptions::InvalidParameterType will be thrown. If the parameter exists and has the right type, but the value is not valid then an std::exception type Exceptions::InvalidParameterValue will be thrown.

Recursive validation stops when:

  • The maxinum depth is reached

  • A sublist note in validParamList has been marked with the disableRecursiveValidation() function, or

  • There are not more parameters or sublists left in *this

A breath-first search is performed to validate all of the parameters in one sublist before moving into nested subslist.

Definition at line 359 of file Teuchos_ParameterList.cpp.

void Teuchos::ParameterList::validateParametersAndSetDefaults ( ParameterList const &  validParamList,
int const  depth = 1000 
)

Validate the parameters in this list given valid selections in the input list and set defaults for those not set.

Parameters:
validParamList[in] This is the list that the parameters and sublist in *this are compared against.
depth[in] Determines the number of levels of depth that the validation will recurse into. A value of dpeth=0 means that only the top level parameters and sublists will be checked. Default: depth = large number.

If a parameter in *this is not found in validParamList then an std::exception of type Exceptions::InvalidParameterName will be thrown which will contain an excellent error message returned by excpt.what(). If the parameter exists but has the wrong type, then an std::exception type Exceptions::InvalidParameterType will be thrown. If the parameter exists and has the right type, but the value is not valid then an std::exception type Exceptions::InvalidParameterValue will be thrown. If a parameter in validParamList does not exist in *this, then it will be set at its default value as determined by validParamList.

Recursive validation stops when:

  • The maxinum depth is reached

  • A sublist note in validParamList has been marked with the disableRecursiveValidation() function, or

  • There are not more parameters or sublists left in *this

A breath-first search is performed to validate all of the parameters in one sublist before moving into nested subslist.

Definition at line 460 of file Teuchos_ParameterList.cpp.

ParameterList::Iterator Teuchos::ParameterList::nonconstBegin ( ) [inline, private]

An iterator pointing to the first entry.

Definition at line 1023 of file Teuchos_ParameterList.hpp.

ParameterList::Iterator Teuchos::ParameterList::nonconstEnd ( ) [inline, private]

An iterator pointing beyond the last entry.

Definition at line 1029 of file Teuchos_ParameterList.hpp.

ParameterEntry & Teuchos::ParameterList::nonconstEntry ( Iterator  i) [inline, private]

Access to ParameterEntry (i.e., returns i->second)

Definition at line 1035 of file Teuchos_ParameterList.hpp.

void Teuchos::ParameterList::validateEntryExists ( const std::string &  funcName,
const std::string &  name,
const ParameterEntry entry 
) const [private]

Validate that a parameter exists.

Definition at line 599 of file Teuchos_ParameterList.cpp.

template<typename T >
void Teuchos::ParameterList::validateEntryType ( const std::string &  funcName,
const std::string &  name,
const ParameterEntry entry 
) const [inline, private]

Validate that a type is the same.

Definition at line 1043 of file Teuchos_ParameterList.hpp.

void Teuchos::ParameterList::validateEntryIsList ( const std::string &  name,
const ParameterEntry entry 
) const [private]

Validate a sublist param is indeed a sublist.

Definition at line 614 of file Teuchos_ParameterList.cpp.

void Teuchos::ParameterList::validateMissingSublistMustExist ( const std::string &  baselist_name,
const std::string &  sublist_name,
const bool  mustAlreadyExist 
) const [private]

Throw a sublist does not exist exception.

Definition at line 625 of file Teuchos_ParameterList.cpp.

void Teuchos::ParameterList::updateSubListNames ( int  depth = 0) [private]

Update sublist names recursively.

Definition at line 582 of file Teuchos_ParameterList.cpp.


Friends And Related Function Documentation

enum EValidateUsed [related]

Validation used enum.

Enumerator:
VALIDATE_USED_ENABLED 
VALIDATE_USED_DISABLED 

Definition at line 68 of file Teuchos_ParameterList.hpp.

enum EValidateDefaults [related]

Validation defaults enum.

Enumerator:
VALIDATE_DEFAULTS_ENABLED 
VALIDATE_DEFAULTS_DISABLED 

Definition at line 80 of file Teuchos_ParameterList.hpp.

RCP< ParameterList > parameterList ( ) [related]

Nonmember constructor.

Definition at line 632 of file Teuchos_ParameterList.hpp.

RCP< ParameterList > parameterList ( const std::string &  name) [related]

Nonmember constructor.

Definition at line 643 of file Teuchos_ParameterList.hpp.

RCP< ParameterList > parameterList ( const ParameterList source) [related]

Nonmember constructor.

Definition at line 654 of file Teuchos_ParameterList.hpp.

RCP< ParameterList > createParameterList ( ) [related]

Nonmember constructor.

Definition at line 665 of file Teuchos_ParameterList.hpp.

RCP< ParameterList > createParameterList ( const std::string &  name) [related]

Nonmember constructor.

Definition at line 676 of file Teuchos_ParameterList.hpp.

TEUCHOS_LIB_DLL_EXPORT bool operator== ( const ParameterList list1,
const ParameterList list2 
) [related]

Returns true if two parameter lists are the same.

bool operator!= ( const ParameterList list1,
const ParameterList list2 
) [related]

Returns true if two parameter lists are not the same.

Definition at line 707 of file Teuchos_ParameterList.hpp.

TEUCHOS_LIB_DLL_EXPORT bool haveSameValues ( const ParameterList list1,
const ParameterList list2 
) [related]

Returns true if two parameter lists have the same values.

Two parameter lists may have the same values but may not be identical. For example, two parameters can have the same values but not have the same documentation strings or the same validators.

template<typename T >
T & getParameter ( ParameterList l,
const std::string &  name 
) [related]

A templated helper function for getting a parameter from a non-const list. This helper function prevents the need for giving a nominal value of the specific template type.

Note:
The syntax for calling this function is: getParameter<int>( list, "Iters" )

Definition at line 1069 of file Teuchos_ParameterList.hpp.

template<typename T >
T & get ( ParameterList l,
const std::string &  name 
) [related]

A shorter name for getParameter().

Note:
The syntax for calling this function is: get<int>( list, "Iters" )

Definition at line 1082 of file Teuchos_ParameterList.hpp.

template<typename T >
const T & getParameter ( const ParameterList l,
const std::string &  name 
) [related]

A templated helper function for getting a parameter from a const list. This helper function prevents the need for giving a nominal value of the specific template type.

Note:
The syntax for calling this function is: getParameter<int>( list, "Iters" )

Definition at line 1095 of file Teuchos_ParameterList.hpp.

template<typename T >
T * getParameterPtr ( ParameterList l,
const std::string &  name 
) [related]

A templated helper function for getting a pointer to a parameter from a non-const list, if it exists. This helper function prevents the need for giving a nominal value of the specific template type.

Note:
The syntax for calling this function is: getParameterPtr<int>(list,"Iters")

Definition at line 1110 of file Teuchos_ParameterList.hpp.

template<typename T >
const T * getParameterPtr ( const ParameterList l,
const std::string &  name 
) [related]

A templated helper function for getting a pointer to a parameter from a non-const list, if it exists. This helper function prevents the need for giving a nominal value of the specific template type.

Note:
The syntax for calling this function is: getParameterPtr<int>(list,"Iters")

Definition at line 1125 of file Teuchos_ParameterList.hpp.

template<typename T >
bool isParameterType ( ParameterList l,
const std::string &  name 
) [related]

A templated helper function for determining the type of a parameter entry for a non-const list. This helper function avoids the need for giving a nominal value of the specific template type.

Note:
The syntax for calling this function is: isParameterType<int>( list, "Iters" )

Definition at line 1139 of file Teuchos_ParameterList.hpp.

template<typename T >
bool isParameterType ( const ParameterList l,
const std::string &  name 
) [related]

A templated helper function for determining the type of a parameter entry for a const list. This helper function avoids the need for giving a nominal value of the specific template type.

Note:
The syntax for calling this function is: isParameterType<int>( list, "Iters" )

Definition at line 1153 of file Teuchos_ParameterList.hpp.

template<typename T >
void setStringParameterFromArray ( const std::string &  paramName,
const Array< T > &  array,
ParameterList paramList 
) [related]

Set a std::string parameter representation of an array.

Parameters:
paramName[in] The name of the parameter containing the std::string representation of the array.
array[in] The array that will be set as a std::string parameter.
paramList[in/out] The parameter list that the array will be set on.

Definition at line 1171 of file Teuchos_ParameterList.hpp.

template<typename T >
Array< T > getArrayFromStringParameter ( const ParameterList paramList,
const std::string &  paramName,
const int  arrayDim = -1,
const bool  mustExist = true 
) [related]

Get an Array object (with entries of type T) from a parameter holding a std::string representation of the array.

Parameters:
paramList[in] The parameter list to extract the parameter array from.
paramName[in] The name of the parameter containing the std::string representation of the array.
arrayDim[in] If arrayDim >= 0, then the read in array must be equal to this dimension, or an std::exception will be thrown. If arrayDim < 0, then an array of any dimension will be returned. The default is -1 and therefore no array length validation will be performed.
mustExist[in] If mustExist==true, then the parameter paramName must exist and must contain a valid array, or an std::exception is thrown. If mustExist==false, and if the parameter paramName does not exist or contains an empty array std::string value, then an empty array object will be returned.
Returns:
an array object if an std::exception is not thrown. If mustExist==false and the parameter does not exist, then an empty array object will be returned. If mustExist==true and arrayDim < 0, then if the parameter paramName exists and its array value is valid, then the converted array, of any size, will be returned. If mustExist==true and arrayDim >= 0 then an array of dimension arrayDim will be returned if an std::exception is not thrown.

Exceptions:

Detailed Description:

This function allows Array<T> objects to be read in from a parameter with a std::string representation of the array. The templated function Teuchos::fromStringToArray() (see documentation for Teuchos::Array) is used to parse the std::string representation and return the array object (see this function's documentation for details on what the formatting of the array std::string must be and what can be handled and what can not be handled.

Definition at line 1247 of file Teuchos_ParameterList.hpp.

RCP< ParameterList > sublist ( const RCP< ParameterList > &  paramList,
const std::string &  name,
bool  mustAlreadyExist = false,
const std::string &  docString = "" 
) [related]

Return a RCP to a sublist in another RCP-ed parameter list.

Definition at line 1301 of file Teuchos_ParameterList.hpp.

RCP< const ParameterList > sublist ( const RCP< const ParameterList > &  paramList,
const std::string &  name 
) [related]

Return a RCP to a sublist in another RCP-ed parameter list.

Definition at line 1315 of file Teuchos_ParameterList.hpp.

std::ostream & operator<< ( std::ostream &  os,
const ParameterList l 
) [related]

Output stream operator for handling the printing of the parameter list.

Definition at line 1327 of file Teuchos_ParameterList.hpp.

template<class IntegralType >
void setStringToIntegralParameter ( std::string const &  paramName,
std::string const &  defaultValue,
std::string const &  docString,
ArrayView< const std::string > const &  strings,
ParameterList paramList 
) [related]

Set up a std::string parameter that will use an embedded validator to allow the extraction of an integral value.

The function getIntegralValue() can then be used to extract the integral value of the std::string parameter. In this case, the integral value return will just be the zero-based index of the std::string value in the list strings.

template<class IntegralType >
void setStringToIntegralParameter ( std::string const &  paramName,
std::string const &  defaultValue,
std::string const &  docString,
ArrayView< const std::string > const &  strings,
ArrayView< const IntegralType > const &  integralValues,
ParameterList paramList 
) [related]

Set up a std::string parameter that will use an embedded validator to allow the extraction of an integral value from a list of integral values.

The function getIntegralValue() can then be used to extract the integral value of the std::string parameter. In this case, the integral value return will just be the zero-based index of the std::string value in the list strings.

template<class IntegralType >
void setStringToIntegralParameter ( std::string const &  paramName,
std::string const &  defaultValue,
std::string const &  docString,
ArrayView< const std::string > const &  strings,
ArrayView< const std::string > const &  stringsDocs,
ArrayView< const IntegralType > const &  integralValues,
ParameterList paramList 
) [related]

Set up a std::string parameter with documentation strings for each valid value that will use an embedded validator to allow the extraction of an integral value from a list of integral values.

The function getIntegralValue() can then be used to extract the integral value of the std::string parameter. In this case, the integral value return will just be the zero-based index of the std::string value in the list strings.

template<class IntegralType >
IntegralType getIntegralValue ( ParameterList const &  paramList,
std::string const &  paramName 
) [related]

Get an integral value for a parameter that is assumed to already be set.

This function does a dynamic cast to get the underlying valiator of type StringToIntegralParameterEntryValidator<IntegralType>. If this dynamic cast failes then an Exceptions::InvalidParameterType std::exception is thrown with an excellent error message.

template<class IntegralType >
std::string getStringValue ( ParameterList const &  paramList,
std::string const &  paramName 
) [related]

Get a std::string value for a parameter that is assumed to already be set.

This function does a dynamic cast to get the underlying valiator of type StringToIntegralParameterEntryValidator<IntegralValue>. The default type for IntegralValue is int. If this dynamic cast failes then an Exceptions::InvalidParameterType std::exception is thrown with an excellent error message.

TEUCHOS_LIB_DLL_EXPORT void setIntParameter ( std::string const &  paramName,
int const  value,
std::string const &  docString,
ParameterList paramList,
AnyNumberParameterEntryValidator::AcceptedTypes const &  acceptedTypes = AnyNumberParameterEntryValidator::AcceptedTypes() 
) [related]

Set an integer parameter that allows for (nearly) any input parameter type that is convertible to an int.

TEUCHOS_LIB_DLL_EXPORT void setDoubleParameter ( std::string const &  paramName,
double const &  value,
std::string const &  docString,
ParameterList paramList,
AnyNumberParameterEntryValidator::AcceptedTypes const &  acceptedTypes = AnyNumberParameterEntryValidator::AcceptedTypes() 
) [related]

Set an double parameter that allows for (nearly) any input parameter type that is convertible to a double.

TEUCHOS_LIB_DLL_EXPORT void setNumericStringParameter ( std::string const &  paramName,
std::string const &  value,
std::string const &  docString,
ParameterList paramList,
AnyNumberParameterEntryValidator::AcceptedTypes const &  acceptedTypes = AnyNumberParameterEntryValidator::AcceptedTypes() 
) [related]

Set an numeric parameter preferred as a std::string that allows for (nearly) any input parameter type that is convertible to a std::string.

TEUCHOS_LIB_DLL_EXPORT int getIntParameter ( ParameterList const &  paramList,
std::string const &  paramName 
) [related]

Get an integer parameter.

If the underlying parameter type is already an integer, then all is good. However, if it is not, then a AnyNumberParameterEntryValidator object is looked for to extract the type correctly. If no validator is attached to the entry, then a new AnyNumberParameterEntryValidator object will be created that that will allow the conversion from any supported type.

The parameter must exist or an Exceptions::InvalidParameterName object will be thrown. The parameters type must be acceptable, or an Exceptions::InvalidParameterType object will be thown.

TEUCHOS_LIB_DLL_EXPORT double getDoubleParameter ( ParameterList const &  paramList,
std::string const &  paramName 
) [related]

Get double integer parameter.

If the underlying parameter type is already a double, then all is good. However, if it is not, then a AnyNumberParameterEntryValidator object is looked for to extract the type correctly. If no validator is attached to the entry, then a new AnyNumberParameterEntryValidator object will be created that that will allow the conversion from any supported type.

The parameter must exist or an Exceptions::InvalidParameterName object will be thrown. The parameters type must be acceptable, or an Exceptions::InvalidParameterType object will be thown.

TEUCHOS_LIB_DLL_EXPORT std::string getNumericStringParameter ( ParameterList const &  paramList,
std::string const &  paramName 
) [related]

Get std::string numeric parameter.

If the underlying parameter type is already a std::string, then all is good. However, if it is not, then a AnyNumberParameterEntryValidator object is looked for to extract the type correctly. If no validator is attached to the entry, then a new AnyNumberParameterEntryValidator object will be created that that will allow the conversion from any supported type.

The parameter must exist or an Exceptions::InvalidParameterName object will be thrown. The parameters type must be acceptable, or an Exceptions::InvalidParameterType object will be thown.

TEUCHOS_LIB_DLL_EXPORT void updateParametersFromXmlFile ( const std::string &  xmlFileName,
const Ptr< ParameterList > &  paramList 
) [related]

Reads XML parameters from a file and updates those already in the given parameter list.

Parameters:
xmlFileName[in] The file name containing XML parameter list specification.
paramList[in/out] On input, *paramList may be empty or contain some parameters and sublists. On output, parameters and sublist from the file xmlFileName will be set or overide those in *paramList.
TEUCHOS_LIB_DLL_EXPORT void updateParametersFromXmlFileAndBroadcast ( const std::string &  xmlFileName,
const Ptr< ParameterList > &  paramList,
const Comm< int > &  comm 
) [related]

On processor rank = 0, reads XML parameters from a file and broadcasts them to all other processors. Then updates the given parameter list with these values.

Parameters:
xmlFileName[in] The file name containing XML parameter list specification.
paramList[in/out] On input, *paramList may be empty or contain some parameters and sublists. On output, parameters and sublist from the file xmlFileName will be set or overide those in *paramList.
comm[in] A Comm object used to broadcast the xml.
TEUCHOS_LIB_DLL_EXPORT RCP< ParameterList > getParametersFromXmlFile ( const std::string &  xmlFileName) [related]

Reads XML parameters from a file and return them in a new parameter list.

Parameters:
xmlFileName[in] The file name containing XML parameter list specification.
TEUCHOS_LIB_DLL_EXPORT RCP< ParameterList > getParametersFromXmlFile ( const std::string &  xmlFileName,
RCP< DependencySheet depSheet 
) [related]

Reads XML parameters from a file and return them in a new parameter list.

Parameters:
xmlFileName[in] The file name containing XML parameter list specification.
depSheet[out] The Dependency Sheet into which Dependencies should be placed.
TEUCHOS_LIB_DLL_EXPORT void updateParametersFromXmlString ( const std::string &  xmlStr,
const Ptr< ParameterList > &  paramList 
) [related]

Reads XML parameters from a std::string and updates those already in the given parameter list.

Parameters:
xmlStr[in] String containing XML parameter list specification.
paramList[in/out] On input, *paramList may be empty or contain some parameters and sublists. On output, parameters and sublist from the file xmlStr will be set or overide those in *paramList.
TEUCHOS_LIB_DLL_EXPORT RCP< ParameterList > getParametersFromXmlString ( const std::string &  xmlStr) [related]

Reads XML parameters from a std::string and return them in a new parameter list.

Parameters:
xmlStr[in] String containing XML parameter list specification.
TEUCHOS_LIB_DLL_EXPORT RCP< ParameterList > getParametersFromXmlString ( const std::string &  xmlStr,
RCP< DependencySheet depSheet 
) [related]

Reads XML parameters from a std::string and return them in a new parameter list.

Parameters:
xmlStr[in] String containing XML parameter list specification.
depSheet[in] The Dependency Sheet into which Dependencies should be placed.
TEUCHOS_LIB_DLL_EXPORT void writeParameterListToXmlOStream ( const ParameterList paramList,
std::ostream &  xmlOut,
RCP< const DependencySheet depSheet = null 
) [related]

Write parameters and sublists in XML format to an std::ostream.

Parameters:
paramList[in] Contains the parameters and sublists that will be written to file.
xmlOut[in] The stream that will get the XML output.
depSheet[in] The Dependency Sheet which should be written out.
TEUCHOS_LIB_DLL_EXPORT void writeParameterListToXmlFile ( const ParameterList paramList,
const std::string &  xmlFileName,
RCP< const DependencySheet depSheet = null 
) [related]

Write parameters and sublist to an XML file.

Parameters:
paramList[in] Contains the parameters and sublists that will be written to file.
xmlFileName[in] The file name that will be create to contain the XML version of the parameter list specification.
depSheet[in] The Dependency Sheet which should be written out.

Member Data Documentation

std::string Teuchos::ParameterList::name_ [private]

Name of the (sub)list.

Definition at line 608 of file Teuchos_ParameterList.hpp.

Parameter list.

Definition at line 616 of file Teuchos_ParameterList.hpp.

Validate into list or not.

Definition at line 622 of file Teuchos_ParameterList.hpp.


The documentation for this class was generated from the following files:
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines