kc3-lang/libxml2/doc/examples/io1.c

• Show log

  Commit

• Hash : 4773df2a
  Author :
  Date : 2004-01-23T13:15:13
  

  added io1.c an example ox xmlIO usage and io1.res test result, fixed a
  
  * doc/examples/*: added io1.c an example ox xmlIO usage and io1.res
    test result, fixed a awful lot of memory leaks showing up in
    testWriter.c, changed the examples and the Makefiles to test
    memory leaks.
  * xmlwriter.c: fixed a memory leak
  * Makefile.am: run the doc/examples regression tests as part of
    make tests
  * xpath.c include/libxml/xpath.h: added xmlXPathCtxtCompile() to
    compile an XPath expression within a context, currently the goal
    is to be able to reuse the XSLT stylesheet dictionnary, but this
    opens the door to others possible optimizations.
  * dict.c include/libxml/dict.h: added xmlDictCreateSub() which allows
    to build a new dictionnary based on another read-only dictionnary.
    This is needed for XSLT to keep the stylesheet dictionnary read-only
    while being able to reuse the strings for the transformation
    dictionnary.
  * xinclude.c: fixed a dictionnar reference counting problem occuring
    when document parsing failed.
  * testSAX.c: adding option --repeat for timing 100times the parsing
  * doc/* : rebuilt all the docs
  Daniel
  

Download

• doc/examples/io1.c

• /**
   * section: InputOutput
   * synopsis: Example of custom Input/Output
   * purpose: Demonstrate the use of xmlRegisterInputCallbacks
   *          to build a custom I/O layer, this is used in an
   *          XInclude method context to show how dynamic document can
   *          be built in a clean way.
   * usage: io1
   * test: io1 > io1.tmp ; diff io1.tmp io1.res ; rm -f io1.tmp
   * author: Daniel Veillard
   * copy: see Copyright for the status of this software.
   */
  
  #include <stdio.h>
  #include <string.h>
  #include <libxml/parser.h>
  #include <libxml/tree.h>
  #include <libxml/xinclude.h>
  #include <libxml/xmlIO.h>
  
  static const char *result = "<list><people>a</people><people>b</people></list>";
  static const char *cur = NULL;
  static int rlen;
  
  /**
   * sqlMatch:
   * @URI: an URI to test
   *
   * Check for an sql: query
   *
   * Returns 1 if yes and 0 if another Input module should be used
   */
  static int
  sqlMatch(const char * URI) {
      if ((URI != NULL) && (!strncmp(URI, "sql:", 4)))
          return(1);
      return(0);
  }
  
  /**
   * sqlOpen:
   * @URI: an URI to test
   *
   * Return a pointer to the sql: query handler, in this example simply
   * the current pointer...
   *
   * Returns an Input context or NULL in case or error
   */
  static void *
  sqlOpen(const char * URI) {
      if ((URI == NULL) || (strncmp(URI, "sql:", 4)))
          return(NULL);
      cur = result;
      rlen = strlen(result);
      return((void *) cur);
  }
  
  /**
   * sqlClose:
   * @context: the read context
   *
   * Close the sql: query handler
   *
   * Returns 0 or -1 in case of error
   */
  static int
  sqlClose(void * context) {
      if (context == NULL) return(-1);
      cur = NULL;
      rlen = 0;
      return(0);
  }
  
  /**
   * sqlRead:
   * @context: the read context
   * @buffer: where to store data
   * @len: number of bytes to read
   *
   * Implement an sql: query read.
   *
   * Returns the number of bytes read or -1 in case of error
   */
  static int
  sqlRead(void * context, char * buffer, int len) {
     const char *ptr = (const char *) context;
  
     if ((context == NULL) || (buffer == NULL) || (len < 0))
         return(-1);
  
     if (len > rlen) len = rlen;
     memcpy(buffer, ptr, len);
     rlen -= len;
     return(len);
  }
  
  const char *include = "<?xml version='1.0'?>\n\
  <document xmlns:xi=\"http://www.w3.org/2003/XInclude\">\n\
    <p>List of people:</p>\n\
    <xi:include href=\"sql:select_name_from_people\"/>\n\
  </document>\n";
  
  int main(void) {
      xmlDocPtr doc;
  
      /*
       * this initialize the library and check potential ABI mismatches
       * between the version it was compiled for and the actual shared
       * library used.
       */
      LIBXML_TEST_VERSION
  
      /*
       * register the new I/O handlers
       */
      if (xmlRegisterInputCallbacks(sqlMatch, sqlOpen, sqlRead, sqlClose) < 0) {
          fprintf(stderr, "failed to register SQL handler\n");
  	exit(1);
      }
      /*
       * parse include into a document
       */
      doc = xmlReadMemory(include, strlen(include), "include.xml", NULL, 0);
      if (doc == NULL) {
          fprintf(stderr, "failed to parse the including file\n");
  	exit(1);
      }
      /*
       * apply the XInclude process, this should trigger the I/O just
       * registered.
       */
      if (xmlXIncludeProcess(doc) <= 0) {
          fprintf(stderr, "XInclude processing failed\n");
  	exit(1);
      }
      /*
       * save the output for checking to stdout
       */
      xmlDocDump(stdout, doc);
      /*
       * Free the document
       */
      xmlFreeDoc(doc);
  
      /*
       * Cleanup function for the XML library.
       */
      xmlCleanupParser();
      /*
       * this is to debug memory for regression tests
       */
      xmlMemoryDump();
      return(0);
  }
  

Download