inet::xmlutils Namespace Reference

Functions
const cXMLElement *	getUniqueChild (const cXMLElement *node, const char *name)
const cXMLElement *	getUniqueChildIfExists (const cXMLElement *node, const char *name)
bool	parseBool (const char *text)
void	checkTags (const cXMLElement *node, const char *allowed)
const char *	getParameterStrValue (const cXMLElement *ptr, const char *name, const char *def)
bool	getParameterBoolValue (const cXMLElement *ptr, const char *name, bool def)
bool	getParameterBoolValue (const cXMLElement *ptr, const char *name)
const char *	getParameterStrValue (const cXMLElement *ptr, const char *name)
int	getParameterIntValue (const cXMLElement *ptr, const char *name, int def)
int	getParameterIntValue (const cXMLElement *ptr, const char *name)
IPv4Address	getParameterIPAddressValue (const cXMLElement *ptr, const char *name, IPv4Address def)
IPv4Address	getParameterIPAddressValue (const cXMLElement *ptr, const char *name)
double	getParameterDoubleValue (const cXMLElement *ptr, const char *name, double def)
double	getParameterDoubleValue (const cXMLElement *ptr, const char *name)
const char *	getRequiredAttribute (const cXMLElement &node, const char *attr)
bool	getAttributeBoolValue (const cXMLElement *node, const char *attrName, bool defVal)
bool	getAttributeBoolValue (const cXMLElement *node, const char *attrName)

Function Documentation

INET_API void inet::xmlutils::checkTags	(	const cXMLElement *	node,
		const char *	allowed
	)

Referenced by inet::RSVP::delSession(), inet::SimpleClassifier::readItemFromXML(), inet::LIBTable::readTableFromXML(), inet::SimpleClassifier::readTableFromXML(), inet::RSVP::readTrafficFromXML(), inet::RSVP::readTrafficRouteFromXML(), and inet::RSVP::readTrafficSessionFromXML().

{
    std::vector<const char *> tags;

    cStringTokenizer st(allowed, " ");
    const char *nt;
    while ((nt = st.nextToken()) != nullptr)
        tags.push_back(nt);

    for (cXMLElement *child = node->getFirstChild(); child; child = child->getNextSibling()) {
        unsigned int i;
        for (i = 0; i < tags.size(); i++)
            if (!strcmp(child->getTagName(), tags[i]))
                break;

        if (i == tags.size())
            throw cRuntimeError("Subtag <%s> not expected in <%s>",
                    child->getTagName(), node->getTagName());
    }
}

INET_API bool inet::xmlutils::getAttributeBoolValue	(	const cXMLElement *	node,
		const char *	attrName,
		bool	defVal
	)

Referenced by inet::IPv4NetworkConfigurator::readInterfaceConfiguration().

{
    const char *attrStr = node->getAttribute(attrName);
    if (attrStr && *attrStr)
        return parseBool(attrStr);
    return defVal;
}

INET_API bool inet::xmlutils::getAttributeBoolValue	(	const cXMLElement *	node,
		const char *	attrName
	)

{
    const char *attrStr = getRequiredAttribute(*node, attrName);
    return parseBool(attrStr);
}

INET_API bool inet::xmlutils::getParameterBoolValue	(	const cXMLElement *	ptr,
		const char *	name,
		bool	def
	)

Referenced by inet::RSVP::readTrafficSessionFromXML().

{
    const cXMLElement *xvalue = getUniqueChildIfExists(ptr, name);
    if (xvalue)
        return parseBool(xvalue->getNodeValue());
    else
        return def;
}

INET_API bool inet::xmlutils::getParameterBoolValue	(	const cXMLElement *	ptr,
		const char *	name
	)

{
    const cXMLElement *xvalue = getUniqueChild(ptr, name);
    return parseBool(xvalue->getNodeValue());
}

INET_API double inet::xmlutils::getParameterDoubleValue	(	const cXMLElement *	ptr,
		const char *	name,
		double	def
	)

Referenced by inet::RSVP::readTrafficSessionFromXML().

{
    const cXMLElement *xvalue = getUniqueChildIfExists(ptr, name);
    if (xvalue)
        return strtod(xvalue->getNodeValue(), nullptr);
    else
        return def;
}

INET_API double inet::xmlutils::getParameterDoubleValue	(	const cXMLElement *	ptr,
		const char *	name
	)

{
    const cXMLElement *xvalue = getUniqueChild(ptr, name);
    return strtod(xvalue->getNodeValue(), nullptr);
}

INET_API int inet::xmlutils::getParameterIntValue	(	const cXMLElement *	ptr,
		const char *	name,
		int	def
	)

Referenced by inet::RSVP::delSession(), inet::SimpleClassifier::readItemFromXML(), inet::LIBTable::readTableFromXML(), and inet::RSVP::readTrafficSessionFromXML().

{
    const cXMLElement *xvalue = getUniqueChildIfExists(ptr, name);
    if (xvalue)
        return atoi(xvalue->getNodeValue());
    else
        return def;
}

