exponenta event banner

matlab.io.xml.dom.Document класс

Пакет: matlab.io.xml.dom

Описание

Объект matlab.io.xml.dom.Document представляет XML-документ. Для создания XML-документа создается Document объект. Если используется matlab.io.xml.dom.Parser объект для чтения XML-файла, синтаксический анализатор создает Document объект.

matlab.io.xml.dom.Document класс является handle класс.

Атрибуты класса

ConstructOnLoad
true
HandleCompatible
true

Сведения об атрибутах класса см. в разделе Атрибуты класса.

Создание

Описание

doc = matlab.io.xml.dom.Document() создает пустой документ.

пример

doc = matlab.io.xml.dom.Document(docElemName) создает документ с корневым элементом, имеющим указанное имя.

Корневой элемент является matlab.io.xml.dom.Element объект с TagName свойство имеет значение docElemName.

doc = matlab.io.xml.dom.Document(docElemName,docTypeName,publicId,systemId) также указывает тип документа.

Вид документа: matlab.io.xml.dom.DocumentType объект с Name свойство имеет значение docTypeName, PublicID свойство имеет значение publicID, и SystemID свойство имеет значение systemID.

doc = matlab.io.xml.dom.Document(docElemNSURI,docElemQName) создает документ с корневым элементом, имеющим указанное пространство имен Uniform Resource Identifier (URI) и полное имя.

doc = matlab.io.xml.dom.Document(docElemNSURI,docElemQName,docTypeName,publicId,systemId) создает документ с указанным корневым элементом и типом документа, в котором корневой элемент находится в указанном пространстве имен.

Входные аргументы

развернуть все

Имя корневого элемента, указанное как вектор символа или скаляр строки.

Имя определения типа документа (DTD), заданного как вектор символа или скаляр строки.

Открытый идентификатор типа документа, заданный как вектор символов или скаляр строки.

Системный идентификатор типа документа, указанный как вектор символов или скаляр строки.

Универсальный идентификатор ресурса пространства имен (URI) для имени корневого элемента, указанного как вектор символов или скаляр строки.

Определенное имя корневого элемента, указанное как вектор символа или скаляр строки.

Свойства

развернуть все

Дочерний узел этого документа, указанный как matlab.io.xml.dom.Element объект.

Атрибуты:

GetAccess
public
SetAccess
immutable
NonCopyable
true
Transient
true

Кодировка исходного XML-файла, из которого был проанализирован этот документ, заданная как вектор символов.

Пример: 'utf-8'

Атрибуты:

GetAccess
public
SetAccess
immutable
Transient
true
NonCopyable
true

Кодировка символов, определенная XML-объявлением в исходном XML-файле, из которого был проанализирован этот документ, указана как вектор символов.

Пример: 'utf-8'

Атрибуты:

GetAccess
public
SetAccess
immutable
Transient
true
NonCopyable
true

Является ли этот документ автономным, указано как true или false. Если это значение равно trueсинтаксический анализатор игнорирует объявления разметки DTD в XML. Если этот документ создан из источника XML, который объявляет, что XML является автономным, синтаксический анализатор устанавливает для этого свойства значение true.

Атрибуты:

GetAccess
public
SetAccess
public
NonCopyable
true

XML-версия этого документа, заданная как символьный вектор. Если документ создан из источника XML, объявляющего версию XML, синтаксический анализатор устанавливает для этого свойства указанную версию.

Пример: '1.0'

Атрибуты:

GetAccess
public
SetAccess
public
NonCopyable
true

Универсальный идентификатор ресурса (URI) исходного файла документа, указанный как символьный вектор. Если документ создан из файла, синтаксический анализатор устанавливает для этого свойства URI, определяющий расположение файла.

Атрибуты:

GetAccess
public
SetAccess
public
NonCopyable
true

Конфигурация документа, указанная как matlab.io.xml.dom.DocumentConfiguration , указывающий параметры нормализации этого документа.

Атрибуты:

GetAccess
public
SetAccess
immutable
NonCopyable
true
Transient
true

Методы

развернуть все

Примеры

свернуть все

Использование синтаксического анализатора XML для создания Document объект из файла days.xml.

import matlab.io.xml.dom.*

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

Создание документа с корневым элементом с именем weekdays. Добавление содержимого в корневой элемент.

import matlab.io.xml.dom.*
doc = Document("weekdays");
docRootNode = getDocumentElement(doc);

weekdays = ["Mon" "Tue" "Wed" "Thu" "Fri"];
for i=1:5
    dayElement = createElement(doc,"day");
    appendChild(dayElement,createTextNode(doc,weekdays(i)));
    appendChild(docRootNode,dayElement);
end

xmlFileName = "weekdays.xml";
writer = matlab.io.xml.dom.DOMWriter;
writeToFile(writer,doc,xmlFileName);
Представлен в R2021a