Класс QDomImplementation

Класс QDomImplementation предоставляет информацию о возможностях реализации DOM. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются реентерабельными за исключением следующих:

• invalidDataPolicy()
• setInvalidDataPolicy(InvalidDataPolicy policy)

Типы публичного доступа

Функции публичного доступа

Статические члены публичного доступа

Подробное описание

Класс QDomImplementation предоставляет информацию о возможностях реализации DOM.

Этот класс описывает возможности, поддерживаемые реализацией DOM. В настоящее время поддерживаются XML-подмножество DOM Level 1 и DOM Level 2 Core.

Обычно для получения объекта реализации используется функция QDomDocument::implementation().

Вы можете создать новый тип документа с помощью createDocumentType() и новый документ с помощью createDocument().

Дополнительную информацию об объектной модели документов см. в Level 1 и Level 2 Core. Более общее введение в реализацию DOM см. в документации к QDomDocument.

Классы QDom имеют несколько проблем несоответствия спецификациям XML, которые нельзя исправить в Qt 4 без нарушения обратной совместимости. Модуль Qt XML Patterns и классы QXmlStreamReader и QXmlStreamWriter имеют более высокую степень соответствия.

См. также hasFeature().

Документация по типам членов

Перечисление QDomImplementation::InvalidDataPolicy

Это перечисление определяет, что должно быть сделано, когда функция-фабрика в QDomDocument вызывается с недействительными данными.

См. также setInvalidDataPolicy() и invalidDataPolicy().

Документация по функциям-членам

QDomImplementation::QDomImplementation()

Конструктор объекта QDomImplementation.

QDomImplementation::QDomImplementation(const QDomImplementation &x)

Конструирует копию x.

QDomImplementation::~QDomImplementation()

Уничтожает объект и освобождает его ресурсы.

QDomDocument QDomImplementation::createDocument(const QString &nsURI, const QString &qName, const QDomDocumentType &doctype)

Создает документ DOM с типом документа doctype. Эта функция также добавляет корневой узел элемента с квалифицированным именем qName и URI пространства имен nsURI.

QDomDocumentType QDomImplementation::createDocumentType(const QString &qName, const QString &publicId, const QString &systemId)

Создает узел типа документа для имени qName.

publicId указывает общественный идентификатор внешнего подмножества. Если вы указываете пустую строку (QString()) в качестве publicId, это означает, что у типа документа нет общественного идентификатора.

systemId указывает системный идентификатор внешнего подмножества. Если вы указываете пустую строку как systemId, это означает, что у типа документа нет системного идентификатора.

Поскольку у вас не может быть общественный идентификатор без системного идентификатора, общественный идентификатор устанавливается в пустую строку, если нет системного идентификатора.

DOM Level 2 не поддерживает другие возможности объявления типа документа.

Единственный способ использовать тип документа, созданный таким образом, — в сочетании с функцией createDocument() для создания QDomDocument с этим типом документа.

В спецификации DOM это единственный способ создать не нулевой документ. По историческим причинам Qt также позволяет создать документ с помощью конструктора по умолчанию без параметров. Результирующий документ равен null, но становится не равным null при вызове функции-фабрики, например QDomDocument::createElement(). Документ также становится не равным null при вызове setContent().

См. также createDocument().

bool QDomImplementation::hasFeature(const QString &feature, const QString &version) const

Функция возвращает true если QDom реализует запрошенную version функции feature; в противном случае возвращает false.

В настоящее время поддерживаемые функции и их версии:

[static] InvalidDataPolicy QDomImplementation::invalidDataPolicy()

Возвращает политику обработки недействительных данных, которая определяет, что должно быть сделано, когда функция-фабрика в QDomDocument получает недействительные данные.

Предупреждение: Эта функция не является реентерабельной.

Эта функция была добавлена в Qt 4.1.

См. также setInvalidDataPolicy() и InvalidDataPolicy.

bool QDomImplementation::isNull()

Возвращает false если объект был создан функцией QDomDocument::implementation(); в противном случае возвращает true.

[static] void QDomImplementation::setInvalidDataPolicy(InvalidDataPolicy policy)

Устанавливает политику обработки недопустимых данных, которая определяет, что делать, когда фабричной функции в QDomDocument передаются недопустимые данные.

Политика policy устанавливается для всех существующих и будущих экземпляров QDomDocument.

QDomDocument doc;
QDomImplementation impl;

// This will create the element, but the resulting XML document will
// be invalid, because '~' is not a valid character in a tag name.
impl.setInvalidDataPolicy(QDomImplementation::AcceptInvalidData);
QDomElement elt1 = doc.createElement("foo~bar");

// This will create an element with the tag name "foobar".
impl.setInvalidDataPolicy(QDomImplementation::DropInvalidData);
QDomElement elt2 = doc.createElement("foo~bar");

// This will create a null element.
impl.setInvalidDataPolicy(QDomImplementation::ReturnNullNode);
QDomElement elt3 = doc.createElement("foo~bar");

Предупреждение: Эта функция не является реентерабельной.

Функция была добавлена в Qt 4.1.

См. также invalidDataPolicy() и InvalidDataPolicy.

bool QDomImplementation::operator!=(const QDomImplementation &x) const

Возвращает true, если x и этот объект реализации DOM были созданы из разных QDomDocument; в противном случае возвращает false.

QDomImplementation &QDomImplementation::operator=(const QDomImplementation &x)

Присваивает x этому объекту реализации DOM.

bool QDomImplementation::operator==(const QDomImplementation &x) const

Возвращает true, если x и этот объект реализации DOM были созданы из одного и того же QDomDocument; в противном случае возвращает false.