Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / platform / external / libxml2 / d433046ae52b0488a9fad77d2045c0139b8cada8 / . / doc / html / libxml-xmlerror.html
blob: 2dbddfc7f3cbd0478ecb2e78d3b1df97a933037b [file] [log] [blame]
Daniel Veillardd4330462003-04-29 12:40:16 +0000[diff] [blame^]1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xmlerror</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
3 .synopsis, .classsynopsis {
4 background: #eeeeee;
5 border: solid 1px #aaaaaa;
6 padding: 0.5em;
7 }
8 .programlisting {
9 background: #eeeeff;
10 border: solid 1px #aaaaff;
11 padding: 0.5em;
12 }
13 .variablelist {
14 padding: 4px;
15 margin-left: 3em;
16 }
17 .navigation {
18 background: #ffeeee;
19 border: solid 1px #ffaaaa;
20 margin-top: 0.5em;
21 margin-bottom: 0.5em;
22 }
23 .navigation a {
24 color: #770000;
25 }
26 .navigation a:visited {
27 color: #550000;
28 }
29 .navigation .title {
30 font-size: 200%;
31 }
32 </style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="libxml-lib.html" title="Libxml Library Reference"><link rel="previous" href="libxml-uri.html" title="uri"><link rel="next" href="libxml-HTMLparser.html" title="HTMLparser"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-uri.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></img></a></td><td><a accesskey="u" href="libxml-lib.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></img></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></img></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-HTMLparser.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></img></a></td></tr></table><div class="refentry" lang="en"><a name="libxml-xmlerror"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlerror</h2><p>xmlerror &#8212; </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
Daniel Veillard7d6fd212001-05-10 15:34:11 +0000[diff] [blame]33
Daniel Veillardd4330462003-04-29 12:40:16 +0000[diff] [blame^]34
35
36enum <a href="libxml-xmlerror.html#xmlParserErrors">xmlParserErrors</a>;
37void (<a href="libxml-xmlerror.html#xmlGenericErrorFunc">*xmlGenericErrorFunc</a>) (void *ctx,
Daniel Veillard7d6fd212001-05-10 15:34:11 +0000[diff] [blame]38 const char *msg,
39 ...);
Daniel Veillardd4330462003-04-29 12:40:16 +0000[diff] [blame^]40void <a href="libxml-xmlerror.html#xmlSetGenericErrorFunc">xmlSetGenericErrorFunc</a> (void *ctx,
41 <a href="libxml-xmlerror.html#xmlGenericErrorFunc">xmlGenericErrorFunc</a> handler);
42void <a href="libxml-xmlerror.html#initGenericErrorDefaultFunc">initGenericErrorDefaultFunc</a> (<a href="libxml-xmlerror.html#xmlGenericErrorFunc">xmlGenericErrorFunc</a> *handler);
43void <a href="libxml-xmlerror.html#xmlParserError">xmlParserError</a> (void *ctx,
Daniel Veillard7d6fd212001-05-10 15:34:11 +0000[diff] [blame]44 const char *msg,
45 ...);
Daniel Veillardd4330462003-04-29 12:40:16 +0000[diff] [blame^]46void <a href="libxml-xmlerror.html#xmlParserWarning">xmlParserWarning</a> (void *ctx,
Daniel Veillard7d6fd212001-05-10 15:34:11 +0000[diff] [blame]47 const char *msg,
48 ...);
Daniel Veillardd4330462003-04-29 12:40:16 +0000[diff] [blame^]49void <a href="libxml-xmlerror.html#xmlParserValidityError">xmlParserValidityError</a> (void *ctx,
Daniel Veillard7d6fd212001-05-10 15:34:11 +0000[diff] [blame]50 const char *msg,
51 ...);
Daniel Veillardd4330462003-04-29 12:40:16 +0000[diff] [blame^]52void <a href="libxml-xmlerror.html#xmlParserValidityWarning">xmlParserValidityWarning</a> (void *ctx,
Daniel Veillard7d6fd212001-05-10 15:34:11 +0000[diff] [blame]53 const char *msg,
54 ...);
Daniel Veillardd4330462003-04-29 12:40:16 +0000[diff] [blame^]55void <a href="libxml-xmlerror.html#xmlParserPrintFileInfo">xmlParserPrintFileInfo</a> (<a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> input);
56void <a href="libxml-xmlerror.html#xmlParserPrintFileContext">xmlParserPrintFileContext</a> (<a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> input);
57</pre></div><div class="refsect1" lang="en"><h2>Description</h2><p>
58
59</p></div><div class="refsect1" lang="en"><h2>Details</h2><div class="refsect2" lang="en"><h3><a name="xmlParserErrors"></a>enum xmlParserErrors</h3><pre class="programlisting">typedef enum {
Daniel Veillard7d6fd212001-05-10 15:34:11 +0000[diff] [blame]60 XML_ERR_OK = 0,
61 XML_ERR_INTERNAL_ERROR,
62 XML_ERR_NO_MEMORY,
63
64 XML_ERR_DOCUMENT_START, /* 3 */
65 XML_ERR_DOCUMENT_EMPTY,
66 XML_ERR_DOCUMENT_END,
67
68 XML_ERR_INVALID_HEX_CHARREF, /* 6 */
69 XML_ERR_INVALID_DEC_CHARREF,
70 XML_ERR_INVALID_CHARREF,
71 XML_ERR_INVALID_CHAR,
72
73 XML_ERR_CHARREF_AT_EOF, /* 10 */
74 XML_ERR_CHARREF_IN_PROLOG,
75 XML_ERR_CHARREF_IN_EPILOG,
76 XML_ERR_CHARREF_IN_DTD,
77 XML_ERR_ENTITYREF_AT_EOF,
78 XML_ERR_ENTITYREF_IN_PROLOG,
79 XML_ERR_ENTITYREF_IN_EPILOG,
80 XML_ERR_ENTITYREF_IN_DTD,
81 XML_ERR_PEREF_AT_EOF,
82 XML_ERR_PEREF_IN_PROLOG,
83 XML_ERR_PEREF_IN_EPILOG,
84 XML_ERR_PEREF_IN_INT_SUBSET,
85
86 XML_ERR_ENTITYREF_NO_NAME, /* 22 */
87 XML_ERR_ENTITYREF_SEMICOL_MISSING,
88
89 XML_ERR_PEREF_NO_NAME, /* 24 */
90 XML_ERR_PEREF_SEMICOL_MISSING,
91
92 XML_ERR_UNDECLARED_ENTITY, /* 26 */
93 XML_WAR_UNDECLARED_ENTITY,
94 XML_ERR_UNPARSED_ENTITY,
95 XML_ERR_ENTITY_IS_EXTERNAL,
96 XML_ERR_ENTITY_IS_PARAMETER,
97
98 XML_ERR_UNKNOWN_ENCODING, /* 31 */
99 XML_ERR_UNSUPPORTED_ENCODING,
100
101 XML_ERR_STRING_NOT_STARTED, /* 33 */
102 XML_ERR_STRING_NOT_CLOSED,
103 XML_ERR_NS_DECL_ERROR,
104
105 XML_ERR_ENTITY_NOT_STARTED, /* 36 */
106 XML_ERR_ENTITY_NOT_FINISHED,
107
108 XML_ERR_LT_IN_ATTRIBUTE, /* 38 */
109 XML_ERR_ATTRIBUTE_NOT_STARTED,
110 XML_ERR_ATTRIBUTE_NOT_FINISHED,
111 XML_ERR_ATTRIBUTE_WITHOUT_VALUE,
112 XML_ERR_ATTRIBUTE_REDEFINED,
113
114 XML_ERR_LITERAL_NOT_STARTED, /* 43 */
115 XML_ERR_LITERAL_NOT_FINISHED,
116
117 XML_ERR_COMMENT_NOT_FINISHED, /* 45 */
118
119 XML_ERR_PI_NOT_STARTED, /* 47 */
120 XML_ERR_PI_NOT_FINISHED,
121
122 XML_ERR_NOTATION_NOT_STARTED, /* 49 */
123 XML_ERR_NOTATION_NOT_FINISHED,
124
125 XML_ERR_ATTLIST_NOT_STARTED, /* 51 */
126 XML_ERR_ATTLIST_NOT_FINISHED,
127
128 XML_ERR_MIXED_NOT_STARTED, /* 53 */
129 XML_ERR_MIXED_NOT_FINISHED,
130
131 XML_ERR_ELEMCONTENT_NOT_STARTED, /* 55 */
132 XML_ERR_ELEMCONTENT_NOT_FINISHED,
133
134 XML_ERR_XMLDECL_NOT_STARTED, /* 57 */
135 XML_ERR_XMLDECL_NOT_FINISHED,
136
137 XML_ERR_CONDSEC_NOT_STARTED, /* 59 */
138 XML_ERR_CONDSEC_NOT_FINISHED,
139
140 XML_ERR_EXT_SUBSET_NOT_FINISHED, /* 61 */
141
142 XML_ERR_DOCTYPE_NOT_FINISHED, /* 62 */
143
144 XML_ERR_MISPLACED_CDATA_END, /* 63 */
145 XML_ERR_CDATA_NOT_FINISHED,
146
147 XML_ERR_RESERVED_XML_NAME, /* 65 */
148
149 XML_ERR_SPACE_REQUIRED, /* 66 */
150 XML_ERR_SEPARATOR_REQUIRED,
151 XML_ERR_NMTOKEN_REQUIRED,
152 XML_ERR_NAME_REQUIRED,
153 XML_ERR_PCDATA_REQUIRED,
154 XML_ERR_URI_REQUIRED,
155 XML_ERR_PUBID_REQUIRED,
156 XML_ERR_LT_REQUIRED,
157 XML_ERR_GT_REQUIRED,
158 XML_ERR_LTSLASH_REQUIRED,
159 XML_ERR_EQUAL_REQUIRED,
160
161 XML_ERR_TAG_NAME_MISMATCH, /* 77 */
Daniel Veillard744683d2002-01-14 17:30:20 +0000[diff] [blame]162 XML_ERR_TAG_NOT_FINISHED,
Daniel Veillard7d6fd212001-05-10 15:34:11 +0000[diff] [blame]163
164 XML_ERR_STANDALONE_VALUE, /* 79 */
165
166 XML_ERR_ENCODING_NAME, /* 80 */
167
168 XML_ERR_HYPHEN_IN_COMMENT, /* 81 */
169
170 XML_ERR_INVALID_ENCODING, /* 82 */
171
172 XML_ERR_EXT_ENTITY_STANDALONE, /* 83 */
173
174 XML_ERR_CONDSEC_INVALID, /* 84 */
175
176 XML_ERR_VALUE_REQUIRED, /* 85 */
177
178 XML_ERR_NOT_WELL_BALANCED, /* 86 */
179 XML_ERR_EXTRA_CONTENT, /* 87 */
180 XML_ERR_ENTITY_CHAR_ERROR, /* 88 */
181 XML_ERR_ENTITY_PE_INTERNAL, /* 88 */
182 XML_ERR_ENTITY_LOOP, /* 89 */
183 XML_ERR_ENTITY_BOUNDARY, /* 90 */
184 XML_ERR_INVALID_URI, /* 91 */
Daniel Veillarde7ead2d2001-08-22 23:44:09 +0000[diff] [blame]185 XML_ERR_URI_FRAGMENT, /* 92 */
Daniel Veillard04382ae2001-09-12 18:51:30 +0000[diff] [blame]186 XML_WAR_CATALOG_PI, /* 93 */
187 XML_ERR_NO_DTD /* 94 */
Daniel Veillardd4330462003-04-29 12:40:16 +0000[diff] [blame^]188}xmlParserErrors;
189</pre><p>
190
191</p></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlGenericErrorFunc"></a>xmlGenericErrorFunc ()</h3><pre class="programlisting">void (*xmlGenericErrorFunc) (void *ctx,
Daniel Veillard7d6fd212001-05-10 15:34:11 +0000[diff] [blame]192 const char *msg,
Daniel Veillardd4330462003-04-29 12:40:16 +0000[diff] [blame^]193 ...);</pre><p>
194Signature of the function to use when there is an error and
195no parsing or validity context available .</p><p>
196
197</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> a parsing context
198</td></tr><tr><td><span class="term"><i><tt>msg</tt></i> :</span></td><td> the message
199</td></tr><tr><td><span class="term"><i><tt>...</tt></i> :</span></td><td> the extra arguments of the varags to format the message
200</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlSetGenericErrorFunc"></a>xmlSetGenericErrorFunc ()</h3><pre class="programlisting">void xmlSetGenericErrorFunc (void *ctx,
201 <a href="libxml-xmlerror.html#xmlGenericErrorFunc">xmlGenericErrorFunc</a> handler);</pre><p>
202Function to reset the handler and the error context for out of
Daniel Veillard7d6fd212001-05-10 15:34:11 +0000[diff] [blame]203context error messages.
Daniel Veillardd4330462003-04-29 12:40:16 +0000[diff] [blame^]204This simply means that <i><tt>handler</tt></i> will be called for subsequent
205error messages while not parsing nor validating. And <i><tt>ctx</tt></i> will
206be passed as first argument to <i><tt>handler</tt></i>
Daniel Veillard7d6fd212001-05-10 15:34:11 +0000[diff] [blame]207One can simply force messages to be emitted to another FILE * than
Daniel Veillardd4330462003-04-29 12:40:16 +0000[diff] [blame^]208stderr by setting <i><tt>ctx</tt></i> to this file handle and <i><tt>handler</tt></i> to NULL.</p><p>
209
210</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the new error handling context
211</td></tr><tr><td><span class="term"><i><tt>handler</tt></i> :</span></td><td> the new handler function
212</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="initGenericErrorDefaultFunc"></a>initGenericErrorDefaultFunc ()</h3><pre class="programlisting">void initGenericErrorDefaultFunc (<a href="libxml-xmlerror.html#xmlGenericErrorFunc">xmlGenericErrorFunc</a> *handler);</pre><p>
213Set or reset (if NULL) the default handler for generic errors
214to the builtin error function.</p><p>
215
216</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>handler</tt></i> :</span></td><td> the handler
217</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlParserError"></a>xmlParserError ()</h3><pre class="programlisting">void xmlParserError (void *ctx,
Daniel Veillard7d6fd212001-05-10 15:34:11 +0000[diff] [blame]218 const char *msg,
Daniel Veillardd4330462003-04-29 12:40:16 +0000[diff] [blame^]219 ...);</pre><p>
220Display and format an error messages, gives file, line, position and
221extra parameters.</p><p>
222
223</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> an XML parser context
224</td></tr><tr><td><span class="term"><i><tt>msg</tt></i> :</span></td><td> the message to display/transmit
225</td></tr><tr><td><span class="term"><i><tt>...</tt></i> :</span></td><td> extra parameters for the message display
226</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlParserWarning"></a>xmlParserWarning ()</h3><pre class="programlisting">void xmlParserWarning (void *ctx,
Daniel Veillard7d6fd212001-05-10 15:34:11 +0000[diff] [blame]227 const char *msg,
Daniel Veillardd4330462003-04-29 12:40:16 +0000[diff] [blame^]228 ...);</pre><p>
229Display and format a warning messages, gives file, line, position and
230extra parameters.</p><p>
231
232</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> an XML parser context
233</td></tr><tr><td><span class="term"><i><tt>msg</tt></i> :</span></td><td> the message to display/transmit
234</td></tr><tr><td><span class="term"><i><tt>...</tt></i> :</span></td><td> extra parameters for the message display
235</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlParserValidityError"></a>xmlParserValidityError ()</h3><pre class="programlisting">void xmlParserValidityError (void *ctx,
Daniel Veillard7d6fd212001-05-10 15:34:11 +0000[diff] [blame]236 const char *msg,
Daniel Veillardd4330462003-04-29 12:40:16 +0000[diff] [blame^]237 ...);</pre><p>
238Display and format an validity error messages, gives file,
239line, position and extra parameters.</p><p>
240
241</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> an XML parser context
242</td></tr><tr><td><span class="term"><i><tt>msg</tt></i> :</span></td><td> the message to display/transmit
243</td></tr><tr><td><span class="term"><i><tt>...</tt></i> :</span></td><td> extra parameters for the message display
244</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlParserValidityWarning"></a>xmlParserValidityWarning ()</h3><pre class="programlisting">void xmlParserValidityWarning (void *ctx,
Daniel Veillard7d6fd212001-05-10 15:34:11 +0000[diff] [blame]245 const char *msg,
Daniel Veillardd4330462003-04-29 12:40:16 +0000[diff] [blame^]246 ...);</pre><p>
247Display and format a validity warning messages, gives file, line,
248position and extra parameters.</p><p>
249
250</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> an XML parser context
251</td></tr><tr><td><span class="term"><i><tt>msg</tt></i> :</span></td><td> the message to display/transmit
252</td></tr><tr><td><span class="term"><i><tt>...</tt></i> :</span></td><td> extra parameters for the message display
253</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlParserPrintFileInfo"></a>xmlParserPrintFileInfo ()</h3><pre class="programlisting">void xmlParserPrintFileInfo (<a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> input);</pre><p>
254Displays the associated file and line informations for the current input</p><p>
255
256</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>input</tt></i> :</span></td><td> an xmlParserInputPtr input
257</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlParserPrintFileContext"></a>xmlParserPrintFileContext ()</h3><pre class="programlisting">void xmlParserPrintFileContext (<a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> input);</pre><p>
258Displays current context within the input content for error tracking</p><p>
259
260</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>input</tt></i> :</span></td><td> an xmlParserInputPtr input
261</td></tr></tbody></table></div></div></div></div><table xmlns="http://www.w3.org/TR/xhtml1/transitional" class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-uri.html"><b>&lt;&lt; uri</b></a></td><td align="right"><a accesskey="n" href="libxml-HTMLparser.html"><b>HTMLparser &gt;&gt;</b></a></td></tr></table></body></html>