HTMLtree

Name

HTMLtree -- 

Synopsis



#define     HTML_TEXT_NODE
#define     HTML_ENTITY_REF_NODE
#define     HTML_COMMENT_NODE
#define     HTML_PRESERVE_NODE
#define     HTML_PI_NODE
htmlDocPtr  htmlNewDoc                      (const xmlChar *URI,
                                             const xmlChar *ExternalID);
htmlDocPtr  htmlNewDocNoDtD                 (const xmlChar *URI,
                                             const xmlChar *ExternalID);
const xmlChar* htmlGetMetaEncoding          (htmlDocPtr doc);
int         htmlSetMetaEncoding             (htmlDocPtr doc,
                                             const xmlChar *encoding);
void        htmlDocDumpMemory               (xmlDocPtr cur,
                                             xmlChar **mem,
                                             int *size);
int         htmlDocDump                     (FILE *f,
                                             xmlDocPtr cur);
int         htmlSaveFile                    (const char *filename,
                                             xmlDocPtr cur);
void        htmlNodeDump                    (xmlBufferPtr buf,
                                             xmlDocPtr doc,
                                             xmlNodePtr cur);
void        htmlNodeDumpFile                (FILE *out,
                                             xmlDocPtr doc,
                                             xmlNodePtr cur);
int         htmlNodeDumpFileFormat          (FILE *out,
                                             xmlDocPtr doc,
                                             xmlNodePtr cur,
                                             const char *encoding,
                                             int format);
int         htmlSaveFileEnc                 (const char *filename,
                                             xmlDocPtr cur,
                                             const char *encoding);
int         htmlSaveFileFormat              (const char *filename,
                                             xmlDocPtr cur,
                                             const char *encoding,
                                             int format);
void        htmlNodeDumpFormatOutput        (xmlOutputBufferPtr buf,
                                             xmlDocPtr doc,
                                             xmlNodePtr cur,
                                             const char *encoding,
                                             int format);
void        htmlDocContentDumpOutput        (xmlOutputBufferPtr buf,
                                             xmlDocPtr cur,
                                             const char *encoding);
void        htmlDocContentDumpFormatOutput  (xmlOutputBufferPtr buf,
                                             xmlDocPtr cur,
                                             const char *encoding,
                                             int format);

Description

Details

>HTML_TEXT_NODE

#define HTML_TEXT_NODE		XML_TEXT_NODE

Macro, a text node in a HTML document is really implemented the same way as a text node in an XML document.


>HTML_ENTITY_REF_NODE

#define HTML_ENTITY_REF_NODE	XML_ENTITY_REF_NODE

Macro, an entity reference in a HTML document is really implemented the same way as an entity reference in an XML document.


>HTML_COMMENT_NODE

#define HTML_COMMENT_NODE	XML_COMMENT_NODE

Macro, a comment in a HTML document is really implemented the same way as a comment in an XML document.


>HTML_PRESERVE_NODE

#define HTML_PRESERVE_NODE	XML_CDATA_SECTION_NODE

Macro, a preserved node in a HTML document is really implemented the same way as a CDATA section in an XML document.


>HTML_PI_NODE

#define HTML_PI_NODE		XML_PI_NODE

Macro, a processing instruction in a HTML document is really implemented the same way as a processing instruction in an XML document.


>htmlNewDoc ()

htmlDocPtr  htmlNewDoc                      (const xmlChar *URI,
                                             const xmlChar *ExternalID);

Creates a new HTML document

URI : URI for the dtd, or NULL
ExternalID : the external ID of the DTD, or NULL
Returns :a new document


>htmlNewDocNoDtD ()

htmlDocPtr  htmlNewDocNoDtD                 (const xmlChar *URI,
                                             const xmlChar *ExternalID);

Creates a new HTML document without a DTD node if URI and ExternalID are NULL

URI : URI for the dtd, or NULL
ExternalID : the external ID of the DTD, or NULL
Returns :a new document, do not initialize the DTD if not provided


>htmlGetMetaEncoding ()

const xmlChar* htmlGetMetaEncoding          (htmlDocPtr doc);

Encoding definition lookup in the Meta tags

