Класс QDomAttr

Класс QDomAttr представляет одно атрибут элемента QDomElement. Подробнее...

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

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

Публичные функции

• 65 публичных функций, унаследованных от QDomNode

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

Класс QDomAttr представляет один атрибут элемента QDomElement.

Например, следующий фрагмент XML создаёт элемент без дочерних элементов, но с двумя атрибутами:

<link href="http://qt-project.org" color="red" />

Вы можете получить доступ к атрибутам элемента с помощью такого кода:

QDomElement e = //...
//...
QDomAttr a = e.attributeNode("href");
cout << a.value() << endl;                // prints "http://qt-project.org"
a.setValue("http://qt-project.org/doc"); // change the node's attribute
QDomAttr a2 = e.attributeNode("href");
cout << a2.value() << endl;               // prints "http://qt-project.org/doc"

Этот пример также демонстрирует, что изменение атрибута, полученного из элемента, изменяет атрибут самого элемента. Если вы не хотите изменять значение атрибута элемента, необходимо использовать cloneNode() для получения независимой копии атрибута.

QDomAttr может возвращать name() и value() атрибута. Значение атрибута устанавливается с помощью setValue(). Если specified() возвращает true, значение было установлено с помощью setValue(). Узел, к которому прикреплён этот атрибут (если таковой имеется), возвращается методом ownerElement().

Дополнительную информацию о Document Object Model см. на http://www.w3.org/TR/REC-DOM-Level-1/ и http://www.w3.org/TR/DOM-Level-2-Core/. Более общее введение в реализацию DOM см. в документации QDomDocument.

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

QDomAttr::QDomAttr()

Создаёт пустой атрибут.

QDomAttr::QDomAttr(const QDomAttr &x)

Создаёт копию x.

Данные копии разделяются (поверхностная копия): изменение одного узла также изменит другой. Если вам нужна глубокая копия, используйте cloneNode().

QString QDomAttr::name() const

Возвращает имя атрибута.

QDomNode::NodeType QDomAttr::nodeType() const

Возвращает AttributeNode.

QDomElement QDomAttr::ownerElement() const

Возвращает узел элемента, к которому прикреплён этот атрибут, или нулевой узел, если этот атрибут не прикреплён ни к одному элементу.

void QDomAttr::setValue(const QString &v)

Устанавливает значение атрибута на v.

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

bool QDomAttr::specified() const

Возвращает true если атрибут был установлен пользователем с помощью setValue(). Возвращает false если значение не было указано или установлено.

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

QString QDomAttr::value() const

Возвращает значение атрибута или пустую строку, если атрибут не указан.

См. также specified() и setValue().

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

Присваивает x этому DOM-атрибуту.

Данные копии разделяются (поверхностная копия): изменение одного узла также изменит другой. Если вам нужна глубокая копия, используйте cloneNode().