INET_API int inet::xmlutils::getParameterIntValue	(	const cXMLElement *	ptr,
		const char *	name
	)

{
    const cXMLElement *xvalue = getUniqueChild(ptr, name);
    return atoi(xvalue->getNodeValue());
}

INET_API IPv4Address inet::xmlutils::getParameterIPAddressValue	(	const cXMLElement *	ptr,
		const char *	name,
		IPv4Address	def
	)

Referenced by inet::RSVP::delSession(), inet::SimpleClassifier::readItemFromXML(), and inet::RSVP::readTrafficSessionFromXML().

{
    const cXMLElement *xvalue = getUniqueChildIfExists(ptr, name);
    if (xvalue)
        return L3AddressResolver().resolve(xvalue->getNodeValue()).toIPv4();
    else
        return def;
}

INET_API IPv4Address inet::xmlutils::getParameterIPAddressValue	(	const cXMLElement *	ptr,
		const char *	name
	)

{
    const cXMLElement *xvalue = getUniqueChild(ptr, name);
    return L3AddressResolver().resolve(xvalue->getNodeValue()).toIPv4();
}

INET_API const char * inet::xmlutils::getParameterStrValue	(	const cXMLElement *	ptr,
		const char *	name,
		const char *	def
	)

Referenced by inet::LIBTable::readTableFromXML(), and inet::RSVP::readTrafficSessionFromXML().

{
    const cXMLElement *xvalue = getUniqueChildIfExists(ptr, name);
    if (xvalue)
        return xvalue->getNodeValue();
    else
        return def;
}

INET_API const char * inet::xmlutils::getParameterStrValue	(	const cXMLElement *	ptr,
		const char *	name
	)

{
    const cXMLElement *xvalue = getUniqueChild(ptr, name);
    return xvalue->getNodeValue();
}

INET_API const char * inet::xmlutils::getRequiredAttribute	(	const cXMLElement &	node,
		const char *	attr
	)

Referenced by getAttributeBoolValue(), inet::ospf::OSPFConfigReader::getInterfaceByXMLAttributesOf(), inet::ospf::OSPFConfigReader::loadAreaFromXML(), inet::ospf::OSPFConfigReader::loadConfigFromXML(), inet::ospf::OSPFConfigReader::loadExternalRoute(), inet::ospf::OSPFConfigReader::loadHostRoute(), inet::ospf::OSPFConfigReader::loadInterfaceParameters(), and inet::ospf::OSPFConfigReader::loadVirtualLink().

{
    const char *s = node.getAttribute(attr);
    if (!(s && *s))
        throw cRuntimeError("required attribute %s of <%s> missing at %s",
                attr, node.getTagName(), node.getSourceLocation());
    return s;
}

INET_API const cXMLElement * inet::xmlutils::getUniqueChild	(	const cXMLElement *	node,
		const char *	name
	)

Referenced by getParameterBoolValue(), getParameterDoubleValue(), getParameterIntValue(), getParameterIPAddressValue(), getParameterStrValue(), inet::MatrixCloudDelayer::initialize(), inet::LIBTable::readTableFromXML(), and inet::RSVP::readTrafficSessionFromXML().

{
    const cXMLElement *child = getUniqueChildIfExists(node, name);
    if (!child)
        throw cRuntimeError("XML error: exactly one %s element expected", name);

    return child;
}

INET_API const cXMLElement * inet::xmlutils::getUniqueChildIfExists	(	const cXMLElement *	node,
		const char *	name
	)

Referenced by inet::RSVP::delSession(), getParameterBoolValue(), getParameterDoubleValue(), getParameterIntValue(), getParameterIPAddressValue(), getParameterStrValue(), getUniqueChild(), inet::SimpleClassifier::readItemFromXML(), and inet::RSVP::readTrafficSessionFromXML().

{
    cXMLElementList list = node->getChildrenByTagName(name);
    if (list.size() > 1)
        throw cRuntimeError("XML error: at most one %s element expected", name);
    else if (list.size() == 1)
        return *list.begin();
    else
        return nullptr;
}

INET_API bool inet::xmlutils::parseBool

(

const char *

text

)

Referenced by getAttributeBoolValue(), and getParameterBoolValue().

{
    if (!strcasecmp(text, "down"))
        return false;
    else if (!strcasecmp(text, "off"))
        return false;
    else if (!strcasecmp(text, "false"))
        return false;
    else if (!strcasecmp(text, "no"))
        return false;
    else if (!strcasecmp(text, "0"))
        return false;
    else if (!strcasecmp(text, "up"))
        return true;
    else if (!strcasecmp(text, "on"))
        return true;
    else if (!strcasecmp(text, "true"))
        return true;
    else if (!strcasecmp(text, "yes"))
        return true;
    else if (!strcasecmp(text, "1"))
        return true;
    else
        throw cRuntimeError("Unknown bool constant: %s", text);
}