📄 ixml.h
字号:
*
* @return [void] This function does not return a value.
*/
EXPORT_SPEC void
ixmlCDATASection_free(IXML_CDATASection *nodeptr
/** The {\bf CDATASection} node to free. */
);
//@}
/*================================================================
*
* Document interfaces
*
*
*=================================================================*/
/**@name Interface {\it Document}
* The {\bf Document} interface represents the entire XML document.
* In essence, it is the root of the document tree and provides the
* primary interface to the elements of the document. For more information,
* refer to the {\it Interface Document} section in the DOM2Core.
*/
//@{
/** Initializes a {\bf Document} node.
*
* @return [void] This function does not return a value.
*/
EXPORT_SPEC void
ixmlDocument_init(IXML_Document *nodeptr
/** The {\bf Document} node to initialize. */
);
/** Creates a new empty {\bf Document} node. The
* {\bf ixmlDocument_createDocumentEx} API differs from the {\bf
* ixmlDocument_createDocument} API in that it returns an error code
* describing the reason for the failure rather than just {\tt NULL}.
*
* @return [int] An integer representing one of the following:
* \begin{itemize}
* \item {\tt IXML_SUCCESS}: The operation completed successfully.
* \item {\tt IXML_INSUFFICIENT_MEMORY}: Not enough free memory exists
* to complete this operation.
* \end{itemize}
*/
EXPORT_SPEC int ixmlDocument_createDocumentEx(IXML_Document** doc
/** Pointer to a {\bf Document} where the
new object will be stored. */
);
/** Creates a new empty {\bf Document} node.
*
* @return [Document*] A pointer to the new {\bf Document} or {\tt NULL} on
* failure.
*/
EXPORT_SPEC IXML_Document* ixmlDocument_createDocument();
/** Creates a new {\bf Element} node with the given tag name. The new
* {\bf Element} node has a {\tt nodeName} of {\bf tagName} and
* the {\tt localName}, {\tt prefix}, and {\tt namespaceURI} set
* to {\tt NULL}. To create an {\bf Element} with a namespace,
* see {\bf ixmlDocument_createElementNS}.
*
* The {\bf ixmlDocument_createElementEx} API differs from the {\bf
* ixmlDocument_createElement} API in that it returns an error code
* describing the reason for failure rather than just {\tt NULL}.
*
* @return [int] An integer representing one of the following:
* \begin{itemize}
* \item {\tt IXML_SUCCESS}: The operation completed successfully.
* \item {\tt IXML_INVALID_PARAMETER}: Either {\bf doc} or
* {\bf tagName} is {\tt NULL}.
* \item {\tt IXML_INSUFFICIENT_MEMORY}: Not enough free memory exists
* to complete this operation.
* \end{itemize}
*/
EXPORT_SPEC int
ixmlDocument_createElementEx(IXML_Document *doc,
/** The owner {\bf Document} of the new node. */
DOMString tagName,
/** The tag name of the new {\bf Element}
node. */
IXML_Element **rtElement
/** Pointer to an {\bf Element} where the new
object will be stored. */
);
/** Creates a new {\bf Element} node with the given tag name. The new
* {\bf Element} node has a {\tt nodeName} of {\bf tagName} and
* the {\tt localName}, {\tt prefix}, and {\tt namespaceURI} set
* to {\tt NULL}. To create an {\bf Element} with a namespace,
* see {\bf ixmlDocument_createElementNS}.
*
* @return [Document*] A pointer to the new {\bf Element} or {\tt NULL} on
* failure.
*/
EXPORT_SPEC IXML_Element*
ixmlDocument_createElement(IXML_Document *doc,
/** The owner {\bf Document} of the new node. */
DOMString tagName
/** The tag name of the new {\bf Element} node. */
);
/** Creates a new {\bf Text} node with the given data.
* The {\bf ixmlDocument_createTextNodeEx} API differs from the {\bf
* ixmlDocument_createTextNode} API in that it returns an error code
* describing the reason for failure rather than just {\tt NULL}.
*
* @return [int] An integer representing one of the following:
* \begin{itemize}
* \item {\tt IXML_SUCCESS}: The operation completed successfully.
* \item {\tt IXML_INVALID_PARAMETER}: Either {\bf doc} or {\bf data}
* is {\tt NULL}.
* \item {\tt IXML_INSUFFICIENT_MEMORY}: Not enough free memory exists
* to complete this operation.
* \end{itemize}
*/
EXPORT_SPEC int
ixmlDocument_createTextNodeEx(IXML_Document *doc,
/** The owner {\bf Document} of the new node. */
DOMString data,
/** The data to associate with the new {\bf
Text} node. */
IXML_Node** textNode
/** A pointer to a {\bf Node} where the new
object will be stored. */
);
/** Creates a new {\bf Text} node with the given data.
*
* @return [Node*] A pointer to the new {\bf Node} or {\tt NULL} on failure.
*/
EXPORT_SPEC IXML_Node*
ixmlDocument_createTextNode(IXML_Document *doc,
/** The owner {\bf Document} of the new node. */
DOMString data
/** The data to associate with the new {\bf Text}
node. */
);
/** Creates a new {\bf CDATASection} node with given data.
*
* The {\bf ixmlDocument_createCDATASectionEx} API differs from the {\bf
* ixmlDocument_createCDATASection} API in that it returns an error code
* describing the reason for failure rather than just {\tt NULL}.
*
* @return [int] An integer representing one of the following:
* \begin{itemize}
* \item {\tt IXML_SUCCESS}: The operation completed successfully.
* \item {\tt IXML_INVALID_PARAMETER}: Either {\bf doc} or {\bd data}
* is {\tt NULL}.
* \item {\tt IXML_INSUFFICIENT_MEMORY}: Not enough free memory exists
* to complete this operation.
* \end{itemize}
*/
EXPORT_SPEC int
ixmlDocument_createCDATASectionEx(IXML_Document *doc,
/** The owner {\bf Document} of the new
node. */
DOMString data,
/** The data to associate with the new
{\bf CDATASection} node. */
IXML_CDATASection** cdNode
/** A pointer to a {\bf Node} where the
new object will be stored. */
);
/** Creates a new {\bf CDATASection} node with given data.
*
* @return [CDATASection*] A pointer to the new {\bf CDATASection} or
* {\tt NULL} on failure.
*/
EXPORT_SPEC IXML_CDATASection*
ixmlDocument_createCDATASection(IXML_Document *doc,
/** The owner {\bf Document} of the new
node. */
DOMString data
/** The data to associate with the new {\bf
CDATASection} node. */
);
/** Creates a new {\bf Attr} node with the given name.
*
* @return [Attr*] A pointer to the new {\bf Attr} or {\tt NULL} on failure.
*/
EXPORT_SPEC IXML_Attr*
ixmlDocument_createAttribute(IXML_Document *doc,
/** The owner {\bf Document} of the new node. */
char *name
/** The name of the new attribute. */
);
/** Creates a new {\bf Attr} node with the given name.
*
* The {\bf ixmlDocument_createAttributeEx} API differs from the {\bf
* ixmlDocument_createAttribute} API in that it returns an error code
* describing the reason for failure rather than just {\tt NULL}.
*
* @return [int] An integer representing one of the following:
* \begin{itemize}
* \item {\tt IXML_SUCCESS}: The operation completed successfully.
* \item {\tt IXML_INVALID_PARAMETER}: Either {\bf doc} or {\bf name}
* is {\tt NULL}.
* \item {\tt IXML_INSUFFICIENT_MEMORY}: Not enough free memory exists
* to complete this operation.
* \end{itemize}
*/
EXPORT_SPEC int
ixmlDocument_createAttributeEx(IXML_Document *doc,
/** The owner {\bf Document} of the new
node. */
char *name,
/** The name of the new attribute. */
IXML_Attr** attrNode
/** A pointer to a {\bf Attr} where the new
object will be stored. */
);
/** Returns a {\bf NodeList} of all {\bf Elements} that match the given
* tag name in the order in which they were encountered in a preorder
* traversal of the {\bf Document} tree.
*
* @return [NodeList*] A pointer to a {\bf NodeList} containing the
* matching items or {\tt NULL} on an error.
*/
EXPORT_SPEC IXML_NodeList*
ixmlDocument_getElementsByTagName(IXML_Document *doc,
/** The {\bf Document} to search. */
DOMString tagName
/** The tag name to find. */
);
// introduced in DOM level 2
/** Creates a new {\bf Element} node in the given qualified name and
* namespace URI.
*
* The {\bf ixmlDocument_createElementNSEx} API differs from the {\bf
* ixmlDocument_createElementNS} API in that it returns an error code
* describing the reason for failure rather than just {\tt NULL}.
*
* @return [int] An integer representing one of the following:
* \begin{itemize}
* \item {\tt IXML_SUCCESS}: The operation completed successfully.
* \item {\tt IXML_INVALID_PARAMETER}: Either {\bf doc},
* {\bf namespaceURI}, or {\bf qualifiedName} is {\tt NULL}.
* \item {\tt IXML_INSUFFICIENT_MEMORY}: Not enough free memory exists
* to complete this operation.
* \end{itemize}
*/
EXPORT_SPEC int
ixmlDocument_createElementNSEx(IXML_Document *doc,
/** The owner {\bf Document} of the new
node. */
DOMString namespaceURI,
/** The namespace URI for the new {\bf
Element}. */
DOMString qualifiedName,
/** The qualified name of the new {\bf
Element}. */
IXML_Element** rtElement
/** A pointer to an {\bf Element} where the
new object will be stored. */
);
/** Creates a new {\bf Element} node in the given qualified name and
* namespace URI.
*
* @return [Element*] A pointer to the new {\bf Element} or {\tt NULL} on
* failure.
*/
EXPORT_SPEC IXML_Element*
ixmlDocument_createElementNS(IXML_Document *doc,
/** The owner {\bf Document} of the new node. */
DOMString namespaceURI,
/** The namespace URI for the new {\bf
Element}. */
DOMString qualifiedName
/** The qualified name of the new {\bf
Element}. */
);
/** Creates a new {\bf Attr} node with the given qualified name and
* namespace URI.
*
* The {\bf ixmlDocument_createAttributeNSEx} API differs from the {\bf
* ixmlDocument_createAttributeNS} API in that it returns an error code
* describing the reason for failure rather than just {\tt NULL}.
*
* @return [int] An integer representing one of the following:
* \begin{itemize}
* \item {\tt IXML_SUCCESS}: The operation completed successfully.
* \item {\tt IXML_INVALID_PARAMETER}: Either {\bf doc},
* {\bf namespaceURI}, or {\bf qualifiedName} is {\tt NULL}.
* \item {\tt IXML_INSUFFICIENT_MEMORY}: Not enough free memory exists
* to complete this operation.
* \end{itemize}
*/
EXPORT_SPEC int
ixmlDocument_createAttributeNSEx(IXML_Document *doc,
/** The owner {\bf Document} of the new
{\bf Attr}. */
DOMString namespaceURI,
/** The namespace URI for the attribute. */
DOMString qualifiedName,
/** The qualified name of the attribute. */
IXML_Attr** attrNode
/** A pointer to an {\bf Attr} where the
new object will be stored. */
);
/** Creates a new {\bf Attr} node with the given qualified name and
* namespace URI.
*
* @return [Attr*] A pointer to the new {\bf Attr} or {\tt NULL} on failure.
*/
EXPORT_SPEC IXML_Attr*
ixmlDocument_createAttributeNS(IXML_Document *doc,
/** The owner {\bf Document} of the new
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -