1 /* 2 * Summary: interface for the I/O interfaces used by the parser 3 * Description: interface for the I/O interfaces used by the parser 4 * 5 * Copy: See Copyright for the status of this software. 6 * 7 * Author: Daniel Veillard 8 */ 9 10 #ifndef __XML_IO_H__ 11 #define __XML_IO_H__ 12 13 #include <stdio.h> 14 #include <libxml/xmlversion.h> 15 16 #ifdef __cplusplus 17 extern "C" { 18 #endif 19 20 /* 21 * Those are the functions and datatypes for the parser input 22 * I/O structures. 23 */ 24 25 /** 26 * xmlInputMatchCallback: 27 * @filename: the filename or URI 28 * 29 * Callback used in the I/O Input API to detect if the current handler 30 * can provide input fonctionnalities for this resource. 31 * 32 * Returns 1 if yes and 0 if another Input module should be used 33 */ 34 typedef int (XMLCALL *xmlInputMatchCallback) (char const *filename); 35 /** 36 * xmlInputOpenCallback: 37 * @filename: the filename or URI 38 * 39 * Callback used in the I/O Input API to open the resource 40 * 41 * Returns an Input context or NULL in case or error 42 */ 43 typedef void * (XMLCALL *xmlInputOpenCallback) (char const *filename); 44 /** 45 * xmlInputReadCallback: 46 * @context: an Input context 47 * @buffer: the buffer to store data read 48 * @len: the length of the buffer in bytes 49 * 50 * Callback used in the I/O Input API to read the resource 51 * 52 * Returns the number of bytes read or -1 in case of error 53 */ 54 typedef int (XMLCALL *xmlInputReadCallback) (void * context, char * buffer, int len); 55 /** 56 * xmlInputCloseCallback: 57 * @context: an Input context 58 * 59 * Callback used in the I/O Input API to close the resource 60 * 61 * Returns 0 or -1 in case of error 62 */ 63 typedef int (XMLCALL *xmlInputCloseCallback) (void * context); 64 65 #ifdef LIBXML_OUTPUT_ENABLED 66 /* 67 * Those are the functions and datatypes for the library output 68 * I/O structures. 69 */ 70 71 /** 72 * xmlOutputMatchCallback: 73 * @filename: the filename or URI 74 * 75 * Callback used in the I/O Output API to detect if the current handler 76 * can provide output fonctionnalities for this resource. 77 * 78 * Returns 1 if yes and 0 if another Output module should be used 79 */ 80 typedef int (XMLCALL *xmlOutputMatchCallback) (char const *filename); 81 /** 82 * xmlOutputOpenCallback: 83 * @filename: the filename or URI 84 * 85 * Callback used in the I/O Output API to open the resource 86 * 87 * Returns an Output context or NULL in case or error 88 */ 89 typedef void * (XMLCALL *xmlOutputOpenCallback) (char const *filename); 90 /** 91 * xmlOutputWriteCallback: 92 * @context: an Output context 93 * @buffer: the buffer of data to write 94 * @len: the length of the buffer in bytes 95 * 96 * Callback used in the I/O Output API to write to the resource 97 * 98 * Returns the number of bytes written or -1 in case of error 99 */ 100 typedef int (XMLCALL *xmlOutputWriteCallback) (void * context, const char * buffer, 101 int len); 102 /** 103 * xmlOutputCloseCallback: 104 * @context: an Output context 105 * 106 * Callback used in the I/O Output API to close the resource 107 * 108 * Returns 0 or -1 in case of error 109 */ 110 typedef int (XMLCALL *xmlOutputCloseCallback) (void * context); 111 #endif /* LIBXML_OUTPUT_ENABLED */ 112 113 #ifdef __cplusplus 114 } 115 #endif 116 117 #include <libxml/globals.h> 118 #include <libxml/tree.h> 119 #include <libxml/parser.h> 120 #include <libxml/encoding.h> 121 122 #ifdef __cplusplus 123 extern "C" { 124 #endif 125 struct _xmlParserInputBuffer { 126 void* context; 127 xmlInputReadCallback readcallback; 128 xmlInputCloseCallback closecallback; 129 130 xmlCharEncodingHandlerPtr encoder; /* I18N conversions to UTF-8 */ 131 132 xmlBufferPtr buffer; /* Local buffer encoded in UTF-8 */ 133 xmlBufferPtr raw; /* if encoder != NULL buffer for raw input */ 134 int compressed; /* -1=unknown, 0=not compressed, 1=compressed */ 135 int error; 136 unsigned long rawconsumed;/* amount consumed from raw */ 137 }; 138 139 140 #ifdef LIBXML_OUTPUT_ENABLED 141 struct _xmlOutputBuffer { 142 void* context; 143 xmlOutputWriteCallback writecallback; 144 xmlOutputCloseCallback closecallback; 145 146 xmlCharEncodingHandlerPtr encoder; /* I18N conversions to UTF-8 */ 147 148 xmlBufferPtr buffer; /* Local buffer encoded in UTF-8 or ISOLatin */ 149 xmlBufferPtr conv; /* if encoder != NULL buffer for output */ 150 int written; /* total number of byte written */ 151 int error; 152 }; 153 #endif /* LIBXML_OUTPUT_ENABLED */ 154 155 /* 156 * Interfaces for input 157 */ 158 XMLPUBFUN void XMLCALL 159 xmlCleanupInputCallbacks (void); 160 161 XMLPUBFUN int XMLCALL 162 xmlPopInputCallbacks (void); 163 164 XMLPUBFUN void XMLCALL 165 xmlRegisterDefaultInputCallbacks (void); 166 XMLPUBFUN xmlParserInputBufferPtr XMLCALL 167 xmlAllocParserInputBuffer (xmlCharEncoding enc); 168 169 XMLPUBFUN xmlParserInputBufferPtr XMLCALL 170 xmlParserInputBufferCreateFilename (const char *URI, 171 xmlCharEncoding enc); 172 XMLPUBFUN xmlParserInputBufferPtr XMLCALL 173 xmlParserInputBufferCreateFile (FILE *file, 174 xmlCharEncoding enc); 175 XMLPUBFUN xmlParserInputBufferPtr XMLCALL 176 xmlParserInputBufferCreateFd (int fd, 177 xmlCharEncoding enc); 178 XMLPUBFUN xmlParserInputBufferPtr XMLCALL 179 xmlParserInputBufferCreateMem (const char *mem, int size, 180 xmlCharEncoding enc); 181 XMLPUBFUN xmlParserInputBufferPtr XMLCALL 182 xmlParserInputBufferCreateStatic (const char *mem, int size, 183 xmlCharEncoding enc); 184 XMLPUBFUN xmlParserInputBufferPtr XMLCALL 185 xmlParserInputBufferCreateIO (xmlInputReadCallback ioread, 186 xmlInputCloseCallback ioclose, 187 void *ioctx, 188 xmlCharEncoding enc); 189 XMLPUBFUN int XMLCALL 190 xmlParserInputBufferRead (xmlParserInputBufferPtr in, 191 int len); 192 XMLPUBFUN int XMLCALL 193 xmlParserInputBufferGrow (xmlParserInputBufferPtr in, 194 int len); 195 XMLPUBFUN int XMLCALL 196 xmlParserInputBufferPush (xmlParserInputBufferPtr in, 197 int len, 198 const char *buf); 199 XMLPUBFUN void XMLCALL 200 xmlFreeParserInputBuffer (xmlParserInputBufferPtr in); 201 XMLPUBFUN char * XMLCALL 202 xmlParserGetDirectory (const char *filename); 203 204 XMLPUBFUN int XMLCALL 205 xmlRegisterInputCallbacks (xmlInputMatchCallback matchFunc, 206 xmlInputOpenCallback openFunc, 207 xmlInputReadCallback readFunc, 208 xmlInputCloseCallback closeFunc); 209 210 xmlParserInputBufferPtr 211 __xmlParserInputBufferCreateFilename(const char *URI, 212 xmlCharEncoding enc); 213 214 #ifdef LIBXML_OUTPUT_ENABLED 215 /* 216 * Interfaces for output 217 */ 218 XMLPUBFUN void XMLCALL 219 xmlCleanupOutputCallbacks (void); 220 XMLPUBFUN void XMLCALL 221 xmlRegisterDefaultOutputCallbacks(void); 222 XMLPUBFUN xmlOutputBufferPtr XMLCALL 223 xmlAllocOutputBuffer (xmlCharEncodingHandlerPtr encoder); 224 225 XMLPUBFUN xmlOutputBufferPtr XMLCALL 226 xmlOutputBufferCreateFilename (const char *URI, 227 xmlCharEncodingHandlerPtr encoder, 228 int compression); 229 230 XMLPUBFUN xmlOutputBufferPtr XMLCALL 231 xmlOutputBufferCreateFile (FILE *file, 232 xmlCharEncodingHandlerPtr encoder); 233 234 XMLPUBFUN xmlOutputBufferPtr XMLCALL 235 xmlOutputBufferCreateBuffer (xmlBufferPtr buffer, 236 xmlCharEncodingHandlerPtr encoder); 237 238 XMLPUBFUN xmlOutputBufferPtr XMLCALL 239 xmlOutputBufferCreateFd (int fd, 240 xmlCharEncodingHandlerPtr encoder); 241 242 XMLPUBFUN xmlOutputBufferPtr XMLCALL 243 xmlOutputBufferCreateIO (xmlOutputWriteCallback iowrite, 244 xmlOutputCloseCallback ioclose, 245 void *ioctx, 246 xmlCharEncodingHandlerPtr encoder); 247 248 XMLPUBFUN int XMLCALL 249 xmlOutputBufferWrite (xmlOutputBufferPtr out, 250 int len, 251 const char *buf); 252 XMLPUBFUN int XMLCALL 253 xmlOutputBufferWriteString (xmlOutputBufferPtr out, 254 const char *str); 255 XMLPUBFUN int XMLCALL 256 xmlOutputBufferWriteEscape (xmlOutputBufferPtr out, 257 const xmlChar *str, 258 xmlCharEncodingOutputFunc escaping); 259 260 XMLPUBFUN int XMLCALL 261 xmlOutputBufferFlush (xmlOutputBufferPtr out); 262 XMLPUBFUN int XMLCALL 263 xmlOutputBufferClose (xmlOutputBufferPtr out); 264 265 XMLPUBFUN int XMLCALL 266 xmlRegisterOutputCallbacks (xmlOutputMatchCallback matchFunc, 267 xmlOutputOpenCallback openFunc, 268 xmlOutputWriteCallback writeFunc, 269 xmlOutputCloseCallback closeFunc); 270 271 xmlOutputBufferPtr 272 __xmlOutputBufferCreateFilename(const char *URI, 273 xmlCharEncodingHandlerPtr encoder, 274 int compression); 275 276 #ifdef LIBXML_HTTP_ENABLED 277 /* This function only exists if HTTP support built into the library */ 278 XMLPUBFUN void XMLCALL 279 xmlRegisterHTTPPostCallbacks (void ); 280 #endif /* LIBXML_HTTP_ENABLED */ 281 282 #endif /* LIBXML_OUTPUT_ENABLED */ 283 284 XMLPUBFUN xmlParserInputPtr XMLCALL 285 xmlCheckHTTPInput (xmlParserCtxtPtr ctxt, 286 xmlParserInputPtr ret); 287 288 /* 289 * A predefined entity loader disabling network accesses 290 */ 291 XMLPUBFUN xmlParserInputPtr XMLCALL 292 xmlNoNetExternalEntityLoader (const char *URL, 293 const char *ID, 294 xmlParserCtxtPtr ctxt); 295 296 /* 297 * xmlNormalizeWindowsPath is obsolete, don't use it. 298 * Check xmlCanonicPath in uri.h for a better alternative. 299 */ 300 XMLPUBFUN xmlChar * XMLCALL 301 xmlNormalizeWindowsPath (const xmlChar *path); 302 303 XMLPUBFUN int XMLCALL 304 xmlCheckFilename (const char *path); 305 /** 306 * Default 'file://' protocol callbacks 307 */ 308 XMLPUBFUN int XMLCALL 309 xmlFileMatch (const char *filename); 310 XMLPUBFUN void * XMLCALL 311 xmlFileOpen (const char *filename); 312 XMLPUBFUN int XMLCALL 313 xmlFileRead (void * context, 314 char * buffer, 315 int len); 316 XMLPUBFUN int XMLCALL 317 xmlFileClose (void * context); 318 319 /** 320 * Default 'http://' protocol callbacks 321 */ 322 #ifdef LIBXML_HTTP_ENABLED 323 XMLPUBFUN int XMLCALL 324 xmlIOHTTPMatch (const char *filename); 325 XMLPUBFUN void * XMLCALL 326 xmlIOHTTPOpen (const char *filename); 327 #ifdef LIBXML_OUTPUT_ENABLED 328 XMLPUBFUN void * XMLCALL 329 xmlIOHTTPOpenW (const char * post_uri, 330 int compression ); 331 #endif /* LIBXML_OUTPUT_ENABLED */ 332 XMLPUBFUN int XMLCALL 333 xmlIOHTTPRead (void * context, 334 char * buffer, 335 int len); 336 XMLPUBFUN int XMLCALL 337 xmlIOHTTPClose (void * context); 338 #endif /* LIBXML_HTTP_ENABLED */ 339 340 /** 341 * Default 'ftp://' protocol callbacks 342 */ 343 #ifdef LIBXML_FTP_ENABLED 344 XMLPUBFUN int XMLCALL 345 xmlIOFTPMatch (const char *filename); 346 XMLPUBFUN void * XMLCALL 347 xmlIOFTPOpen (const char *filename); 348 XMLPUBFUN int XMLCALL 349 xmlIOFTPRead (void * context, 350 char * buffer, 351 int len); 352 XMLPUBFUN int XMLCALL 353 xmlIOFTPClose (void * context); 354 #endif /* LIBXML_FTP_ENABLED */ 355 356 #ifdef __cplusplus 357 } 358 #endif 359 360 #endif /* __XML_IO_H__ */ 361
