Teuchos - Trilinos Tools Package Version of the Day
Loading...
Searching...
No Matches
Teuchos_ParameterEntryXMLConverter.cpp
1// @HEADER
2// *****************************************************************************
3// Teuchos: Common Tools Package
4//
5// Copyright 2004 NTESS and the Teuchos contributors.
6// SPDX-License-Identifier: BSD-3-Clause
7// *****************************************************************************
8// @HEADER
9
10#include "Teuchos_ParameterEntryXMLConverter.hpp"
14#include "Teuchos_ParameterEntryXMLConverterDB.hpp"
15
16namespace Teuchos{
17
18
19ParameterEntry
21 const XMLObject &xmlObj) const
22{
23 #ifdef HAVE_TEUCHOS_DEBUG
27 "Error: this Parameter Entry XML tag has a type different than "
28 "the XMLConverter being used to convert it." <<std::endl <<
29 "Parameter name: " << xmlObj.getRequired(
31 "XML Parameter Entry type: " <<
32 xmlObj.getRequired(getTypeAttributeName()) << std::endl <<
33 "XMLConverter type: " << getTypeAttributeValue() <<
34 std::endl <<std::endl);
35 #endif
36
38 !xmlObj.hasAttribute(getValueAttributeName()),
40 ParameterEntry::getTagName() <<" tags must "
41 "have a " << getValueAttributeName() << " attribute" << std::endl <<
42 "Bad Parameter: " <<
44 std::endl << std::endl);
45
47 bool isDefault = false;
48 bool isUsed = false;
49 std::string docString = "";
50
51
52 if(xmlObj.hasAttribute(getDefaultAttributeName())){
53 isDefault = xmlObj.getRequiredBool(getDefaultAttributeName());
54 }
55
56 if(xmlObj.hasAttribute(getUsedAttributeName())){
57 isUsed = xmlObj.getRequiredBool(getUsedAttributeName());
58 }
59
60 if(xmlObj.hasAttribute(getDocStringAttributeName())){
61 docString = xmlObj.getRequired(getDocStringAttributeName());
62 }
63
64 toReturn.setAnyValue(getAny(xmlObj), isDefault);
65 toReturn.setDocString(docString);
66
67 if(isUsed){
68 toReturn.getAny();
69 }
70
71 return toReturn;
72}
73
74
78 const std::string &name,
81{
82 #ifdef HAVE_TEUCHOS_DEBUG
84 (entry->getAny().typeName() != getTypeAttributeValue())
85 &&
86 (
89 ),
91 "Error: This converter can't convert the given ParameterEntry to XML "
92 "because their types don't match." << std::endl <<
93 "Parameter name: " << name << std::endl <<
94 "Parameter type: " << entry->getAny().typeName() << std::endl <<
95 "Converter type: " << getTypeAttributeValue() << std::endl << std::endl);
96 #endif
97
99 toReturn.addAttribute(
102 toReturn.addAttribute(getDocStringAttributeName(), entry->docString());
103 toReturn.addAttribute(getIdAttributeName(), id);
104 toReturn.addAttribute(
106 toReturn.addBool(getDefaultAttributeName(), entry->isDefault());
107 toReturn.addBool(getUsedAttributeName(), entry->isUsed());
108 if(nonnull(entry->validator())){
110 validatorIDsMap.find(entry->validator()) == validatorIDsMap.end(),
112 "Could not find validator in given ValidatorIDsMap! " <<
113 std::endl << std::endl);
114 toReturn.addAttribute(
116 validatorIDsMap.find(entry->validator())->second);
117 }
118 return toReturn;
119}
120
121
122} // namespace Teuchos
123
Converts back and forth between XML and ParameterEntryValidators.
A collection of Exceptions that can be potentially thrown when converting a ParameterList to and from...
Writes a ParameterList to an XML object.
Thrown when a converter is being used to convert either and XML tag or ParameterEntry with an innappr...
Thrown when a referenced validator can't be found.
Thrown when a parameter entry tag is missing it's value attribute.
static RCP< const ParameterEntryXMLConverter > getDefaultConverter()
Gets the default converter to be used on Parameter Entries.
virtual const std::string getTypeAttributeValue() const =0
Gets a string representing the value that should be assigned to the "type" attribute when converting ...
ParameterEntry fromXMLtoParameterEntry(const XMLObject &xmlObj) const
Converts the given xml into a parameter entry.
XMLObject fromParameterEntrytoXML(RCP< const ParameterEntry > entry, const std::string &name, const ParameterEntry::ParameterEntryID &id, const ValidatortoIDMap &validatorIDsMap) const
Converts the given parameter entry to xml.
virtual const std::string getValueAttributeValue(RCP< const ParameterEntry > entry) const =0
Gets the value to be assigned to the "value" attribute when converting the paramter entry to xml.
This object is held as the "value" in the Teuchos::ParameterList std::map.
static const std::string & getTagName()
Get the string that should be used as the tag name for all parameters when they are serialized to xml...
Smart reference counting pointer class for automatic garbage collection.
static const std::string & getIdAttributeName()
A class for mapping validators to integers.
Representation of an XML data tree. XMLObject is a ref-counted handle to a XMLObjectImplem object,...
static const std::string & getNameAttributeName()
#define TEUCHOS_TEST_FOR_EXCEPTION(throw_exception_test, Exception, msg)
Macro for throwing an exception with breakpointing to ease debugging.
bool nonnull(const std::shared_ptr< T > &p)
Returns true if p.get()!=NULL.
The Teuchos namespace contains all of the classes, structs and enums used by Teuchos,...