- cleaned up the FTP module, did the API, extracted docs
[baserock-morphs:libxml2.git] / doc / html / gnome-xml-xmlio.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >xmlIO</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.33"><LINK
8 REL="HOME"
9 TITLE="Gnome XML Library Reference Manual"
10 HREF="book1.html"><LINK
11 REL="UP"
12 TITLE="Libxml Library Reference"
13 HREF="libxml-lib.html"><LINK
14 REL="PREVIOUS"
15 TITLE="nanoftp"
16 HREF="gnome-xml-nanoftp.html"><LINK
17 REL="NEXT"
18 TITLE="parserInternals"
19 HREF="gnome-xml-parserinternals.html"></HEAD
20 ><BODY
21 BGCOLOR="#FFFFFF"
22 TEXT="#000000"
23 ><DIV
24 CLASS="NAVHEADER"
25 ><TABLE
26 WIDTH="100%"
27 BORDER="0"
28 BGCOLOR="#000000"
29 CELLPADDING="1"
30 CELLSPACING="0"
31 ><TR
32 ><TH
33 COLSPAN="4"
34 ALIGN="center"
35 ><FONT
36 COLOR="#FFFFFF"
37 SIZE="5"
38 >Gnome XML Library Reference Manual</FONT
39 ></TH
40 ></TR
41 ><TR
42 ><TD
43 WIDTH="25%"
44 BGCOLOR="#C00000"
45 ALIGN="left"
46 ><A
47 HREF="gnome-xml-nanoftp.html"
48 ><FONT
49 COLOR="#FFFFFF"
50 SIZE="3"
51 ><B
52 >&#60;&#60;&#60; Previous Page</B
53 ></FONT
54 ></A
55 ></TD
56 ><TD
57 WIDTH="25%"
58 BGCOLOR="#0000C0"
59 ALIGN="center"
60 ><FONT
61 COLOR="#FFFFFF"
62 SIZE="3"
63 ><B
64 ><A
65 HREF="book1.html"
66 ><FONT
67 COLOR="#FFFFFF"
68 SIZE="3"
69 ><B
70 >Home</B
71 ></FONT
72 ></A
73 ></B
74 ></FONT
75 ></TD
76 ><TD
77 WIDTH="25%"
78 BGCOLOR="#00C000"
79 ALIGN="center"
80 ><FONT
81 COLOR="#FFFFFF"
82 SIZE="3"
83 ><B
84 ><A
85 HREF="libxml-lib.html"
86 ><FONT
87 COLOR="#FFFFFF"
88 SIZE="3"
89 ><B
90 >Up</B
91 ></FONT
92 ></A
93 ></B
94 ></FONT
95 ></TD
96 ><TD
97 WIDTH="25%"
98 BGCOLOR="#C00000"
99 ALIGN="right"
100 ><A
101 HREF="gnome-xml-parserinternals.html"
102 ><FONT
103 COLOR="#FFFFFF"
104 SIZE="3"
105 ><B
106 >Next Page &#62;&#62;&#62;</B
107 ></FONT
108 ></A
109 ></TD
110 ></TR
111 ></TABLE
112 ></DIV
113 ><H1
114 >xmlIO</H1
115 ><DIV
116 CLASS="REFNAMEDIV"
117 ><A
118 NAME="AEN9747"
119 ></A
120 ><H2
121 >Name</H2
122 >xmlIO &#8212; </DIV
123 ><DIV
124 CLASS="REFSYNOPSISDIV"
125 ><A
126 NAME="AEN9750"
127 ></A
128 ><H2
129 >Synopsis</H2
130 ><TABLE
131 BORDER="0"
132 BGCOLOR="#D6E8FF"
133 WIDTH="100%"
134 CELLPADDING="6"
135 ><TR
136 ><TD
137 ><PRE
138 CLASS="SYNOPSIS"
139 >&#13;
140
141 struct      <A
142 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFER"
143 >xmlParserInputBuffer</A
144 >;
145 typedef     <A
146 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
147 >xmlParserInputBufferPtr</A
148 >;
149 <A
150 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
151 >xmlParserInputBufferPtr</A
152 > <A
153 HREF="gnome-xml-xmlio.html#XMLALLOCPARSERINPUTBUFFER"
154 >xmlAllocParserInputBuffer</A
155 >
156                                             (<A
157 HREF="gnome-xml-encoding.html#XMLCHARENCODING"
158 >xmlCharEncoding</A
159 > enc);
160 <A
161 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
162 >xmlParserInputBufferPtr</A
163 > <A
164 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERCREATEFILENAME"
165 >xmlParserInputBufferCreateFilename</A
166 >
167                                             (const char *filename,
168                                              <A
169 HREF="gnome-xml-encoding.html#XMLCHARENCODING"
170 >xmlCharEncoding</A
171 > enc);
172 <A
173 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
174 >xmlParserInputBufferPtr</A
175 > <A
176 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERCREATEFILE"
177 >xmlParserInputBufferCreateFile</A
178 >
179                                             (<GTKDOCLINK
180 HREF="FILE"
181 >FILE</GTKDOCLINK
182 > *file,
183                                              <A
184 HREF="gnome-xml-encoding.html#XMLCHARENCODING"
185 >xmlCharEncoding</A
186 > enc);
187 <A
188 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
189 >xmlParserInputBufferPtr</A
190 > <A
191 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERCREATEFD"
192 >xmlParserInputBufferCreateFd</A
193 >
194                                             (int fd,
195                                              <A
196 HREF="gnome-xml-encoding.html#XMLCHARENCODING"
197 >xmlCharEncoding</A
198 > enc);
199 int         <A
200 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERREAD"
201 >xmlParserInputBufferRead</A
202 >        (<A
203 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
204 >xmlParserInputBufferPtr</A
205 > in,
206                                              int len);
207 int         <A
208 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERGROW"
209 >xmlParserInputBufferGrow</A
210 >        (<A
211 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
212 >xmlParserInputBufferPtr</A
213 > in,
214                                              int len);
215 int         <A
216 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPUSH"
217 >xmlParserInputBufferPush</A
218 >        (<A
219 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
220 >xmlParserInputBufferPtr</A
221 > in,
222                                              int len,
223                                              const char *buf);
224 void        <A
225 HREF="gnome-xml-xmlio.html#XMLFREEPARSERINPUTBUFFER"
226 >xmlFreeParserInputBuffer</A
227 >        (<A
228 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
229 >xmlParserInputBufferPtr</A
230 > in);
231 char*       <A
232 HREF="gnome-xml-xmlio.html#XMLPARSERGETDIRECTORY"
233 >xmlParserGetDirectory</A
234 >           (const char *filename);</PRE
235 ></TD
236 ></TR
237 ></TABLE
238 ></DIV
239 ><DIV
240 CLASS="REFSECT1"
241 ><A
242 NAME="AEN9777"
243 ></A
244 ><H2
245 >Description</H2
246 ><P
247 ></P
248 ></DIV
249 ><DIV
250 CLASS="REFSECT1"
251 ><A
252 NAME="AEN9780"
253 ></A
254 ><H2
255 >Details</H2
256 ><DIV
257 CLASS="REFSECT2"
258 ><A
259 NAME="AEN9782"
260 ></A
261 ><H3
262 ><A
263 NAME="XMLPARSERINPUTBUFFER"
264 ></A
265 >struct xmlParserInputBuffer</H3
266 ><TABLE
267 BORDER="0"
268 BGCOLOR="#D6E8FF"
269 WIDTH="100%"
270 CELLPADDING="6"
271 ><TR
272 ><TD
273 ><PRE
274 CLASS="PROGRAMLISTING"
275 >struct xmlParserInputBuffer {
276     /* Inputs */
277     FILE          *file;    /* Input on file handler */
278     void*        gzfile;    /* Input on a compressed stream */
279     int              fd;    /* Input on a file descriptor */
280     void        *httpIO;    /* Input from an HTTP stream */
281     void         *ftpIO;    /* Input from an FTP stream */
282     
283     xmlCharEncodingHandlerPtr encoder; /* I18N conversions to UTF-8 */
284     
285     xmlBufferPtr buffer;    /* Local buffer encoded in  UTF-8 */
286 };</PRE
287 ></TD
288 ></TR
289 ></TABLE
290 ><P
291 ></P
292 ></DIV
293 ><HR><DIV
294 CLASS="REFSECT2"
295 ><A
296 NAME="AEN9787"
297 ></A
298 ><H3
299 ><A
300 NAME="XMLPARSERINPUTBUFFERPTR"
301 ></A
302 >xmlParserInputBufferPtr</H3
303 ><TABLE
304 BORDER="0"
305 BGCOLOR="#D6E8FF"
306 WIDTH="100%"
307 CELLPADDING="6"
308 ><TR
309 ><TD
310 ><PRE
311 CLASS="PROGRAMLISTING"
312 >typedef xmlParserInputBuffer *xmlParserInputBufferPtr;</PRE
313 ></TD
314 ></TR
315 ></TABLE
316 ><P
317 ></P
318 ></DIV
319 ><HR><DIV
320 CLASS="REFSECT2"
321 ><A
322 NAME="AEN9792"
323 ></A
324 ><H3
325 ><A
326 NAME="XMLALLOCPARSERINPUTBUFFER"
327 ></A
328 >xmlAllocParserInputBuffer ()</H3
329 ><TABLE
330 BORDER="0"
331 BGCOLOR="#D6E8FF"
332 WIDTH="100%"
333 CELLPADDING="6"
334 ><TR
335 ><TD
336 ><PRE
337 CLASS="PROGRAMLISTING"
338 ><A
339 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
340 >xmlParserInputBufferPtr</A
341 > xmlAllocParserInputBuffer
342                                             (<A
343 HREF="gnome-xml-encoding.html#XMLCHARENCODING"
344 >xmlCharEncoding</A
345 > enc);</PRE
346 ></TD
347 ></TR
348 ></TABLE
349 ><P
350 >Create a buffered parser input for progressive parsing</P
351 ><P
352 ></P
353 ><DIV
354 CLASS="INFORMALTABLE"
355 ><P
356 ></P
357 ><TABLE
358 BORDER="0"
359 WIDTH="100%"
360 BGCOLOR="#FFD0D0"
361 CELLSPACING="0"
362 CELLPADDING="4"
363 CLASS="CALSTABLE"
364 ><TR
365 ><TD
366 WIDTH="20%"
367 ALIGN="RIGHT"
368 VALIGN="TOP"
369 ><TT
370 CLASS="PARAMETER"
371 ><I
372 >enc</I
373 ></TT
374 >&nbsp;:</TD
375 ><TD
376 WIDTH="80%"
377 ALIGN="LEFT"
378 VALIGN="TOP"
379 >  the charset encoding if known</TD
380 ></TR
381 ><TR
382 ><TD
383 WIDTH="20%"
384 ALIGN="RIGHT"
385 VALIGN="TOP"
386 ><I
387 CLASS="EMPHASIS"
388 >Returns</I
389 > :</TD
390 ><TD
391 WIDTH="80%"
392 ALIGN="LEFT"
393 VALIGN="TOP"
394 >the new parser input or NULL</TD
395 ></TR
396 ></TABLE
397 ><P
398 ></P
399 ></DIV
400 ></DIV
401 ><HR><DIV
402 CLASS="REFSECT2"
403 ><A
404 NAME="AEN9813"
405 ></A
406 ><H3
407 ><A
408 NAME="XMLPARSERINPUTBUFFERCREATEFILENAME"
409 ></A
410 >xmlParserInputBufferCreateFilename ()</H3
411 ><TABLE
412 BORDER="0"
413 BGCOLOR="#D6E8FF"
414 WIDTH="100%"
415 CELLPADDING="6"
416 ><TR
417 ><TD
418 ><PRE
419 CLASS="PROGRAMLISTING"
420 ><A
421 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
422 >xmlParserInputBufferPtr</A
423 > xmlParserInputBufferCreateFilename
424                                             (const char *filename,
425                                              <A
426 HREF="gnome-xml-encoding.html#XMLCHARENCODING"
427 >xmlCharEncoding</A
428 > enc);</PRE
429 ></TD
430 ></TR
431 ></TABLE
432 ><P
433 >Create a buffered parser input for the progressive parsing of a file
434 If filename is "-' then we use stdin as the input.
435 Automatic support for ZLIB/Compress compressed document is provided
436 by default if found at compile-time.</P
437 ><P
438 ></P
439 ><DIV
440 CLASS="INFORMALTABLE"
441 ><P
442 ></P
443 ><TABLE
444 BORDER="0"
445 WIDTH="100%"
446 BGCOLOR="#FFD0D0"
447 CELLSPACING="0"
448 CELLPADDING="4"
449 CLASS="CALSTABLE"
450 ><TR
451 ><TD
452 WIDTH="20%"
453 ALIGN="RIGHT"
454 VALIGN="TOP"
455 ><TT
456 CLASS="PARAMETER"
457 ><I
458 >filename</I
459 ></TT
460 >&nbsp;:</TD
461 ><TD
462 WIDTH="80%"
463 ALIGN="LEFT"
464 VALIGN="TOP"
465 >  a C string containing the filename</TD
466 ></TR
467 ><TR
468 ><TD
469 WIDTH="20%"
470 ALIGN="RIGHT"
471 VALIGN="TOP"
472 ><TT
473 CLASS="PARAMETER"
474 ><I
475 >enc</I
476 ></TT
477 >&nbsp;:</TD
478 ><TD
479 WIDTH="80%"
480 ALIGN="LEFT"
481 VALIGN="TOP"
482 >  the charset encoding if known</TD
483 ></TR
484 ><TR
485 ><TD
486 WIDTH="20%"
487 ALIGN="RIGHT"
488 VALIGN="TOP"
489 ><I
490 CLASS="EMPHASIS"
491 >Returns</I
492 > :</TD
493 ><TD
494 WIDTH="80%"
495 ALIGN="LEFT"
496 VALIGN="TOP"
497 >the new parser input or NULL</TD
498 ></TR
499 ></TABLE
500 ><P
501 ></P
502 ></DIV
503 ></DIV
504 ><HR><DIV
505 CLASS="REFSECT2"
506 ><A
507 NAME="AEN9838"
508 ></A
509 ><H3
510 ><A
511 NAME="XMLPARSERINPUTBUFFERCREATEFILE"
512 ></A
513 >xmlParserInputBufferCreateFile ()</H3
514 ><TABLE
515 BORDER="0"
516 BGCOLOR="#D6E8FF"
517 WIDTH="100%"
518 CELLPADDING="6"
519 ><TR
520 ><TD
521 ><PRE
522 CLASS="PROGRAMLISTING"
523 ><A
524 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
525 >xmlParserInputBufferPtr</A
526 > xmlParserInputBufferCreateFile
527                                             (<GTKDOCLINK
528 HREF="FILE"
529 >FILE</GTKDOCLINK
530 > *file,
531                                              <A
532 HREF="gnome-xml-encoding.html#XMLCHARENCODING"
533 >xmlCharEncoding</A
534 > enc);</PRE
535 ></TD
536 ></TR
537 ></TABLE
538 ><P
539 >Create a buffered parser input for the progressive parsing of a FILE *
540 buffered C I/O</P
541 ><P
542 ></P
543 ><DIV
544 CLASS="INFORMALTABLE"
545 ><P
546 ></P
547 ><TABLE
548 BORDER="0"
549 WIDTH="100%"
550 BGCOLOR="#FFD0D0"
551 CELLSPACING="0"
552 CELLPADDING="4"
553 CLASS="CALSTABLE"
554 ><TR
555 ><TD
556 WIDTH="20%"
557 ALIGN="RIGHT"
558 VALIGN="TOP"
559 ><TT
560 CLASS="PARAMETER"
561 ><I
562 >file</I
563 ></TT
564 >&nbsp;:</TD
565 ><TD
566 WIDTH="80%"
567 ALIGN="LEFT"
568 VALIGN="TOP"
569 >  a FILE* </TD
570 ></TR
571 ><TR
572 ><TD
573 WIDTH="20%"
574 ALIGN="RIGHT"
575 VALIGN="TOP"
576 ><TT
577 CLASS="PARAMETER"
578 ><I
579 >enc</I
580 ></TT
581 >&nbsp;:</TD
582 ><TD
583 WIDTH="80%"
584 ALIGN="LEFT"
585 VALIGN="TOP"
586 >  the charset encoding if known</TD
587 ></TR
588 ><TR
589 ><TD
590 WIDTH="20%"
591 ALIGN="RIGHT"
592 VALIGN="TOP"
593 ><I
594 CLASS="EMPHASIS"
595 >Returns</I
596 > :</TD
597 ><TD
598 WIDTH="80%"
599 ALIGN="LEFT"
600 VALIGN="TOP"
601 >the new parser input or NULL</TD
602 ></TR
603 ></TABLE
604 ><P
605 ></P
606 ></DIV
607 ></DIV
608 ><HR><DIV
609 CLASS="REFSECT2"
610 ><A
611 NAME="AEN9864"
612 ></A
613 ><H3
614 ><A
615 NAME="XMLPARSERINPUTBUFFERCREATEFD"
616 ></A
617 >xmlParserInputBufferCreateFd ()</H3
618 ><TABLE
619 BORDER="0"
620 BGCOLOR="#D6E8FF"
621 WIDTH="100%"
622 CELLPADDING="6"
623 ><TR
624 ><TD
625 ><PRE
626 CLASS="PROGRAMLISTING"
627 ><A
628 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
629 >xmlParserInputBufferPtr</A
630 > xmlParserInputBufferCreateFd
631                                             (int fd,
632                                              <A
633 HREF="gnome-xml-encoding.html#XMLCHARENCODING"
634 >xmlCharEncoding</A
635 > enc);</PRE
636 ></TD
637 ></TR
638 ></TABLE
639 ><P
640 >Create a buffered parser input for the progressive parsing for the input
641 from a file descriptor</P
642 ><P
643 ></P
644 ><DIV
645 CLASS="INFORMALTABLE"
646 ><P
647 ></P
648 ><TABLE
649 BORDER="0"
650 WIDTH="100%"
651 BGCOLOR="#FFD0D0"
652 CELLSPACING="0"
653 CELLPADDING="4"
654 CLASS="CALSTABLE"
655 ><TR
656 ><TD
657 WIDTH="20%"
658 ALIGN="RIGHT"
659 VALIGN="TOP"
660 ><TT
661 CLASS="PARAMETER"
662 ><I
663 >fd</I
664 ></TT
665 >&nbsp;:</TD
666 ><TD
667 WIDTH="80%"
668 ALIGN="LEFT"
669 VALIGN="TOP"
670 >  a file descriptor number</TD
671 ></TR
672 ><TR
673 ><TD
674 WIDTH="20%"
675 ALIGN="RIGHT"
676 VALIGN="TOP"
677 ><TT
678 CLASS="PARAMETER"
679 ><I
680 >enc</I
681 ></TT
682 >&nbsp;:</TD
683 ><TD
684 WIDTH="80%"
685 ALIGN="LEFT"
686 VALIGN="TOP"
687 >  the charset encoding if known</TD
688 ></TR
689 ><TR
690 ><TD
691 WIDTH="20%"
692 ALIGN="RIGHT"
693 VALIGN="TOP"
694 ><I
695 CLASS="EMPHASIS"
696 >Returns</I
697 > :</TD
698 ><TD
699 WIDTH="80%"
700 ALIGN="LEFT"
701 VALIGN="TOP"
702 >the new parser input or NULL</TD
703 ></TR
704 ></TABLE
705 ><P
706 ></P
707 ></DIV
708 ></DIV
709 ><HR><DIV
710 CLASS="REFSECT2"
711 ><A
712 NAME="AEN9889"
713 ></A
714 ><H3
715 ><A
716 NAME="XMLPARSERINPUTBUFFERREAD"
717 ></A
718 >xmlParserInputBufferRead ()</H3
719 ><TABLE
720 BORDER="0"
721 BGCOLOR="#D6E8FF"
722 WIDTH="100%"
723 CELLPADDING="6"
724 ><TR
725 ><TD
726 ><PRE
727 CLASS="PROGRAMLISTING"
728 >int         xmlParserInputBufferRead        (<A
729 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
730 >xmlParserInputBufferPtr</A
731 > in,
732                                              int len);</PRE
733 ></TD
734 ></TR
735 ></TABLE
736 ><P
737 >Refresh the content of the input buffer, the old data are considered
738 consumed
739 This routine handle the I18N transcoding to internal UTF-8</P
740 ><P
741 ></P
742 ><DIV
743 CLASS="INFORMALTABLE"
744 ><P
745 ></P
746 ><TABLE
747 BORDER="0"
748 WIDTH="100%"
749 BGCOLOR="#FFD0D0"
750 CELLSPACING="0"
751 CELLPADDING="4"
752 CLASS="CALSTABLE"
753 ><TR
754 ><TD
755 WIDTH="20%"
756 ALIGN="RIGHT"
757 VALIGN="TOP"
758 ><TT
759 CLASS="PARAMETER"
760 ><I
761 >in</I
762 ></TT
763 >&nbsp;:</TD
764 ><TD
765 WIDTH="80%"
766 ALIGN="LEFT"
767 VALIGN="TOP"
768 >  a buffered parser input</TD
769 ></TR
770 ><TR
771 ><TD
772 WIDTH="20%"
773 ALIGN="RIGHT"
774 VALIGN="TOP"
775 ><TT
776 CLASS="PARAMETER"
777 ><I
778 >len</I
779 ></TT
780 >&nbsp;:</TD
781 ><TD
782 WIDTH="80%"
783 ALIGN="LEFT"
784 VALIGN="TOP"
785 >  indicative value of the amount of chars to read</TD
786 ></TR
787 ><TR
788 ><TD
789 WIDTH="20%"
790 ALIGN="RIGHT"
791 VALIGN="TOP"
792 ><I
793 CLASS="EMPHASIS"
794 >Returns</I
795 > :</TD
796 ><TD
797 WIDTH="80%"
798 ALIGN="LEFT"
799 VALIGN="TOP"
800 >the number of chars read and stored in the buffer, or -1
801 in case of error.</TD
802 ></TR
803 ></TABLE
804 ><P
805 ></P
806 ></DIV
807 ></DIV
808 ><HR><DIV
809 CLASS="REFSECT2"
810 ><A
811 NAME="AEN9913"
812 ></A
813 ><H3
814 ><A
815 NAME="XMLPARSERINPUTBUFFERGROW"
816 ></A
817 >xmlParserInputBufferGrow ()</H3
818 ><TABLE
819 BORDER="0"
820 BGCOLOR="#D6E8FF"
821 WIDTH="100%"
822 CELLPADDING="6"
823 ><TR
824 ><TD
825 ><PRE
826 CLASS="PROGRAMLISTING"
827 >int         xmlParserInputBufferGrow        (<A
828 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
829 >xmlParserInputBufferPtr</A
830 > in,
831                                              int len);</PRE
832 ></TD
833 ></TR
834 ></TABLE
835 ><P
836 >Grow up the content of the input buffer, the old data are preserved
837 This routine handle the I18N transcoding to internal UTF-8
838 This routine is used when operating the parser in normal (pull) mode
839 TODO: one should be able to remove one extra copy</P
840 ><P
841 ></P
842 ><DIV
843 CLASS="INFORMALTABLE"
844 ><P
845 ></P
846 ><TABLE
847 BORDER="0"
848 WIDTH="100%"
849 BGCOLOR="#FFD0D0"
850 CELLSPACING="0"
851 CELLPADDING="4"
852 CLASS="CALSTABLE"
853 ><TR
854 ><TD
855 WIDTH="20%"
856 ALIGN="RIGHT"
857 VALIGN="TOP"
858 ><TT
859 CLASS="PARAMETER"
860 ><I
861 >in</I
862 ></TT
863 >&nbsp;:</TD
864 ><TD
865 WIDTH="80%"
866 ALIGN="LEFT"
867 VALIGN="TOP"
868 >  a buffered parser input</TD
869 ></TR
870 ><TR
871 ><TD
872 WIDTH="20%"
873 ALIGN="RIGHT"
874 VALIGN="TOP"
875 ><TT
876 CLASS="PARAMETER"
877 ><I
878 >len</I
879 ></TT
880 >&nbsp;:</TD
881 ><TD
882 WIDTH="80%"
883 ALIGN="LEFT"
884 VALIGN="TOP"
885 >  indicative value of the amount of chars to read</TD
886 ></TR
887 ><TR
888 ><TD
889 WIDTH="20%"
890 ALIGN="RIGHT"
891 VALIGN="TOP"
892 ><I
893 CLASS="EMPHASIS"
894 >Returns</I
895 > :</TD
896 ><TD
897 WIDTH="80%"
898 ALIGN="LEFT"
899 VALIGN="TOP"
900 >the number of chars read and stored in the buffer, or -1
901 in case of error.</TD
902 ></TR
903 ></TABLE
904 ><P
905 ></P
906 ></DIV
907 ></DIV
908 ><HR><DIV
909 CLASS="REFSECT2"
910 ><A
911 NAME="AEN9937"
912 ></A
913 ><H3
914 ><A
915 NAME="XMLPARSERINPUTBUFFERPUSH"
916 ></A
917 >xmlParserInputBufferPush ()</H3
918 ><TABLE
919 BORDER="0"
920 BGCOLOR="#D6E8FF"
921 WIDTH="100%"
922 CELLPADDING="6"
923 ><TR
924 ><TD
925 ><PRE
926 CLASS="PROGRAMLISTING"
927 >int         xmlParserInputBufferPush        (<A
928 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
929 >xmlParserInputBufferPtr</A
930 > in,
931                                              int len,
932                                              const char *buf);</PRE
933 ></TD
934 ></TR
935 ></TABLE
936 ><P
937 >Push the content of the arry in the input buffer
938 This routine handle the I18N transcoding to internal UTF-8
939 This is used when operating the parser in progressive (push) mode.</P
940 ><P
941 ></P
942 ><DIV
943 CLASS="INFORMALTABLE"
944 ><P
945 ></P
946 ><TABLE
947 BORDER="0"
948 WIDTH="100%"
949 BGCOLOR="#FFD0D0"
950 CELLSPACING="0"
951 CELLPADDING="4"
952 CLASS="CALSTABLE"
953 ><TR
954 ><TD
955 WIDTH="20%"
956 ALIGN="RIGHT"
957 VALIGN="TOP"
958 ><TT
959 CLASS="PARAMETER"
960 ><I
961 >in</I
962 ></TT
963 >&nbsp;:</TD
964 ><TD
965 WIDTH="80%"
966 ALIGN="LEFT"
967 VALIGN="TOP"
968 >  a buffered parser input</TD
969 ></TR
970 ><TR
971 ><TD
972 WIDTH="20%"
973 ALIGN="RIGHT"
974 VALIGN="TOP"
975 ><TT
976 CLASS="PARAMETER"
977 ><I
978 >len</I
979 ></TT
980 >&nbsp;:</TD
981 ><TD
982 WIDTH="80%"
983 ALIGN="LEFT"
984 VALIGN="TOP"
985 >  the size in bytes of the array.</TD
986 ></TR
987 ><TR
988 ><TD
989 WIDTH="20%"
990 ALIGN="RIGHT"
991 VALIGN="TOP"
992 ><TT
993 CLASS="PARAMETER"
994 ><I
995 >buf</I
996 ></TT
997 >&nbsp;:</TD
998 ><TD
999 WIDTH="80%"
1000 ALIGN="LEFT"
1001 VALIGN="TOP"
1002 >  an char array</TD
1003 ></TR
1004 ><TR
1005 ><TD
1006 WIDTH="20%"
1007 ALIGN="RIGHT"
1008 VALIGN="TOP"
1009 ><I
1010 CLASS="EMPHASIS"
1011 >Returns</I
1012 > :</TD
1013 ><TD
1014 WIDTH="80%"
1015 ALIGN="LEFT"
1016 VALIGN="TOP"
1017 >the number of chars read and stored in the buffer, or -1
1018 in case of error.</TD
1019 ></TR
1020 ></TABLE
1021 ><P
1022 ></P
1023 ></DIV
1024 ></DIV
1025 ><HR><DIV
1026 CLASS="REFSECT2"
1027 ><A
1028 NAME="AEN9965"
1029 ></A
1030 ><H3
1031 ><A
1032 NAME="XMLFREEPARSERINPUTBUFFER"
1033 ></A
1034 >xmlFreeParserInputBuffer ()</H3
1035 ><TABLE
1036 BORDER="0"
1037 BGCOLOR="#D6E8FF"
1038 WIDTH="100%"
1039 CELLPADDING="6"
1040 ><TR
1041 ><TD
1042 ><PRE
1043 CLASS="PROGRAMLISTING"
1044 >void        xmlFreeParserInputBuffer        (<A
1045 HREF="gnome-xml-xmlio.html#XMLPARSERINPUTBUFFERPTR"
1046 >xmlParserInputBufferPtr</A
1047 > in);</PRE
1048 ></TD
1049 ></TR
1050 ></TABLE
1051 ><P
1052 >Free up the memory used by a buffered parser input</P
1053 ><P
1054 ></P
1055 ><DIV
1056 CLASS="INFORMALTABLE"
1057 ><P
1058 ></P
1059 ><TABLE
1060 BORDER="0"
1061 WIDTH="100%"
1062 BGCOLOR="#FFD0D0"
1063 CELLSPACING="0"
1064 CELLPADDING="4"
1065 CLASS="CALSTABLE"
1066 ><TR
1067 ><TD
1068 WIDTH="20%"
1069 ALIGN="RIGHT"
1070 VALIGN="TOP"
1071 ><TT
1072 CLASS="PARAMETER"
1073 ><I
1074 >in</I
1075 ></TT
1076 >&nbsp;:</TD
1077 ><TD
1078 WIDTH="80%"
1079 ALIGN="LEFT"
1080 VALIGN="TOP"
1081 >  a buffered parser input</TD
1082 ></TR
1083 ></TABLE
1084 ><P
1085 ></P
1086 ></DIV
1087 ></DIV
1088 ><HR><DIV
1089 CLASS="REFSECT2"
1090 ><A
1091 NAME="AEN9981"
1092 ></A
1093 ><H3
1094 ><A
1095 NAME="XMLPARSERGETDIRECTORY"
1096 ></A
1097 >xmlParserGetDirectory ()</H3
1098 ><TABLE
1099 BORDER="0"
1100 BGCOLOR="#D6E8FF"
1101 WIDTH="100%"
1102 CELLPADDING="6"
1103 ><TR
1104 ><TD
1105 ><PRE
1106 CLASS="PROGRAMLISTING"
1107 >char*       xmlParserGetDirectory           (const char *filename);</PRE
1108 ></TD
1109 ></TR
1110 ></TABLE
1111 ><P
1112 ></P
1113 ><DIV
1114 CLASS="INFORMALTABLE"
1115 ><P
1116 ></P
1117 ><TABLE
1118 BORDER="0"
1119 WIDTH="100%"
1120 BGCOLOR="#FFD0D0"
1121 CELLSPACING="0"
1122 CELLPADDING="4"
1123 CLASS="CALSTABLE"
1124 ><TR
1125 ><TD
1126 WIDTH="20%"
1127 ALIGN="RIGHT"
1128 VALIGN="TOP"
1129 ><TT
1130 CLASS="PARAMETER"
1131 ><I
1132 >filename</I
1133 ></TT
1134 >&nbsp;:</TD
1135 ><TD
1136 WIDTH="80%"
1137 ALIGN="LEFT"
1138 VALIGN="TOP"
1139 >&nbsp;</TD
1140 ></TR
1141 ><TR
1142 ><TD
1143 WIDTH="20%"
1144 ALIGN="RIGHT"
1145 VALIGN="TOP"
1146 ><I
1147 CLASS="EMPHASIS"
1148 >Returns</I
1149 > :</TD
1150 ><TD
1151 WIDTH="80%"
1152 ALIGN="LEFT"
1153 VALIGN="TOP"
1154 >&nbsp;</TD
1155 ></TR
1156 ></TABLE
1157 ><P
1158 ></P
1159 ></DIV
1160 ></DIV
1161 ></DIV
1162 ><DIV
1163 CLASS="NAVFOOTER"
1164 ><BR
1165 CLEAR="all"><BR><TABLE
1166 WIDTH="100%"
1167 BORDER="0"
1168 BGCOLOR="#000000"
1169 CELLPADDING="1"
1170 CELLSPACING="0"
1171 ><TR
1172 ><TD
1173 WIDTH="25%"
1174 BGCOLOR="#C00000"
1175 ALIGN="left"
1176 ><A
1177 HREF="gnome-xml-nanoftp.html"
1178 ><FONT
1179 COLOR="#FFFFFF"
1180 SIZE="3"
1181 ><B
1182 >&#60;&#60;&#60; Previous Page</B
1183 ></FONT
1184 ></A
1185 ></TD
1186 ><TD
1187 WIDTH="25%"
1188 BGCOLOR="#0000C0"
1189 ALIGN="center"
1190 ><FONT
1191 COLOR="#FFFFFF"
1192 SIZE="3"
1193 ><B
1194 ><A
1195 HREF="book1.html"
1196 ><FONT
1197 COLOR="#FFFFFF"
1198 SIZE="3"
1199 ><B
1200 >Home</B
1201 ></FONT
1202 ></A
1203 ></B
1204 ></FONT
1205 ></TD
1206 ><TD
1207 WIDTH="25%"
1208 BGCOLOR="#00C000"
1209 ALIGN="center"
1210 ><FONT
1211 COLOR="#FFFFFF"
1212 SIZE="3"
1213 ><B
1214 ><A
1215 HREF="libxml-lib.html"
1216 ><FONT
1217 COLOR="#FFFFFF"
1218 SIZE="3"
1219 ><B
1220 >Up</B
1221 ></FONT
1222 ></A
1223 ></B
1224 ></FONT
1225 ></TD
1226 ><TD
1227 WIDTH="25%"
1228 BGCOLOR="#C00000"
1229 ALIGN="right"
1230 ><A
1231 HREF="gnome-xml-parserinternals.html"
1232 ><FONT
1233 COLOR="#FFFFFF"
1234 SIZE="3"
1235 ><B
1236 >Next Page &#62;&#62;&#62;</B
1237 ></FONT
1238 ></A
1239 ></TD
1240 ></TR
1241 ><TR
1242 ><TD
1243 COLSPAN="2"
1244 ALIGN="left"
1245 ><FONT
1246 COLOR="#FFFFFF"
1247 SIZE="3"
1248 ><B
1249 >nanoftp</B
1250 ></FONT
1251 ></TD
1252 ><TD
1253 COLSPAN="2"
1254 ALIGN="right"
1255 ><FONT
1256 COLOR="#FFFFFF"
1257 SIZE="3"
1258 ><B
1259 >parserInternals</B
1260 ></FONT
1261 ></TD
1262 ></TR
1263 ></TABLE
1264 ></DIV
1265 ></BODY
1266 ></HTML
1267 >