Описание класса QDomNamedNodeMapКласс QDomNamedNodeMap содержит коллекцию узлов, которые могут быть доступны по имени. Далее... #include <QDomNamedNodeMap> Замечание: Все функции в этом классе реентерабельны. Открытые функции
Подробное описаниеКласс QDomNamedNodeMap содержит коллекцию узлов, которые могут быть доступны по имени. Помните о том, что QDomNamedNodeMap не унаследован от QDomNodeList. QDomNamedNodeMaps не обеспечивает специальную сортировку узлов. Хотя узлы в QDomNamedNodeMap могут быть получены по порядковому индексу, это реализовано просто для того, чтобы удобно было перебирать содержимое QDomNamedNodeMap, и это не означает, что DOM определяет порядок узлов. QDomNamedNodeMap используется в трёх местах:
Элементы в словаре определяются по имени, которое возвращает QDomNode::name(). Узлы можно получить с помощью namedItem(), namedItemNS() или item(). Новые узлы можно вставить посредством setNamedItem() или setNamedItemNS() и удалить с помощью removeNamedItem() или removeNamedItemNS(). Используйте contains() для того, чтобы узнать, содержит ли словарь элемент с заданным именем. Число элементов можно узнать с помощью length(). Терминология: в контексте данного класса мы используем "элемент" и "узел" как равнозначные понятия. Описание функций-членовQDomNamedNodeMap::QDomNamedNodeMap ()Создает пустой словарь именованных узлов. QDomNamedNodeMap::QDomNamedNodeMap ( const QDomNamedNodeMap & n )Создаёт копию n. QDomNamedNodeMap::~QDomNamedNodeMap ()Уничтожает объекты и освобождает их ресурсы. bool QDomNamedNodeMap::contains ( const QString & name ) constВозвращает true, если словарь содержит узел с именем name; в противном случае возвращает false. Замечание: функция не учитывает пространств имен. Используйте namedItemNS() для проверки, содержит ли словарь узел с определенными URI пространства имен и именем. int QDomNamedNodeMap::count () constЭта функция создана из соображений согласованности Qt API. Она является эквивалентом length(). bool QDomNamedNodeMap::isEmpty () constВозвращает true, если словарь пуст; в противном случае возвращает false. Эта функция создана из соображений согласованности Qt API. QDomNode QDomNamedNodeMap::item ( int index ) constНаходит узел на позиции index. Это может быть использовано для итеративного обхода словаря. Помните, что узлы в словаре не упорядочены. Смотрите также length(). uint QDomNamedNodeMap::length () constВозвращает количество узлов в словаре. Смотрите также item(). QDomNode QDomNamedNodeMap::namedItem ( const QString & name ) constВозвращает узел с именем name. Если словарь именованных узлов не содержит заданный узел, возвращается нулевой узел. Имя узла возвращается с помощью QDomNode::nodeName(). Смотрите также setNamedItem() и namedItemNS(). QDomNode QDomNamedNodeMap::namedItemNS ( const QString & nsURI, const QString & localName ) constВозвращает узел, связанный с локальным именем localName и URI пространства имен nsURI. Если словарь не содержит такого узла, возвращается нулевой узел. Смотрите также setNamedItemNS() и namedItem(). QDomNode QDomNamedNodeMap::removeNamedItem ( const QString & name )Удаляет узел с именем name из словаря. Функция возвращает удаленный узел или же нулевой узел, если словарь не содержит элемента с именем name. Смотрите также setNamedItem(), namedItem() и removeNamedItemNS(). QDomNode QDomNamedNodeMap::removeNamedItemNS ( const QString & nsURI, const QString & localName )Удаляет узел с локальным именем localName и URI пространства имен nsURI из словаря. Функция возвращает удаленный узел или же нулевой узел, если словарь не содержит элемента с локальным именем localName и URI пространства имен nsURI. Смотрите также setNamedItemNS(), namedItemNS() и removeNamedItem(). QDomNode QDomNamedNodeMap::setNamedItem ( const QDomNode & newNode )Вставляет узел newNode в словарь именованных узлов. Имя, использованное для помещения в словарь узла newNode, можно получить с помощью QDomNode::nodeName(). Если новый узел замещает существующий, т.е словарь уже содержит узел с тем же именем, возвращается замеченный элемент. Смотрите также namedItem(), removeNamedItem() и setNamedItemNS(). QDomNode QDomNamedNodeMap::setNamedItemNS ( const QDomNode & newNode )Вставляет узел newNode в словарь. Если узел с таким же URI пространства имен и локальным именем уже существует в словаре, он замещается на newNode. Если это происходит, возвращается замещенный узел. Смотрите также namedItemNS(), removeNamedItemNS() и setNamedItem(). int QDomNamedNodeMap::size () constЭта функция создана из соображений согласованности Qt API. Она является эквивалентом length(). bool QDomNamedNodeMap::operator!= ( const QDomNamedNodeMap & n ) constВозвращает true, если n и текущий словарь не эквивалентны; в противном случае возвращает false. QDomNamedNodeMap & QDomNamedNodeMap::operator= ( const QDomNamedNodeMap & n )Ассоциирует n с текущим словарём узлов. bool QDomNamedNodeMap::operator== ( const QDomNamedNodeMap & n ) constВозвращает true, если n и текущий словарь эквивалентны; в противном случае возвращает false. |
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |