文書の内部表現はツリーで、各ノードは子ノードのリストを持ちます。子の順序はXML表現での順序と一致します。また、要素ノードは属性のリストも持ち、これにも順序があります。ツリー内のあるノードから別のノードへ移るために、いくつかの関数が用意されています。これらの関数は内部表現におおむね対応しているため、通常はほかの走査方法の構成要素になります。たとえば、XPathによる走査はこれらの関数に基づいています。

parentはノードの親を返します。文書以外のnullでないノードは、すべてnullでない親を持ちます。first_childとlast_childは、それぞれ最初と最後の子を返します。空でない子ノードリストを持てるのは、文書ノードと要素ノードだけです。子がない場合、どちらもnullノードを返します。next_siblingとprevious_siblingは、子リストでこのノードのすぐ右と左にあるノードを、それぞれ返します。たとえば<a/><b/><c/>で、<b/>を指すハンドルのnext_siblingを呼ぶと<c/>を指すハンドルになり、previous_siblingを呼ぶと<a/>を指すハンドルになります。次または前の兄弟がない場合（リストの最後または最初のノードの場合）、これらの関数はnullノードを返します。first_attribute、last_attribute、next_attribute、previous_attributeも、対応する子ノード関数と同様に動作し、同じ方法で属性リストを反復処理できます。

上記の関数のいずれも、nullハンドルに対して呼び出すとnullハンドルを返します。たとえばnode.first_child().next_sibling()はnodeの2番目の子を返しますが、nodeがnull、子がまったくない、または子ノードが1個だけの場合にはnullハンドルを返します。

これらの関数を使うと、次のようにすべての子ノードを反復処理し、すべての属性を表示できます（samples/traverse_base.cpp）。

構造情報（親、子ノード、属性）に加えて、ノードは名前と値を持つことがあり、どちらも文字列です。ノード型によっては、名前や値がありません。node_documentノードは名前も値も持ちません。node_elementとnode_declarationノードは常に名前を持ちますが、値は持ちません。node_pcdata、node_cdata、node_comment、node_doctypeノードは名前を持たず、常に値を持ちます。ただし、値は空の場合もあります。node_piノードは常に名前と値を持ちますが、やはり値は空の場合があります。ノードの名前や値を取得するには、次の関数を使えます。

ノードが名前や値を持たない場合や、ノードハンドルがnullの場合、これらの関数は空文字列を返します。nullポインターは返しません。

データをノードのテキスト内容として保存することは一般的です。たとえば<node><description>This is a node</description></node>です。この場合、<description>ノード自体は値を持ちませんが、値が"This is a node"のnode_pcdata型の子を持ちます。pugixmlには、このようなデータを解析するための補助関数があります。

child_value()は、node_pcdataまたはnode_cdata型の最初の子の値を返します。child_value(name)はchild(name).child_value()の単純なラッパーです。上の例では、node.child_value("description")とdescription.child_value()のどちらも"This is a node"という文字列を返します。該当する型の子がない場合や、ハンドルがnullの場合、child_value関数は空文字列を返します。

text()は、値の取得より複雑な場合にPCDATAの内容を扱うための特別なオブジェクトを返します。テキスト内容の操作で説明します。

これらの関数の一部を使う例が、次の節の末尾にあります。

すべての属性は名前と値を持ち、どちらも文字列です。値は空の場合もあります。xml_nodeと同様に、対応するアクセサーが2つあります。

属性ハンドルがnullの場合、これらの関数は空文字列を返します。nullポインターは返しません。

属性ハンドルがnullのときに空でない文字列が必要なら、as_stringアクセサーを使えます。たとえば、XML属性からオプション値を取得し、指定されていない場合には""ではなく"sorted"を既定値にしたい場合です。

属性ハンドルがnullの場合は、def引数を返します。引数を指定しなければ、この関数はvalue()と同じです。

多くの場合、属性値には文字列以外の型があります。たとえば、XMLでは文字列として表されていても、常に整数として扱うべき値を含む属性があります。pugixmlには、属性値を別の型へ変換するアクセサーがいくつかあります。

