![]() | ![]() | ![]() | Gnome XSLT Library Reference Manual | ![]() |
---|
transform —
void xsltSetXIncludeDefault (int xinclude); int xsltGetXIncludeDefault (void); xsltTransformContextPtr xsltNewTransformContext (xsltStylesheetPtr style,xmlDocPtr doc); void xsltFreeTransformContext (xsltTransformContextPtr ctxt);xmlDocPtr xsltApplyStylesheetUser (xsltStylesheetPtr style,xmlDocPtr doc, const char **params, const char *output,FILE *profile, xsltTransformContextPtr userCtxt); void xsltApplyStripSpaces (xsltTransformContextPtr ctxt,xmlNodePtr node);xmlDocPtr xsltApplyStylesheet (xsltStylesheetPtr style,xmlDocPtr doc, const char **params);xmlDocPtr xsltProfileStylesheet (xsltStylesheetPtr style,xmlDocPtr doc, const char **params,FILE *output); int xsltRunStylesheet (xsltStylesheetPtr style,xmlDocPtr doc, const char **params, const char *output,xmlSAXHandlerPtr SAX,xmlOutputBufferPtr IObuf); int xsltRunStylesheetUser (xsltStylesheetPtr style,xmlDocPtr doc, const char **params, const char *output,xmlSAXHandlerPtr SAX,xmlOutputBufferPtr IObuf,FILE *profile, xsltTransformContextPtr userCtxt); void xsltApplyOneTemplate (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr list, xsltTemplatePtr templ, xsltStackElemPtr params); void xsltDocumentElem (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltSort (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltCopy (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltText (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltElement (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltComment (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltAttribute (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltProcessingInstruction (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltCopyOf (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltValueOf (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltNumber (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltApplyImports (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltCallTemplate (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltApplyTemplates (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltChoose (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltIf (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltForEach (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp); void xsltRegisterAllElement (xsltTransformContextPtr ctxt);xmlNodePtr xsltCopyTextString (xsltTransformContextPtr ctxt,xmlNodePtr target, constxmlChar *string, int noescape); void xslHandleDebugger (xmlNodePtr cur,xmlNodePtr node, xsltTemplatePtr templ, xsltTransformContextPtr ctxt);
void xsltSetXIncludeDefault (int xinclude);
Set whether XInclude should be processed on document being loaded by default
xinclude : | whether to do XInclude processing |
int xsltGetXIncludeDefault (void);
Provides the default state for XInclude processing
Returns : | 0 if there is no processing 1 otherwise |
xsltTransformContextPtr xsltNewTransformContext (xsltStylesheetPtr style,xmlDocPtr doc);
Create a new XSLT TransformContext
style : | a parsed XSLT stylesheet |
doc : | the input document |
Returns : | the newly allocated xsltTransformContextPtr or NULL in case of error |
void xsltFreeTransformContext (xsltTransformContextPtr ctxt);
Free up the memory allocated by ctxt
ctxt : | an XSLT parser context |
xmlDocPtr xsltApplyStylesheetUser (xsltStylesheetPtr style,xmlDocPtr doc, const char **params, const char *output,FILE *profile, xsltTransformContextPtr userCtxt);
Apply the stylesheet to the document and allow the user to provide its own transformation context.
style : | a parsed XSLT stylesheet |
doc : | a parsed XML document |
params : | a NULL terminated arry of parameters names/values tuples |
output : | the targetted output |
profile : | profile FILE * output or NULL |
userCtxt : | user provided transform context |
Returns : | the result document or NULL in case of error |
void xsltApplyStripSpaces (xsltTransformContextPtr ctxt,xmlNodePtr node);
Strip the unwanted ignorable spaces from the input tree
ctxt : | a XSLT process context |
node : | the root of the XML tree |
xmlDocPtr xsltApplyStylesheet (xsltStylesheetPtr style,xmlDocPtr doc, const char **params);
Apply the stylesheet to the document NOTE: This may lead to a non-wellformed output XML wise !
style : | a parsed XSLT stylesheet |
doc : | a parsed XML document |
params : | a NULL terminated arry of parameters names/values tuples |
Returns : | the result document or NULL in case of error |
xmlDocPtr xsltProfileStylesheet (xsltStylesheetPtr style,xmlDocPtr doc, const char **params,FILE *output);
Apply the stylesheet to the document and dump the profiling to the given output.
style : | a parsed XSLT stylesheet |
doc : | a parsed XML document |
params : | a NULL terminated arry of parameters names/values tuples |
output : | a FILE * for the profiling output |
Returns : | the result document or NULL in case of error |
int xsltRunStylesheet (xsltStylesheetPtr style,xmlDocPtr doc, const char **params, const char *output,xmlSAXHandlerPtr SAX,xmlOutputBufferPtr IObuf);
Apply the stylesheet to the document and generate the output according to output SAX and IObuf. It's an error to specify both SAX and IObuf.
NOTE: This may lead to a non-wellformed output XML wise ! NOTE: This may also result in multiple files being generated NOTE: using IObuf, the result encoding used will be the one used for creating the output buffer, use the following macro to read it from the stylesheet XSLT_GET_IMPORT_PTR(encoding, style, encoding) NOTE: using SAX, any encoding specified in the stylesheet will be lost since the interface uses only UTF8
style : | a parsed XSLT stylesheet |
doc : | a parsed XML document |
params : | a NULL terminated arry of parameters names/values tuples |
output : | the URL/filename ot the generated resource if available |
SAX : | a SAX handler for progressive callback output (not implemented yet) |
IObuf : | an output buffer for progressive output (not implemented yet) |
Returns : | the number of by written to the main resource or -1 in case of error. |
int xsltRunStylesheetUser (xsltStylesheetPtr style,xmlDocPtr doc, const char **params, const char *output,xmlSAXHandlerPtr SAX,xmlOutputBufferPtr IObuf,FILE *profile, xsltTransformContextPtr userCtxt);
Apply the stylesheet to the document and generate the output according to output SAX and IObuf. It's an error to specify both SAX and IObuf.
NOTE: This may lead to a non-wellformed output XML wise ! NOTE: This may also result in multiple files being generated NOTE: using IObuf, the result encoding used will be the one used for creating the output buffer, use the following macro to read it from the stylesheet XSLT_GET_IMPORT_PTR(encoding, style, encoding) NOTE: using SAX, any encoding specified in the stylesheet will be lost since the interface uses only UTF8
style : | a parsed XSLT stylesheet |
doc : | a parsed XML document |
params : | a NULL terminated arry of parameters names/values tuples |
output : | the URL/filename ot the generated resource if available |
SAX : | a SAX handler for progressive callback output (not implemented yet) |
IObuf : | an output buffer for progressive output (not implemented yet) |
profile : | profile FILE * output or NULL |
userCtxt : | user provided transform context |
Returns : | the number of by written to the main resource or -1 in case of error. |
void xsltApplyOneTemplate (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr list, xsltTemplatePtr templ, xsltStackElemPtr params);
Process the apply-templates node on the source node, if params are passed they are pushed on the variable stack but not popped, it's left to the caller to handle them back (they may be reused).
ctxt : | a XSLT process context |
node : | the node in the source tree. |
list : | the template replacement nodelist |
templ : | if is this a real template processing, the template processed |
params : | a set of parameters for the template or NULL |
void xsltDocumentElem (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process an EXSLT/XSLT-1.1 document element
ctxt : | an XSLT processing context |
node : | The current node |
inst : | the instruction in the stylesheet |
comp : | precomputed information |
void xsltSort (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
function attached to xsl:sort nodes, but this should not be called directly
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the xslt sort node |
comp : | precomputed information |
void xsltCopy (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process the xslt copy node on the source node
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the xslt copy node |
comp : | precomputed information |
void xsltText (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process the xslt text node on the source node
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the xslt text node |
comp : | precomputed information |
void xsltElement (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process the xslt element node on the source node
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the xslt element node |
comp : | precomputed information |
void xsltComment (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process the xslt comment node on the source node
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the xslt comment node |
comp : | precomputed information |
void xsltAttribute (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process the xslt attribute node on the source node
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the xslt attribute node |
comp : | precomputed information |
void xsltProcessingInstruction (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process the xslt processing-instruction node on the source node
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the xslt processing-instruction node |
comp : | precomputed information |
void xsltCopyOf (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process the xslt copy-of node on the source node
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the xslt copy-of node |
comp : | precomputed information |
void xsltValueOf (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process the xslt value-of node on the source node
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the xslt value-of node |
comp : | precomputed information |
void xsltNumber (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process the xslt number node on the source node
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the xslt number node |
comp : | precomputed information |
void xsltApplyImports (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process the xslt apply-imports node on the source node
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the xslt apply-imports node |
comp : | precomputed information |
void xsltCallTemplate (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process the xslt call-template node on the source node
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the xslt call-template node |
comp : | precomputed information |
void xsltApplyTemplates (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process the apply-templates node on the source node
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the apply-templates node |
comp : | precomputed information |
void xsltChoose (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process the xslt choose node on the source node
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the xslt choose node |
comp : | precomputed information |
void xsltIf (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process the xslt if node on the source node
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the xslt if node |
comp : | precomputed information |
void xsltForEach (xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst, xsltStylePreCompPtr comp);
Process the xslt for-each node on the source node
ctxt : | a XSLT process context |
node : | the node in the source tree. |
inst : | the xslt for-each node |
comp : | precomputed information |
void xsltRegisterAllElement (xsltTransformContextPtr ctxt);
Registers all default XSLT elements in this context
ctxt : | the XPath context |
xmlNodePtr xsltCopyTextString (xsltTransformContextPtr ctxt,xmlNodePtr target, constxmlChar *string, int noescape);
Create a text node
ctxt : | a XSLT process context |
target : | the element where the text will be attached |
string : | the text string |
noescape : | should disable-escaping be activated for this text node. |
Returns : | a new xmlNodePtr, or NULL in case of error. |
void xslHandleDebugger (xmlNodePtr cur,xmlNodePtr node, xsltTemplatePtr templ, xsltTransformContextPtr ctxt);
If either cur or node are a breakpoint, or xslDebugStatus in state where debugging must occcur at this time then transfer control to the xslDebugBreak function
cur : | source node being executed |
node : | data node being processed |
templ : | temlate that applies to node |
ctxt : | the xslt transform context |
<< templates | xsltutils >> |