]> SAX2 3 RAPTOR Library SAX2 SAX2 XML Parsing API with namespaces and base URI support. typedef raptor_sax2; raptor_sax2* raptor_new_sax2 (void *user_data, raptor_error_handlers *error_handlers); void raptor_free_sax2 (raptor_sax2 *sax2); void (*raptor_sax2_start_element_handler) (void *user_data, raptor_xml_element *xml_element); void (*raptor_sax2_end_element_handler) (void *user_data, raptor_xml_element *xml_element); void (*raptor_sax2_characters_handler) (void *user_data, raptor_xml_element *xml_element, unsigned char *s, int len); void (*raptor_sax2_cdata_handler) (void *user_data, raptor_xml_element *xml_element, unsigned char *s, int len); void (*raptor_sax2_comment_handler) (void *user_data, raptor_xml_element *xml_element, unsigned char *s); void (*raptor_sax2_unparsed_entity_decl_handler) (void *user_data, unsigned char *entityName, unsigned char *base, unsigned char *systemId, unsigned char *publicId, unsigned char *notationName); int (*raptor_sax2_external_entity_ref_handler) (void *user_data, unsigned char *context, unsigned char *base, unsigned char *systemId, unsigned char *publicId); void raptor_sax2_set_start_element_handler (raptor_sax2 *sax2, raptor_sax2_start_element_handler handler); void raptor_sax2_set_end_element_handler (raptor_sax2 *sax2, raptor_sax2_end_element_handler handler); void raptor_sax2_set_characters_handler (raptor_sax2 *sax2, raptor_sax2_characters_handler handler); void raptor_sax2_set_cdata_handler (raptor_sax2 *sax2, raptor_sax2_cdata_handler handler); void raptor_sax2_set_comment_handler (raptor_sax2 *sax2, raptor_sax2_comment_handler handler); void raptor_sax2_set_unparsed_entity_decl_handler (raptor_sax2 *sax2, raptor_sax2_unparsed_entity_decl_handler handler); void raptor_sax2_set_external_entity_ref_handler (raptor_sax2 *sax2, raptor_sax2_external_entity_ref_handler handler); void raptor_sax2_set_namespace_handler (raptor_sax2 *sax2, raptor_namespace_handler handler); void raptor_sax2_parse_start (raptor_sax2 *sax2, raptor_uri *base_uri); int raptor_sax2_parse_chunk (raptor_sax2 *sax2, unsigned char *buffer, size_t len, int is_end); const unsigned char* raptor_sax2_inscope_xml_language (raptor_sax2 *sax2); raptor_uri* raptor_sax2_inscope_base_uri (raptor_sax2 *sax2); A class providing a SAX2 XML parsing API with XML namespaces and XML base support. raptor_sax2typedef struct raptor_sax2_s raptor_sax2; Raptor SAX2 class raptor_new_sax2raptor_sax2* raptor_new_sax2 (void *user_data, raptor_error_handlers *error_handlers); Constructor - Create a new SAX2 with error handlers user_data : pointer context information to pass to handlers error_handlers : error handlers pointer Returns : new raptor_sax2 object or NULL on failure raptor_free_sax2void raptor_free_sax2 (raptor_sax2 *sax2); Destructor - destroy a SAX2 object sax2 : SAX2 object raptor_sax2_start_element_handlervoid (*raptor_sax2_start_element_handler) (void *user_data, raptor_xml_element *xml_element); SAX2 start element handler user_data : user data xml_element : XML element raptor_sax2_end_element_handlervoid (*raptor_sax2_end_element_handler) (void *user_data, raptor_xml_element *xml_element); SAX2 end element handler user_data : user data xml_element : XML element raptor_sax2_characters_handlervoid (*raptor_sax2_characters_handler) (void *user_data, raptor_xml_element *xml_element, unsigned char *s, int len); SAX2 characters handler user_data : user data xml_element : XML element s : string len : string len raptor_sax2_cdata_handlervoid (*raptor_sax2_cdata_handler) (void *user_data, raptor_xml_element *xml_element, unsigned char *s, int len); SAX2 CDATA section handler user_data : user data xml_element : XML element s : string len : string len raptor_sax2_comment_handlervoid (*raptor_sax2_comment_handler) (void *user_data, raptor_xml_element *xml_element, unsigned char *s); SAX2 XML comment handler user_data : user data xml_element : XML element s : string raptor_sax2_unparsed_entity_decl_handlervoid (*raptor_sax2_unparsed_entity_decl_handler) (void *user_data, unsigned char *entityName, unsigned char *base, unsigned char *systemId, unsigned char *publicId, unsigned char *notationName); SAX2 unparsed entity (NDATA) handler user_data : user data entityName : entity name base : base URI systemId : system ID publicId : public ID notationName : notation name raptor_sax2_external_entity_ref_handlerint (*raptor_sax2_external_entity_ref_handler) (void *user_data, unsigned char *context, unsigned char *base, unsigned char *systemId, unsigned char *publicId); SAX2 external entity reference handler user_data : user data context : context base : base URI systemId : system ID publicId : public ID Returns : 0 if processing should not continue because of a fatal error in the handling of the external entity. raptor_sax2_set_start_element_handlervoid raptor_sax2_set_start_element_handler (raptor_sax2 *sax2, raptor_sax2_start_element_handler handler); Set SAX2 start element handler. sax2 : SAX2 object handler : start element handler raptor_sax2_set_end_element_handlervoid raptor_sax2_set_end_element_handler (raptor_sax2 *sax2, raptor_sax2_end_element_handler handler); Set SAX2 end element handler. sax2 : SAX2 object handler : end element handler raptor_sax2_set_characters_handlervoid raptor_sax2_set_characters_handler (raptor_sax2 *sax2, raptor_sax2_characters_handler handler); Set SAX2 characters handler. sax2 : SAX2 object handler : characters handler raptor_sax2_set_cdata_handlervoid raptor_sax2_set_cdata_handler (raptor_sax2 *sax2, raptor_sax2_cdata_handler handler); Set SAX2 CDATA handler. sax2 : SAX2 object handler : CDATA handler raptor_sax2_set_comment_handlervoid raptor_sax2_set_comment_handler (raptor_sax2 *sax2, raptor_sax2_comment_handler handler); Set SAX2 XML comment handler. sax2 : SAX2 object handler : comment handler raptor_sax2_set_unparsed_entity_decl_handlervoid raptor_sax2_set_unparsed_entity_decl_handler (raptor_sax2 *sax2, raptor_sax2_unparsed_entity_decl_handler handler); Set SAX2 XML unparsed entity declaration handler. sax2 : SAX2 object handler : unparsed entity declaration handler raptor_sax2_set_external_entity_ref_handlervoid raptor_sax2_set_external_entity_ref_handler (raptor_sax2 *sax2, raptor_sax2_external_entity_ref_handler handler); Set SAX2 XML entity reference handler. sax2 : SAX2 object handler : entity reference handler raptor_sax2_set_namespace_handlervoid raptor_sax2_set_namespace_handler (raptor_sax2 *sax2, raptor_namespace_handler handler); Set the XML namespace handler function. When a prefix/namespace is seen in an XML parser, call the given handler with the prefix string and the raptor_uri namespace URI. Either can be NULL for the default prefix or default namespace. The handler function does not deal with duplicates so any namespace may be declared multiple times when a namespace is seen in different parts of a document. sax2 : raptor_sax2 object handler : new namespace callback function raptor_sax2_parse_startvoid raptor_sax2_parse_start (raptor_sax2 *sax2, raptor_uri *base_uri); Start an XML SAX2 parse. sax2 : sax2 object base_uri : base URI raptor_sax2_parse_chunkint raptor_sax2_parse_chunk (raptor_sax2 *sax2, unsigned char *buffer, size_t len, int is_end); Parse a chunk of XML data generating SAX2 events sax2 : sax2 object buffer : input buffer len : input buffer lenght is_end : non-0 if end of data Returns : non-0 on failure raptor_sax2_inscope_xml_languageconst unsigned char* raptor_sax2_inscope_xml_language (raptor_sax2 *sax2); Get the in-scope XML language sax2 : SAX2 object Returns : the XML language or NULL if none is in scope. raptor_sax2_inscope_base_uriraptor_uri* raptor_sax2_inscope_base_uri (raptor_sax2 *sax2); Get the in-scope base URI sax2 : SAX2 object Returns : the in-scope base URI shared object or NULL if none is in scope.