xmlValidate

Validate a document in using a DTD, a Relax NG or a Schema.

Calling Sequence

error = xmlValidate(docs [, valid])

Arguments

:docs a mlist typed XMLDoc or a matrix of string containing path to
XML documents

: :valid a mlist typed XMLValid. : :error a matrix of string if an error occurred or [] :

Description

Validate an already parsed document or a set of documents with given paths with a DTD, a Relax NG or a Schema. If the document is valid, then the returned error is an empty matrix, else a matrix of strings is returned with the error message.

Validate a document with its path can improve performance and reduce the memory consumption.

It is not possible for the moment to validate a document against an external DTD. The only way to do this is to include in your XML file someting like <!DOCTYPE foo SYSTEM “foo.dtd”> and to use xmlValidate without second argument.

Examples

doc = `xmlRead`_("SCI/modules/xml/tests/unit_tests/library.xml");
dtd = `xmlDTD`_("SCI/modules/xml/tests/unit_tests/library.dtd");
schema = `xmlSchema`_("SCI/modules/xml/tests/unit_tests/library.xsd");
rng = `xmlRelaxNG`_("SCI/modules/xml/tests/unit_tests/library.rng");

// We test if the document is valid
// If no error the file is valid

// DTD
xmlValidate(doc, dtd);

// Relax NG
xmlValidate(doc, rng);

// Schema
xmlValidate(doc, schema);

// All is ok... now we add a new element to the document
doc.root.children(3) = "<a>error</a>"

// Now the validations go to fail
xmlValidate(doc, dtd);
xmlValidate(doc, rng);
xmlValidate(doc, schema);

// You can validate a document with its path
xmlValidate("SCI/modules/xml/tests/unit_tests/library.xml")
xmlValidate("SCI/modules/xml/tests/unit_tests/invalid_library.xml")

xmlValidate("SCI/modules/xml/tests/unit_tests/library.xml", schema)
xmlValidate("SCI/modules/xml/tests/unit_tests/invalid_library.xml", rng)

// We delete the all the open documents
xmlDelete(doc, dtd, schema, rng);

See Also

History

Version Description 5.4.0 XML module introduced. .. _xmlDTD: xmlDTD.html .. _xmlRelaxNG: xmlRelaxNG.html .. _xmlSchema: xmlSchema.html

Table Of Contents

This Page