> For the complete documentation index, see [llms.txt](https://sandbox-docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sandbox-docs.verifone.com/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8c.md). # xmldoc.c [Macros](#define-members) | [Functions](#func-members) `#include ` `#include "`[xmldoc.h](/adk-5.0-programmers-guide/xmldoc_8h_source.md)`"` Include dependency graph for xmldoc.c: ![](/files/uto0aMS3y5VcHGuojoyw) | | | | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Macros | | | #define | [INDENT](#a502b06aa5ad25116c775d201326bad52) 2 | | #define | [XML\_MAX\_NESTING\_DEPTH](#a2f1b9f2d279db1ce98562788dcbacd43) 64 | | #define | [YYCTYPE](#ad44df346a68d07dd2420887508f0818f) char | | #define | [YYCURSOR](#a1fcda04b90493a75641fa6299a7e9529) cursor | | #define | [YYLIMIT](#a66de83134d9447c49f1addf533e357c8) cursor /\* nicht verwendet: 0-Byte markiert das Ende \*/ | | #define | [YYMARKER](#ad27f395c8f1fecfe0e33c02787e6a5e8) marker | | #define | [YYFILL](#a9f6301310226eae6a3234c0e6863f0b5)(n) | | #define | [RETURN](#a9a16dd7a920f66fe5d85dee94af8eb02)(x) do { \_this->buffer=cursor; [return](/adk-5.0-programmers-guide/readme/files/dir_30aba3d9bf6279a25d84abe4015711f7/dir_f7a957c8f5c8e80b5a8d4b37f193d419/dir_2e151e0b75e9d9c1ff29ffca72564687/_v_h_q__vfisyspm__wrapper_8cpp.md#abe95a00f8e60264f7043a99eed75eba0) x; } while(0) | | | | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Functions | | | enum [XMLTokenizer\_\_Encoding](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#aa5d1bb6cbd537293ccc23cbe090c4256) | [XMLTokenizer\_\_readHeader](#a339f65c4da9757075e594656f2f49830) (struct [XMLTokenizer](/adk-5.0-programmers-guide/readme/annotated/struct_x_m_l_tokenizer.md) \*\_this) | | enum [XMLTokenizer\_\_Token](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#af1dad427b690336ae7242fcb821b72b5) | [XMLTokenizer\_\_readToken](#ad48dd9dc8bf13108d1ed5c2d0883dbd4) (struct [XMLTokenizer](/adk-5.0-programmers-guide/readme/annotated/struct_x_m_l_tokenizer.md) \*\_this) | | void | [XMLTokenizer\_\_Constructor](#a9fc3816f7fd0dee395ac512d77a421ad) (struct [XMLTokenizer](/adk-5.0-programmers-guide/readme/annotated/struct_x_m_l_tokenizer.md) \*\_this) | | void | [XMLTokenizer\_\_Destructor](#abaa2d9625980042d73c4cda857c4f69f) (struct [XMLTokenizer](/adk-5.0-programmers-guide/readme/annotated/struct_x_m_l_tokenizer.md) \*\_this) | | void | [XMLTokenizer\_\_init](#a090478d7bdf8be57c2b002a01f89d8a0) (struct [XMLTokenizer](/adk-5.0-programmers-guide/readme/annotated/struct_x_m_l_tokenizer.md) \*\_this, char \*buf, char \*(\*fill)(void \*fill\_data), void \*fill\_data) | | enum [XMLTokenizer\_\_Token](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#af1dad427b690336ae7242fcb821b72b5) | [XMLTokenizer\_\_nextToken](#ae86917930a62c406096333658aa8c5e7) (struct [XMLTokenizer](/adk-5.0-programmers-guide/readme/annotated/struct_x_m_l_tokenizer.md) \*\_this) | | int | [XMLDocument\_\_read](#a026359c5968a228e29f0f15d5eb72685) (struct [XMLDocument](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_document) \*\_this, char \*buffer) | | int | [XMLDocument\_\_read2](#a03f757e5643923bf33a1da56c9e7ce3a) (struct [XMLDocument](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_document) \*\_this, char \*buffer, char \*(\*fill)(void \*fill\_data), void \*fill\_data) | | int | [XMLDocument\_\_write](#a2d3843c7695a5eae4e2b31fec4454839) (const struct [XMLDocument](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_document) \*\_this, char \*buffer, int size) | | int | [XMLNode\_\_Constructor](#ab0c08f500b76c404cf9065b195ddc6c4) (struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this, const char \*\_name, const char \*\_value) | | int | [XMLNode\_\_Constructor2](#a72f399a3696f0fb9d228d39976985d7e) (struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this, const char \*\_name, const char \*\_value, enum [XMLTokenizer\_\_Encoding](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#aa5d1bb6cbd537293ccc23cbe090c4256) source\_encoding) | | struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \* | [XMLNode\_\_Create](#acffb256c2a6716451e2935b08cb828bd) (const char \*\_name, const char \*\_value) | | struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \* | [XMLNode\_\_Create2](#a89eccae3da2d18f38f32fb72886a0f06) (const char \*\_name, const char \*\_value, enum [XMLTokenizer\_\_Encoding](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#aa5d1bb6cbd537293ccc23cbe090c4256) source\_encoding) | | void | [XMLNode\_\_Destructor](#aa5449a1862f6814f6100c1d616dc0c79) (struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this) | | void | [XMLNode\_\_Destroy](#a983e13b392bccbee1021abd6b7876a52) (struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this) | | void | [XMLNode\_\_setName](#aaa2c23abf0f440cfdf5cdaa4ea3493f0) (struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this, const char \*\_name) | | void | [XMLNode\_\_setValue](#a13dd3a77a8244ee755d86bbf30c8c86e) (struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this, const char \*\_value) | | struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \* | [XMLNode\_\_clone](#af06814fd150b2f9681ee0b182cff5288) (const struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this, enum [XMLNode\_\_CloneMode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#ab74ac56ab687317d89ad37db581f534f) cm, int clone\_successor) | | int | [XMLNode\_\_parse](#abaf4b367b59b52380b54c944ed425f90) (struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this, const char \*name, struct [XMLTokenizer](/adk-5.0-programmers-guide/readme/annotated/struct_x_m_l_tokenizer.md) \*t) | | int | [XMLNode\_\_write](#acc01a18d71844b4a9b3f73803f3450ab) (struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this, char \*buffer, int size, int level, enum [XMLTokenizer\_\_Encoding](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#aa5d1bb6cbd537293ccc23cbe090c4256) dest\_encoding) | | void | [XMLNode\_\_addToContent](#a32a0039eb81696b03b02792427725bdb) (struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this, struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*node) | | struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \* | [XMLNode\_\_findNode](#af5c3a0bf4d226ce3388d4ad5049a44ab) (struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this, const char \*name) | | void | [XMLNode\_\_insertNode](#a8b8d6ce6b677fb884fc2ecf71a0d94fb) (struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this, const char \*name, struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*node) | | void | [XMLNode\_\_reorderContent](#adb969bd1c04750d23691516c0a654bde) (struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this, const char \*reference\[]) | | enum [XMLNode\_\_NodeType](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#a77b3a9e89ab3f44418d513e422ab184b) | [XMLNode\_\_type](#ab2618028f6ea359110aa6e2b90604bb1) (const struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this) | | const char \* | [XMLNode\_\_getName](#ac78d3fc316e376c991a82e26f193ea53) (const struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this) | | const char \* | [XMLNode\_\_getValue](#a9f6ebcd5095ef5c64835bff6c3835287) (const struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this) | | void | [XMLNode\_\_swap](#a9d9fbd613657c10dfec7a2b27bbbe48c) (struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*\_this, struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*other) | | void | [XMLDocument\_\_Constructor](#ac325416dee38262efa72afa6be5a6d56) (struct [XMLDocument](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_document) \*\_this, enum [XMLTokenizer\_\_Encoding](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#aa5d1bb6cbd537293ccc23cbe090c4256) enc) | | void | [XMLDocument\_\_CopyConstructor](#a070550a0b656048cdaf4b0ead9b9cd05) (struct [XMLDocument](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_document) \*\_this, const struct [XMLDocument](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_document) \*o) | | struct [XMLDocument](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_document) \* | [XMLDocument\_\_Assign](#a7aa132bbf1a11dc0e53d438b3e9507a7) (struct [XMLDocument](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_document) \*\_this, const struct [XMLDocument](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_document) \*o) | | void | [XMLDocument\_\_Destructor](#afb55c479565dce251504835744b06941) (struct [XMLDocument](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_document) \*\_this) | | void | [XMLDocument\_\_clear](#a62b82f2718759b0b298755112f6df440) (struct [XMLDocument](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_document) \*\_this) | | struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \* | [XMLDocument\_\_findNode](#a2d915117bc9a01980f01a9cfbff8ff45) (struct [XMLDocument](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_document) \*\_this, const char \*name) | | void | [XMLDocument\_\_insertNode](#a53e0386e50ce88bd181fd84a28391a2e) (struct [XMLDocument](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_document) \*\_this, const char \*name, struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) \*node) | | void | [XMLDocument\_\_removeNode](#ac491bd43799ebe30d5f51d905a63f477) (struct [XMLDocument](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_document) \*\_this, const char \*name) | ### DetailedDescription ### MacroDefinition Documentation ### INDENT \#define INDENT 2 ### RETURN \#define RETURN ### XML\_MAX\_NESTING\_DEPTH \#define XML\_MAX\_NESTING\_DEPTH 64 ### YYCTYPE \#define YYCTYPE char ### YYCURSOR \#define YYCURSOR cursor ### YYFILL \#define YYFILL ### YYLIMIT \#define YYLIMIT cursor /\\\* nicht verwendet: 0-Byte markiert das Ende \\\*/ ### YYMARKER \#define YYMARKER marker ### FunctionDocumentation ### XMLDocument\_\_Assign() struct [XMLDocument](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_document)\\\* XMLDocument\\\_\\\_Assign copy operator, performs deep copy of contained nodes **Parameters** \[in,out] **\_this** this object \[in] **o** object to be copied ### XMLDocument\_\_clear() void XMLDocument\\\_\\\_clear remove all contents from the XML-document ### XMLDocument\_\_Constructor() void XMLDocument\\\_\\\_Constructor constructor **Parameters** \[in,out] **\_this** this object \[in] **enc** encoding that should be used internally ### XMLDocument\_\_CopyConstructor() void XMLDocument\\\_\\\_CopyConstructor copy constructor, performs deep copy of contained nodes **Parameters** \[in,out] **\_this** this object \[in] **o** object to be copied ### XMLDocument\_\_Destructor() void XMLDocument\\\_\\\_Destructor destructor **Parameters** \[in,out] **\_this** this object ### XMLDocument\_\_findNode() struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node)\\\* XMLDocument\\\_\\\_findNode find node **Parameters** \[in,out] **\_this** this object \[in] **name** path of the node (see XMLDocument) #### Returns node if found or NULL #### Seealso Path description ### XMLDocument\_\_insertNode() void XMLDocument\\\_\\\_insertNode Insert a node. If a node already exists that matches the path the node is replaced. Note that the name of the new node is not taken from the path, therefore, `insertNode`("a/b",new [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node)("c",0)) will remove node `b` and insert a node with name `c`! If a node is to be appended to a node, use ...\/+. If components of the path do not exist, they are created as simple nodes, e.g. inserting with the path a/b/c/+ will create nodes a, b and c if they do not already exist. **Parameters** \[in,out] **\_this** this object \[in] **name** path of the node (see XMLDocument) \[in] **node** to be inserted or 0 to remove and delete a node (removeNode()) #### Seealso Path description ### XMLDocument\_\_read() int XMLDocument\\\_\\\_read read an XML-document from a 0-terminated buffer **Parameters** \[in,out] **\_this** this object \[in] **buffer** XML-document #### Returns \[unsupported block] ### XMLDocument\_\_read2() int XMLDocument\\\_\\\_read2 read an XML-document from a 0-terminated buffer. Large XML documents may be split after '>' into several parts. When a part is completely read, fill() is called. fill() must return a 0-terminated buffer for the respective next part. It is important that the splitting can only be done after a '>' to not confuse the parser. **Parameters** \[in,out] **\_this** this object \[in] **buffer** XML-document \[in] **fill** callback function that is called when the end of the buffer is encountered \[in] **fill\_data** parameter for the callback function #### Returns \[unsupported block] ### XMLDocument\_\_removeNode() void XMLDocument\\\_\\\_removeNode remove node **Parameters** \[in,out] **\_this** this object \[in] **name** path of the node #### Seealso Path description ### XMLDocument\_\_write() int XMLDocument\\\_\\\_write write an XML-document as 0-terminated string to a buffer. **Parameters** \[in,out] **\_this** this object \[out] **buffer** buffer \[in] **size** size of the buffer #### Returns number of written bytes without the trailing 0 or -1, if the buffer was too small ### XMLNode\_\_addToContent() void XMLNode\\\_\\\_addToContent append a node to the content list **Parameters** \[in,out] **\_this** this object \[in] **node** node to append ### XMLNode\_\_clone() struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node)\\\* XMLNode\\\_\\\_clone clone a node including its content **Parameters** \[in,out] **\_this** this object \[in] **cm** mode: clone all (XMLNode\_\_CLONE\_ALL) or clone only the attributes (XMLNode\_\_CLONE\_ATTRIBUTE) \[in] **clone\_successor** used for recursion, should be initially set to 0 #### Returns pointer to cloned node ### XMLNode\_\_Constructor() int XMLNode\\\_\\\_Constructor constructor **Parameters** \[out] **\_this** this pointer \[in] **\_name** name of the node \[in] **\_value** value contained in the node #### Returns 1 on success, 0 if a memory allocation failed (\_this is left fully zeroed) ### XMLNode\_\_Constructor2() int XMLNode\\\_\\\_Constructor2 constructor, the input value is converted to internal representation **Parameters** \[out] **\_this** this pointer \[in] **\_name** name of the node \[in] **\_value** value contained in the node \[in] **source\_encoding** encoding scheme of \_value #### Returns 1 on success, 0 if a memory allocation failed (\_this is left fully zeroed) ### XMLNode\_\_Create() struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node)\\\* XMLNode\\\_\\\_Create allocate and initialize a new [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) (shortcut for malloc + XMLNode\_\_Constructor) **Parameters** \[in] **\_name** name of the node \[in] **\_value** value contained in the node #### Returns allocated object or 0 if no memory could be allocated ### XMLNode\_\_Create2() struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node)\\\* XMLNode\\\_\\\_Create2 allocate and initialize a new [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) (shortcut for malloc + XMLNode\_\_Constructor2) **Parameters** \[in] **\_name** name of the node \[in] **\_value** value contained in the node \[in] **source\_encoding** encoding scheme of \_value #### Returns allocated object or 0 if no memory could be allocated ### XMLNode\_\_Destroy() void XMLNode\\\_\\\_Destroy short cut for XMLNode\_\_Destructor + free **Parameters** \[in] **\_this** object to be released ### XMLNode\_\_Destructor() void XMLNode\\\_\\\_Destructor destructor **Parameters** \[in,out] **\_this** this object ### XMLNode\_\_findNode() struct [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node)\\\* XMLNode\\\_\\\_findNode search for a node inside this node **Parameters** \[in,out] **\_this** this object \[in] **name** path of the node relative to this node (see XMLDocument) #### Returns node if found or NULL #### Seealso Path description ### XMLNode\_\_getName() const char\\\* XMLNode\\\_\\\_getName access name **Parameters** \[in,out] **\_this** this object #### Returns name ### XMLNode\_\_getValue() const char\\\* XMLNode\\\_\\\_getValue access value (text) **Parameters** \[in,out] **\_this** this object #### Returns value ### XMLNode\_\_insertNode() void XMLNode\\\_\\\_insertNode Insert a node. If a node already exists that matches the path the node is replaced. Note that the name of the new node is not taken from the path, therefore, `insertNode`("a/b",new [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node)("c",0)) will remove node `b` and insert a node with name `c`! If a node is to be appended to a node, use ...\/+. If components of the path do not exist, they are created as simple nodes, e.g. inserting with the path a/b/c/+ will create nodes a, b and c if they do not already exist. **Parameters** \[in,out] **\_this** this object \[in] **name** path of the node (see XMLDocument) \[in] **node** to be inserted or 0 to remove and delete a node (removeNode()) #### Seealso Path description ### XMLNode\_\_parse() int XMLNode\\\_\\\_parse ### XMLNode\_\_reorderContent() void XMLNode\\\_\\\_reorderContent reorder content according to an ordering an a reference table **Parameters** \[in,out] **\_this** this object \[in] **reference** null-pointer terminated string array with a reference ordering of the nodes {% hint style="info" %} nodes not found in reference are moved to the end {% endhint %} ### XMLNode\_\_setName() void XMLNode\\\_\\\_setName set name **Parameters** \[in,out] **\_this** this object \[in] **\_name** name ### XMLNode\_\_setValue() void XMLNode\\\_\\\_setValue set value **Parameters** \[in,out] **\_this** this object \[in] **\_value** value (text) ### XMLNode\_\_swap() void XMLNode\\\_\\\_swap swap contents with another node **Parameters** \[in,out] **\_this** this object \[in,out] **other** other node with which to swapt the content ### XMLNode\_\_type() enum [XMLNode\_\_NodeType](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#a77b3a9e89ab3f44418d513e422ab184b) XMLNode\\\_\\\_type determine the type of node by the combinations of name and value **Parameters** \[in,out] **\_this** this object #### Returns type of node, one of [XMLNode\_\_ATTRIBUTE](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#a77b3a9e89ab3f44418d513e422ab184babcc735431fa4199b0f7ebe3df45ca99a), [XMLNode\_\_NODE](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#a77b3a9e89ab3f44418d513e422ab184baf4c5a5fa113d0c3cf13e51c07d15534d), [XMLNode\_\_VALUE](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#a77b3a9e89ab3f44418d513e422ab184ba4ad21b9cb57b3ce307ad13654c872df3), [XMLNode\_\_ROOT](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#a77b3a9e89ab3f44418d513e422ab184badbfadf399207fd928ca7abd2c64c44bf) #### Seealso [XMLNode](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#struct_x_m_l_node) ### XMLNode\_\_write() int XMLNode\\\_\\\_write write XML-code. **Parameters** \[in,out] **\_this** this object \[out] **buffer** buffer \[in] **size** size of the buffer \[in] **level** level used for indentation \[in] **dest\_encoding** destination encoding #### Returns number of bytes written without trailing 0-byte or -1 if the buffer was too small. ### XMLTokenizer\_\_Constructor() void XMLTokenizer\\\_\\\_Constructor constructor. Default encoding is UTF-8 **Parameters** \[in,out] **\_this** this object ### XMLTokenizer\_\_Destructor() void XMLTokenizer\\\_\\\_Destructor destructor **Parameters** \[in,out] **\_this** this object ### XMLTokenizer\_\_init() void XMLTokenizer\\\_\\\_init sets the buffer to be parsed **Parameters** \[in,out] **\_this** this object \[in] **buf** 0-terminated buffer, it will be modified temporarily \[in] **fill** callback function that is called when the end of the buffer is encountered \[in] **fill\_data** parameter for the callback function ### XMLTokenizer\_\_nextToken() enum [XMLTokenizer\_\_Token](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#af1dad427b690336ae7242fcb821b72b5) XMLTokenizer\\\_\\\_nextToken read the next token from the buffer. Temporarily terminate name and value with 0-byte. The next call to nextToken() will revert this modification (and will 0-terminate the next token) **Parameters** \[in,out] **\_this** this object #### Returns Token object containing name and value of the token ### XMLTokenizer\_\_readHeader() enum [XMLTokenizer\_\_Encoding](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#aa5d1bb6cbd537293ccc23cbe090c4256) XMLTokenizer\\\_\\\_readHeader read XML-header and extract the encoding. If no encoding is contained ISO-Latin-9 is assumed **Parameters** \[in,out] **\_this** this object #### Returns encoding ### XMLTokenizer\_\_readToken() enum [XMLTokenizer\_\_Token](/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8h.md#af1dad427b690336ae7242fcb821b72b5) XMLTokenizer\\\_\\\_readToken read one token from the XML-buffer and fill in name/name\_len and value/value\_len **Parameters** \[in,out] **\_this** this object #### Returns Token --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://sandbox-docs.verifone.com/adk-5.0-programmers-guide/readme/files/dir_44d926a17fc606d3c25449ba60427c63/dir_048f823fee1bfb22502a8732b9a001aa/xmldoc_8c.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.