doc : the document
Returns :the current encoding as flagged in the HTML source


>htmlSetMetaEncoding ()

int         htmlSetMetaEncoding             (htmlDocPtr doc,
                                             const xmlChar *encoding);

Sets the current encoding in the Meta tags NOTE: this will not change the document content encoding, just the META flag associated.

doc : the document
encoding : the encoding string
Returns :0 in case of success and -1 in case of error


>htmlDocDumpMemory ()

void        htmlDocDumpMemory               (xmlDocPtr cur,
                                             xmlChar **mem,
                                             int *size);

Dump an HTML document in memory and return the xmlChar * and it's size. It's up to the caller to free the memory.

cur : the document
mem : OUT: the memory pointer
size : OUT: the memory length


>htmlDocDump ()

int         htmlDocDump                     (FILE *f,
                                             xmlDocPtr cur);

Dump an HTML document to an open FILE.

f : the FILE*
cur : the document
Returns : the number of byte written or -1 in case of failure.


>htmlSaveFile ()

int         htmlSaveFile                    (const char *filename,
                                             xmlDocPtr cur);

Dump an HTML document to a file. If filename is "-" the stdout file is used.

filename : the filename (or URL)
cur : the document
Returns : the number of byte written or -1 in case of failure.


>htmlNodeDump ()

void        htmlNodeDump                    (xmlBufferPtr buf,
                                             xmlDocPtr doc,
                                             xmlNodePtr cur);

Dump an HTML node, recursive behaviour,children are printed too, and formatting returns are added.

buf : the HTML buffer output
doc : the document
cur : the current node


>htmlNodeDumpFile ()

void        htmlNodeDumpFile                (FILE *out,
                                             xmlDocPtr doc,
                                             xmlNodePtr cur);

Dump an HTML node, recursive behaviour,children are printed too, and formatting returns are added.

out : the FILE pointer
doc : the document
cur : the current node


>htmlNodeDumpFileFormat ()

int         htmlNodeDumpFileFormat          (FILE *out,
                                             xmlDocPtr doc,
                                             xmlNodePtr cur,
                                             const char *encoding,
                                             int format);

Dump an HTML node, recursive behaviour,children are printed too.

TODO: if encoding == NULL try to save in the doc encoding

out : the FILE pointer
doc : the document
cur : the current node
encoding : the document encoding
format : should formatting spaces been added
Returns : the number of byte written or -1 in case of failure.


>htmlSaveFileEnc ()

int         htmlSaveFileEnc                 (const char *filename,
                                             xmlDocPtr cur,
                                             const char *encoding);

Dump an HTML document to a file using a given encoding and formatting returns/spaces are added.

filename : the filename
cur : the document
encoding : the document encoding
Returns : the number of byte written or -1 in case of failure.


>htmlSaveFileFormat ()

int         htmlSaveFileFormat              (const char *filename,
                                             xmlDocPtr cur,
                                             const char *encoding,
                                             int format);

Dump an HTML document to a file using a given encoding.

filename : the filename
cur : the document
encoding : the document encoding
format : should formatting spaces been added
Returns : the number of byte written or -1 in case of failure.


>htmlNodeDumpFormatOutput ()

void        htmlNodeDumpFormatOutput        (xmlOutputBufferPtr buf,
                                             xmlDocPtr doc,
                                             xmlNodePtr cur,
                                             const char *encoding,
                                             int format);

Dump an HTML node, recursive behaviour,children are printed too.

buf : the HTML buffer output
doc : the document
cur : the current node
encoding : the encoding string
format : should formatting spaces been added


>htmlDocContentDumpOutput ()

void        htmlDocContentDumpOutput        (xmlOutputBufferPtr buf,
                                             xmlDocPtr cur,
                                             const char *encoding);

Dump an HTML document. Formating return/spaces are added.

buf : the HTML buffer output
cur : the document
encoding : the encoding string


>htmlDocContentDumpFormatOutput ()

void        htmlDocContentDumpFormatOutput  (xmlOutputBufferPtr buf,
                                             xmlDocPtr cur,
                                             const char *encoding,
                                             int format);

Dump an HTML document.

buf : the HTML buffer output
cur : the document
encoding : the encoding string
format :