Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
2025.0.0 - Français


xmlValidate

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

Syntax

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 something 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

VersionDescription
5.4.0 XML module introduced.
Report an issue
<< xmlSetValues Traitement XML xmlWrite >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Thu Oct 24 11:15:59 CEST 2024