blob: e751e1d554b786fab2f66b10197fa9512a50ad13 [file] [log] [blame]
Daniel Veillardaeea04f2000-01-25 19:27:27 +00001<HTML
2><HEAD
3><TITLE
4>encoding</TITLE
5><META
6NAME="GENERATOR"
Daniel Veillardbed7b052001-05-19 14:59:49 +00007CONTENT="Modular DocBook HTML Stylesheet Version 1.59"><LINK
Daniel Veillardaeea04f2000-01-25 19:27:27 +00008REL="HOME"
9TITLE="Gnome XML Library Reference Manual"
10HREF="book1.html"><LINK
11REL="UP"
12TITLE="Libxml Library Reference"
13HREF="libxml-lib.html"><LINK
14REL="PREVIOUS"
15TITLE="parserInternals"
Daniel Veillard9cb5ff42001-01-29 08:22:21 +000016HREF="libxml-parserinternals.html"><LINK
Daniel Veillardaeea04f2000-01-25 19:27:27 +000017REL="NEXT"
18TITLE="debugXML"
Daniel Veillard9cb5ff42001-01-29 08:22:21 +000019HREF="libxml-debugxml.html"></HEAD
Daniel Veillardaeea04f2000-01-25 19:27:27 +000020><BODY
Daniel Veillardbed7b052001-05-19 14:59:49 +000021CLASS="REFENTRY"
Daniel Veillardaeea04f2000-01-25 19:27:27 +000022BGCOLOR="#FFFFFF"
23TEXT="#000000"
Daniel Veillard503b8932001-01-05 06:36:31 +000024LINK="#0000FF"
25VLINK="#840084"
26ALINK="#0000FF"
Daniel Veillardaeea04f2000-01-25 19:27:27 +000027><DIV
28CLASS="NAVHEADER"
29><TABLE
30WIDTH="100%"
31BORDER="0"
32BGCOLOR="#000000"
33CELLPADDING="1"
34CELLSPACING="0"
35><TR
36><TH
37COLSPAN="4"
38ALIGN="center"
39><FONT
40COLOR="#FFFFFF"
41SIZE="5"
42>Gnome XML Library Reference Manual</FONT
43></TH
44></TR
45><TR
46><TD
47WIDTH="25%"
48BGCOLOR="#C00000"
49ALIGN="left"
50><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +000051HREF="libxml-parserinternals.html"
Daniel Veillardaeea04f2000-01-25 19:27:27 +000052><FONT
53COLOR="#FFFFFF"
54SIZE="3"
55><B
56>&#60;&#60;&#60; Previous Page</B
57></FONT
58></A
59></TD
60><TD
61WIDTH="25%"
62BGCOLOR="#0000C0"
63ALIGN="center"
64><FONT
65COLOR="#FFFFFF"
66SIZE="3"
67><B
68><A
69HREF="book1.html"
70><FONT
71COLOR="#FFFFFF"
72SIZE="3"
73><B
74>Home</B
75></FONT
76></A
77></B
78></FONT
79></TD
80><TD
81WIDTH="25%"
82BGCOLOR="#00C000"
83ALIGN="center"
84><FONT
85COLOR="#FFFFFF"
86SIZE="3"
87><B
88><A
89HREF="libxml-lib.html"
90><FONT
91COLOR="#FFFFFF"
92SIZE="3"
93><B
94>Up</B
95></FONT
96></A
97></B
98></FONT
99></TD
100><TD
101WIDTH="25%"
102BGCOLOR="#C00000"
103ALIGN="right"
104><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000105HREF="libxml-debugxml.html"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000106><FONT
107COLOR="#FFFFFF"
108SIZE="3"
109><B
110>Next Page &#62;&#62;&#62;</B
111></FONT
112></A
113></TD
114></TR
115></TABLE
116></DIV
117><H1
Daniel Veillard503b8932001-01-05 06:36:31 +0000118><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000119NAME="LIBXML-ENCODING"
Daniel Veillard503b8932001-01-05 06:36:31 +0000120>encoding</A
121></H1
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000122><DIV
123CLASS="REFNAMEDIV"
124><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000125NAME="AEN21633"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000126></A
127><H2
128>Name</H2
Daniel Veillard503b8932001-01-05 06:36:31 +0000129>encoding&nbsp;--&nbsp;</DIV
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000130><DIV
131CLASS="REFSYNOPSISDIV"
132><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000133NAME="AEN21636"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000134></A
135><H2
136>Synopsis</H2
137><TABLE
138BORDER="0"
139BGCOLOR="#D6E8FF"
140WIDTH="100%"
141CELLPADDING="6"
142><TR
143><TD
144><PRE
145CLASS="SYNOPSIS"
146>&#13;
147
148enum <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000149HREF="libxml-encoding.html#XMLCHARENCODING"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000150>xmlCharEncoding</A
151>;
152int (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000153HREF="libxml-encoding.html#XMLCHARENCODINGINPUTFUNC"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000154>*xmlCharEncodingInputFunc</A
155>) (unsigned char *out,
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000156 int *outlen,
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000157 unsigned char *in,
Daniel Veillardedfb29b2000-03-14 19:59:05 +0000158 int *inlen);
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000159int (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000160HREF="libxml-encoding.html#XMLCHARENCODINGOUTPUTFUNC"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000161>*xmlCharEncodingOutputFunc</A
162>) (unsigned char *out,
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000163 int *outlen,
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000164 unsigned char *in,
Daniel Veillardedfb29b2000-03-14 19:59:05 +0000165 int *inlen);
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000166struct <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000167HREF="libxml-encoding.html#XMLCHARENCODINGHANDLER"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000168>xmlCharEncodingHandler</A
169>;
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000170typedef <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000171HREF="libxml-encoding.html#XMLCHARENCODINGHANDLERPTR"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000172>xmlCharEncodingHandlerPtr</A
173>;
174void <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000175HREF="libxml-encoding.html#XMLINITCHARENCODINGHANDLERS"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000176>xmlInitCharEncodingHandlers</A
177> (void);
178void <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000179HREF="libxml-encoding.html#XMLCLEANUPCHARENCODINGHANDLERS"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000180>xmlCleanupCharEncodingHandlers</A
181> (void);
182void <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000183HREF="libxml-encoding.html#XMLREGISTERCHARENCODINGHANDLER"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000184>xmlRegisterCharEncodingHandler</A
185> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000186HREF="libxml-encoding.html#XMLCHARENCODINGHANDLERPTR"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000187>xmlCharEncodingHandlerPtr</A
188> handler);
189<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000190HREF="libxml-encoding.html#XMLCHARENCODINGHANDLERPTR"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000191>xmlCharEncodingHandlerPtr</A
192> <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000193HREF="libxml-encoding.html#XMLGETCHARENCODINGHANDLER"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000194>xmlGetCharEncodingHandler</A
195>
196 (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000197HREF="libxml-encoding.html#XMLCHARENCODING"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000198>xmlCharEncoding</A
199> enc);
200<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000201HREF="libxml-encoding.html#XMLCHARENCODINGHANDLERPTR"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000202>xmlCharEncodingHandlerPtr</A
203> <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000204HREF="libxml-encoding.html#XMLFINDCHARENCODINGHANDLER"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000205>xmlFindCharEncodingHandler</A
206>
Daniel Veillardedfb29b2000-03-14 19:59:05 +0000207 (const char *name);
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000208int <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000209HREF="libxml-encoding.html#XMLADDENCODINGALIAS"
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000210>xmlAddEncodingAlias</A
211> (const char *name,
212 const char *alias);
213int <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000214HREF="libxml-encoding.html#XMLDELENCODINGALIAS"
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000215>xmlDelEncodingAlias</A
216> (const char *alias);
217const char* <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000218HREF="libxml-encoding.html#XMLGETENCODINGALIAS"
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000219>xmlGetEncodingAlias</A
220> (const char *alias);
221void <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000222HREF="libxml-encoding.html#XMLCLEANUPENCODINGALIASES"
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000223>xmlCleanupEncodingAliases</A
224> (void);
225<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000226HREF="libxml-encoding.html#XMLCHARENCODING"
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000227>xmlCharEncoding</A
228> <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000229HREF="libxml-encoding.html#XMLPARSECHARENCODING"
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000230>xmlParseCharEncoding</A
231> (const char *name);
232const char* <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000233HREF="libxml-encoding.html#XMLGETCHARENCODINGNAME"
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000234>xmlGetCharEncodingName</A
235> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000236HREF="libxml-encoding.html#XMLCHARENCODING"
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000237>xmlCharEncoding</A
238> enc);
239<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000240HREF="libxml-encoding.html#XMLCHARENCODING"
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000241>xmlCharEncoding</A
242> <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000243HREF="libxml-encoding.html#XMLDETECTCHARENCODING"
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000244>xmlDetectCharEncoding</A
245> (unsigned char *in,
246 int len);
247int <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000248HREF="libxml-encoding.html#XMLCHARENCOUTFUNC"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000249>xmlCharEncOutFunc</A
250> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000251HREF="libxml-encoding.html#XMLCHARENCODINGHANDLER"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000252>xmlCharEncodingHandler</A
253> *handler,
254 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000255HREF="libxml-tree.html#XMLBUFFERPTR"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000256>xmlBufferPtr</A
257> out,
258 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000259HREF="libxml-tree.html#XMLBUFFERPTR"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000260>xmlBufferPtr</A
261> in);
262int <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000263HREF="libxml-encoding.html#XMLCHARENCINFUNC"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000264>xmlCharEncInFunc</A
265> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000266HREF="libxml-encoding.html#XMLCHARENCODINGHANDLER"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000267>xmlCharEncodingHandler</A
268> *handler,
269 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000270HREF="libxml-tree.html#XMLBUFFERPTR"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000271>xmlBufferPtr</A
272> out,
273 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000274HREF="libxml-tree.html#XMLBUFFERPTR"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000275>xmlBufferPtr</A
276> in);
277int <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000278HREF="libxml-encoding.html#XMLCHARENCFIRSTLINE"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000279>xmlCharEncFirstLine</A
280> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000281HREF="libxml-encoding.html#XMLCHARENCODINGHANDLER"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000282>xmlCharEncodingHandler</A
283> *handler,
284 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000285HREF="libxml-tree.html#XMLBUFFERPTR"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000286>xmlBufferPtr</A
287> out,
288 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000289HREF="libxml-tree.html#XMLBUFFERPTR"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000290>xmlBufferPtr</A
291> in);
292int <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000293HREF="libxml-encoding.html#XMLCHARENCCLOSEFUNC"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000294>xmlCharEncCloseFunc</A
295> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000296HREF="libxml-encoding.html#XMLCHARENCODINGHANDLER"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000297>xmlCharEncodingHandler</A
Daniel Veillarda41123c2001-04-22 19:31:20 +0000298> *handler);
299int <A
300HREF="libxml-encoding.html#UTF8TOISOLAT1"
301>UTF8Toisolat1</A
302> (unsigned char *out,
303 int *outlen,
304 unsigned char *in,
305 int *inlen);
306int <A
307HREF="libxml-encoding.html#ISOLAT1TOUTF8"
308>isolat1ToUTF8</A
309> (unsigned char *out,
310 int *outlen,
311 unsigned char *in,
312 int *inlen);
313int <A
314HREF="libxml-encoding.html#XMLCHECKUTF8"
315>xmlCheckUTF8</A
316> (unsigned char *utf);
317int <A
Daniel Veillard4ec885a2001-06-17 10:31:07 +0000318HREF="libxml-encoding.html#XMLUTF8STRSIZE"
319>xmlUTF8Strsize</A
320> (const <A
321HREF="libxml-tree.html#XMLCHAR"
322>xmlChar</A
323> *utf,
324 int len);
325<A
326HREF="libxml-tree.html#XMLCHAR"
327>xmlChar</A
328>* <A
329HREF="libxml-encoding.html#XMLUTF8STRNDUP"
330>xmlUTF8Strndup</A
331> (const <A
332HREF="libxml-tree.html#XMLCHAR"
333>xmlChar</A
334> *utf,
335 int len);
336<A
337HREF="libxml-tree.html#XMLCHAR"
338>xmlChar</A
339>* <A
340HREF="libxml-encoding.html#XMLUTF8STRPOS"
341>xmlUTF8Strpos</A
342> (const <A
343HREF="libxml-tree.html#XMLCHAR"
344>xmlChar</A
345> *utf,
346 int pos);
347int <A
348HREF="libxml-encoding.html#XMLUTF8STRLOC"
349>xmlUTF8Strloc</A
350> (const <A
351HREF="libxml-tree.html#XMLCHAR"
352>xmlChar</A
353> *utf,
354 const <A
355HREF="libxml-tree.html#XMLCHAR"
356>xmlChar</A
357> *utfchar);
358<A
359HREF="libxml-tree.html#XMLCHAR"
360>xmlChar</A
361>* <A
362HREF="libxml-encoding.html#XMLUTF8STRSUB"
363>xmlUTF8Strsub</A
364> (const <A
365HREF="libxml-tree.html#XMLCHAR"
366>xmlChar</A
367> *utf,
368 int start,
369 int len);
370int <A
Daniel Veillarda41123c2001-04-22 19:31:20 +0000371HREF="libxml-encoding.html#XMLUTF8STRLEN"
372>xmlUTF8Strlen</A
Daniel Veillard4ec885a2001-06-17 10:31:07 +0000373> (const <A
374HREF="libxml-tree.html#XMLCHAR"
375>xmlChar</A
376> *utf);</PRE
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000377></TD
378></TR
379></TABLE
380></DIV
381><DIV
382CLASS="REFSECT1"
383><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000384NAME="AEN21696"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000385></A
386><H2
387>Description</H2
388><P
389></P
390></DIV
391><DIV
392CLASS="REFSECT1"
393><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000394NAME="AEN21699"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000395></A
396><H2
397>Details</H2
398><DIV
399CLASS="REFSECT2"
400><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000401NAME="AEN21701"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000402></A
403><H3
404><A
405NAME="XMLCHARENCODING"
406></A
407>enum xmlCharEncoding</H3
408><TABLE
409BORDER="0"
410BGCOLOR="#D6E8FF"
411WIDTH="100%"
412CELLPADDING="6"
413><TR
414><TD
415><PRE
416CLASS="PROGRAMLISTING"
417>typedef enum {
418 XML_CHAR_ENCODING_ERROR= -1, /* No char encoding detected */
419 XML_CHAR_ENCODING_NONE= 0, /* No char encoding detected */
420 XML_CHAR_ENCODING_UTF8= 1, /* UTF-8 */
421 XML_CHAR_ENCODING_UTF16LE= 2, /* UTF-16 little endian */
422 XML_CHAR_ENCODING_UTF16BE= 3, /* UTF-16 big endian */
423 XML_CHAR_ENCODING_UCS4LE= 4, /* UCS-4 little endian */
424 XML_CHAR_ENCODING_UCS4BE= 5, /* UCS-4 big endian */
425 XML_CHAR_ENCODING_EBCDIC= 6, /* EBCDIC uh! */
426 XML_CHAR_ENCODING_UCS4_2143=7, /* UCS-4 unusual ordering */
427 XML_CHAR_ENCODING_UCS4_3412=8, /* UCS-4 unusual ordering */
428 XML_CHAR_ENCODING_UCS2= 9, /* UCS-2 */
429 XML_CHAR_ENCODING_8859_1= 10,/* ISO-8859-1 ISO Latin 1 */
430 XML_CHAR_ENCODING_8859_2= 11,/* ISO-8859-2 ISO Latin 2 */
431 XML_CHAR_ENCODING_8859_3= 12,/* ISO-8859-3 */
432 XML_CHAR_ENCODING_8859_4= 13,/* ISO-8859-4 */
433 XML_CHAR_ENCODING_8859_5= 14,/* ISO-8859-5 */
434 XML_CHAR_ENCODING_8859_6= 15,/* ISO-8859-6 */
435 XML_CHAR_ENCODING_8859_7= 16,/* ISO-8859-7 */
436 XML_CHAR_ENCODING_8859_8= 17,/* ISO-8859-8 */
437 XML_CHAR_ENCODING_8859_9= 18,/* ISO-8859-9 */
438 XML_CHAR_ENCODING_2022_JP= 19,/* ISO-2022-JP */
439 XML_CHAR_ENCODING_SHIFT_JIS=20,/* Shift_JIS */
Daniel Veillarde46e20d2000-07-14 15:02:46 +0000440 XML_CHAR_ENCODING_EUC_JP= 21,/* EUC-JP */
441 XML_CHAR_ENCODING_ASCII= 22 /* pure ASCII */
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000442} xmlCharEncoding;</PRE
443></TD
444></TR
445></TABLE
446><P
447></P
448></DIV
449><HR><DIV
450CLASS="REFSECT2"
451><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000452NAME="AEN21706"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000453></A
454><H3
455><A
456NAME="XMLCHARENCODINGINPUTFUNC"
457></A
458>xmlCharEncodingInputFunc ()</H3
459><TABLE
460BORDER="0"
461BGCOLOR="#D6E8FF"
462WIDTH="100%"
463CELLPADDING="6"
464><TR
465><TD
466><PRE
467CLASS="PROGRAMLISTING"
468>int (*xmlCharEncodingInputFunc) (unsigned char *out,
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000469 int *outlen,
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000470 unsigned char *in,
Daniel Veillardedfb29b2000-03-14 19:59:05 +0000471 int *inlen);</PRE
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000472></TD
473></TR
474></TABLE
475><P
476></P
477><DIV
478CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000479><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000480NAME="AEN21711"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000481></A
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000482><P
483></P
484><TABLE
485BORDER="0"
486WIDTH="100%"
487BGCOLOR="#FFD0D0"
488CELLSPACING="0"
489CELLPADDING="4"
490CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000491><TBODY
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000492><TR
493><TD
494WIDTH="20%"
495ALIGN="RIGHT"
496VALIGN="TOP"
497><TT
498CLASS="PARAMETER"
499><I
500>out</I
501></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000502>&nbsp;:</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000503><TD
504WIDTH="80%"
505ALIGN="LEFT"
506VALIGN="TOP"
Daniel Veillardf012a642001-07-23 19:10:52 +0000507>&nbsp;</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000508></TR
509><TR
510><TD
511WIDTH="20%"
512ALIGN="RIGHT"
513VALIGN="TOP"
514><TT
515CLASS="PARAMETER"
516><I
517>outlen</I
518></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000519>&nbsp;:</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000520><TD
521WIDTH="80%"
522ALIGN="LEFT"
523VALIGN="TOP"
Daniel Veillardf012a642001-07-23 19:10:52 +0000524>&nbsp;</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000525></TR
526><TR
527><TD
528WIDTH="20%"
529ALIGN="RIGHT"
530VALIGN="TOP"
531><TT
532CLASS="PARAMETER"
533><I
534>in</I
535></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000536>&nbsp;:</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000537><TD
538WIDTH="80%"
539ALIGN="LEFT"
540VALIGN="TOP"
Daniel Veillardf012a642001-07-23 19:10:52 +0000541>&nbsp;</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000542></TR
543><TR
544><TD
545WIDTH="20%"
546ALIGN="RIGHT"
547VALIGN="TOP"
548><TT
549CLASS="PARAMETER"
550><I
551>inlen</I
552></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000553>&nbsp;:</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000554><TD
555WIDTH="80%"
556ALIGN="LEFT"
557VALIGN="TOP"
Daniel Veillardf012a642001-07-23 19:10:52 +0000558>&nbsp;</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000559></TR
560><TR
561><TD
562WIDTH="20%"
563ALIGN="RIGHT"
564VALIGN="TOP"
565><I
566CLASS="EMPHASIS"
567>Returns</I
568> :</TD
569><TD
570WIDTH="80%"
571ALIGN="LEFT"
572VALIGN="TOP"
Daniel Veillardf012a642001-07-23 19:10:52 +0000573>&nbsp;</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000574></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +0000575></TBODY
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000576></TABLE
577><P
578></P
579></DIV
580></DIV
581><HR><DIV
582CLASS="REFSECT2"
583><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000584NAME="AEN21736"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000585></A
586><H3
587><A
588NAME="XMLCHARENCODINGOUTPUTFUNC"
589></A
590>xmlCharEncodingOutputFunc ()</H3
591><TABLE
592BORDER="0"
593BGCOLOR="#D6E8FF"
594WIDTH="100%"
595CELLPADDING="6"
596><TR
597><TD
598><PRE
599CLASS="PROGRAMLISTING"
600>int (*xmlCharEncodingOutputFunc) (unsigned char *out,
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000601 int *outlen,
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000602 unsigned char *in,
Daniel Veillardedfb29b2000-03-14 19:59:05 +0000603 int *inlen);</PRE
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000604></TD
605></TR
606></TABLE
607><P
608></P
609><DIV
610CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000611><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000612NAME="AEN21741"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000613></A
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000614><P
615></P
616><TABLE
617BORDER="0"
618WIDTH="100%"
619BGCOLOR="#FFD0D0"
620CELLSPACING="0"
621CELLPADDING="4"
622CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000623><TBODY
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000624><TR
625><TD
626WIDTH="20%"
627ALIGN="RIGHT"
628VALIGN="TOP"
629><TT
630CLASS="PARAMETER"
631><I
632>out</I
633></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000634>&nbsp;:</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000635><TD
636WIDTH="80%"
637ALIGN="LEFT"
638VALIGN="TOP"
Daniel Veillardf012a642001-07-23 19:10:52 +0000639>&nbsp;</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000640></TR
641><TR
642><TD
643WIDTH="20%"
644ALIGN="RIGHT"
645VALIGN="TOP"
646><TT
647CLASS="PARAMETER"
648><I
649>outlen</I
650></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000651>&nbsp;:</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000652><TD
653WIDTH="80%"
654ALIGN="LEFT"
655VALIGN="TOP"
Daniel Veillardf012a642001-07-23 19:10:52 +0000656>&nbsp;</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000657></TR
658><TR
659><TD
660WIDTH="20%"
661ALIGN="RIGHT"
662VALIGN="TOP"
663><TT
664CLASS="PARAMETER"
665><I
666>in</I
667></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000668>&nbsp;:</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000669><TD
670WIDTH="80%"
671ALIGN="LEFT"
672VALIGN="TOP"
Daniel Veillardf012a642001-07-23 19:10:52 +0000673>&nbsp;</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000674></TR
675><TR
676><TD
677WIDTH="20%"
678ALIGN="RIGHT"
679VALIGN="TOP"
680><TT
681CLASS="PARAMETER"
682><I
683>inlen</I
684></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000685>&nbsp;:</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000686><TD
687WIDTH="80%"
688ALIGN="LEFT"
689VALIGN="TOP"
Daniel Veillardf012a642001-07-23 19:10:52 +0000690>&nbsp;</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000691></TR
692><TR
693><TD
694WIDTH="20%"
695ALIGN="RIGHT"
696VALIGN="TOP"
697><I
698CLASS="EMPHASIS"
699>Returns</I
700> :</TD
701><TD
702WIDTH="80%"
703ALIGN="LEFT"
704VALIGN="TOP"
Daniel Veillardf012a642001-07-23 19:10:52 +0000705>&nbsp;</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000706></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +0000707></TBODY
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000708></TABLE
709><P
710></P
711></DIV
712></DIV
713><HR><DIV
714CLASS="REFSECT2"
715><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000716NAME="AEN21766"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000717></A
718><H3
719><A
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000720NAME="XMLCHARENCODINGHANDLER"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000721></A
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000722>struct xmlCharEncodingHandler</H3
723><TABLE
724BORDER="0"
725BGCOLOR="#D6E8FF"
726WIDTH="100%"
727CELLPADDING="6"
728><TR
729><TD
730><PRE
731CLASS="PROGRAMLISTING"
732>struct xmlCharEncodingHandler {
733 char *name;
734 xmlCharEncodingInputFunc input;
735 xmlCharEncodingOutputFunc output;
736#ifdef LIBXML_ICONV_ENABLED
737 iconv_t iconv_in;
738 iconv_t iconv_out;
739#endif /* LIBXML_ICONV_ENABLED */
740};</PRE
741></TD
742></TR
743></TABLE
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000744><P
745></P
746></DIV
747><HR><DIV
748CLASS="REFSECT2"
749><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000750NAME="AEN21771"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000751></A
752><H3
753><A
754NAME="XMLCHARENCODINGHANDLERPTR"
755></A
756>xmlCharEncodingHandlerPtr</H3
Daniel Veillard4b8328d2001-07-05 22:48:42 +0000757><TABLE
758BORDER="0"
759BGCOLOR="#D6E8FF"
760WIDTH="100%"
761CELLPADDING="6"
762><TR
763><TD
764><PRE
765CLASS="PROGRAMLISTING"
766>typedef xmlCharEncodingHandler *xmlCharEncodingHandlerPtr;</PRE
767></TD
768></TR
769></TABLE
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000770><P
771></P
772></DIV
773><HR><DIV
774CLASS="REFSECT2"
775><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000776NAME="AEN21776"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000777></A
778><H3
779><A
780NAME="XMLINITCHARENCODINGHANDLERS"
781></A
782>xmlInitCharEncodingHandlers ()</H3
783><TABLE
784BORDER="0"
785BGCOLOR="#D6E8FF"
786WIDTH="100%"
787CELLPADDING="6"
788><TR
789><TD
790><PRE
791CLASS="PROGRAMLISTING"
792>void xmlInitCharEncodingHandlers (void);</PRE
793></TD
794></TR
795></TABLE
796><P
797>Initialize the char encoding support, it registers the default
798encoding supported.
799NOTE: while public, this function usually doesn't need to be called
800in normal processing.</P
801><P
802></P
803></DIV
804><HR><DIV
805CLASS="REFSECT2"
806><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000807NAME="AEN21782"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000808></A
809><H3
810><A
811NAME="XMLCLEANUPCHARENCODINGHANDLERS"
812></A
813>xmlCleanupCharEncodingHandlers ()</H3
814><TABLE
815BORDER="0"
816BGCOLOR="#D6E8FF"
817WIDTH="100%"
818CELLPADDING="6"
819><TR
820><TD
821><PRE
822CLASS="PROGRAMLISTING"
823>void xmlCleanupCharEncodingHandlers (void);</PRE
824></TD
825></TR
826></TABLE
827><P
828>Cleanup the memory allocated for the char encoding support, it
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000829unregisters all the encoding handlers and the aliases.</P
Daniel Veillard3f6f7f62000-06-30 17:58:25 +0000830><P
831></P
832></DIV
833><HR><DIV
834CLASS="REFSECT2"
835><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000836NAME="AEN21788"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000837></A
838><H3
839><A
840NAME="XMLREGISTERCHARENCODINGHANDLER"
841></A
842>xmlRegisterCharEncodingHandler ()</H3
843><TABLE
844BORDER="0"
845BGCOLOR="#D6E8FF"
846WIDTH="100%"
847CELLPADDING="6"
848><TR
849><TD
850><PRE
851CLASS="PROGRAMLISTING"
852>void xmlRegisterCharEncodingHandler (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000853HREF="libxml-encoding.html#XMLCHARENCODINGHANDLERPTR"
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000854>xmlCharEncodingHandlerPtr</A
855> handler);</PRE
856></TD
857></TR
858></TABLE
859><P
860>Register the char encoding handler, surprizing, isn't it ?</P
861><P
862></P
863><DIV
864CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000865><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000866NAME="AEN21795"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000867></A
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000868><P
869></P
870><TABLE
871BORDER="0"
872WIDTH="100%"
873BGCOLOR="#FFD0D0"
874CELLSPACING="0"
875CELLPADDING="4"
876CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000877><TBODY
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000878><TR
879><TD
880WIDTH="20%"
881ALIGN="RIGHT"
882VALIGN="TOP"
883><TT
884CLASS="PARAMETER"
885><I
886>handler</I
887></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000888>&nbsp;:</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000889><TD
890WIDTH="80%"
891ALIGN="LEFT"
892VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +0000893> the xmlCharEncodingHandlerPtr handler block</TD
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000894></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +0000895></TBODY
Daniel Veillardaeea04f2000-01-25 19:27:27 +0000896></TABLE
897><P
898></P
899></DIV
900></DIV
901><HR><DIV
902CLASS="REFSECT2"
903><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000904NAME="AEN21804"
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000905></A
906><H3
907><A
908NAME="XMLGETCHARENCODINGHANDLER"
909></A
910>xmlGetCharEncodingHandler ()</H3
911><TABLE
912BORDER="0"
913BGCOLOR="#D6E8FF"
914WIDTH="100%"
915CELLPADDING="6"
916><TR
917><TD
918><PRE
919CLASS="PROGRAMLISTING"
920><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000921HREF="libxml-encoding.html#XMLCHARENCODINGHANDLERPTR"
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000922>xmlCharEncodingHandlerPtr</A
923> xmlGetCharEncodingHandler
924 (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000925HREF="libxml-encoding.html#XMLCHARENCODING"
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000926>xmlCharEncoding</A
927> enc);</PRE
928></TD
929></TR
930></TABLE
931><P
932>Search in the registrered set the handler able to read/write that encoding.</P
933><P
934></P
935><DIV
936CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000937><A
Daniel Veillardf012a642001-07-23 19:10:52 +0000938NAME="AEN21812"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000939></A
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000940><P
941></P
942><TABLE
943BORDER="0"
944WIDTH="100%"
945BGCOLOR="#FFD0D0"
946CELLSPACING="0"
947CELLPADDING="4"
948CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000949><TBODY
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000950><TR
951><TD
952WIDTH="20%"
953ALIGN="RIGHT"
954VALIGN="TOP"
955><TT
956CLASS="PARAMETER"
957><I
958>enc</I
959></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000960>&nbsp;:</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +0000961><TD
962WIDTH="80%"
963ALIGN="LEFT"
964VALIGN="TOP"
Daniel Veillardf012a642001-07-23 19:10:52 +0000965> an xmlCharEncoding value.</TD
966></TR
967><TR
968><TD
969WIDTH="20%"
970ALIGN="RIGHT"
971VALIGN="TOP"
972><I
973CLASS="EMPHASIS"
974>Returns</I
975> :</TD
976><TD
977WIDTH="80%"
978ALIGN="LEFT"
979VALIGN="TOP"
980>the handler or NULL if not found</TD
981></TR
982></TBODY
983></TABLE
984><P
985></P
986></DIV
987></DIV
988><HR><DIV
989CLASS="REFSECT2"
990><A
991NAME="AEN21825"
992></A
993><H3
994><A
995NAME="XMLFINDCHARENCODINGHANDLER"
996></A
997>xmlFindCharEncodingHandler ()</H3
998><TABLE
999BORDER="0"
1000BGCOLOR="#D6E8FF"
1001WIDTH="100%"
1002CELLPADDING="6"
1003><TR
1004><TD
1005><PRE
1006CLASS="PROGRAMLISTING"
1007><A
1008HREF="libxml-encoding.html#XMLCHARENCODINGHANDLERPTR"
1009>xmlCharEncodingHandlerPtr</A
1010> xmlFindCharEncodingHandler
1011 (const char *name);</PRE
1012></TD
1013></TR
1014></TABLE
1015><P
1016>Search in the registrered set the handler able to read/write that encoding.</P
1017><P
1018></P
1019><DIV
1020CLASS="INFORMALTABLE"
1021><A
1022NAME="AEN21832"
1023></A
1024><P
1025></P
1026><TABLE
1027BORDER="0"
1028WIDTH="100%"
1029BGCOLOR="#FFD0D0"
1030CELLSPACING="0"
1031CELLPADDING="4"
1032CLASS="CALSTABLE"
1033><TBODY
1034><TR
1035><TD
1036WIDTH="20%"
1037ALIGN="RIGHT"
1038VALIGN="TOP"
1039><TT
1040CLASS="PARAMETER"
1041><I
1042>name</I
1043></TT
1044>&nbsp;:</TD
1045><TD
1046WIDTH="80%"
1047ALIGN="LEFT"
1048VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001049> a string describing the char encoding.</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001050></TR
1051><TR
1052><TD
1053WIDTH="20%"
1054ALIGN="RIGHT"
1055VALIGN="TOP"
1056><I
1057CLASS="EMPHASIS"
1058>Returns</I
1059> :</TD
1060><TD
1061WIDTH="80%"
1062ALIGN="LEFT"
1063VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001064>the handler or NULL if not found</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001065></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +00001066></TBODY
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001067></TABLE
1068><P
1069></P
1070></DIV
1071></DIV
1072><HR><DIV
1073CLASS="REFSECT2"
1074><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001075NAME="AEN21845"
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001076></A
1077><H3
1078><A
1079NAME="XMLADDENCODINGALIAS"
1080></A
1081>xmlAddEncodingAlias ()</H3
1082><TABLE
1083BORDER="0"
1084BGCOLOR="#D6E8FF"
1085WIDTH="100%"
1086CELLPADDING="6"
1087><TR
1088><TD
1089><PRE
1090CLASS="PROGRAMLISTING"
1091>int xmlAddEncodingAlias (const char *name,
1092 const char *alias);</PRE
1093></TD
1094></TR
1095></TABLE
1096><P
1097>Registers and alias <TT
1098CLASS="PARAMETER"
1099><I
1100>alias</I
1101></TT
1102> for an encoding named <TT
1103CLASS="PARAMETER"
1104><I
1105>name</I
1106></TT
1107>. Existing alias
1108will be overwritten.</P
1109><P
1110></P
1111><DIV
1112CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001113><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001114NAME="AEN21853"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001115></A
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001116><P
1117></P
1118><TABLE
1119BORDER="0"
1120WIDTH="100%"
1121BGCOLOR="#FFD0D0"
1122CELLSPACING="0"
1123CELLPADDING="4"
1124CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001125><TBODY
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001126><TR
1127><TD
1128WIDTH="20%"
1129ALIGN="RIGHT"
1130VALIGN="TOP"
1131><TT
1132CLASS="PARAMETER"
1133><I
1134>name</I
1135></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001136>&nbsp;:</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001137><TD
1138WIDTH="80%"
1139ALIGN="LEFT"
1140VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001141> the encoding name as parsed, in UTF-8 format (ASCII actually)</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001142></TR
1143><TR
1144><TD
1145WIDTH="20%"
1146ALIGN="RIGHT"
1147VALIGN="TOP"
1148><TT
1149CLASS="PARAMETER"
1150><I
1151>alias</I
1152></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001153>&nbsp;:</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001154><TD
1155WIDTH="80%"
1156ALIGN="LEFT"
1157VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001158> the alias name as parsed, in UTF-8 format (ASCII actually)</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001159></TR
1160><TR
1161><TD
1162WIDTH="20%"
1163ALIGN="RIGHT"
1164VALIGN="TOP"
1165><I
1166CLASS="EMPHASIS"
1167>Returns</I
1168> :</TD
1169><TD
1170WIDTH="80%"
1171ALIGN="LEFT"
1172VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001173>0 in case of success, -1 in case of error</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001174></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +00001175></TBODY
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001176></TABLE
1177><P
1178></P
1179></DIV
1180></DIV
1181><HR><DIV
1182CLASS="REFSECT2"
1183><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001184NAME="AEN21870"
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001185></A
1186><H3
1187><A
1188NAME="XMLDELENCODINGALIAS"
1189></A
1190>xmlDelEncodingAlias ()</H3
1191><TABLE
1192BORDER="0"
1193BGCOLOR="#D6E8FF"
1194WIDTH="100%"
1195CELLPADDING="6"
1196><TR
1197><TD
1198><PRE
1199CLASS="PROGRAMLISTING"
1200>int xmlDelEncodingAlias (const char *alias);</PRE
1201></TD
1202></TR
1203></TABLE
1204><P
1205>Unregisters an encoding alias <TT
1206CLASS="PARAMETER"
1207><I
1208>alias</I
1209></TT
1210></P
1211><P
1212></P
1213><DIV
1214CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001215><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001216NAME="AEN21877"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001217></A
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001218><P
1219></P
1220><TABLE
1221BORDER="0"
1222WIDTH="100%"
1223BGCOLOR="#FFD0D0"
1224CELLSPACING="0"
1225CELLPADDING="4"
1226CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001227><TBODY
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001228><TR
1229><TD
1230WIDTH="20%"
1231ALIGN="RIGHT"
1232VALIGN="TOP"
1233><TT
1234CLASS="PARAMETER"
1235><I
1236>alias</I
1237></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001238>&nbsp;:</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001239><TD
1240WIDTH="80%"
1241ALIGN="LEFT"
1242VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001243> the alias name as parsed, in UTF-8 format (ASCII actually)</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001244></TR
1245><TR
1246><TD
1247WIDTH="20%"
1248ALIGN="RIGHT"
1249VALIGN="TOP"
1250><I
1251CLASS="EMPHASIS"
1252>Returns</I
1253> :</TD
1254><TD
1255WIDTH="80%"
1256ALIGN="LEFT"
1257VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001258>0 in case of success, -1 in case of error</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001259></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +00001260></TBODY
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001261></TABLE
1262><P
1263></P
1264></DIV
1265></DIV
1266><HR><DIV
1267CLASS="REFSECT2"
1268><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001269NAME="AEN21890"
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001270></A
1271><H3
1272><A
1273NAME="XMLGETENCODINGALIAS"
1274></A
1275>xmlGetEncodingAlias ()</H3
1276><TABLE
1277BORDER="0"
1278BGCOLOR="#D6E8FF"
1279WIDTH="100%"
1280CELLPADDING="6"
1281><TR
1282><TD
1283><PRE
1284CLASS="PROGRAMLISTING"
1285>const char* xmlGetEncodingAlias (const char *alias);</PRE
1286></TD
1287></TR
1288></TABLE
1289><P
1290>Lookup an encoding name for the given alias.</P
1291><P
1292></P
1293><DIV
1294CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001295><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001296NAME="AEN21896"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001297></A
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001298><P
1299></P
1300><TABLE
1301BORDER="0"
1302WIDTH="100%"
1303BGCOLOR="#FFD0D0"
1304CELLSPACING="0"
1305CELLPADDING="4"
1306CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001307><TBODY
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001308><TR
1309><TD
1310WIDTH="20%"
1311ALIGN="RIGHT"
1312VALIGN="TOP"
1313><TT
1314CLASS="PARAMETER"
1315><I
1316>alias</I
1317></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001318>&nbsp;:</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001319><TD
1320WIDTH="80%"
1321ALIGN="LEFT"
1322VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001323> the alias name as parsed, in UTF-8 format (ASCII actually)</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001324></TR
1325><TR
1326><TD
1327WIDTH="20%"
1328ALIGN="RIGHT"
1329VALIGN="TOP"
1330><I
1331CLASS="EMPHASIS"
1332>Returns</I
1333> :</TD
1334><TD
1335WIDTH="80%"
1336ALIGN="LEFT"
1337VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001338>NULL if not found the original name otherwise</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001339></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +00001340></TBODY
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001341></TABLE
1342><P
1343></P
1344></DIV
1345></DIV
1346><HR><DIV
1347CLASS="REFSECT2"
1348><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001349NAME="AEN21909"
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001350></A
1351><H3
1352><A
1353NAME="XMLCLEANUPENCODINGALIASES"
1354></A
1355>xmlCleanupEncodingAliases ()</H3
1356><TABLE
1357BORDER="0"
1358BGCOLOR="#D6E8FF"
1359WIDTH="100%"
1360CELLPADDING="6"
1361><TR
1362><TD
1363><PRE
1364CLASS="PROGRAMLISTING"
1365>void xmlCleanupEncodingAliases (void);</PRE
1366></TD
1367></TR
1368></TABLE
1369><P
1370>Unregisters all aliases</P
1371><P
1372></P
1373></DIV
1374><HR><DIV
1375CLASS="REFSECT2"
1376><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001377NAME="AEN21915"
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001378></A
1379><H3
1380><A
1381NAME="XMLPARSECHARENCODING"
1382></A
1383>xmlParseCharEncoding ()</H3
1384><TABLE
1385BORDER="0"
1386BGCOLOR="#D6E8FF"
1387WIDTH="100%"
1388CELLPADDING="6"
1389><TR
1390><TD
1391><PRE
1392CLASS="PROGRAMLISTING"
1393><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001394HREF="libxml-encoding.html#XMLCHARENCODING"
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001395>xmlCharEncoding</A
1396> xmlParseCharEncoding (const char *name);</PRE
1397></TD
1398></TR
1399></TABLE
1400><P
1401>Conpare the string to the known encoding schemes already known. Note
1402that the comparison is case insensitive accordingly to the section
1403[XML] 4.3.3 Character Encoding in Entities.</P
1404><P
1405></P
1406><DIV
1407CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001408><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001409NAME="AEN21922"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001410></A
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001411><P
1412></P
1413><TABLE
1414BORDER="0"
1415WIDTH="100%"
1416BGCOLOR="#FFD0D0"
1417CELLSPACING="0"
1418CELLPADDING="4"
1419CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001420><TBODY
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001421><TR
1422><TD
1423WIDTH="20%"
1424ALIGN="RIGHT"
1425VALIGN="TOP"
1426><TT
1427CLASS="PARAMETER"
1428><I
1429>name</I
1430></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001431>&nbsp;:</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001432><TD
1433WIDTH="80%"
1434ALIGN="LEFT"
1435VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001436> the encoding name as parsed, in UTF-8 format (ASCII actually)</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001437></TR
1438><TR
1439><TD
1440WIDTH="20%"
1441ALIGN="RIGHT"
1442VALIGN="TOP"
1443><I
1444CLASS="EMPHASIS"
1445>Returns</I
1446> :</TD
1447><TD
1448WIDTH="80%"
1449ALIGN="LEFT"
1450VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001451>one of the XML_CHAR_ENCODING_... values or XML_CHAR_ENCODING_NONE
1452if not recognized.</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001453></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +00001454></TBODY
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001455></TABLE
1456><P
1457></P
1458></DIV
1459></DIV
1460><HR><DIV
1461CLASS="REFSECT2"
1462><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001463NAME="AEN21935"
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001464></A
1465><H3
1466><A
1467NAME="XMLGETCHARENCODINGNAME"
1468></A
1469>xmlGetCharEncodingName ()</H3
1470><TABLE
1471BORDER="0"
1472BGCOLOR="#D6E8FF"
1473WIDTH="100%"
1474CELLPADDING="6"
1475><TR
1476><TD
1477><PRE
1478CLASS="PROGRAMLISTING"
1479>const char* xmlGetCharEncodingName (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001480HREF="libxml-encoding.html#XMLCHARENCODING"
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001481>xmlCharEncoding</A
1482> enc);</PRE
1483></TD
1484></TR
1485></TABLE
1486><P
1487>The "canonical" name for XML encoding.
1488C.f. http://www.w3.org/TR/REC-xml<GTKDOCLINK
1489HREF="CHARENCODING"
1490>charencoding</GTKDOCLINK
1491>
1492Section 4.3.3 Character Encoding in Entities</P
1493><P
1494></P
1495><DIV
1496CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001497><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001498NAME="AEN21943"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001499></A
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001500><P
1501></P
1502><TABLE
1503BORDER="0"
1504WIDTH="100%"
1505BGCOLOR="#FFD0D0"
1506CELLSPACING="0"
1507CELLPADDING="4"
1508CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001509><TBODY
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001510><TR
1511><TD
1512WIDTH="20%"
1513ALIGN="RIGHT"
1514VALIGN="TOP"
1515><TT
1516CLASS="PARAMETER"
1517><I
1518>enc</I
1519></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001520>&nbsp;:</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001521><TD
1522WIDTH="80%"
1523ALIGN="LEFT"
1524VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001525> the encoding</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001526></TR
1527><TR
1528><TD
1529WIDTH="20%"
1530ALIGN="RIGHT"
1531VALIGN="TOP"
1532><I
1533CLASS="EMPHASIS"
1534>Returns</I
1535> :</TD
1536><TD
1537WIDTH="80%"
1538ALIGN="LEFT"
1539VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001540>the canonical name for the given encoding</TD
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001541></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +00001542></TBODY
Daniel Veillard3bff2b02000-10-01 20:33:47 +00001543></TABLE
1544><P
1545></P
1546></DIV
1547></DIV
1548><HR><DIV
1549CLASS="REFSECT2"
1550><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001551NAME="AEN21956"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001552></A
1553><H3
1554><A
1555NAME="XMLDETECTCHARENCODING"
1556></A
1557>xmlDetectCharEncoding ()</H3
1558><TABLE
1559BORDER="0"
1560BGCOLOR="#D6E8FF"
1561WIDTH="100%"
1562CELLPADDING="6"
1563><TR
1564><TD
1565><PRE
1566CLASS="PROGRAMLISTING"
1567><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001568HREF="libxml-encoding.html#XMLCHARENCODING"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001569>xmlCharEncoding</A
1570> xmlDetectCharEncoding (unsigned char *in,
1571 int len);</PRE
1572></TD
1573></TR
1574></TABLE
1575><P
1576>Guess the encoding of the entity using the first bytes of the entity content
1577accordingly of the non-normative appendix F of the XML-1.0 recommendation.</P
1578><P
1579></P
1580><DIV
1581CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001582><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001583NAME="AEN21963"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001584></A
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001585><P
1586></P
1587><TABLE
1588BORDER="0"
1589WIDTH="100%"
1590BGCOLOR="#FFD0D0"
1591CELLSPACING="0"
1592CELLPADDING="4"
1593CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001594><TBODY
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001595><TR
1596><TD
1597WIDTH="20%"
1598ALIGN="RIGHT"
1599VALIGN="TOP"
1600><TT
1601CLASS="PARAMETER"
1602><I
1603>in</I
1604></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001605>&nbsp;:</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001606><TD
1607WIDTH="80%"
1608ALIGN="LEFT"
1609VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001610> a pointer to the first bytes of the XML entity, must be at least
16114 bytes long.</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001612></TR
1613><TR
1614><TD
1615WIDTH="20%"
1616ALIGN="RIGHT"
1617VALIGN="TOP"
1618><TT
1619CLASS="PARAMETER"
1620><I
1621>len</I
1622></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001623>&nbsp;:</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001624><TD
1625WIDTH="80%"
1626ALIGN="LEFT"
1627VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001628> pointer to the length of the buffer</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001629></TR
1630><TR
1631><TD
1632WIDTH="20%"
1633ALIGN="RIGHT"
1634VALIGN="TOP"
1635><I
1636CLASS="EMPHASIS"
1637>Returns</I
1638> :</TD
1639><TD
1640WIDTH="80%"
1641ALIGN="LEFT"
1642VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001643>one of the XML_CHAR_ENCODING_... values.</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001644></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +00001645></TBODY
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001646></TABLE
1647><P
1648></P
1649></DIV
1650></DIV
1651><HR><DIV
1652CLASS="REFSECT2"
1653><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001654NAME="AEN21980"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001655></A
1656><H3
1657><A
1658NAME="XMLCHARENCOUTFUNC"
1659></A
1660>xmlCharEncOutFunc ()</H3
1661><TABLE
1662BORDER="0"
1663BGCOLOR="#D6E8FF"
1664WIDTH="100%"
1665CELLPADDING="6"
1666><TR
1667><TD
1668><PRE
1669CLASS="PROGRAMLISTING"
1670>int xmlCharEncOutFunc (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001671HREF="libxml-encoding.html#XMLCHARENCODINGHANDLER"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001672>xmlCharEncodingHandler</A
1673> *handler,
1674 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001675HREF="libxml-tree.html#XMLBUFFERPTR"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001676>xmlBufferPtr</A
1677> out,
1678 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001679HREF="libxml-tree.html#XMLBUFFERPTR"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001680>xmlBufferPtr</A
1681> in);</PRE
1682></TD
1683></TR
1684></TABLE
1685><P
1686>Generic front-end for the encoding handler output function
1687a first call with <TT
1688CLASS="PARAMETER"
1689><I
1690>in</I
1691></TT
1692> == NULL has to be made firs to initiate the
1693output in case of non-stateless encoding needing to initiate their
1694state or the output (like the BOM in UTF16).
1695In case of UTF8 sequence conversion errors for the given encoder,
1696the content will be automatically remapped to a CharRef sequence.</P
1697><P
1698></P
1699><DIV
1700CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001701><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001702NAME="AEN21990"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001703></A
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001704><P
1705></P
1706><TABLE
1707BORDER="0"
1708WIDTH="100%"
1709BGCOLOR="#FFD0D0"
1710CELLSPACING="0"
1711CELLPADDING="4"
1712CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001713><TBODY
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001714><TR
1715><TD
1716WIDTH="20%"
1717ALIGN="RIGHT"
1718VALIGN="TOP"
1719><TT
1720CLASS="PARAMETER"
1721><I
1722>handler</I
1723></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001724>&nbsp;:</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001725><TD
1726WIDTH="80%"
1727ALIGN="LEFT"
1728VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001729> char enconding transformation data structure</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001730></TR
1731><TR
1732><TD
1733WIDTH="20%"
1734ALIGN="RIGHT"
1735VALIGN="TOP"
1736><TT
1737CLASS="PARAMETER"
1738><I
1739>out</I
1740></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001741>&nbsp;:</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001742><TD
1743WIDTH="80%"
1744ALIGN="LEFT"
1745VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001746> an xmlBuffer for the output.</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001747></TR
1748><TR
1749><TD
1750WIDTH="20%"
1751ALIGN="RIGHT"
1752VALIGN="TOP"
1753><TT
1754CLASS="PARAMETER"
1755><I
Daniel Veillard06047432000-04-24 11:33:38 +00001756>in</I
Daniel Veillardedfb29b2000-03-14 19:59:05 +00001757></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001758>&nbsp;:</TD
Daniel Veillardedfb29b2000-03-14 19:59:05 +00001759><TD
1760WIDTH="80%"
1761ALIGN="LEFT"
1762VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001763> an xmlBuffer for the input</TD
Daniel Veillardedfb29b2000-03-14 19:59:05 +00001764></TR
1765><TR
1766><TD
1767WIDTH="20%"
1768ALIGN="RIGHT"
1769VALIGN="TOP"
1770><I
1771CLASS="EMPHASIS"
1772>Returns</I
1773> :</TD
1774><TD
1775WIDTH="80%"
1776ALIGN="LEFT"
1777VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001778>the number of byte written if success, or
1779-1 general error
1780-2 if the transcoding fails (for *in is not valid utf8 string or
1781the result of transformation can't fit into the encoding we want), or</TD
Daniel Veillardedfb29b2000-03-14 19:59:05 +00001782></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +00001783></TBODY
Daniel Veillardedfb29b2000-03-14 19:59:05 +00001784></TABLE
1785><P
1786></P
1787></DIV
1788></DIV
Daniel Veillard06047432000-04-24 11:33:38 +00001789><HR><DIV
1790CLASS="REFSECT2"
1791><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001792NAME="AEN22011"
Daniel Veillard06047432000-04-24 11:33:38 +00001793></A
1794><H3
1795><A
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001796NAME="XMLCHARENCINFUNC"
Daniel Veillard06047432000-04-24 11:33:38 +00001797></A
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001798>xmlCharEncInFunc ()</H3
Daniel Veillard06047432000-04-24 11:33:38 +00001799><TABLE
1800BORDER="0"
1801BGCOLOR="#D6E8FF"
1802WIDTH="100%"
1803CELLPADDING="6"
1804><TR
1805><TD
1806><PRE
1807CLASS="PROGRAMLISTING"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001808>int xmlCharEncInFunc (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001809HREF="libxml-encoding.html#XMLCHARENCODINGHANDLER"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001810>xmlCharEncodingHandler</A
1811> *handler,
1812 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001813HREF="libxml-tree.html#XMLBUFFERPTR"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001814>xmlBufferPtr</A
1815> out,
1816 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001817HREF="libxml-tree.html#XMLBUFFERPTR"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001818>xmlBufferPtr</A
1819> in);</PRE
Daniel Veillard06047432000-04-24 11:33:38 +00001820></TD
1821></TR
1822></TABLE
1823><P
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001824>Generic front-end for the encoding handler input function</P
Daniel Veillard06047432000-04-24 11:33:38 +00001825><P
1826></P
1827><DIV
1828CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001829><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001830NAME="AEN22020"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001831></A
Daniel Veillard06047432000-04-24 11:33:38 +00001832><P
1833></P
1834><TABLE
1835BORDER="0"
1836WIDTH="100%"
1837BGCOLOR="#FFD0D0"
1838CELLSPACING="0"
1839CELLPADDING="4"
1840CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001841><TBODY
Daniel Veillard06047432000-04-24 11:33:38 +00001842><TR
1843><TD
1844WIDTH="20%"
1845ALIGN="RIGHT"
1846VALIGN="TOP"
1847><TT
1848CLASS="PARAMETER"
1849><I
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001850>handler</I
Daniel Veillard06047432000-04-24 11:33:38 +00001851></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001852>&nbsp;:</TD
Daniel Veillard06047432000-04-24 11:33:38 +00001853><TD
1854WIDTH="80%"
1855ALIGN="LEFT"
1856VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001857> char enconding transformation data structure</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001858></TR
1859><TR
1860><TD
1861WIDTH="20%"
1862ALIGN="RIGHT"
1863VALIGN="TOP"
1864><TT
1865CLASS="PARAMETER"
1866><I
1867>out</I
1868></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001869>&nbsp;:</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001870><TD
1871WIDTH="80%"
1872ALIGN="LEFT"
1873VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001874> an xmlBuffer for the output.</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001875></TR
1876><TR
1877><TD
1878WIDTH="20%"
1879ALIGN="RIGHT"
1880VALIGN="TOP"
1881><TT
1882CLASS="PARAMETER"
1883><I
1884>in</I
1885></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001886>&nbsp;:</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001887><TD
1888WIDTH="80%"
1889ALIGN="LEFT"
1890VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001891> an xmlBuffer for the input</TD
Daniel Veillard06047432000-04-24 11:33:38 +00001892></TR
1893><TR
1894><TD
1895WIDTH="20%"
1896ALIGN="RIGHT"
1897VALIGN="TOP"
1898><I
1899CLASS="EMPHASIS"
1900>Returns</I
1901> :</TD
1902><TD
1903WIDTH="80%"
1904ALIGN="LEFT"
1905VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001906>the number of byte written if success, or
1907-1 general error
1908-2 if the transcoding fails (for *in is not valid utf8 string or
1909the result of transformation can't fit into the encoding we want), or</TD
Daniel Veillard06047432000-04-24 11:33:38 +00001910></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +00001911></TBODY
Daniel Veillard06047432000-04-24 11:33:38 +00001912></TABLE
1913><P
1914></P
1915></DIV
1916></DIV
1917><HR><DIV
1918CLASS="REFSECT2"
1919><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001920NAME="AEN22041"
Daniel Veillard06047432000-04-24 11:33:38 +00001921></A
1922><H3
1923><A
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001924NAME="XMLCHARENCFIRSTLINE"
Daniel Veillard06047432000-04-24 11:33:38 +00001925></A
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001926>xmlCharEncFirstLine ()</H3
Daniel Veillard06047432000-04-24 11:33:38 +00001927><TABLE
1928BORDER="0"
1929BGCOLOR="#D6E8FF"
1930WIDTH="100%"
1931CELLPADDING="6"
1932><TR
1933><TD
1934><PRE
1935CLASS="PROGRAMLISTING"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001936>int xmlCharEncFirstLine (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001937HREF="libxml-encoding.html#XMLCHARENCODINGHANDLER"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001938>xmlCharEncodingHandler</A
1939> *handler,
1940 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001941HREF="libxml-tree.html#XMLBUFFERPTR"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001942>xmlBufferPtr</A
1943> out,
1944 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001945HREF="libxml-tree.html#XMLBUFFERPTR"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001946>xmlBufferPtr</A
1947> in);</PRE
Daniel Veillard06047432000-04-24 11:33:38 +00001948></TD
1949></TR
1950></TABLE
1951><P
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001952>Front-end for the encoding handler input function, but handle only
1953the very first line, i.e. limit itself to 45 chars.</P
Daniel Veillard06047432000-04-24 11:33:38 +00001954><P
1955></P
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001956><DIV
1957CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001958><A
Daniel Veillardf012a642001-07-23 19:10:52 +00001959NAME="AEN22050"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001960></A
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001961><P
1962></P
1963><TABLE
1964BORDER="0"
1965WIDTH="100%"
1966BGCOLOR="#FFD0D0"
1967CELLSPACING="0"
1968CELLPADDING="4"
1969CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00001970><TBODY
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001971><TR
1972><TD
1973WIDTH="20%"
1974ALIGN="RIGHT"
1975VALIGN="TOP"
1976><TT
1977CLASS="PARAMETER"
1978><I
1979>handler</I
1980></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001981>&nbsp;:</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001982><TD
1983WIDTH="80%"
1984ALIGN="LEFT"
1985VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00001986> char enconding transformation data structure</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001987></TR
1988><TR
1989><TD
1990WIDTH="20%"
1991ALIGN="RIGHT"
1992VALIGN="TOP"
1993><TT
1994CLASS="PARAMETER"
1995><I
1996>out</I
1997></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00001998>&nbsp;:</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00001999><TD
2000WIDTH="80%"
2001ALIGN="LEFT"
2002VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002003> an xmlBuffer for the output.</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00002004></TR
2005><TR
2006><TD
2007WIDTH="20%"
2008ALIGN="RIGHT"
2009VALIGN="TOP"
2010><TT
2011CLASS="PARAMETER"
2012><I
2013>in</I
2014></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00002015>&nbsp;:</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00002016><TD
2017WIDTH="80%"
2018ALIGN="LEFT"
2019VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002020> an xmlBuffer for the input</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00002021></TR
2022><TR
2023><TD
2024WIDTH="20%"
2025ALIGN="RIGHT"
2026VALIGN="TOP"
2027><I
2028CLASS="EMPHASIS"
2029>Returns</I
2030> :</TD
2031><TD
2032WIDTH="80%"
2033ALIGN="LEFT"
2034VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002035>the number of byte written if success, or
2036-1 general error
2037-2 if the transcoding fails (for *in is not valid utf8 string or
2038the result of transformation can't fit into the encoding we want), or</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00002039></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +00002040></TBODY
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00002041></TABLE
2042><P
2043></P
2044></DIV
2045></DIV
2046><HR><DIV
2047CLASS="REFSECT2"
2048><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002049NAME="AEN22071"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00002050></A
2051><H3
2052><A
2053NAME="XMLCHARENCCLOSEFUNC"
2054></A
2055>xmlCharEncCloseFunc ()</H3
2056><TABLE
2057BORDER="0"
2058BGCOLOR="#D6E8FF"
2059WIDTH="100%"
2060CELLPADDING="6"
2061><TR
2062><TD
2063><PRE
2064CLASS="PROGRAMLISTING"
2065>int xmlCharEncCloseFunc (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00002066HREF="libxml-encoding.html#XMLCHARENCODINGHANDLER"
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00002067>xmlCharEncodingHandler</A
2068> *handler);</PRE
2069></TD
2070></TR
2071></TABLE
2072><P
2073>Generic front-end for hencoding handler close function</P
2074><P
2075></P
2076><DIV
2077CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00002078><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002079NAME="AEN22078"
Daniel Veillardbed7b052001-05-19 14:59:49 +00002080></A
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00002081><P
2082></P
2083><TABLE
2084BORDER="0"
2085WIDTH="100%"
2086BGCOLOR="#FFD0D0"
2087CELLSPACING="0"
2088CELLPADDING="4"
2089CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00002090><TBODY
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00002091><TR
2092><TD
2093WIDTH="20%"
2094ALIGN="RIGHT"
2095VALIGN="TOP"
2096><TT
2097CLASS="PARAMETER"
2098><I
2099>handler</I
2100></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00002101>&nbsp;:</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00002102><TD
2103WIDTH="80%"
2104ALIGN="LEFT"
2105VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002106> char enconding transformation data structure</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00002107></TR
2108><TR
2109><TD
2110WIDTH="20%"
2111ALIGN="RIGHT"
2112VALIGN="TOP"
2113><I
2114CLASS="EMPHASIS"
2115>Returns</I
2116> :</TD
2117><TD
2118WIDTH="80%"
2119ALIGN="LEFT"
2120VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002121>0 if success, or -1 in case of error</TD
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00002122></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +00002123></TBODY
Daniel Veillard3f6f7f62000-06-30 17:58:25 +00002124></TABLE
2125><P
2126></P
2127></DIV
Daniel Veillard06047432000-04-24 11:33:38 +00002128></DIV
Daniel Veillarda41123c2001-04-22 19:31:20 +00002129><HR><DIV
2130CLASS="REFSECT2"
2131><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002132NAME="AEN22091"
Daniel Veillarda41123c2001-04-22 19:31:20 +00002133></A
2134><H3
2135><A
2136NAME="UTF8TOISOLAT1"
2137></A
2138>UTF8Toisolat1 ()</H3
2139><TABLE
2140BORDER="0"
2141BGCOLOR="#D6E8FF"
2142WIDTH="100%"
2143CELLPADDING="6"
2144><TR
2145><TD
2146><PRE
2147CLASS="PROGRAMLISTING"
2148>int UTF8Toisolat1 (unsigned char *out,
2149 int *outlen,
2150 unsigned char *in,
2151 int *inlen);</PRE
2152></TD
2153></TR
2154></TABLE
2155><P
2156>Take a block of UTF-8 chars in and try to convert it to an ISO Latin 1
2157block of chars out.</P
2158><P
2159></P
2160><DIV
2161CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00002162><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002163NAME="AEN22097"
Daniel Veillardbed7b052001-05-19 14:59:49 +00002164></A
Daniel Veillarda41123c2001-04-22 19:31:20 +00002165><P
2166></P
2167><TABLE
2168BORDER="0"
2169WIDTH="100%"
2170BGCOLOR="#FFD0D0"
2171CELLSPACING="0"
2172CELLPADDING="4"
2173CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00002174><TBODY
Daniel Veillarda41123c2001-04-22 19:31:20 +00002175><TR
2176><TD
2177WIDTH="20%"
2178ALIGN="RIGHT"
2179VALIGN="TOP"
2180><TT
2181CLASS="PARAMETER"
2182><I
2183>out</I
2184></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00002185>&nbsp;:</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002186><TD
2187WIDTH="80%"
2188ALIGN="LEFT"
2189VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002190> a pointer to an array of bytes to store the result</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002191></TR
2192><TR
2193><TD
2194WIDTH="20%"
2195ALIGN="RIGHT"
2196VALIGN="TOP"
2197><TT
2198CLASS="PARAMETER"
2199><I
2200>outlen</I
2201></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00002202>&nbsp;:</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002203><TD
2204WIDTH="80%"
2205ALIGN="LEFT"
2206VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002207> the length of <TT
2208CLASS="PARAMETER"
2209><I
2210>out</I
2211></TT
2212></TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002213></TR
2214><TR
2215><TD
2216WIDTH="20%"
2217ALIGN="RIGHT"
2218VALIGN="TOP"
2219><TT
2220CLASS="PARAMETER"
2221><I
2222>in</I
2223></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00002224>&nbsp;:</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002225><TD
2226WIDTH="80%"
2227ALIGN="LEFT"
2228VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002229> a pointer to an array of UTF-8 chars</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002230></TR
2231><TR
2232><TD
2233WIDTH="20%"
2234ALIGN="RIGHT"
2235VALIGN="TOP"
2236><TT
2237CLASS="PARAMETER"
2238><I
2239>inlen</I
2240></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00002241>&nbsp;:</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002242><TD
2243WIDTH="80%"
2244ALIGN="LEFT"
2245VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002246> the length of <TT
2247CLASS="PARAMETER"
2248><I
2249>in</I
2250></TT
2251></TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002252></TR
2253><TR
2254><TD
2255WIDTH="20%"
2256ALIGN="RIGHT"
2257VALIGN="TOP"
2258><I
2259CLASS="EMPHASIS"
2260>Returns</I
2261> :</TD
2262><TD
2263WIDTH="80%"
2264ALIGN="LEFT"
2265VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002266>0 if success, -2 if the transcoding fails, or -1 otherwise
2267The value of <TT
2268CLASS="PARAMETER"
2269><I
2270>inlen</I
2271></TT
2272> after return is the number of octets consumed
2273as the return value is positive, else unpredictiable.
2274The value of <TT
2275CLASS="PARAMETER"
2276><I
2277>outlen</I
2278></TT
2279> after return is the number of ocetes consumed.</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002280></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +00002281></TBODY
Daniel Veillarda41123c2001-04-22 19:31:20 +00002282></TABLE
2283><P
2284></P
2285></DIV
2286></DIV
2287><HR><DIV
2288CLASS="REFSECT2"
2289><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002290NAME="AEN22126"
Daniel Veillarda41123c2001-04-22 19:31:20 +00002291></A
2292><H3
2293><A
2294NAME="ISOLAT1TOUTF8"
2295></A
2296>isolat1ToUTF8 ()</H3
2297><TABLE
2298BORDER="0"
2299BGCOLOR="#D6E8FF"
2300WIDTH="100%"
2301CELLPADDING="6"
2302><TR
2303><TD
2304><PRE
2305CLASS="PROGRAMLISTING"
2306>int isolat1ToUTF8 (unsigned char *out,
2307 int *outlen,
2308 unsigned char *in,
2309 int *inlen);</PRE
2310></TD
2311></TR
2312></TABLE
2313><P
2314>Take a block of ISO Latin 1 chars in and try to convert it to an UTF-8
2315block of chars out.</P
2316><P
2317></P
2318><DIV
2319CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00002320><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002321NAME="AEN22132"
Daniel Veillardbed7b052001-05-19 14:59:49 +00002322></A
Daniel Veillarda41123c2001-04-22 19:31:20 +00002323><P
2324></P
2325><TABLE
2326BORDER="0"
2327WIDTH="100%"
2328BGCOLOR="#FFD0D0"
2329CELLSPACING="0"
2330CELLPADDING="4"
2331CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00002332><TBODY
Daniel Veillarda41123c2001-04-22 19:31:20 +00002333><TR
2334><TD
2335WIDTH="20%"
2336ALIGN="RIGHT"
2337VALIGN="TOP"
2338><TT
2339CLASS="PARAMETER"
2340><I
2341>out</I
2342></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00002343>&nbsp;:</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002344><TD
2345WIDTH="80%"
2346ALIGN="LEFT"
2347VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002348> a pointer to an array of bytes to store the result</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002349></TR
2350><TR
2351><TD
2352WIDTH="20%"
2353ALIGN="RIGHT"
2354VALIGN="TOP"
2355><TT
2356CLASS="PARAMETER"
2357><I
2358>outlen</I
2359></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00002360>&nbsp;:</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002361><TD
2362WIDTH="80%"
2363ALIGN="LEFT"
2364VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002365> the length of <TT
2366CLASS="PARAMETER"
2367><I
2368>out</I
2369></TT
2370></TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002371></TR
2372><TR
2373><TD
2374WIDTH="20%"
2375ALIGN="RIGHT"
2376VALIGN="TOP"
2377><TT
2378CLASS="PARAMETER"
2379><I
2380>in</I
2381></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00002382>&nbsp;:</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002383><TD
2384WIDTH="80%"
2385ALIGN="LEFT"
2386VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002387> a pointer to an array of ISO Latin 1 chars</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002388></TR
2389><TR
2390><TD
2391WIDTH="20%"
2392ALIGN="RIGHT"
2393VALIGN="TOP"
2394><TT
2395CLASS="PARAMETER"
2396><I
2397>inlen</I
2398></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00002399>&nbsp;:</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002400><TD
2401WIDTH="80%"
2402ALIGN="LEFT"
2403VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002404> the length of <TT
2405CLASS="PARAMETER"
2406><I
2407>in</I
2408></TT
2409></TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002410></TR
2411><TR
2412><TD
2413WIDTH="20%"
2414ALIGN="RIGHT"
2415VALIGN="TOP"
2416><I
2417CLASS="EMPHASIS"
2418>Returns</I
2419> :</TD
2420><TD
2421WIDTH="80%"
2422ALIGN="LEFT"
2423VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002424>0 if success, or -1 otherwise
2425The value of <TT
2426CLASS="PARAMETER"
2427><I
2428>inlen</I
2429></TT
2430> after return is the number of octets consumed
2431as the return value is positive, else unpredictiable.
2432The value of <TT
2433CLASS="PARAMETER"
2434><I
2435>outlen</I
2436></TT
2437> after return is the number of ocetes consumed.</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002438></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +00002439></TBODY
Daniel Veillarda41123c2001-04-22 19:31:20 +00002440></TABLE
2441><P
2442></P
2443></DIV
2444></DIV
2445><HR><DIV
2446CLASS="REFSECT2"
2447><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002448NAME="AEN22161"
Daniel Veillarda41123c2001-04-22 19:31:20 +00002449></A
2450><H3
2451><A
2452NAME="XMLCHECKUTF8"
2453></A
2454>xmlCheckUTF8 ()</H3
2455><TABLE
2456BORDER="0"
2457BGCOLOR="#D6E8FF"
2458WIDTH="100%"
2459CELLPADDING="6"
2460><TR
2461><TD
2462><PRE
2463CLASS="PROGRAMLISTING"
2464>int xmlCheckUTF8 (unsigned char *utf);</PRE
2465></TD
2466></TR
2467></TABLE
2468><P
2469>Checks <TT
2470CLASS="PARAMETER"
2471><I
2472>utf</I
2473></TT
2474> for being valid utf-8. <TT
2475CLASS="PARAMETER"
2476><I
2477>utf</I
2478></TT
2479> is assumed to be
2480null-terminated. This function is not super-strict, as it will
2481allow longer utf-8 sequences than necessary. Note that Java is
2482capable of producing these sequences if provoked. Also note, this
2483routine checks for the 4-byte maxiumum size, but does not check for
24840x10ffff maximum value.</P
2485><P
2486></P
2487><DIV
2488CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00002489><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002490NAME="AEN22169"
Daniel Veillardbed7b052001-05-19 14:59:49 +00002491></A
Daniel Veillarda41123c2001-04-22 19:31:20 +00002492><P
2493></P
2494><TABLE
2495BORDER="0"
2496WIDTH="100%"
2497BGCOLOR="#FFD0D0"
2498CELLSPACING="0"
2499CELLPADDING="4"
2500CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00002501><TBODY
Daniel Veillarda41123c2001-04-22 19:31:20 +00002502><TR
2503><TD
2504WIDTH="20%"
2505ALIGN="RIGHT"
2506VALIGN="TOP"
2507><TT
2508CLASS="PARAMETER"
2509><I
2510>utf</I
2511></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00002512>&nbsp;:</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002513><TD
2514WIDTH="80%"
2515ALIGN="LEFT"
2516VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002517> Pointer to putative utf-8 encoded string.</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002518></TR
2519><TR
2520><TD
2521WIDTH="20%"
2522ALIGN="RIGHT"
2523VALIGN="TOP"
2524><I
2525CLASS="EMPHASIS"
2526>Returns</I
2527> :</TD
2528><TD
2529WIDTH="80%"
2530ALIGN="LEFT"
2531VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002532> true if <TT
2533CLASS="PARAMETER"
2534><I
2535>utf</I
2536></TT
2537> is valid.</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00002538></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +00002539></TBODY
Daniel Veillarda41123c2001-04-22 19:31:20 +00002540></TABLE
2541><P
2542></P
2543></DIV
2544></DIV
2545><HR><DIV
2546CLASS="REFSECT2"
2547><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002548NAME="AEN22183"
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002549></A
2550><H3
2551><A
2552NAME="XMLUTF8STRSIZE"
2553></A
2554>xmlUTF8Strsize ()</H3
2555><TABLE
2556BORDER="0"
2557BGCOLOR="#D6E8FF"
2558WIDTH="100%"
2559CELLPADDING="6"
2560><TR
2561><TD
2562><PRE
2563CLASS="PROGRAMLISTING"
2564>int xmlUTF8Strsize (const <A
2565HREF="libxml-tree.html#XMLCHAR"
2566>xmlChar</A
2567> *utf,
2568 int len);</PRE
2569></TD
2570></TR
2571></TABLE
2572><P
2573>storage size of an UTF8 string</P
2574><P
2575></P
2576><DIV
2577CLASS="INFORMALTABLE"
2578><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002579NAME="AEN22190"
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002580></A
2581><P
2582></P
2583><TABLE
2584BORDER="0"
2585WIDTH="100%"
2586BGCOLOR="#FFD0D0"
2587CELLSPACING="0"
2588CELLPADDING="4"
2589CLASS="CALSTABLE"
2590><TBODY
2591><TR
2592><TD
2593WIDTH="20%"
2594ALIGN="RIGHT"
2595VALIGN="TOP"
2596><TT
2597CLASS="PARAMETER"
2598><I
2599>utf</I
2600></TT
2601>&nbsp;:</TD
2602><TD
2603WIDTH="80%"
2604ALIGN="LEFT"
2605VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002606> a sequence of UTF-8 encoded bytes</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002607></TR
2608><TR
2609><TD
2610WIDTH="20%"
2611ALIGN="RIGHT"
2612VALIGN="TOP"
2613><TT
2614CLASS="PARAMETER"
2615><I
2616>len</I
2617></TT
2618>&nbsp;:</TD
2619><TD
2620WIDTH="80%"
2621ALIGN="LEFT"
2622VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002623> the number of characters in the array</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002624></TR
2625><TR
2626><TD
2627WIDTH="20%"
2628ALIGN="RIGHT"
2629VALIGN="TOP"
2630><I
2631CLASS="EMPHASIS"
2632>Returns</I
2633> :</TD
2634><TD
2635WIDTH="80%"
2636ALIGN="LEFT"
2637VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002638>the storage size of
2639the first 'len' characters of ARRAY&#13;</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002640></TR
2641></TBODY
2642></TABLE
2643><P
2644></P
2645></DIV
2646></DIV
2647><HR><DIV
2648CLASS="REFSECT2"
2649><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002650NAME="AEN22207"
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002651></A
2652><H3
2653><A
2654NAME="XMLUTF8STRNDUP"
2655></A
2656>xmlUTF8Strndup ()</H3
2657><TABLE
2658BORDER="0"
2659BGCOLOR="#D6E8FF"
2660WIDTH="100%"
2661CELLPADDING="6"
2662><TR
2663><TD
2664><PRE
2665CLASS="PROGRAMLISTING"
2666><A
2667HREF="libxml-tree.html#XMLCHAR"
2668>xmlChar</A
2669>* xmlUTF8Strndup (const <A
2670HREF="libxml-tree.html#XMLCHAR"
2671>xmlChar</A
2672> *utf,
2673 int len);</PRE
2674></TD
2675></TR
2676></TABLE
2677><P
2678>a strndup for array of UTF8's</P
2679><P
2680></P
2681><DIV
2682CLASS="INFORMALTABLE"
2683><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002684NAME="AEN22215"
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002685></A
2686><P
2687></P
2688><TABLE
2689BORDER="0"
2690WIDTH="100%"
2691BGCOLOR="#FFD0D0"
2692CELLSPACING="0"
2693CELLPADDING="4"
2694CLASS="CALSTABLE"
2695><TBODY
2696><TR
2697><TD
2698WIDTH="20%"
2699ALIGN="RIGHT"
2700VALIGN="TOP"
2701><TT
2702CLASS="PARAMETER"
2703><I
2704>utf</I
2705></TT
2706>&nbsp;:</TD
2707><TD
2708WIDTH="80%"
2709ALIGN="LEFT"
2710VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002711> the input UTF8 *</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002712></TR
2713><TR
2714><TD
2715WIDTH="20%"
2716ALIGN="RIGHT"
2717VALIGN="TOP"
2718><TT
2719CLASS="PARAMETER"
2720><I
2721>len</I
2722></TT
2723>&nbsp;:</TD
2724><TD
2725WIDTH="80%"
2726ALIGN="LEFT"
2727VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002728> the len of <TT
2729CLASS="PARAMETER"
2730><I
2731>utf</I
2732></TT
2733> (in chars)</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002734></TR
2735><TR
2736><TD
2737WIDTH="20%"
2738ALIGN="RIGHT"
2739VALIGN="TOP"
2740><I
2741CLASS="EMPHASIS"
2742>Returns</I
2743> :</TD
2744><TD
2745WIDTH="80%"
2746ALIGN="LEFT"
2747VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002748>a new UTF8 * or NULL</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002749></TR
2750></TBODY
2751></TABLE
2752><P
2753></P
2754></DIV
2755></DIV
2756><HR><DIV
2757CLASS="REFSECT2"
2758><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002759NAME="AEN22233"
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002760></A
2761><H3
2762><A
2763NAME="XMLUTF8STRPOS"
2764></A
2765>xmlUTF8Strpos ()</H3
2766><TABLE
2767BORDER="0"
2768BGCOLOR="#D6E8FF"
2769WIDTH="100%"
2770CELLPADDING="6"
2771><TR
2772><TD
2773><PRE
2774CLASS="PROGRAMLISTING"
2775><A
2776HREF="libxml-tree.html#XMLCHAR"
2777>xmlChar</A
2778>* xmlUTF8Strpos (const <A
2779HREF="libxml-tree.html#XMLCHAR"
2780>xmlChar</A
2781> *utf,
2782 int pos);</PRE
2783></TD
2784></TR
2785></TABLE
2786><P
2787>a function to provide the equivalent of fetching a
2788character from a string array</P
2789><P
2790></P
2791><DIV
2792CLASS="INFORMALTABLE"
2793><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002794NAME="AEN22241"
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002795></A
2796><P
2797></P
2798><TABLE
2799BORDER="0"
2800WIDTH="100%"
2801BGCOLOR="#FFD0D0"
2802CELLSPACING="0"
2803CELLPADDING="4"
2804CLASS="CALSTABLE"
2805><TBODY
2806><TR
2807><TD
2808WIDTH="20%"
2809ALIGN="RIGHT"
2810VALIGN="TOP"
2811><TT
2812CLASS="PARAMETER"
2813><I
2814>utf</I
2815></TT
2816>&nbsp;:</TD
2817><TD
2818WIDTH="80%"
2819ALIGN="LEFT"
2820VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002821> the input UTF8 *</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002822></TR
2823><TR
2824><TD
2825WIDTH="20%"
2826ALIGN="RIGHT"
2827VALIGN="TOP"
2828><TT
2829CLASS="PARAMETER"
2830><I
2831>pos</I
2832></TT
2833>&nbsp;:</TD
2834><TD
2835WIDTH="80%"
2836ALIGN="LEFT"
2837VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002838> the position of the desired UTF8 char (in chars)</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002839></TR
2840><TR
2841><TD
2842WIDTH="20%"
2843ALIGN="RIGHT"
2844VALIGN="TOP"
2845><I
2846CLASS="EMPHASIS"
2847>Returns</I
2848> :</TD
2849><TD
2850WIDTH="80%"
2851ALIGN="LEFT"
2852VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002853>a pointer to the UTF8 character or NULL</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002854></TR
2855></TBODY
2856></TABLE
2857><P
2858></P
2859></DIV
2860></DIV
2861><HR><DIV
2862CLASS="REFSECT2"
2863><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002864NAME="AEN22258"
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002865></A
2866><H3
2867><A
2868NAME="XMLUTF8STRLOC"
2869></A
2870>xmlUTF8Strloc ()</H3
2871><TABLE
2872BORDER="0"
2873BGCOLOR="#D6E8FF"
2874WIDTH="100%"
2875CELLPADDING="6"
2876><TR
2877><TD
2878><PRE
2879CLASS="PROGRAMLISTING"
2880>int xmlUTF8Strloc (const <A
2881HREF="libxml-tree.html#XMLCHAR"
2882>xmlChar</A
2883> *utf,
2884 const <A
2885HREF="libxml-tree.html#XMLCHAR"
2886>xmlChar</A
2887> *utfchar);</PRE
2888></TD
2889></TR
2890></TABLE
2891><P
2892>a function to provide relative location of a UTF8 char</P
2893><P
2894></P
2895><DIV
2896CLASS="INFORMALTABLE"
2897><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002898NAME="AEN22266"
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002899></A
2900><P
2901></P
2902><TABLE
2903BORDER="0"
2904WIDTH="100%"
2905BGCOLOR="#FFD0D0"
2906CELLSPACING="0"
2907CELLPADDING="4"
2908CLASS="CALSTABLE"
2909><TBODY
2910><TR
2911><TD
2912WIDTH="20%"
2913ALIGN="RIGHT"
2914VALIGN="TOP"
2915><TT
2916CLASS="PARAMETER"
2917><I
2918>utf</I
2919></TT
2920>&nbsp;:</TD
2921><TD
2922WIDTH="80%"
2923ALIGN="LEFT"
2924VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002925> the input UTF8 *</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002926></TR
2927><TR
2928><TD
2929WIDTH="20%"
2930ALIGN="RIGHT"
2931VALIGN="TOP"
2932><TT
2933CLASS="PARAMETER"
2934><I
2935>utfchar</I
2936></TT
2937>&nbsp;:</TD
2938><TD
2939WIDTH="80%"
2940ALIGN="LEFT"
2941VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002942> the UTF8 character to be found</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002943></TR
2944><TR
2945><TD
2946WIDTH="20%"
2947ALIGN="RIGHT"
2948VALIGN="TOP"
2949><I
2950CLASS="EMPHASIS"
2951>Returns</I
2952> :</TD
2953><TD
2954WIDTH="80%"
2955ALIGN="LEFT"
2956VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00002957>the relative character position of the desired char
2958or -1 if not found</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002959></TR
2960></TBODY
2961></TABLE
2962><P
2963></P
2964></DIV
2965></DIV
2966><HR><DIV
2967CLASS="REFSECT2"
2968><A
Daniel Veillardf012a642001-07-23 19:10:52 +00002969NAME="AEN22283"
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002970></A
2971><H3
2972><A
2973NAME="XMLUTF8STRSUB"
2974></A
2975>xmlUTF8Strsub ()</H3
2976><TABLE
2977BORDER="0"
2978BGCOLOR="#D6E8FF"
2979WIDTH="100%"
2980CELLPADDING="6"
2981><TR
2982><TD
2983><PRE
2984CLASS="PROGRAMLISTING"
2985><A
2986HREF="libxml-tree.html#XMLCHAR"
2987>xmlChar</A
2988>* xmlUTF8Strsub (const <A
2989HREF="libxml-tree.html#XMLCHAR"
2990>xmlChar</A
2991> *utf,
2992 int start,
2993 int len);</PRE
2994></TD
2995></TR
2996></TABLE
2997><P
Daniel Veillard4ec885a2001-06-17 10:31:07 +00002998>Note: positions are given in units of UTF-8 chars</P
2999><P
3000></P
3001><DIV
3002CLASS="INFORMALTABLE"
3003><A
Daniel Veillardf012a642001-07-23 19:10:52 +00003004NAME="AEN22291"
Daniel Veillard4ec885a2001-06-17 10:31:07 +00003005></A
3006><P
3007></P
3008><TABLE
3009BORDER="0"
3010WIDTH="100%"
3011BGCOLOR="#FFD0D0"
3012CELLSPACING="0"
3013CELLPADDING="4"
3014CLASS="CALSTABLE"
3015><TBODY
3016><TR
3017><TD
3018WIDTH="20%"
3019ALIGN="RIGHT"
3020VALIGN="TOP"
3021><TT
3022CLASS="PARAMETER"
3023><I
3024>utf</I
3025></TT
3026>&nbsp;:</TD
3027><TD
3028WIDTH="80%"
3029ALIGN="LEFT"
3030VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00003031> a sequence of UTF-8 encoded bytes</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00003032></TR
3033><TR
3034><TD
3035WIDTH="20%"
3036ALIGN="RIGHT"
3037VALIGN="TOP"
3038><TT
3039CLASS="PARAMETER"
3040><I
3041>start</I
3042></TT
3043>&nbsp;:</TD
3044><TD
3045WIDTH="80%"
3046ALIGN="LEFT"
3047VALIGN="TOP"
Daniel Veillardf012a642001-07-23 19:10:52 +00003048> relative pos of first char</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00003049></TR
3050><TR
3051><TD
3052WIDTH="20%"
3053ALIGN="RIGHT"
3054VALIGN="TOP"
3055><TT
3056CLASS="PARAMETER"
3057><I
3058>len</I
3059></TT
3060>&nbsp;:</TD
3061><TD
3062WIDTH="80%"
3063ALIGN="LEFT"
3064VALIGN="TOP"
Daniel Veillardf012a642001-07-23 19:10:52 +00003065> total number to copy</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00003066></TR
3067><TR
3068><TD
3069WIDTH="20%"
3070ALIGN="RIGHT"
3071VALIGN="TOP"
3072><I
3073CLASS="EMPHASIS"
3074>Returns</I
3075> :</TD
3076><TD
3077WIDTH="80%"
3078ALIGN="LEFT"
3079VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00003080>a pointer to a newly created string
3081or NULL if any problem</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +00003082></TR
3083></TBODY
3084></TABLE
3085><P
3086></P
3087></DIV
3088></DIV
3089><HR><DIV
3090CLASS="REFSECT2"
3091><A
Daniel Veillardf012a642001-07-23 19:10:52 +00003092NAME="AEN22312"
Daniel Veillarda41123c2001-04-22 19:31:20 +00003093></A
3094><H3
3095><A
3096NAME="XMLUTF8STRLEN"
3097></A
3098>xmlUTF8Strlen ()</H3
3099><TABLE
3100BORDER="0"
3101BGCOLOR="#D6E8FF"
3102WIDTH="100%"
3103CELLPADDING="6"
3104><TR
3105><TD
3106><PRE
3107CLASS="PROGRAMLISTING"
Daniel Veillard4ec885a2001-06-17 10:31:07 +00003108>int xmlUTF8Strlen (const <A
3109HREF="libxml-tree.html#XMLCHAR"
3110>xmlChar</A
3111> *utf);</PRE
Daniel Veillarda41123c2001-04-22 19:31:20 +00003112></TD
3113></TR
3114></TABLE
3115><P
3116>compute the lenght of an UTF8 string, it doesn't do a full UTF8
3117checking of the content of the string.</P
3118><P
3119></P
3120><DIV
3121CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00003122><A
Daniel Veillardf012a642001-07-23 19:10:52 +00003123NAME="AEN22319"
Daniel Veillardbed7b052001-05-19 14:59:49 +00003124></A
Daniel Veillarda41123c2001-04-22 19:31:20 +00003125><P
3126></P
3127><TABLE
3128BORDER="0"
3129WIDTH="100%"
3130BGCOLOR="#FFD0D0"
3131CELLSPACING="0"
3132CELLPADDING="4"
3133CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +00003134><TBODY
Daniel Veillarda41123c2001-04-22 19:31:20 +00003135><TR
3136><TD
3137WIDTH="20%"
3138ALIGN="RIGHT"
3139VALIGN="TOP"
3140><TT
3141CLASS="PARAMETER"
3142><I
3143>utf</I
3144></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +00003145>&nbsp;:</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00003146><TD
3147WIDTH="80%"
3148ALIGN="LEFT"
3149VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00003150> a sequence of UTF-8 encoded bytes</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00003151></TR
3152><TR
3153><TD
3154WIDTH="20%"
3155ALIGN="RIGHT"
3156VALIGN="TOP"
3157><I
3158CLASS="EMPHASIS"
3159>Returns</I
3160> :</TD
3161><TD
3162WIDTH="80%"
3163ALIGN="LEFT"
3164VALIGN="TOP"
Daniel Veillard4b8328d2001-07-05 22:48:42 +00003165>the number of characters in the string or -1 in case of error</TD
Daniel Veillarda41123c2001-04-22 19:31:20 +00003166></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +00003167></TBODY
Daniel Veillarda41123c2001-04-22 19:31:20 +00003168></TABLE
3169><P
3170></P
3171></DIV
3172></DIV
Daniel Veillardaeea04f2000-01-25 19:27:27 +00003173></DIV
3174><DIV
3175CLASS="NAVFOOTER"
3176><BR
3177CLEAR="all"><BR><TABLE
3178WIDTH="100%"
3179BORDER="0"
3180BGCOLOR="#000000"
3181CELLPADDING="1"
3182CELLSPACING="0"
3183><TR
3184><TD
3185WIDTH="25%"
3186BGCOLOR="#C00000"
3187ALIGN="left"
3188><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00003189HREF="libxml-parserinternals.html"
Daniel Veillardaeea04f2000-01-25 19:27:27 +00003190><FONT
3191COLOR="#FFFFFF"
3192SIZE="3"
3193><B
3194>&#60;&#60;&#60; Previous Page</B
3195></FONT
3196></A
3197></TD
3198><TD
3199WIDTH="25%"
3200BGCOLOR="#0000C0"
3201ALIGN="center"
3202><FONT
3203COLOR="#FFFFFF"
3204SIZE="3"
3205><B
3206><A
3207HREF="book1.html"
3208><FONT
3209COLOR="#FFFFFF"
3210SIZE="3"
3211><B
3212>Home</B
3213></FONT
3214></A
3215></B
3216></FONT
3217></TD
3218><TD
3219WIDTH="25%"
3220BGCOLOR="#00C000"
3221ALIGN="center"
3222><FONT
3223COLOR="#FFFFFF"
3224SIZE="3"
3225><B
3226><A
3227HREF="libxml-lib.html"
3228><FONT
3229COLOR="#FFFFFF"
3230SIZE="3"
3231><B
3232>Up</B
3233></FONT
3234></A
3235></B
3236></FONT
3237></TD
3238><TD
3239WIDTH="25%"
3240BGCOLOR="#C00000"
3241ALIGN="right"
3242><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00003243HREF="libxml-debugxml.html"
Daniel Veillardaeea04f2000-01-25 19:27:27 +00003244><FONT
3245COLOR="#FFFFFF"
3246SIZE="3"
3247><B
3248>Next Page &#62;&#62;&#62;</B
3249></FONT
3250></A
3251></TD
3252></TR
3253><TR
3254><TD
3255COLSPAN="2"
3256ALIGN="left"
3257><FONT
3258COLOR="#FFFFFF"
3259SIZE="3"
3260><B
3261>parserInternals</B
3262></FONT
3263></TD
3264><TD
3265COLSPAN="2"
3266ALIGN="right"
3267><FONT
3268COLOR="#FFFFFF"
3269SIZE="3"
3270><B
3271>debugXML</B
3272></FONT
3273></TD
3274></TR
3275></TABLE
3276></DIV
3277></BODY
3278></HTML
3279>