QDomNamedNodeMap Class
QDomNamedNodeMap 클래스는 이름으로 접근할 수 있는 노드 모음을 포함합니다. 더 보기...
| 헤더: | #include <QDomNamedNodeMap> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Xml) target_link_libraries(mytarget PRIVATE Qt6::Xml) |
| qmake: | QT += xml |
- 상속된 멤버를 포함한 모든 멤버 목록
- QDomNamedNodeMap은 XML 클래스의 일부입니다.
참고: 이 클래스의 모든 함수는 재진입 가능합니다.
공개 함수
| QDomNamedNodeMap() | |
| QDomNamedNodeMap(const QDomNamedNodeMap &namedNodeMap) | |
| ~QDomNamedNodeMap() | |
| bool | contains(const QString &name) const |
| int | count() const |
| bool | isEmpty() const |
| QDomNode | item(int index) const |
| int | length() const |
| QDomNode | namedItem(const QString &name) const |
| QDomNode | namedItemNS(const QString &nsURI, const QString &localName) const |
| QDomNode | removeNamedItem(const QString &name) |
| QDomNode | removeNamedItemNS(const QString &nsURI, const QString &localName) |
| QDomNode | setNamedItem(const QDomNode &newNode) |
| QDomNode | setNamedItemNS(const QDomNode &newNode) |
| int | size() const |
| bool | operator!=(const QDomNamedNodeMap &other) const |
| QDomNamedNodeMap & | operator=(const QDomNamedNodeMap &other) |
| bool | operator==(const QDomNamedNodeMap &other) const |
상세 설명
QDomNamedNodeMap은 QDomNodeList 를 상속받지 않는다는 점에 유의하십시오. QDomNamedNodeMap은 특정 노드 순서를 제공하지 않습니다. QDomNamedNodeMap의 노드는 서수 인덱스를 통해 액세스할 수 있지만, 이는 단순히 QDomNamedNodeMap의 내용을 편리하게 열거할 수 있도록 하기 위한 것이며, DOM이 노드의 순서를 지정한다는 것을 의미하지는 않습니다.
QDomNamedNodeMap은 다음 세 곳에서 사용됩니다:
- QDomDocumentType::entities()는 DTD에 기술된 모든 엔티티의 맵을 반환합니다.
- QDomDocumentType::notations()는 DTD에 정의된 모든 표기법에 대한 맵을 반환합니다.
- QDomNode::attributes()는 요소의 모든 속성을 담은 맵을 반환합니다.
맵 내의 항목은 QDomNode::name()이 반환하는 이름으로 식별됩니다. 노드는 namedItem(), namedItemNS() 또는 item()을 사용하여 검색합니다. 새로운 노드는 setNamedItem() 또는 setNamedItemNS()을 사용하여 삽입하고, removeNamedItem() 또는 removeNamedItemNS()을 사용하여 제거합니다. contains()을 사용하여 지정된 이름을 가진 항목이 명명된 노드 맵에 있는지 확인합니다. 항목의 개수는 length()을 통해 반환됩니다.
용어: 이 클래스에서는 "항목(item)"과 "노드(node)"를 같은 의미로 사용합니다.
멤버 함수 설명서
QDomNamedNodeMap::QDomNamedNodeMap()
빈 명명된 노드 맵을 생성합니다.
QDomNamedNodeMap::QDomNamedNodeMap(const QDomNamedNodeMap &namedNodeMap)
namedNodeMap 의 복사본을 생성합니다.
[noexcept] QDomNamedNodeMap::~QDomNamedNodeMap()
객체를 삭제하고 해당 리소스를 해제합니다.
bool QDomNamedNodeMap::contains(const QString &name) const
맵에 name 라는 노드가 포함되어 있으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.
참고: 이 함수는 네임스페이스의 존재 여부를 고려하지 않습니다. 맵에 특정 네임스페이스 URI와 이름을 가진 노드가 포함되어 있는지 확인하려면 namedItemNS()를 사용하십시오.
int QDomNamedNodeMap::count() const
이 함수는 Qt API의 일관성을 위해 제공됩니다. 이는 length()와 동일합니다.
bool QDomNamedNodeMap::isEmpty() const
맵이 비어 있으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다. 이 함수는 Qt API의 일관성을 위해 제공됩니다.
QDomNode QDomNamedNodeMap::item(int index) const
index 위치에 있는 노드를 가져옵니다.
이 함수는 맵을 순회하는 데 사용할 수 있습니다. 맵 내의 노드 순서는 임의로 정해져 있다는 점에 유의하십시오.
length()도 참조하십시오 .
int QDomNamedNodeMap::length() const
맵에 포함된 노드의 개수를 반환합니다.
item()도 참조하십시오 .
QDomNode QDomNamedNodeMap::namedItem(const QString &name) const
name 라는 노드를 반환합니다.
지정된 노드 맵에 해당 노드가 포함되어 있지 않으면 ` null node `가 반환됩니다. 노드의 이름은 ` QDomNode::nodeName()` 함수가 반환하는 이름입니다.
setNamedItem() 및 namedItemNS()도 참조하십시오 .
QDomNode QDomNamedNodeMap::namedItemNS(const QString &nsURI, const QString &localName) const
로컬 이름 localName 및 네임스페이스 URI nsURI 과 연관된 노드를 반환합니다.
맵에 해당 노드가 포함되어 있지 않은 경우, null node 이 반환됩니다.
setNamedItemNS() 및 namedItem()도 참조하십시오 .
QDomNode QDomNamedNodeMap::removeNamedItem(const QString &name)
맵에서 ' name '라는 노드를 제거합니다.
이 함수는 제거된 노드를 반환하거나, 맵에 name 라는 노드가 포함되어 있지 않은 경우 null node 를 반환합니다.
setNamedItem(), namedItem(), removeNamedItemNS()도 참조하십시오 .
QDomNode QDomNamedNodeMap::removeNamedItemNS(const QString &nsURI, const QString &localName)
맵에서 로컬 이름이 localName 이고 네임스페이스 URI가 nsURI 인 노드를 제거합니다.
nsURI이 함수는 맵에 로컬 이름이 null node 이고 네임스페이스 URI가 localName 인 노드가 포함되어 있지 않은 경우, 제거된 노드 또는 를 반환합니다.
setNamedItemNS(), namedItemNS(), removeNamedItem()도 참조하십시오 .
QDomNode QDomNamedNodeMap::setNamedItem(const QDomNode &newNode)
newNode 노드를 지정된 노드 맵에 삽입합니다. 맵에서 사용하는 이름은 QDomNode::nodeName() 함수가 반환하는 newNode 의 노드 이름입니다.
새 노드가 기존 노드를 대체하는 경우, 즉 맵에 동일한 이름을 가진 노드가 이미 존재하는 경우, 대체된 노드가 반환됩니다.
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 &other) const
other 와 이 명명된 노드 맵이 서로 다를 경우 ` true `을 반환하고, 그렇지 않은 경우 ` false`을 반환합니다.
QDomNamedNodeMap &QDomNamedNodeMap::operator=(const QDomNamedNodeMap &other)
이 명명된 노드 맵에 ` other `를 할당합니다.
bool QDomNamedNodeMap::operator==(const QDomNamedNodeMap &other) const
other 와 이 명명된 노드 맵이 동일하면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.