# ## Module xinclude from libxml2

API Menu
Main Menu Developer Menu Code Examples API Menu Parser API Tree API Reader API XML Guidelines ChangeLog
API Indexes
Alphabetic Constructors Functions/Types Modules Symbols
Related links
Mail archive XSLT libxslt DOM gdome2 XML-DSig xmlsec FTP Windows binaries Solaris binaries MacOsX binaries lxml Python bindings Perl bindings C++ bindings PHP bindings Pascal bindings Ruby bindings Tcl bindings Bug Tracker
API to handle XInclude processing, implements the World Wide Web Consortium Last Call Working Draft 10 November 2003 ## Table of Contents
    #define XINCLUDE_FALLBACK
    #define XINCLUDE_HREF
    #define XINCLUDE_NODE
    #define XINCLUDE_NS
    #define XINCLUDE_OLD_NS
    #define XINCLUDE_PARSE
    #define XINCLUDE_PARSE_ENCODING
    #define XINCLUDE_PARSE_TEXT
    #define XINCLUDE_PARSE_XML
    #define XINCLUDE_PARSE_XPOINTER
    Structure xmlXIncludeCtxt
    struct _xmlXIncludeCtxt
    The content of this structure is not made public by the API.
    Typedef xmlXIncludeCtxt * xmlXIncludeCtxtPtr
    void	xmlXIncludeFreeContext		(xmlXIncludeCtxtPtr ctxt)
    xmlXIncludeCtxtPtr	xmlXIncludeNewContext	(xmlDocPtr doc)
    int	xmlXIncludeProcess		(xmlDocPtr doc)
    int	xmlXIncludeProcessFlags		(xmlDocPtr doc,
    					 int flags)
    int	xmlXIncludeProcessFlagsData	(xmlDocPtr doc,
    					 int flags,
    					 void * data)
    int	xmlXIncludeProcessNode		(xmlXIncludeCtxtPtr ctxt,
    					 xmlNodePtr node)
    int	xmlXIncludeProcessTree		(xmlNodePtr tree)
    int	xmlXIncludeProcessTreeFlags	(xmlNodePtr tree,
    					 int flags)
    int	xmlXIncludeProcessTreeFlagsData	(xmlNodePtr tree,
    					 int flags,
    					 void * data)
    int	xmlXIncludeSetFlags		(xmlXIncludeCtxtPtr ctxt,
    					 int flags)
## Description ### Macro: XINCLUDE_FALLBACK
    #define XINCLUDE_FALLBACK
Macro defining "fallback" ### Macro: XINCLUDE_HREF
    #define XINCLUDE_HREF
Macro defining "href" ### Macro: XINCLUDE_NODE
    #define XINCLUDE_NODE
Macro defining "include" ### Macro: XINCLUDE_NS
    #define XINCLUDE_NS
Macro defining the Xinclude namespace: http://www.w3.org/2003/XInclude ### Macro: XINCLUDE_OLD_NS
    #define XINCLUDE_OLD_NS
Macro defining the draft Xinclude namespace: http://www.w3.org/2001/XInclude ### Macro: XINCLUDE_PARSE
    #define XINCLUDE_PARSE
Macro defining "parse" ### Macro: XINCLUDE_PARSE_ENCODING
    #define XINCLUDE_PARSE_ENCODING
Macro defining "encoding" ### Macro: XINCLUDE_PARSE_TEXT
    #define XINCLUDE_PARSE_TEXT
Macro defining "text" ### Macro: XINCLUDE_PARSE_XML
    #define XINCLUDE_PARSE_XML
Macro defining "xml" ### Macro: XINCLUDE_PARSE_XPOINTER
    #define XINCLUDE_PARSE_XPOINTER
Macro defining "xpointer" ### Structure xmlXIncludeCtxt
    Structure xmlXIncludeCtxt
    struct _xmlXIncludeCtxt {
    The content of this structure is not made public by the API.
    }
### Function: xmlXIncludeFreeContext
    void	xmlXIncludeFreeContext		(xmlXIncludeCtxtPtr ctxt)
Free an XInclude context
`ctxt`: | the XInclude context
### Function: xmlXIncludeNewContext
    xmlXIncludeCtxtPtr	xmlXIncludeNewContext	(xmlDocPtr doc)
Creates a new XInclude context
`doc`: | an XML Document
`Returns`: | the new set
### Function: xmlXIncludeProcess
    int	xmlXIncludeProcess		(xmlDocPtr doc)
Implement the XInclude substitution on the XML document @doc
`doc`: | an XML document
`Returns`: | 0 if no substitution were done, -1 if some processing failed or the number of substitutions done.
### Function: xmlXIncludeProcessFlags
    int	xmlXIncludeProcessFlags		(xmlDocPtr doc,
    					 int flags)
Implement the XInclude substitution on the XML document @doc
`doc`: | an XML document
`flags`: | a set of xmlParserOption used for parsing XML includes
`Returns`: | 0 if no substitution were done, -1 if some processing failed or the number of substitutions done.
### Function: xmlXIncludeProcessFlagsData
    int	xmlXIncludeProcessFlagsData	(xmlDocPtr doc,
    					 int flags,
    					 void * data)
Implement the XInclude substitution on the XML document @doc
`doc`: | an XML document
`flags`: | a set of xmlParserOption used for parsing XML includes
`data`: | application data that will be passed to the parser context in the _private field of the parser context(s)
`Returns`: | 0 if no substitution were done, -1 if some processing failed or the number of substitutions done.
### Function: xmlXIncludeProcessNode
    int	xmlXIncludeProcessNode		(xmlXIncludeCtxtPtr ctxt,
    					 xmlNodePtr node)
Implement the XInclude substitution for the given subtree reusing the information and data coming from the given context.
`ctxt`: | an existing XInclude context
`node`: | a node in an XML document
`Returns`: | 0 if no substitution were done, -1 if some processing failed or the number of substitutions done.
### Function: xmlXIncludeProcessTree
    int	xmlXIncludeProcessTree		(xmlNodePtr tree)
Implement the XInclude substitution for the given subtree
`tree`: | a node in an XML document
`Returns`: | 0 if no substitution were done, -1 if some processing failed or the number of substitutions done.
### Function: xmlXIncludeProcessTreeFlags
    int	xmlXIncludeProcessTreeFlags	(xmlNodePtr tree,
    					 int flags)
Implement the XInclude substitution for the given subtree
`tree`: | a node in an XML document
`flags`: | a set of xmlParserOption used for parsing XML includes
`Returns`: | 0 if no substitution were done, -1 if some processing failed or the number of substitutions done.
### Function: xmlXIncludeProcessTreeFlagsData
    int	xmlXIncludeProcessTreeFlagsData	(xmlNodePtr tree,
    					 int flags,
    					 void * data)
Implement the XInclude substitution on the XML node @tree
`tree`: | an XML node
`flags`: | a set of xmlParserOption used for parsing XML includes
`data`: | application data that will be passed to the parser context in the _private field of the parser context(s)
`Returns`: | 0 if no substitution were done, -1 if some processing failed or the number of substitutions done.
### Function: xmlXIncludeSetFlags
    int	xmlXIncludeSetFlags		(xmlXIncludeCtxtPtr ctxt,
    					 int flags)
Set the flags used for further processing of XML resources.
`ctxt`: | an XInclude processing context
`flags`: | a set of xmlParserOption used for parsing XML includes
`Returns`: | 0 in case of success and -1 in case of error.
Daniel Veillard