QDomDocument Class

QDomDocument doc("mydocument");
QFile file("mydocument.xml");
if (!file.open(QIODevice::ReadOnly))
    return;
if (!doc.setContent(&file)) {
    file.close();
    return;
}
file.close();

// print out the element names of all elements that are direct children
// of the outermost element.
QDomElement docElem = doc.documentElement();

QDomNode n = docElem.firstChild();
while(!n.isNull()) {
    QDomElement e = n.toElement(); // try to convert the node to an element.
    if(!e.isNull()) {
        cout << qPrintable(e.tagName()) << '\n'; // the node really is an element.
    }
    n = n.nextSibling();
}

// Here we append a new element to the end of the document
QDomElement elem = doc.createElement("img");
elem.setAttribute("src", "myimage.png");
docElem.appendChild(elem);

QDomDocument doc;
QDomElement root = doc.createElement("MyML");
doc.appendChild(root);

QDomElement tag = doc.createElement("Greeting");
root.appendChild(tag);

QDomText t = doc.createTextNode("Hello World");
tag.appendChild(t);

QString xml = doc.toString();

メンバ関数のドキュメント

QDomDocument::QDomDocument()

空のドキュメントを作成します。

[explicit] QDomDocument::QDomDocument(const QDomDocumentType &doctype)

ドキュメントタイプ「doctype 」のドキュメントを作成します。

QDomImplementation::createDocumentType()も参照してください 。

[explicit] QDomDocument::QDomDocument(const QString &name)

ドキュメントを作成し、ドキュメントタイプの名前を「name 」に設定します。

QDomDocument::QDomDocument(const QDomDocument &document)

document のコピーを作成します。

このコピーのデータは共有されています（浅いコピー）：一方のノードを変更すると、もう一方のノードも変更されます。深いコピーを作成したい場合は、cloneNode() を使用してください。

[noexcept] QDomDocument::~QDomDocument()

オブジェクトを破棄し、そのリソースを解放します。

QDomAttr QDomDocument::createAttribute(const QString &name)

name という名前の新しい属性を作成します。この属性は、例えば `QDomElement::setAttributeNode()` などを使用して、要素に挿入することができます。

name が有効な XML 名でない場合、この関数の動作はQDomImplementation::InvalidDataPolicy によって規定されます。

createAttributeNS()も参照してください 。

QDomAttr QDomDocument::createAttributeNS(const QString &nsURI, const QString &qName)

要素に挿入可能な、名前空間をサポートする新しい属性を作成します。属性名は `qName `、名前空間 URI は `nsURI` です。また、この関数は `QDomNode::prefix()` および `QDomNode::localName()` を（`qName` に応じて）適切な値に設定します。

qName が有効な XML 名でない場合、この関数の動作はQDomImplementation::InvalidDataPolicy によって規定されます。

createAttribute()も参照してください 。

QDomCDATASection QDomDocument::createCDATASection(const QString &value)

文字列 `value ` に対して、ドキュメントに挿入可能な新しい CDATA セクションを作成します。例えば、QDomNode::appendChild() を使用することで挿入できます。

value に CDATA セクションに格納できない文字が含まれている場合、この関数の動作はQDomImplementation::InvalidDataPolicy によって規定されます。

QDomNode::appendChild()、QDomNode::insertBefore()、およびQDomNode::insertAfter()も参照してください 。

QDomComment QDomDocument::createComment(const QString &value)

文字列 `value ` に対する新しいコメントを作成します。このコメントは、例えば `QDomNode::appendChild()` などを使用して、ドキュメントに挿入することができます。

value に XML コメントとして保存できない文字が含まれている場合、この関数の動作はQDomImplementation::InvalidDataPolicy によって規定されます。

QDomNode::appendChild()、QDomNode::insertBefore()、およびQDomNode::insertAfter()も参照してください 。

QDomDocumentFragment QDomDocument::createDocumentFragment()

新しいドキュメントフラグメントを作成します。これは、ドキュメントツリーに対する複雑な操作を行う場合など、ドキュメントの一部を保持するために使用できます。

QDomElement QDomDocument::createElement(const QString &tagName)