as_int、as_uint、as_llong、as_ullong、as_double、as_floatは、属性値を数値へ変換します。属性ハンドルがnullの場合は、def引数（既定値は0）を返します。それ以外の場合は、先頭の空白文字をすべて取り除き、残りの文字列を解析します。整数の場合は10進数または16進数です。これはas_int、as_uint、as_llong、as_ullongに適用され、数値に0xまたは0Xの接頭辞があれば16進数として扱います。浮動小数点数の場合は、10進表記または科学的記数法で解析します（as_doubleまたはas_float）。

整数変換では、数値でない文字列に対して0を返し、範囲外の値は表現可能な最も近い値に制限されます。浮動小数点変換の結果は実装に依存します（PUGIXML_CHARCONV_FLOATを使うかどうかに応じて、CRTまたはSTL）。

as_boolは、次の方法で属性値を真偽値へ変換します。属性ハンドルがnullの場合は、def引数（既定値はfalse）を返します。属性値が空の場合はfalseを返します。それ以外の場合は、最初の文字が'1', 't', 'T', 'y', 'Y'のいずれかであればtrueを返します。このため、"true"や"yes"などの文字列はtrue、"false"や"no"などの文字列はfalseと認識されます。より複雑な照合が必要なら、独自の関数を書く必要があります。

これらの関数とノードデータ取得関数を使う例です（samples/traverse_base.cpp）。

文書の走査では、指定した名前のノードや属性を探すことが多いため、そのための専用の関数があります。

childとattributeは、指定した名前の最初の子または属性を返します。next_siblingとprevious_siblingは、対応する方向で、指定した名前の最初の兄弟を返します。文字列の比較ではすべて、大文字と小文字を区別します。ノードハンドルがnullの場合や、指定した名前のノードや属性がない場合は、nullハンドルを返します。

childとnext_siblingを組み合わせると、次のように指定した名前のすべての子ノードをループで処理できます。

attributeは、目的の属性を名前で探す必要があります。ノードに多くの属性がある場合、名前で1つずつ探すと時間がかかることがあります。ノード内での属性の順序が分かっていれば、より高速な関数を使えます。

追加のhint引数は、属性がありそうな位置の推定に使われ、次の属性の位置へ更新されます。そのため、複数の属性を正しい順序で探すと、性能を最大限に高められます。hintはnullか、そのノードに属する属性でなければなりません。それ以外の場合の動作は未定義です。

この関数は、次のように使えます。

このコードは属性の順序にかかわらず正しく動作しますが、"id"、"name"、"version"がこの順に並んでいれば、より高速になります。

必要なノードを、一意の名前ではなく、ある属性の値で指定することもあります。たとえば、各ノードが一意のIDを持つノードの集合は一般的です。<group><item id="1"/> <item id="2"/></group>のような場合です。属性値に基づいて子ノードを探す関数が2つあります。

引数が3つの関数は、指定した名前を持ち、指定した名前と値の属性を持つ、最初の子ノードを返します。引数が2つの関数はノード名の検査を省くため、異なる種類が混在する集合の検索に役立ちます。ノードハンドルがnullの場合や、ノードが見つからない場合は、nullハンドルを返します。文字列の比較ではすべて、大文字と小文字を区別します。

上記の関数では、すべての引数が有効な文字列でなければなりません。nullポインターを渡した場合の動作は未定義です。

これらの関数を使う例です（samples/traverse_base.cpp）。

C++コンパイラーが範囲forループに対応していれば、ノードや属性の列挙に使えます。これはC++11の機能で、Microsoft Visual Studio 2012以降、GCC 4.6以降、Clang 3.0以降が対応しています。そのための補助機能が用意されています。Boost Foreachとも互換性があり、C++11以前のほかのforeach機能でも使える可能性があります。

childrenはすべての子ノードを列挙でき、name引数を取るchildrenは指定した名前のすべての子ノードを列挙できます。attributesはノードのすべての属性を列挙できます。範囲forの構文では、ノードオブジェクト自体も使えます。これはchildren()を使うことと同じです。

これらの関数を使う例です（samples/traverse_rangefor.cpp）。

children()を使うとコードの意図が明確になりますが、各ノード自体も子ノードのコンテナーとして扱えます。次の節で説明するbegin()とend()メンバー関数があるためです。このため、ノード自体を使うだけで、その子を反復処理できます。

C++20では、ノードと、children()やattributes()が返すオブジェクトを、範囲として使うこともできます。

