Don't preload rarely seen large images
[chromium-blink-merge.git] / third_party / libxml / src / DOCBparser.c
blobf12511b9e8acb4a27be23396c0b6cd7a2f8d9f74
1 /*
2 * DOCBparser.c : an attempt to parse SGML Docbook documents
4 * This is deprecated !!!
5 * Code removed with release 2.6.0 it was broken.
6 * The doc are expect to be migrated to XML DocBook
8 * See Copyright for the status of this software.
10 * daniel@veillard.com
13 #define IN_LIBXML
14 #include "libxml.h"
15 #ifdef LIBXML_DOCB_ENABLED
17 #include <libxml/xmlerror.h>
18 #include <libxml/DOCBparser.h>
20 /**
21 * docbEncodeEntities:
22 * @out: a pointer to an array of bytes to store the result
23 * @outlen: the length of @out
24 * @in: a pointer to an array of UTF-8 chars
25 * @inlen: the length of @in
26 * @quoteChar: the quote character to escape (' or ") or zero.
28 * Take a block of UTF-8 chars in and try to convert it to an ASCII
29 * plus SGML entities block of chars out.
31 * Returns 0 if success, -2 if the transcoding fails, or -1 otherwise
32 * The value of @inlen after return is the number of octets consumed
33 * as the return value is positive, else unpredictable.
34 * The value of @outlen after return is the number of octets consumed.
36 int
37 docbEncodeEntities(unsigned char *out ATTRIBUTE_UNUSED,
38 int *outlen ATTRIBUTE_UNUSED,
39 const unsigned char *in ATTRIBUTE_UNUSED,
40 int *inlen ATTRIBUTE_UNUSED,
41 int quoteChar ATTRIBUTE_UNUSED)
43 static int deprecated = 0;
45 if (!deprecated) {
46 xmlGenericError(xmlGenericErrorContext,
47 "docbEncodeEntities() deprecated function reached\n");
48 deprecated = 1;
50 return(-1);
53 /**
54 * docbParseDocument:
55 * @ctxt: an SGML parser context
57 * parse an SGML document (and build a tree if using the standard SAX
58 * interface).
60 * Returns 0, -1 in case of error. the parser context is augmented
61 * as a result of the parsing.
64 int
65 docbParseDocument(docbParserCtxtPtr ctxt ATTRIBUTE_UNUSED)
67 static int deprecated = 0;
69 if (!deprecated) {
70 xmlGenericError(xmlGenericErrorContext,
71 "docbParseDocument() deprecated function reached\n");
72 deprecated = 1;
74 return (xmlParseDocument(ctxt));
77 /**
78 * docbFreeParserCtxt:
79 * @ctxt: an SGML parser context
81 * Free all the memory used by a parser context. However the parsed
82 * document in ctxt->myDoc is not freed.
85 void
86 docbFreeParserCtxt(docbParserCtxtPtr ctxt ATTRIBUTE_UNUSED)
88 static int deprecated = 0;
90 if (!deprecated) {
91 xmlGenericError(xmlGenericErrorContext,
92 "docbFreeParserCtxt() deprecated function reached\n");
93 deprecated = 1;
95 xmlFreeParserCtxt(ctxt);
98 /**
99 * docbParseChunk:
100 * @ctxt: an XML parser context
101 * @chunk: an char array
102 * @size: the size in byte of the chunk
103 * @terminate: last chunk indicator
105 * Parse a Chunk of memory
107 * Returns zero if no error, the xmlParserErrors otherwise.
110 docbParseChunk(docbParserCtxtPtr ctxt ATTRIBUTE_UNUSED,
111 const char *chunk ATTRIBUTE_UNUSED,
112 int size ATTRIBUTE_UNUSED,
113 int terminate ATTRIBUTE_UNUSED)
115 static int deprecated = 0;
117 if (!deprecated) {
118 xmlGenericError(xmlGenericErrorContext,
119 "docbParseChunk() deprecated function reached\n");
120 deprecated = 1;
123 return (xmlParseChunk(ctxt, chunk, size, terminate));
127 * docbCreatePushParserCtxt:
128 * @sax: a SAX handler
129 * @user_data: The user data returned on SAX callbacks
130 * @chunk: a pointer to an array of chars
131 * @size: number of chars in the array
132 * @filename: an optional file name or URI
133 * @enc: an optional encoding
135 * Create a parser context for using the DocBook SGML parser in push mode
136 * To allow content encoding detection, @size should be >= 4
137 * The value of @filename is used for fetching external entities
138 * and error/warning reports.
140 * Returns the new parser context or NULL
142 docbParserCtxtPtr
143 docbCreatePushParserCtxt(docbSAXHandlerPtr sax ATTRIBUTE_UNUSED,
144 void *user_data ATTRIBUTE_UNUSED,
145 const char *chunk ATTRIBUTE_UNUSED,
146 int size ATTRIBUTE_UNUSED,
147 const char *filename ATTRIBUTE_UNUSED,
148 xmlCharEncoding enc ATTRIBUTE_UNUSED)
150 static int deprecated = 0;
152 if (!deprecated) {
153 xmlGenericError(xmlGenericErrorContext,
154 "docbParseChunk() deprecated function reached\n");
155 deprecated = 1;
158 return(xmlCreatePushParserCtxt(sax, user_data, chunk, size, filename));
162 * docbSAXParseDoc:
163 * @cur: a pointer to an array of xmlChar
164 * @encoding: a free form C string describing the SGML document encoding, or NULL
165 * @sax: the SAX handler block
166 * @userData: if using SAX, this pointer will be provided on callbacks.
168 * parse an SGML in-memory document and build a tree.
169 * It use the given SAX function block to handle the parsing callback.
170 * If sax is NULL, fallback to the default DOM tree building routines.
172 * Returns the resulting document tree
175 docbDocPtr
176 docbSAXParseDoc(xmlChar * cur ATTRIBUTE_UNUSED,
177 const char *encoding ATTRIBUTE_UNUSED,
178 docbSAXHandlerPtr sax ATTRIBUTE_UNUSED,
179 void *userData ATTRIBUTE_UNUSED)
181 static int deprecated = 0;
183 if (!deprecated) {
184 xmlGenericError(xmlGenericErrorContext,
185 "docbParseChunk() deprecated function reached\n");
186 deprecated = 1;
189 return (xmlSAXParseMemoryWithData(sax, (const char *)cur,
190 xmlStrlen((const xmlChar *) cur), 0, userData));
194 * docbParseDoc:
195 * @cur: a pointer to an array of xmlChar
196 * @encoding: a free form C string describing the SGML document encoding, or NULL
198 * parse an SGML in-memory document and build a tree.
200 * Returns the resulting document tree
203 docbDocPtr
204 docbParseDoc(xmlChar * cur ATTRIBUTE_UNUSED,
205 const char *encoding ATTRIBUTE_UNUSED)
207 static int deprecated = 0;
209 if (!deprecated) {
210 xmlGenericError(xmlGenericErrorContext,
211 "docbParseChunk() deprecated function reached\n");
212 deprecated = 1;
215 return (xmlParseDoc(cur));
220 * docbCreateFileParserCtxt:
221 * @filename: the filename
222 * @encoding: the SGML document encoding, or NULL
224 * Create a parser context for a file content.
225 * Automatic support for ZLIB/Compress compressed document is provided
226 * by default if found at compile-time.
228 * Returns the new parser context or NULL
230 docbParserCtxtPtr
231 docbCreateFileParserCtxt(const char *filename ATTRIBUTE_UNUSED,
232 const char *encoding ATTRIBUTE_UNUSED)
234 static int deprecated = 0;
236 if (!deprecated) {
237 xmlGenericError(xmlGenericErrorContext,
238 "docbCreateFileParserCtxt() deprecated function reached\n");
239 deprecated = 1;
242 return (xmlCreateFileParserCtxt(filename));
246 * docbSAXParseFile:
247 * @filename: the filename
248 * @encoding: a free form C string describing the SGML document encoding, or NULL
249 * @sax: the SAX handler block
250 * @userData: if using SAX, this pointer will be provided on callbacks.
252 * parse an SGML file and build a tree. Automatic support for ZLIB/Compress
253 * compressed document is provided by default if found at compile-time.
254 * It use the given SAX function block to handle the parsing callback.
255 * If sax is NULL, fallback to the default DOM tree building routines.
257 * Returns the resulting document tree
260 docbDocPtr
261 docbSAXParseFile(const char *filename ATTRIBUTE_UNUSED,
262 const char *encoding ATTRIBUTE_UNUSED,
263 docbSAXHandlerPtr sax ATTRIBUTE_UNUSED,
264 void *userData ATTRIBUTE_UNUSED)
266 static int deprecated = 0;
268 if (!deprecated) {
269 xmlGenericError(xmlGenericErrorContext,
270 "docbSAXParseFile() deprecated function reached\n");
271 deprecated = 1;
274 return (xmlSAXParseFileWithData(sax, filename, 0, userData));
278 * docbParseFile:
279 * @filename: the filename
280 * @encoding: a free form C string describing document encoding, or NULL
282 * parse a Docbook SGML file and build a tree. Automatic support for
283 * ZLIB/Compress compressed document is provided by default if found
284 * at compile-time.
286 * Returns the resulting document tree
289 docbDocPtr
290 docbParseFile(const char *filename ATTRIBUTE_UNUSED,
291 const char *encoding ATTRIBUTE_UNUSED)
293 static int deprecated = 0;
295 if (!deprecated) {
296 xmlGenericError(xmlGenericErrorContext,
297 "docbParseFile() deprecated function reached\n");
298 deprecated = 1;
301 return (xmlParseFile(filename));
303 #define bottom_DOCBparser
304 #include "elfgcchack.h"
305 #endif /* LIBXML_DOCB_ENABLED */