tagName という名前の新しい要素を作成します。この要素は、例えば `QDomNode::appendChild()` などを使用して DOM ツリーに挿入することができます。

tagName が有効な XML 名でない場合、この関数の動作はQDomImplementation::InvalidDataPolicy によって規定されます。

createElementNS()、QDomNode::appendChild()、QDomNode::insertBefore()、およびQDomNode::insertAfter()も参照してください 。

QDomElement QDomDocument::createElementNS(const QString &nsURI, const QString &qName)

DOMツリーに挿入可能な、名前空間をサポートする新しい要素を作成します。要素の名前は `qName `、名前空間URIは `nsURI` です。また、この関数は `QDomNode::prefix()` および `QDomNode::localName()` を（`qName` に応じて）適切な値に設定します。

qName が空の文字列の場合、無効なデータポリシーが設定されているかどうかにかかわらず、null要素を返します。

createElement()も参照してください 。

QDomEntityReference QDomDocument::createEntityReference(const QString &name)

name という名前の新しいエンティティ参照を作成します。これは、例えばQDomNode::appendChild() などを使用して、ドキュメントに挿入することができます。

name が有効な XML 名でない場合、この関数の動作はQDomImplementation::InvalidDataPolicy によって規定されます。

QDomNode::appendChild()、QDomNode::insertBefore()、およびQDomNode::insertAfter()も参照してください 。

QDomProcessingInstruction QDomDocument::createProcessingInstruction(const QString &target, const QString &data)

QDomNode::appendChild() などを使用して、ドキュメントに挿入可能な新しい処理命令を作成します。この関数は、処理命令のターゲットをtarget に、データをdata に設定します。

target が有効なXML名でない場合、またはdataに処理命令に含まれてはならない文字が含まれている場合、この関数の動作はQDomImplementation::InvalidDataPolicy に従います。

QDomNode::appendChild()、QDomNode::insertBefore()、およびQDomNode::insertAfter()も参照してください 。

QDomText QDomDocument::createTextNode(const QString &value)

文字列 `value ` に対応するテキストノードを作成します。このノードは、例えば `QDomNode::appendChild()` を使用して、ドキュメントツリーに挿入することができます。

value に、XML ドキュメントの文字データとして（文字参照の形式であっても）格納できない文字が含まれている場合、この関数の動作はQDomImplementation::InvalidDataPolicy によって規定されます。

QDomNode::appendChild()、QDomNode::insertBefore()、およびQDomNode::insertAfter()も参照してください 。

QDomDocumentType QDomDocument::doctype() const

このドキュメントのドキュメントタイプを返します。

QDomElement QDomDocument::documentElement() const

ドキュメントのルート要素を返します。

QDomElement QDomDocument::elementById(const QString &elementId)

IDがelementId と等しい要素を返します。このIDを持つ要素が見つからなかった場合、この関数はnull element を返します。

QDomClasses は、どの属性が要素の ID であるかを認識していないため、この関数は常に `null element` を返します。これは将来のバージョンで変更される可能性があります。

QDomNodeList QDomDocument::elementsByTagName(const QString &tagname) const

tagname という名前のドキュメントに含まれるすべての要素を含むQDomNodeList を返します。ノードリストの順序は、要素ツリーのプレオーダー探索でノードが検出される順序となります。

elementsByTagNameNS() およびQDomElement::elementsByTagName()も参照してください 。

QDomNodeList QDomDocument::elementsByTagNameNS(const QString &nsURI, const QString &localName)

ローカル名localName 、名前空間 URInsURI を持つドキュメント内のすべての要素を含む `QDomNodeList ` を返します。ノードリストの順序は、要素ツリーのプレオーダー走査において要素が出現する順序となります。

elementsByTagName() およびQDomElement::elementsByTagNameNS()も参照してください 。

QDomImplementation QDomDocument::implementation() const

QDomImplementation オブジェクトを返します。

QDomNode QDomDocument::importNode(const QDomNode &importedNode, bool deep)

別のドキュメントから「importedNode 」というノードを、このドキュメントにインポートします。「importedNode 」は元のドキュメントに残ったままとなり、この関数はこのドキュメント内で使用できるコピーを作成します。

