1
0
mirror of https://gitlab.gnome.org/GNOME/libxslt synced 2025-06-15 10:41:43 +03:00
Files
libxslt/doc/html/libxslt-xsltutils.html
Daniel Veillard ca7b104205 releasing 0.13.0 don't index the win32 include rebuilt the docs Daniel
* configure.in doc/xslt.html: releasing 0.13.0
* doc/Makefile.am: don't index the win32 include
* doc/html/*: rebuilt the docs
Daniel
2001-06-26 16:48:50 +00:00

1978 lines
26 KiB
HTML

<HTML
><HEAD
><TITLE
>xsltutils</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.59"><LINK
REL="HOME"
TITLE="Gnome XSLT Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Libxslt Library Reference"
HREF="libxslt-lib.html"><LINK
REL="PREVIOUS"
TITLE="transform"
HREF="libxslt-transform.html"><LINK
REL="NEXT"
TITLE="attributes"
HREF="libxslt-attributes.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="5"
>Gnome XSLT Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="libxslt-transform.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libxslt-lib.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="libxslt-attributes.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="LIBXSLT-XSLTUTILS"
>xsltutils</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN1711"
></A
><H2
>Name</H2
>xsltutils&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN1714"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;
#define <A
HREF="libxslt-xsltutils.html#TODO-CAPS"
>TODO</A
>
#define <A
HREF="libxslt-xsltutils.html#STRANGE-CAPS"
>STRANGE</A
>
#define <A
HREF="libxslt-xsltutils.html#IS-XSLT-ELEM-CAPS"
>IS_XSLT_ELEM</A
> (n)
#define <A
HREF="libxslt-xsltutils.html#IS-XSLT-NAME-CAPS"
>IS_XSLT_NAME</A
> (n, val)
<GTKDOCLINK
HREF="XMLCHAR"
>xmlChar</GTKDOCLINK
>* <A
HREF="libxslt-xsltutils.html#XSLTGETNSPROP"
>xsltGetNsProp</A
> (<GTKDOCLINK
HREF="XMLNODEPTR"
>xmlNodePtr</GTKDOCLINK
> node,
const <GTKDOCLINK
HREF="XMLCHAR"
>xmlChar</GTKDOCLINK
> *name,
const <GTKDOCLINK
HREF="XMLCHAR"
>xmlChar</GTKDOCLINK
> *nameSpace);
extern xmlGenericErrorFunc <A
HREF="libxslt-xsltutils.html#XSLTGENERICERROR"
>xsltGenericError</A
>;
extern void *<A
HREF="libxslt-xsltutils.html#XSLTGENERICERRORCONTEXT"
>xsltGenericErrorContext</A
>;
extern xmlGenericErrorFunc <A
HREF="libxslt-xsltutils.html#XSLTGENERICDEBUG"
>xsltGenericDebug</A
>;
extern void *<A
HREF="libxslt-xsltutils.html#XSLTGENERICDEBUGCONTEXT"
>xsltGenericDebugContext</A
>;
void <A
HREF="libxslt-xsltutils.html#XSLTMESSAGE"
>xsltMessage</A
> (<A
HREF="libxslt-xsltinternals.html#XSLTTRANSFORMCONTEXTPTR"
>xsltTransformContextPtr</A
> ctxt,
<GTKDOCLINK
HREF="XMLNODEPTR"
>xmlNodePtr</GTKDOCLINK
> node,
<GTKDOCLINK
HREF="XMLNODEPTR"
>xmlNodePtr</GTKDOCLINK
> inst);
void <A
HREF="libxslt-xsltutils.html#XSLTSETGENERICERRORFUNC"
>xsltSetGenericErrorFunc</A
> (void *ctx,
<GTKDOCLINK
HREF="XMLGENERICERRORFUNC"
>xmlGenericErrorFunc</GTKDOCLINK
> handler);
void <A
HREF="libxslt-xsltutils.html#XSLTSETGENERICDEBUGFUNC"
>xsltSetGenericDebugFunc</A
> (void *ctx,
<GTKDOCLINK
HREF="XMLGENERICERRORFUNC"
>xmlGenericErrorFunc</GTKDOCLINK
> handler);
void <A
HREF="libxslt-xsltutils.html#XSLTDOCUMENTSORTFUNCTION"
>xsltDocumentSortFunction</A
> (<GTKDOCLINK
HREF="XMLNODESETPTR"
>xmlNodeSetPtr</GTKDOCLINK
> list);
void <A
HREF="libxslt-xsltutils.html#XSLTDOSORTFUNCTION"
>xsltDoSortFunction</A
> (<A
HREF="libxslt-xsltinternals.html#XSLTTRANSFORMCONTEXTPTR"
>xsltTransformContextPtr</A
> ctxt,
<GTKDOCLINK
HREF="XMLNODEPTR"
>xmlNodePtr</GTKDOCLINK
> *sorts,
int nbsorts);
int <A
HREF="libxslt-xsltutils.html#XSLTSAVERESULTTO"
>xsltSaveResultTo</A
> (<GTKDOCLINK
HREF="XMLOUTPUTBUFFERPTR"
>xmlOutputBufferPtr</GTKDOCLINK
> buf,
<GTKDOCLINK
HREF="XMLDOCPTR"
>xmlDocPtr</GTKDOCLINK
> result,
<A
HREF="libxslt-xsltinternals.html#XSLTSTYLESHEETPTR"
>xsltStylesheetPtr</A
> style);
int <A
HREF="libxslt-xsltutils.html#XSLTSAVERESULTTOFILENAME"
>xsltSaveResultToFilename</A
> (const char *URI,
<GTKDOCLINK
HREF="XMLDOCPTR"
>xmlDocPtr</GTKDOCLINK
> result,
<A
HREF="libxslt-xsltinternals.html#XSLTSTYLESHEETPTR"
>xsltStylesheetPtr</A
> style,
int compression);
int <A
HREF="libxslt-xsltutils.html#XSLTSAVERESULTTOFILE"
>xsltSaveResultToFile</A
> (<GTKDOCLINK
HREF="FILE-CAPS"
>FILE</GTKDOCLINK
> *file,
<GTKDOCLINK
HREF="XMLDOCPTR"
>xmlDocPtr</GTKDOCLINK
> result,
<A
HREF="libxslt-xsltinternals.html#XSLTSTYLESHEETPTR"
>xsltStylesheetPtr</A
> style);
int <A
HREF="libxslt-xsltutils.html#XSLTSAVERESULTTOFD"
>xsltSaveResultToFd</A
> (int fd,
<GTKDOCLINK
HREF="XMLDOCPTR"
>xmlDocPtr</GTKDOCLINK
> result,
<A
HREF="libxslt-xsltinternals.html#XSLTSTYLESHEETPTR"
>xsltStylesheetPtr</A
> style);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1757"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1760"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN1762"
></A
><H3
><A
NAME="TODO-CAPS"
></A
>TODO</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define TODO</PRE
></TD
></TR
></TABLE
><P
>macro to flag unimplemented blocks</P
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1768"
></A
><H3
><A
NAME="STRANGE-CAPS"
></A
>STRANGE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define STRANGE</PRE
></TD
></TR
></TABLE
><P
>macro to flag that a problem was detected internally</P
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1774"
></A
><H3
><A
NAME="IS-XSLT-ELEM-CAPS"
></A
>IS_XSLT_ELEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define IS_XSLT_ELEM(n)</PRE
></TD
></TR
></TABLE
><P
>Checks that the element pertains to XSLt namespace</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1780"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>n</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1789"
></A
><H3
><A
NAME="IS-XSLT-NAME-CAPS"
></A
>IS_XSLT_NAME()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define IS_XSLT_NAME(n, val)</PRE
></TD
></TR
></TABLE
><P
>Checks the value of an element in XSLT namespace</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1795"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>n</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>val</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1808"
></A
><H3
><A
NAME="XSLTGETNSPROP"
></A
>xsltGetNsProp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="XMLCHAR"
>xmlChar</GTKDOCLINK
>* xsltGetNsProp (<GTKDOCLINK
HREF="XMLNODEPTR"
>xmlNodePtr</GTKDOCLINK
> node,
const <GTKDOCLINK
HREF="XMLCHAR"
>xmlChar</GTKDOCLINK
> *name,
const <GTKDOCLINK
HREF="XMLCHAR"
>xmlChar</GTKDOCLINK
> *nameSpace);</PRE
></TD
></TR
></TABLE
><P
>Similar to <GTKDOCLINK
HREF="XMLGETNSPROP"
>xmlGetNsProp</GTKDOCLINK
>() but with a slightly different semantic</P
><P
>Search and get the value of an attribute associated to a node
This attribute has to be anchored in the namespace specified,
or has no namespace and the element is in that namespace.</P
><P
>This does the entity substitution.
This function looks in DTD attribute declaration for <GTKDOCLINK
HREF="FIXED-CAPS"
>FIXED</GTKDOCLINK
> or
default declaration values unless DTD use has been turned off.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1822"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>node</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the node</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the attribute name</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>nameSpace</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the URI of the namespace</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the attribute value or NULL if not found.
It's up to the caller to free the memory.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1843"
></A
><H3
><A
NAME="XSLTGENERICERROR"
></A
>xsltGenericError</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>extern xmlGenericErrorFunc xsltGenericError;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1848"
></A
><H3
><A
NAME="XSLTGENERICERRORCONTEXT"
></A
>xsltGenericErrorContext</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>extern void *xsltGenericErrorContext;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1853"
></A
><H3
><A
NAME="XSLTGENERICDEBUG"
></A
>xsltGenericDebug</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>extern xmlGenericErrorFunc xsltGenericDebug;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1858"
></A
><H3
><A
NAME="XSLTGENERICDEBUGCONTEXT"
></A
>xsltGenericDebugContext</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>extern void *xsltGenericDebugContext;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1863"
></A
><H3
><A
NAME="XSLTMESSAGE"
></A
>xsltMessage ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void xsltMessage (<A
HREF="libxslt-xsltinternals.html#XSLTTRANSFORMCONTEXTPTR"
>xsltTransformContextPtr</A
> ctxt,
<GTKDOCLINK
HREF="XMLNODEPTR"
>xmlNodePtr</GTKDOCLINK
> node,
<GTKDOCLINK
HREF="XMLNODEPTR"
>xmlNodePtr</GTKDOCLINK
> inst);</PRE
></TD
></TR
></TABLE
><P
>Process and xsl:message construct</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1872"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ctxt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> an XSLT processing context</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>node</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The current node</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>inst</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The node containing the message instruction</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1889"
></A
><H3
><A
NAME="XSLTSETGENERICERRORFUNC"
></A
>xsltSetGenericErrorFunc ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void xsltSetGenericErrorFunc (void *ctx,
<GTKDOCLINK
HREF="XMLGENERICERRORFUNC"
>xmlGenericErrorFunc</GTKDOCLINK
> handler);</PRE
></TD
></TR
></TABLE
><P
>Function to reset the handler and the error context for out of
context error messages.
This simply means that <TT
CLASS="PARAMETER"
><I
>handler</I
></TT
> will be called for subsequent
error messages while not parsing nor validating. And <TT
CLASS="PARAMETER"
><I
>ctx</I
></TT
> will
be passed as first argument to <TT
CLASS="PARAMETER"
><I
>handler</I
></TT
>
One can simply force messages to be emitted to another FILE * than
stderr by setting <TT
CLASS="PARAMETER"
><I
>ctx</I
></TT
> to this file handle and <TT
CLASS="PARAMETER"
><I
>handler</I
></TT
> to NULL.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1901"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ctx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the new error handling context</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>handler</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the new handler function</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1914"
></A
><H3
><A
NAME="XSLTSETGENERICDEBUGFUNC"
></A
>xsltSetGenericDebugFunc ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void xsltSetGenericDebugFunc (void *ctx,
<GTKDOCLINK
HREF="XMLGENERICERRORFUNC"
>xmlGenericErrorFunc</GTKDOCLINK
> handler);</PRE
></TD
></TR
></TABLE
><P
>Function to reset the handler and the error context for out of
context error messages.
This simply means that <TT
CLASS="PARAMETER"
><I
>handler</I
></TT
> will be called for subsequent
error messages while not parsing nor validating. And <TT
CLASS="PARAMETER"
><I
>ctx</I
></TT
> will
be passed as first argument to <TT
CLASS="PARAMETER"
><I
>handler</I
></TT
>
One can simply force messages to be emitted to another FILE * than
stderr by setting <TT
CLASS="PARAMETER"
><I
>ctx</I
></TT
> to this file handle and <TT
CLASS="PARAMETER"
><I
>handler</I
></TT
> to NULL.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1926"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ctx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the new error handling context</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>handler</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the new handler function</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1939"
></A
><H3
><A
NAME="XSLTDOCUMENTSORTFUNCTION"
></A
>xsltDocumentSortFunction ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void xsltDocumentSortFunction (<GTKDOCLINK
HREF="XMLNODESETPTR"
>xmlNodeSetPtr</GTKDOCLINK
> list);</PRE
></TD
></TR
></TABLE
><P
>reorder the current node list <TT
CLASS="PARAMETER"
><I
>list</I
></TT
> accordingly to the document order</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1947"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the node set</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1956"
></A
><H3
><A
NAME="XSLTDOSORTFUNCTION"
></A
>xsltDoSortFunction ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void xsltDoSortFunction (<A
HREF="libxslt-xsltinternals.html#XSLTTRANSFORMCONTEXTPTR"
>xsltTransformContextPtr</A
> ctxt,
<GTKDOCLINK
HREF="XMLNODEPTR"
>xmlNodePtr</GTKDOCLINK
> *sorts,
int nbsorts);</PRE
></TD
></TR
></TABLE
><P
>reorder the current node list accordingly to the set of sorting
requirement provided by the arry of nodes.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1964"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ctxt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a XSLT process context</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>sorts</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> array of sort nodes</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>nbsorts</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the number of sorts in the array</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1981"
></A
><H3
><A
NAME="XSLTSAVERESULTTO"
></A
>xsltSaveResultTo ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int xsltSaveResultTo (<GTKDOCLINK
HREF="XMLOUTPUTBUFFERPTR"
>xmlOutputBufferPtr</GTKDOCLINK
> buf,
<GTKDOCLINK
HREF="XMLDOCPTR"
>xmlDocPtr</GTKDOCLINK
> result,
<A
HREF="libxslt-xsltinternals.html#XSLTSTYLESHEETPTR"
>xsltStylesheetPtr</A
> style);</PRE
></TD
></TR
></TABLE
><P
>Save the result <TT
CLASS="PARAMETER"
><I
>result</I
></TT
> obtained by applying the <TT
CLASS="PARAMETER"
><I
>style</I
></TT
> stylesheet
to an I/O output channel <TT
CLASS="PARAMETER"
><I
>buf</I
></TT
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1993"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>buf</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> an output buffer</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>result</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the result xmlDocPtr</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>style</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the stylesheet</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the number of byte written or -1 in case of failure.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2014"
></A
><H3
><A
NAME="XSLTSAVERESULTTOFILENAME"
></A
>xsltSaveResultToFilename ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int xsltSaveResultToFilename (const char *URI,
<GTKDOCLINK
HREF="XMLDOCPTR"
>xmlDocPtr</GTKDOCLINK
> result,
<A
HREF="libxslt-xsltinternals.html#XSLTSTYLESHEETPTR"
>xsltStylesheetPtr</A
> style,
int compression);</PRE
></TD
></TR
></TABLE
><P
>Save the result <TT
CLASS="PARAMETER"
><I
>result</I
></TT
> obtained by applying the <TT
CLASS="PARAMETER"
><I
>style</I
></TT
> stylesheet
to a file or URL <TT
CLASS="PARAMETER"
><I
>URL</I
></TT
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2025"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>URI</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>result</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the result xmlDocPtr</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>style</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the stylesheet</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>compression</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the compression factor (0 - 9 included)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the number of byte written or -1 in case of failure.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2050"
></A
><H3
><A
NAME="XSLTSAVERESULTTOFILE"
></A
>xsltSaveResultToFile ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int xsltSaveResultToFile (<GTKDOCLINK
HREF="FILE-CAPS"
>FILE</GTKDOCLINK
> *file,
<GTKDOCLINK
HREF="XMLDOCPTR"
>xmlDocPtr</GTKDOCLINK
> result,
<A
HREF="libxslt-xsltinternals.html#XSLTSTYLESHEETPTR"
>xsltStylesheetPtr</A
> style);</PRE
></TD
></TR
></TABLE
><P
>Save the result <TT
CLASS="PARAMETER"
><I
>result</I
></TT
> obtained by applying the <TT
CLASS="PARAMETER"
><I
>style</I
></TT
> stylesheet
to an open FILE * I/O.
This does not close the FILE <TT
CLASS="PARAMETER"
><I
>file</I
></TT
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2062"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>file</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a FILE * I/O</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>result</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the result xmlDocPtr</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>style</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the stylesheet</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the number of byte written or -1 in case of failure.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2083"
></A
><H3
><A
NAME="XSLTSAVERESULTTOFD"
></A
>xsltSaveResultToFd ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int xsltSaveResultToFd (int fd,
<GTKDOCLINK
HREF="XMLDOCPTR"
>xmlDocPtr</GTKDOCLINK
> result,
<A
HREF="libxslt-xsltinternals.html#XSLTSTYLESHEETPTR"
>xsltStylesheetPtr</A
> style);</PRE
></TD
></TR
></TABLE
><P
>Save the result <TT
CLASS="PARAMETER"
><I
>result</I
></TT
> obtained by applying the <TT
CLASS="PARAMETER"
><I
>style</I
></TT
> stylesheet
to an open file descriptor
This does not close the descriptor.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2093"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fd</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a file descriptor</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>result</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the result xmlDocPtr</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>style</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the stylesheet</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the number of byte written or -1 in case of failure.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="libxslt-transform.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libxslt-lib.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="libxslt-attributes.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>transform</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>attributes</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>