子ノードリストと属性リストは、単純な双方向連結リストです。反復処理にはprevious_siblingやnext_siblingなどの関数を使えますが、pugixmlにはノードと属性のイテレーターもあります。これにより、ノードを、ほかのノードや属性のコンテナーとして扱えます。

beginとattributes_beginは、それぞれ最初のノードと属性を指すイテレーターを返します。endとattributes_endは、それぞれノードリストと属性リストの末尾の次を指すイテレーターを返します。このイテレーターは参照外しできませんが、デクリメントすると、リストの最後の要素を指すイテレーターになります。ただし、空のリストでは、末尾の次を指すイテレーターをデクリメントした場合の動作は未定義です。末尾の次を指すイテレーターは、通常、反復ループの終了値として使います（下の例を参照）。既存のハンドルを指すイテレーターが必要なら、xml_node_iterator(node)のように、ハンドル1つをコンストラクターの引数として渡して作れます。xml_attribute_iteratorには、属性とその親ノードの両方を渡す必要があります。

nullノードで呼び出した場合、beginとendは等しいイテレーターを返し、これらは参照外しできません。attributes_beginとattributes_endも同様です。イテレーターを正しく使う場合、nullノードの子ノードや属性の集合は、空の集合として扱われます。

どちらのイテレーターも双方向イテレーターの意味論を持ちます。つまり、インクリメントとデクリメントはできますが、効率的なランダムアクセスには対応しません。比較や参照外しなど、通常のイテレーター操作をすべて使えます。指しているノードや属性のオブジェクトをツリーから削除すると、イテレーターは無効になります。ノードや属性の追加では、イテレーターは無効になりません。

イテレーターで文書を走査する例です（samples/traverse_iter.cpp）。

これまでに説明した方法では、ノードの直接の子を走査できます。ツリーの深い走査を行うには、再帰関数などの方法を使う必要があります。ただし、pugixmlには、部分ツリーを深さ優先で走査する補助機能があります。使うには、xml_tree_walkerインターフェースを実装し、traverseを呼び出してください。

走査の根でtraverseを呼び出すと、次の順序で走査が始まります。

begin、end、またはいずれかのfor_eachの呼び出しがfalseを返すと、走査は終了し、走査結果としてfalseを返します。それ以外の場合は、結果としてtrueを返します。beginやendをオーバーライドする必要はありません。既定の実装はtrueを返します。

depthを呼び出すと、いつでも走査の根に対するノードの相対的な深さを取得できます。beginやendから呼び出した場合は-1を返します。for_eachから呼び出した場合は、0から数える深さを返します。走査の根の子はすべて深さ0、孫はすべて深さ1、という具合です。

xml_tree_walkerでツリー階層を走査する例です（samples/traverse_walker.cpp）。

既知の内容を持つノードや属性を取得する関数はありますが、単純な問い合わせでも十分でない場合がよくあります。目的のノードや属性が見つかるまで手動で反復処理する代わりに、述語を作ってfind_関数のいずれかを呼び出せます。

述語は、通常の関数か関数オブジェクトで、引数を1つ受け取り、boolを返すものにしてください。引数の型は、find_attributeではxml_attribute、find_childとfind_nodeではxml_nodeです。nullハンドルを引数として述語が呼び出されることはありません。

find_attributeは、指定したノードのすべての属性を反復処理し、述語がtrueを返した最初の属性を返します。すべての属性で述語がfalseを返した場合や、属性がない場合（ノードがnullの場合も含む）は、null属性を返します。

find_childは、指定したノードのすべての子ノードを反復処理し、述語がtrueを返した最初のノードを返します。すべてのノードで述語がfalseを返した場合や、子ノードがない場合（ノードがnullの場合も含む）は、nullノードを返します。

find_nodeは、指定したノードの部分ツリーを、ノード自体を除いて深さ優先で走査し、述語がtrueを返した最初のノードを返します。すべてのノードで述語がfalseを返した場合や、部分ツリーが空の場合は、nullノードを返します。

述語に基づく関数を使う例です（samples/traverse_predicate.cpp）。

