matlab.io.xml.dom.Parser Class

Namespace: matlab.io.xml.dom

XML markup parser

Since R2021a

Description

Use an object of the matlab.io.xml.dom.Parser class to convert XML markup to a matlab.io.xml.dom.Document object. A Parser object has two methods for converting XML If the XML is in a file, use the parseFile method to convert the XML markup. If the XML is in character vector or string scalar, use the parseString method.

The XML markup to be parsed must contain only one top-level element, which can be preceded or followed by a comment or processing instruction. If the markup contains more than one top-level element, the parser throws an error after processing the first element. The parser reports comment or processing instruction expected as the reason for the error.

The matlab.io.xml.dom.Parser class is a handle class.

Class Attributes

HandleCompatible

true

For information on class attributes, see Class Attributes.

Creation

Description

parser = matlab.io.xml.dom.Parser() creates an XML markup parser. Use the Configuration property to specify parser options.

Properties

Configuration — Parser options

matlab.io.xml.dom.ParserConfiguration object

Parser options, specified as a matlab.io.xml.dom.ParserConfiguration object.

Attributes:

GetAccess	public
SetAccess	immutable
Transient	true
NonCopyable	true

Methods

Public Methods

parseFile

doc = parseFile(thisParser,filePath) uses thisParser to parse the XML markup in the file specified by filePath and returns the result as a matlab.io.xml.dom.Document object. Specify filePath as a character vector or string. If the file is stored at a remote location, then filePath must contain the full path of the file specified with the form: scheme_name://path_to_file/my_file.ext Based on the remote location, scheme_name can be one of the values in this table. Remote Location scheme_name Amazon S3™ s3 Azure® Blob Storage wasb, wasbs HDFS™ hdfs For more information, see Work with Remote Data. Example: 's3://bucketname/path_to_file/data.xml'

parseString

doc = parseString(thisParser,xmlStr) uses thisParser to parse the XML markup specified by xmlStr and returns the result as a matlab.io.xml.dom.Document object. Specify xmlStr as a character vector or string scalar.

Examples

Parse an XML File

Create a parser and call the parseFile method to convert the XML in a file to a matlab.io.xml.dom.Document object.

import matlab.io.xml.dom.*

doc = parseFile(Parser,"days.xml");

Parse an XML String

Create a parser and call the parseString method to convert an XML string to a matlab.io.xml.dom.Document object.

import matlab.io.xml.dom.*
s1 = "<days><day>Mon</day><day>Tue</day><day>Wed</day>";
s2 = "<day>Thu</day><day>Fri</day></days>";
xmlString = s1+s2;
doc = parseString(Parser,xmlString);

Limitations

• A Parser object cannot parse a file if the input XML file contains an <xi> tag.

Version History

Introduced in R2021a

R2022a: Document type definition (DTD) not supported by default

By default, the parser does not support parsing a document that specifies a document type definition (DTD). If the document to be parsed specifies a DTD, the parser throws an error and exits. This minimizes the potential of malicious code infecting the local system by posing as a DTD. If you need to use a DTD, you can enable the parser to process DTDs with the AllowDoctype property of the parser configuration. However, enable this option only for DTDs that reference trusted sources.