2002-03-09 14:13:11 +00:00
< HTML
>< HEAD
>< TITLE
>c14n< /TITLE
>< META
NAME="GENERATOR"
2002-07-06 19:55:14 +00:00
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
2002-03-09 14:13:11 +00:00
">< LINK
REL="HOME"
TITLE="Gnome XML Library Reference Manual"
HREF="book1.html">< LINK
REL="UP"
TITLE="Libxml Library Reference"
HREF="libxml-lib.html">< LINK
REL="PREVIOUS"
TITLE="catalog"
HREF="libxml-catalog.html">< LINK
REL="NEXT"
TITLE="threads"
HREF="libxml-threads.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 XML Library Reference Manual< /FONT
>< /TH
>< /TR
>< TR
>< TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
>< A
HREF="libxml-catalog.html"
>< FONT
COLOR="#FFFFFF"
SIZE="3"
>< B
>< < < 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="libxml-lib.html"
>< FONT
COLOR="#FFFFFF"
SIZE="3"
>< B
>Up< /B
>< /FONT
>< /A
>< /B
>< /FONT
>< /TD
>< TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
>< A
HREF="libxml-threads.html"
>< FONT
COLOR="#FFFFFF"
SIZE="3"
>< B
>Next Page > > > < /B
>< /FONT
>< /A
>< /TD
>< /TR
>< /TABLE
>< /DIV
>< H1
>< A
2002-07-06 19:55:14 +00:00
NAME="LIBXML-C14N">c14n< /H1
2002-03-09 14:13:11 +00:00
>< DIV
CLASS="REFNAMEDIV"
>< A
2002-10-18 11:21:38 +00:00
NAME="AEN20734"
2002-03-09 14:13:11 +00:00
>< /A
>< H2
>Name< /H2
>c14n -- < /DIV
>< DIV
CLASS="REFSYNOPSISDIV"
>< A
2002-10-18 11:21:38 +00:00
NAME="AEN20737">< H2
2002-03-09 14:13:11 +00:00
>Synopsis< /H2
>< TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
>< TR
>< TD
>< PRE
CLASS="SYNOPSIS"
>
int < A
HREF="libxml-c14n.html#XMLC14NDOCSAVETO"
>xmlC14NDocSaveTo< /A
> (< A
HREF="libxml-tree.html#XMLDOCPTR"
>xmlDocPtr< /A
> doc,
< A
HREF="libxml-xpath.html#XMLNODESETPTR"
>xmlNodeSetPtr< /A
> nodes,
int exclusive,
< A
HREF="libxml-tree.html#XMLCHAR"
>xmlChar< /A
> **inclusive_ns_prefixes,
int with_comments,
< A
HREF="libxml-tree.html#XMLOUTPUTBUFFERPTR"
>xmlOutputBufferPtr< /A
> buf);
int < A
HREF="libxml-c14n.html#XMLC14NDOCDUMPMEMORY"
>xmlC14NDocDumpMemory< /A
> (< A
HREF="libxml-tree.html#XMLDOCPTR"
>xmlDocPtr< /A
> doc,
< A
HREF="libxml-xpath.html#XMLNODESETPTR"
>xmlNodeSetPtr< /A
> nodes,
int exclusive,
< A
HREF="libxml-tree.html#XMLCHAR"
>xmlChar< /A
> **inclusive_ns_prefixes,
int with_comments,
< A
HREF="libxml-tree.html#XMLCHAR"
>xmlChar< /A
> **doc_txt_ptr);
int < A
HREF="libxml-c14n.html#XMLC14NDOCSAVE"
>xmlC14NDocSave< /A
> (< A
HREF="libxml-tree.html#XMLDOCPTR"
>xmlDocPtr< /A
> doc,
< A
HREF="libxml-xpath.html#XMLNODESETPTR"
>xmlNodeSetPtr< /A
> nodes,
int exclusive,
< A
HREF="libxml-tree.html#XMLCHAR"
>xmlChar< /A
> **inclusive_ns_prefixes,
int with_comments,
const char *filename,
2002-09-26 12:28:02 +00:00
int compression);
int (< A
HREF="libxml-c14n.html#XMLC14NISVISIBLECALLBACK"
>*xmlC14NIsVisibleCallback< /A
>) (void *user_data,
< A
HREF="libxml-tree.html#XMLNODEPTR"
>xmlNodePtr< /A
> node,
< A
HREF="libxml-tree.html#XMLNODEPTR"
>xmlNodePtr< /A
> parent);
int < A
HREF="libxml-c14n.html#XMLC14NEXECUTE"
>xmlC14NExecute< /A
> (< A
HREF="libxml-tree.html#XMLDOCPTR"
>xmlDocPtr< /A
> doc,
< A
HREF="libxml-c14n.html#XMLC14NISVISIBLECALLBACK"
>xmlC14NIsVisibleCallback< /A
> is_visible_callback,
void *user_data,
int exclusive,
< A
HREF="libxml-tree.html#XMLCHAR"
>xmlChar< /A
> **inclusive_ns_prefixes,
int with_comments,
< A
HREF="libxml-tree.html#XMLOUTPUTBUFFERPTR"
>xmlOutputBufferPtr< /A
> buf);< /PRE
2002-03-09 14:13:11 +00:00
>< /TD
>< /TR
>< /TABLE
>< /DIV
>< DIV
CLASS="REFSECT1"
>< A
2002-10-18 11:21:38 +00:00
NAME="AEN20762"
2002-03-09 14:13:11 +00:00
>< /A
>< H2
>Description< /H2
>< P
>< /P
>< /DIV
>< DIV
CLASS="REFSECT1"
>< A
2002-10-18 11:21:38 +00:00
NAME="AEN20765"
2002-03-09 14:13:11 +00:00
>< /A
>< H2
>Details< /H2
>< DIV
CLASS="REFSECT2"
>< A
2002-10-18 11:21:38 +00:00
NAME="AEN20767"
2002-03-09 14:13:11 +00:00
>< /A
>< H3
>< A
NAME="XMLC14NDOCSAVETO"
>< /A
>xmlC14NDocSaveTo ()< /H3
>< TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
>< TR
>< TD
>< PRE
CLASS="PROGRAMLISTING"
>int xmlC14NDocSaveTo (< A
HREF="libxml-tree.html#XMLDOCPTR"
>xmlDocPtr< /A
> doc,
< A
HREF="libxml-xpath.html#XMLNODESETPTR"
>xmlNodeSetPtr< /A
> nodes,
int exclusive,
< A
HREF="libxml-tree.html#XMLCHAR"
>xmlChar< /A
> **inclusive_ns_prefixes,
int with_comments,
< A
HREF="libxml-tree.html#XMLOUTPUTBUFFERPTR"
>xmlOutputBufferPtr< /A
> buf);< /PRE
>< /TD
>< /TR
>< /TABLE
>< P
>Dumps the canonized image of given XML document into the provided buffer.
For details see "Canonical XML" (http://www.w3.org/TR/xml-c14n) or
"Exclusive XML Canonicalization" (http://www.w3.org/TR/xml-exc-c14n)< /P
>< P
>< /P
>< DIV
CLASS="INFORMALTABLE"
>< A
2002-10-18 11:21:38 +00:00
NAME="AEN20777">< P
2002-03-09 14:13:11 +00:00
>< /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
>doc< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the XML document for canonization< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>nodes< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the nodes set to be included in the canonized image
or NULL if all document nodes should be included< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>exclusive< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the exclusive flag (0 - non-exclusive canonicalization;
otherwise - exclusive canonicalization)< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>inclusive_ns_prefixes< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the list of inclusive namespace prefixes
ended with a NULL or NULL if there is no
inclusive namespaces (only for exclusive
canonicalization, ignored otherwise)< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>with_comments< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> include comments in the result (!=0) or not (==0)< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>buf< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the output buffer to store canonical XML; this
buffer MUST have encoder==NULL because C14N requires
UTF-8 output< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
2002-07-06 19:55:14 +00:00
>< SPAN
CLASS="emphasis"
2002-03-09 14:13:11 +00:00
>< I
CLASS="EMPHASIS"
>Returns< /I
2002-07-06 19:55:14 +00:00
>< /SPAN
2002-03-09 14:13:11 +00:00
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>non-negative value on success or a negative value on fail < /TD
>< /TR
>< /TBODY
>< /TABLE
>< P
>< /P
>< /DIV
>< /DIV
>< HR > < DIV
CLASS="REFSECT2"
>< A
2002-10-18 11:21:38 +00:00
NAME="AEN20810"
2002-03-09 14:13:11 +00:00
>< /A
>< H3
>< A
NAME="XMLC14NDOCDUMPMEMORY"
>< /A
>xmlC14NDocDumpMemory ()< /H3
>< TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
>< TR
>< TD
>< PRE
CLASS="PROGRAMLISTING"
>int xmlC14NDocDumpMemory (< A
HREF="libxml-tree.html#XMLDOCPTR"
>xmlDocPtr< /A
> doc,
< A
HREF="libxml-xpath.html#XMLNODESETPTR"
>xmlNodeSetPtr< /A
> nodes,
int exclusive,
< A
HREF="libxml-tree.html#XMLCHAR"
>xmlChar< /A
> **inclusive_ns_prefixes,
int with_comments,
< A
HREF="libxml-tree.html#XMLCHAR"
>xmlChar< /A
> **doc_txt_ptr);< /PRE
>< /TD
>< /TR
>< /TABLE
>< P
>Dumps the canonized image of given XML document into memory.
For details see "Canonical XML" (http://www.w3.org/TR/xml-c14n) or
"Exclusive XML Canonicalization" (http://www.w3.org/TR/xml-exc-c14n)< /P
>< P
>< /P
>< DIV
CLASS="INFORMALTABLE"
>< A
2002-10-18 11:21:38 +00:00
NAME="AEN20820">< P
2002-03-09 14:13:11 +00:00
>< /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
>doc< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the XML document for canonization< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>nodes< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the nodes set to be included in the canonized image
or NULL if all document nodes should be included< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>exclusive< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the exclusive flag (0 - non-exclusive canonicalization;
otherwise - exclusive canonicalization)< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>inclusive_ns_prefixes< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the list of inclusive namespace prefixes
ended with a NULL or NULL if there is no
inclusive namespaces (only for exclusive
canonicalization, ignored otherwise)< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>with_comments< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> include comments in the result (!=0) or not (==0)< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>doc_txt_ptr< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the memory pointer for allocated canonical XML text;
the caller of this functions is responsible for calling
< A
HREF="libxml-globals.html#XMLFREE"
>xmlFree< /A
>() to free allocated memory < /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
2002-07-06 19:55:14 +00:00
>< SPAN
CLASS="emphasis"
2002-03-09 14:13:11 +00:00
>< I
CLASS="EMPHASIS"
>Returns< /I
2002-07-06 19:55:14 +00:00
>< /SPAN
2002-03-09 14:13:11 +00:00
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the number of bytes written on success or a negative value on fail < /TD
>< /TR
>< /TBODY
>< /TABLE
>< P
>< /P
>< /DIV
>< /DIV
>< HR > < DIV
CLASS="REFSECT2"
>< A
2002-10-18 11:21:38 +00:00
NAME="AEN20854"
2002-03-09 14:13:11 +00:00
>< /A
>< H3
>< A
NAME="XMLC14NDOCSAVE"
>< /A
>xmlC14NDocSave ()< /H3
>< TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
>< TR
>< TD
>< PRE
CLASS="PROGRAMLISTING"
>int xmlC14NDocSave (< A
HREF="libxml-tree.html#XMLDOCPTR"
>xmlDocPtr< /A
> doc,
< A
HREF="libxml-xpath.html#XMLNODESETPTR"
>xmlNodeSetPtr< /A
> nodes,
int exclusive,
< A
HREF="libxml-tree.html#XMLCHAR"
>xmlChar< /A
> **inclusive_ns_prefixes,
int with_comments,
const char *filename,
int compression);< /PRE
>< /TD
>< /TR
>< /TABLE
>< P
>Dumps the canonized image of given XML document into the file.
For details see "Canonical XML" (http://www.w3.org/TR/xml-c14n) or
"Exclusive XML Canonicalization" (http://www.w3.org/TR/xml-exc-c14n)< /P
>< P
>< /P
>< DIV
CLASS="INFORMALTABLE"
>< A
2002-10-18 11:21:38 +00:00
NAME="AEN20863">< P
2002-03-09 14:13:11 +00:00
>< /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
>doc< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the XML document for canonization< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>nodes< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the nodes set to be included in the canonized image
or NULL if all document nodes should be included< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>exclusive< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the exclusive flag (0 - non-exclusive canonicalization;
otherwise - exclusive canonicalization)< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>inclusive_ns_prefixes< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the list of inclusive namespace prefixes
ended with a NULL or NULL if there is no
inclusive namespaces (only for exclusive
canonicalization, ignored otherwise)< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>with_comments< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> include comments in the result (!=0) or not (==0)< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>filename< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the filename to store canonical XML image< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>compression< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the compression level (zlib requred):
-1 - libxml default,
0 - uncompressed,
> 0 - compression level< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
2002-07-06 19:55:14 +00:00
>< SPAN
CLASS="emphasis"
2002-03-09 14:13:11 +00:00
>< I
CLASS="EMPHASIS"
>Returns< /I
2002-07-06 19:55:14 +00:00
>< /SPAN
2002-03-09 14:13:11 +00:00
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the number of bytes written success or a negative value on fail < /TD
>< /TR
>< /TBODY
>< /TABLE
>< P
>< /P
>< /DIV
>< /DIV
2002-09-26 12:28:02 +00:00
>< HR > < DIV
CLASS="REFSECT2"
>< A
2002-10-18 11:21:38 +00:00
NAME="AEN20900"
2002-09-26 12:28:02 +00:00
>< /A
>< H3
>< A
NAME="XMLC14NISVISIBLECALLBACK"
>< /A
>xmlC14NIsVisibleCallback ()< /H3
>< TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
>< TR
>< TD
>< PRE
CLASS="PROGRAMLISTING"
>int (*xmlC14NIsVisibleCallback) (void *user_data,
< A
HREF="libxml-tree.html#XMLNODEPTR"
>xmlNodePtr< /A
> node,
< A
HREF="libxml-tree.html#XMLNODEPTR"
>xmlNodePtr< /A
> parent);< /PRE
>< /TD
>< /TR
>< /TABLE
>< P
>< /P
>< DIV
CLASS="INFORMALTABLE"
>< A
2002-10-18 11:21:38 +00:00
NAME="AEN20907">< P
2002-09-26 12:28:02 +00:00
>< /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
>user_data< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> < /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>node< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> < /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>parent< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> < /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< SPAN
CLASS="emphasis"
>< I
CLASS="EMPHASIS"
>Returns< /I
>< /SPAN
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> < /TD
>< /TR
>< /TBODY
>< /TABLE
>< P
>< /P
>< /DIV
>< /DIV
>< HR > < DIV
CLASS="REFSECT2"
>< A
2002-10-18 11:21:38 +00:00
NAME="AEN20928"
2002-09-26 12:28:02 +00:00
>< /A
>< H3
>< A
NAME="XMLC14NEXECUTE"
>< /A
>xmlC14NExecute ()< /H3
>< TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
>< TR
>< TD
>< PRE
CLASS="PROGRAMLISTING"
>int xmlC14NExecute (< A
HREF="libxml-tree.html#XMLDOCPTR"
>xmlDocPtr< /A
> doc,
< A
HREF="libxml-c14n.html#XMLC14NISVISIBLECALLBACK"
>xmlC14NIsVisibleCallback< /A
> is_visible_callback,
void *user_data,
int exclusive,
< A
HREF="libxml-tree.html#XMLCHAR"
>xmlChar< /A
> **inclusive_ns_prefixes,
int with_comments,
< A
HREF="libxml-tree.html#XMLOUTPUTBUFFERPTR"
>xmlOutputBufferPtr< /A
> buf);< /PRE
>< /TD
>< /TR
>< /TABLE
>< P
>Dumps the canonized image of given XML document into the provided buffer.
For details see "Canonical XML" (http://www.w3.org/TR/xml-c14n) or
"Exclusive XML Canonicalization" (http://www.w3.org/TR/xml-exc-c14n)< /P
>< P
>< /P
>< DIV
CLASS="INFORMALTABLE"
>< A
2002-10-18 11:21:38 +00:00
NAME="AEN20938">< P
2002-09-26 12:28:02 +00:00
>< /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
>doc< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the XML document for canonization< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>is_visible_callback< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the function to use to determine is node visible
or not< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>user_data< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the first parameter for < TT
CLASS="PARAMETER"
>< I
>is_visible_callback< /I
>< /TT
> function
(in most cases, it is nodes set)< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>exclusive< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the exclusive flag (0 - non-exclusive canonicalization;
otherwise - exclusive canonicalization)< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>inclusive_ns_prefixes< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the list of inclusive namespace prefixes
ended with a NULL or NULL if there is no
inclusive namespaces (only for exclusive
canonicalization, ignored otherwise)< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>with_comments< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> include comments in the result (!=0) or not (==0)< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< TT
CLASS="PARAMETER"
>< I
>buf< /I
>< /TT
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the output buffer to store canonical XML; this
buffer MUST have encoder==NULL because C14N requires
UTF-8 output< /TD
>< /TR
>< TR
>< TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
>< SPAN
CLASS="emphasis"
>< I
CLASS="EMPHASIS"
>Returns< /I
>< /SPAN
> :< /TD
>< TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>non-negative value on success or a negative value on fail < /TD
>< /TR
>< /TBODY
>< /TABLE
>< P
>< /P
>< /DIV
>< /DIV
2002-03-09 14:13:11 +00:00
>< /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="libxml-catalog.html"
>< FONT
COLOR="#FFFFFF"
SIZE="3"
>< B
>< < < 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="libxml-lib.html"
>< FONT
COLOR="#FFFFFF"
SIZE="3"
>< B
>Up< /B
>< /FONT
>< /A
>< /B
>< /FONT
>< /TD
>< TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
>< A
HREF="libxml-threads.html"
>< FONT
COLOR="#FFFFFF"
SIZE="3"
>< B
>Next Page > > > < /B
>< /FONT
>< /A
>< /TD
>< /TR
>< TR
>< TD
COLSPAN="2"
ALIGN="left"
>< FONT
COLOR="#FFFFFF"
SIZE="3"
>< B
>catalog< /B
>< /FONT
>< /TD
>< TD
COLSPAN="2"
ALIGN="right"
>< FONT
COLOR="#FFFFFF"
SIZE="3"
>< B
>threads< /B
>< /FONT
>< /TD
>< /TR
>< /TABLE
>< /DIV
>< /BODY
>< /HTML
>