データをノードのテキスト内容として保存することは一般的です。たとえば<node><description>This is a node</description></node>です。この場合、<description>ノード自体は値を持ちませんが、値が"This is a node"のnode_pcdata型の子を持ちます。pugixmlには、このようなデータを扱う専用のクラスxml_textがあります。テキストオブジェクトを使ったデータの変更は、文書データの変更の説明で扱います。この節では、xml_textのアクセスインターフェースを説明します。

text()メソッドを使うと、ノードからテキストオブジェクトを取得できます。

ノードの型がnode_pcdataまたはnode_cdataなら、ノード自体を使ってデータを返します。それ以外の場合は、最初のnode_pcdataまたはnode_cdata型の子ノードを使います。

テキストオブジェクトをif (text) { …​ }やif (!text) { …​ }のように真偽値として使うと、有効なPCDATA・CDATAノードに結び付いているかどうかを確認できます。empty()メソッドでも確認できます。

テキストオブジェクトから、その内容（PCDATA・CDATAノードの値）を取得するには、次の関数を使えます。

テキストオブジェクトが空の場合、この関数は空文字列を返します。nullポインターは返しません。

テキストオブジェクトが空のときに空でない文字列が必要な場合や、テキスト内容が、文字列として保存された数値や真偽値の場合には、次のアクセサーを使えます。

上記の関数はすべて、対応するxml_attributeメンバーと同じ意味を持ちます。テキストオブジェクトが空なら既定値の引数を返し、同じ規則と制約に従って、テキスト内容を対象の型へ変換します。詳細は属性関数の説明を参照してください。

xml_textは、基本的にはxml_nodeの値を操作する補助クラスです。node_pcdataまたはnode_cdata型のノードに結び付いています。このノードを取得するには、次の関数を使えます。

つまり、textがxml_textオブジェクトである場合、text.get()を呼び出すことは、text.data().value()を呼び出すことと同じです。

xml_textオブジェクトを使う例です（samples/text.cpp）。

あるノードの文書の根を取得するには、次の関数を使えます。

この関数は、そのノードが属する文書の根ノードである、node_document型のノードを返します。ただし、ノードがnullの場合は、nullノードを返します。

pugixmlは複雑なXPath式に対応していますが、単純なパス処理機能が必要な場合もあります。ノードのパスを取得する関数と、パスをノードへ変換する関数の2つがあります。

ノードのパスは、区切り文字（既定では/）で区切られたノード名からなります。自身（.）と親（..）を表す疑似的な名前も使えるため、"../../foo/./bar"は有効なパスです。pathは文書の根からノードへのパスを返し、first_element_by_pathは指定したパスで表されるノードを探します。パスは絶対パスにも、指定したノードからの相対パスにもできます。絶対パスは区切り文字で始まり、それ以降を文書の根からの相対パスとして扱います。たとえば、文書<a><b><c/></b></a>では、ノード<c/>のパスは"a/b/c"です。文書に対してパス"a/b"でfirst_element_by_pathを呼び出すと、ノード<b/>になります。ノード<a/>に対してパス"../a/./b/../."でfirst_element_by_pathを呼び出すと、ノード<a/>になります。パス"/a"でfirst_element_by_pathを呼び出すと、どのノードからでもノード<a/>になります。

パスの構成要素が曖昧な場合（同じ名前のノードが2つある場合）は、最初のものを選びます。パスが文書内のノードを一意に識別する保証はありません。パスのいずれかの構成要素が見つからなければ、first_element_by_pathの結果はnullノードです。また、nullノードでfirst_element_by_pathを呼び出した場合もnullノードを返し、この場合はパスの内容は関係ありません。nullノードでpathを呼び出すと、空文字列を返します。

効率上の理由から、pugixmlは解析時にノードの行や列の情報を記録しません。ただし、解析後にノードが大きく変更されていなければ、XMLバッファの先頭からのオフセットを取得できます。つまり、名前や値が変更されず、ノード自体が元のものである場合です。ツリーから削除され、後で追加し直されたノードではいけません。

オフセットを取得できない場合、この関数は-1を返します。これは、ノードがnull、もともとストリームから解析されたものではない、または大きく変更された場合に起こります。それ以外の場合は、XMLバッファの先頭からノードのデータまでのオフセットを、pugi::char_t単位で返します。解析オフセットの詳細は、解析エラー処理の説明を参照してください。