この関数は、このドキュメントに属するインポートされたノードを返します。返されるノードには親がありません。QDomDocument およびQDomDocumentType ノードをインポートすることはできません。そのような場合、この関数はnull node を返します。

importedNode がnull node である場合、nullノードが返されます。

deep がtrueの場合、この関数はノードimportedNode だけでなく、そのサブツリー全体をインポートします。falseの場合は、importedNode のみがインポートされます。引数deep は、QDomAttr およびQDomEntityReference ノードには影響しません。これは、QDomAttr ノードの子孫は常にインポートされ、QDomEntityReference ノードの子孫は決してインポートされないためです。

この関数の動作は、ノードの種類によって若干異なります：

QDomElement::setAttribute()、QDomNode::insertBefore()、QDomNode::insertAfter()、QDomNode::replaceChild()、QDomNode::removeChild()、およびQDomNode::appendChild()も参照してください 。

QDomNode::NodeType QDomDocument::nodeType() const

DocumentNode を返します。

この関数は、バイト配列 `data`、文字列ビュー `text`、IO `device`、またはストリーム `reader ` から XML ドキュメントを解析し、それをドキュメントの内容として設定します。XML 仕様に従って、ドキュメントのエンコーディングを検出しようとします。解析結果を `ParseResult` に返しますが、これは明示的に `bool` に変換されます。

options パラメータを使用すると、名前空間処理の有効化など、さまざまな解析オプションを指定できます。

デフォルトでは、名前空間処理は無効になっています。無効になっている場合、パーサーはXMLファイルを読み込む際に名前空間処理を行いません。関数QDomNode::prefix()、QDomNode::localName()、およびQDomNode::namespaceURI()は、空の文字列を返します。

parseoptions を介して名前空間処理が有効になっている場合、パーサーはXMLファイル内の名前空間を認識し、プレフィックス名、ローカル名、および名前空間URIを適切な値に設定します。関数QDomNode::prefix()、QDomNode::localName()、およびQDomNode::namespaceURI()は、すべての要素および属性に対して文字列を返しますが、要素または属性にプレフィックスがない場合は空の文字列を返します。

空白のみで構成されるテキストノードは削除され、QDomDocument には表示されません。Qt 6.5以降では、QDomDocument::ParseOption::PreserveSpacingOnlyNodes を解析オプションとして指定することで、空白のみのテキストノードを保持するように指定できます。

エンティティ参照は次のように処理されます：

• コンテンツ内に現れる内部一般エンティティおよび文字エンティティへの参照は含まれます。その結果、参照が対応するエンティティ値に置き換えられたQDomText ノードが生成されます。
• 内部サブセット内に現れるパラメータエンティティへの参照は含められます。その結果、参照が対応するエンティティ値に置き換えられたエンティティおよび表記法宣言を含む `QDomDocumentType ` ノードが生成されます。
• 内部サブセットで定義されておらず、かつコンテンツ内に現れる一般的な解析済みエンティティ参照は、QDomEntityReference ノードとして表現されます。
• 内部サブセットで定義されておらず、コンテンツの外側に現れる解析済みエンティティ参照は、空の文字列に置き換えられます。
• 解析されていないエンティティ参照は、空の文字列に置き換えられます。

これらの関数は Qt 6.5 で導入されました。

ParseResult およびParseOptionsも参照してください 。

QByteArray QDomDocument::toByteArray(int indent = 1) const

解析済みのドキュメントをテキスト形式に戻し、UTF-8でエンコードされたデータを含むQByteArray を返します。

この関数は、indent を子要素のインデント量として使用します。

toString()も参照してください 。

QString QDomDocument::toString(int indent = 1) const

解析済みのドキュメントをテキスト形式に戻します。

この関数は、indent を子要素のインデント量として使用します。

indent が -1 の場合、空白は一切追加されません。

QDomDocument &QDomDocument::operator=(const QDomDocument &other)

このDOMドキュメントにother を割り当てます。

コピーされたデータは共有されます（浅いコピー）：一方のノードを変更すると、もう一方も変更されます。深いコピーを作成したい場合は、cloneNode() を使用してください。