Importing XML

Functions for Importing XML

Import

Importing files.

A simple MathML equation. In[7]:= Out[7]=

Importing this file returns the equation as a box expression. In[15]:= Out[15]=

With "XMLObject" specified as the Import element, the equation is imported as a symbolic XML expression. In[57]:= Out[57]=

Import a file with the .mml extension. In[13]:= Out[13]=

Display the box expression as conventional mathematical notation using DisplayForm. In[14]:= Out[14]//DisplayForm=

ImportString

Importing strings.

A simple XML expression converted to symbolic XML using ImportString. In[17]:= Out[17]=

Importing a simple MathML expression. The MathML markup is automatically converted to a Mathematica box expression. In[18]:= Out[18]=

Stop the automatic interpretation of imported files by specifying "XMLElement" as the Import element. In[21]:= Out[21]=

XMLGet

Retrieve stock quotes from a website and return the data as symbolic XML. In[24]:= Out[24]=

XMLGet[file, option1->value1, option2->value2, ...]

Import[file, "XML", option1->value1, option2->value2, ...]

XMLGetString

In[10]:=

Out[10]=

Load the XML package and then pre-initialize the parser, XHTMLParser, according to the XHTML DTD located at the specified URI. In[11]:= Out[11]=

Import an XML string. The string is validated with respect to the DTD stored in XHTMLParser by setting "ValidateAgainstDTD"->True. Valid->True in the output indicates that the input string was valid XML with respect to the XHTML DTD. In[12]:= Out[12]=

XMLGetString[string, option1->value1, option2->value2, ...]

ImportString[string, "XML", option1->value1, option2->value2, ...]

Entities and Validation

When importing an XML document into Mathematica, all numeric Unicode character entity references are automatically resolved into the corresponding Mathematica character. In[13]:= Out[13]=

Entities that are not built into XML are resolved according to the rules present in the DTD. In[14]:= Out[14]=

Import Options

Introduction

Import[file, option->value]

• "NormalizeWhitespace"

• "AllowRemoteDTDAccess"

• "AllowUnrecognizedEntities"

• "ReadDTD"

• "ValidateAgainstDTD"

• "IncludeDefaultedAttributes"

• "IncludeEmbeddedObjects"

• "IncludeNamespaces"

• "PreserveCDATASections"

"NormalizeWhitespace"

Values for "NormalizeWhitespace".

Whitespace handling with the default setting "NormalizeWhitespace"->True. In[15]:= Out[15]=

"NormalizeWhitespace"->False preserves the whitespace as it appears in the original string. In[16]:= Out[16]=

"AllowRemoteDTDAccess"

Values for "AllowRemoteDTDAccess".

"AllowUnrecognizedEntities"

Values for "AllowUnrecognizedEntities".

This contains an undefined entity called 'dogs'. If "AllowUnrecognizedEntities" is False, then an error message is reported and the parse fails. In[17]:= Out[17]=

With the default setting, Automatic, an error message is reported, and the entity is wrapped in special entity delimiter characters. This does not interrupt the importing and parsing of the XML data. In[18]:= Out[18]=

With "AllowUnrecognizedEntities"->True any undefined entities are wrapped in special entity delimiter characters and no error messages are reported. In[19]:= Out[19]=

"ReadDTD"

Values for "ReadDTD".

"ValidateAgainstDTD"

Values for "ValidateAgainstDTD".

Parse a document that is not valid by setting "ValidateAgainstDTD" to True. The parser generates error messages. In[20]:= Out[20]//InputForm=

If the document is valid, then no messages are generated and "Valid"->True is included in the output. In[21]:= Out[21]//InputForm=

Parsing with "ValidateAgainstDTD" set to False generates no error messages, nor does it add a "Valid" option to XMLObject["Document"]. In[22]:= Out[22]//InputForm= In[23]:= Out[23]//InputForm=

With "ValidateAgainstDTD" set to True, validation is attempted even if there is no DOCTYPE declaration. In[24]:= Out[24]=

For validation only when there is a DOCTYPE declaration, use "ValidateAgainstDTD"->Automatic. When no DTD is specified, the parser does not attempt to validate the XML string. In[25]:= Out[25]=

Here the parser tries to validate the input string because a DTD is specified explicitly. In[26]:= Out[26]//InputForm=

"IncludeDefaultedAttributes"

Values for "IncludeDefaultedAttributes".

Assign a variable to represent the XML fragment. In[27]:=

Convert the XML fragment into symbolic XML. In[28]:= Out[28]=

To include default attributes in the imported symbolic XML, set "IncludeDefaultedAttributes" to True. In[29]:= Out[29]=

Including default attributes in the expression is not the same as validation; thus, they can be included even with "ValidateAgainstDTD"->False. In[30]:= Out[30]=

"IncludeEmbeddedObjects"

Values for "IncludeEmbeddedObjects".

Set a variable to represent a simple XML fragment to facilitate further examples. In[31]:=

"IncludeEmbeddedObjects"->All includes all the embedded objects in the document tree. In[32]:= Out[32]=

The default setting of "IncludeEmbeddedObjects" is None since comments and processing instructions are not intended to affect applications using the XML document. Including them may hamper pattern matching. In[33]:= Out[33]=

Using the "ProcessingInstructions" or "Comments" settings will include only the embedded processing instructions or comments, respectively. Setting "IncludeEmbeddedObjects" to {"Comments", "ProcessingInstructions"} includes a list of the embedded comments and processing instructions. In[34]:= Out[34]= In[35]:= Out[35]= In[36]:= Out[36]=

"IncludeNamespaces"

Values for "IncludeNamespaces".

<root xmlns="http://mynamespace.com"
     xmlns:same="http://mynamespace.com"
     xmlns:foo="http://anothernamespace.com">
     <child attr1="a"  same:attr2="b"  foo:attr3="c"/>
     <foo:child/>
     <same:child/>
</root>

In[37]:=

True

In[38]:=

Out[38]=

False

In[39]:=

Out[39]=

Automatic

In[40]:=

Out[40]=

Unparsed

In[41]:=

Out[41]=

"PreserveCDATASections"

Values for "PreserveCDATASections".

Here is an example of the default behavior of "PreserveCDATASections". In[42]:= Out[42]=

To preserve CDATA sections, specify "PreserveCDATASections"->True. In[43]:= Out[43]=

RELATED TUTORIALS

• XML Capabilities

• Representing XML in Mathematica

• Exporting XML

• Transforming XML

• Working with MathML