  
    
    
    
    
    
    
    
  
  
    
      
        
          
libxml2-HTMLtree.html            
Prev          
        
        
          
general.html            
Up          
        
        
          
index.html            
Home          
        
        
          
libxml2-SAX2.html            
Next          
        
        
libxml2 Reference Manual      
    
    
      
SAX    
    
SAX - Old SAX version 1 handler, deprecated
    
DEPRECATED set of SAX version 1 interfaces used to build the DOM tree. 
    
 WARNING: this module is deprecated !
    
Author(s): Daniel Veillard 
    
      
Synopsis
      
void	#commentcomment 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * value);
int	
#checkNamespacecheckNamespace 			(void * ctx, 					 libxml2-xmlstring.html#xmlCharxmlChar  * namespace);
int	
#getColumnNumbergetColumnNumber 			(void * ctx);
void	
#entityDeclentityDecl 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name, 					 int type, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * publicId, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * systemId, 					 libxml2-xmlstring.html#xmlCharxmlChar  * content);
void	
#attributeattribute 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * fullname, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * value);
libxml2-tree.html#xmlNsPtrxmlNsPtr 	#getNamespacegetNamespace 		(void * ctx);
void	
#setDocumentLocatorsetDocumentLocator 		(void * ctx, 					 libxml2-tree.html#xmlSAXLocatorPtrxmlSAXLocatorPtr  loc);
void	
#initxmlDefaultSAXHandlerinitxmlDefaultSAXHandler 	( libxml2-parser.html#xmlSAXHandlerV1xmlSAXHandlerV1  * hdlr, 					 int warning);
void	
#ignorableWhitespaceignorableWhitespace 		(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * ch, 					 int len);
int	
#hasExternalSubsethasExternalSubset 		(void * ctx);
void	
#unparsedEntityDeclunparsedEntityDecl 		(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * publicId, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * systemId, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * notationName);
void	
#globalNamespaceglobalNamespace 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * href, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * prefix);
int	
#hasInternalSubsethasInternalSubset 		(void * ctx);
void	
#referencereference 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name);
void	
#notationDeclnotationDecl 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * publicId, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * systemId);
const 
libxml2-xmlstring.html#xmlCharxmlChar  *	#getSystemIdgetSystemId 		(void * ctx);
void	
#externalSubsetexternalSubset 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * ExternalID, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * SystemID);
libxml2-tree.html#xmlParserInputPtrxmlParserInputPtr 	#resolveEntityresolveEntity 	(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * publicId, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * systemId);
void	
#startDocumentstartDocument 			(void * ctx);
void	
#setNamespacesetNamespace 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name);
void	
#cdataBlockcdataBlock 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * value, 					 int len);
const 
libxml2-xmlstring.html#xmlCharxmlChar  *	#getPublicIdgetPublicId 		(void * ctx);
void	
#inithtmlDefaultSAXHandlerinithtmlDefaultSAXHandler 	( libxml2-parser.html#xmlSAXHandlerV1xmlSAXHandlerV1  * hdlr);
void	
#processingInstructionprocessingInstruction 		(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * target, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * data);
void	
#endElementendElement 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name);
void	
#namespaceDeclnamespaceDecl 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * href, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * prefix);
void	
#initdocbDefaultSAXHandlerinitdocbDefaultSAXHandler 	( libxml2-parser.html#xmlSAXHandlerV1xmlSAXHandlerV1  * hdlr);
libxml2-tree.html#xmlEntityPtrxmlEntityPtr 	#getEntitygetEntity 		(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name);
void	
#characterscharacters 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * ch, 					 int len);
void	
#elementDeclelementDecl 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name, 					 int type, 					 libxml2-tree.html#xmlElementContentPtrxmlElementContentPtr  content);
void	
#startElementstartElement 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * fullname, 					 const libxml2-xmlstring.html#xmlCharxmlChar  ** atts);
libxml2-tree.html#xmlEntityPtrxmlEntityPtr 	#getParameterEntitygetParameterEntity 	(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name);
void	
#attributeDeclattributeDecl 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * elem, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * fullname, 					 int type, 					 int def, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * defaultValue, 					 libxml2-tree.html#xmlEnumerationPtrxmlEnumerationPtr  tree);
int	
#isStandaloneisStandalone 			(void * ctx);
void	
#internalSubsetinternalSubset 			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * ExternalID, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * SystemID);
void	
#endDocumentendDocument 			(void * ctx);
int	
#getLineNumbergetLineNumber 			(void * ctx);
    
    
      
Description
    
    
      
Details
      
        
attribute ()
void	attribute			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * fullname, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * value)Handle an libxml2-SAX.html#attributeattribute  that has been read by the parser. The default handling is to convert the libxml2-SAX.html#attributeattribute  into an DOM subtree and past it in a new libxml2-tree.html#xmlAttrxmlAttr  element added to the element. DEPRECATED: use xmlSAX2Attribute()
ctx: the user data (XML parser context) fullname: The libxml2-SAX.html#attributeattribute  name, including namespace prefix value: The libxml2-SAX.html#attributeattribute  value         
        
attributeDecl ()
void	attributeDecl			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * elem, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * fullname, 					 int type, 					 int def, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * defaultValue, 					 libxml2-tree.html#xmlEnumerationPtrxmlEnumerationPtr  tree)An libxml2-SAX.html#attributeattribute  definition has been parsed DEPRECATED: use xmlSAX2AttributeDecl()
ctx: the user data (XML parser context) elem: the name of the element fullname: the libxml2-SAX.html#attributeattribute  name type: the libxml2-SAX.html#attributeattribute  type def: the type of default value defaultValue: the libxml2-SAX.html#attributeattribute  default value tree: the tree of enumerated value set         
        
cdataBlock ()
void	cdataBlock			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * value, 					 int len)called when a pcdata block has been parsed DEPRECATED: use xmlSAX2CDataBlock()
ctx: the user data (XML parser context) value: The pcdata content len: the block length         
        
characters ()
void	characters			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * ch, 					 int len)receiving some chars from the parser. DEPRECATED: use xmlSAX2Characters()
ctx: the user data (XML parser context) ch: a libxml2-xmlstring.html#xmlCharxmlChar  string len: the number of libxml2-xmlstring.html#xmlCharxmlChar         
        
checkNamespace ()
int	checkNamespace			(void * ctx, 					 libxml2-xmlstring.html#xmlCharxmlChar  * namespace)Check that the current element namespace is the same as the one read upon parsing. DEPRECATED
ctx: the user data (XML parser context) namespace: the namespace to check against Returns: 1 if true 0 otherwise         
        
comment ()
void	comment			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * value)A libxml2-SAX.html#commentcomment  has been parsed. DEPRECATED: use xmlSAX2Comment()
ctx: the user data (XML parser context) value: the libxml2-SAX.html#commentcomment  content         
        
elementDecl ()
void	elementDecl			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name, 					 int type, 					 libxml2-tree.html#xmlElementContentPtrxmlElementContentPtr  content)An element definition has been parsed DEPRECATED: use xmlSAX2ElementDecl()
ctx: the user data (XML parser context) name: the element name type: the element type content: the element value tree         
        
endDocument ()
void	endDocument			(void * ctx)called when the document end has been detected. DEPRECATED: use xmlSAX2EndDocument()
ctx: the user data (XML parser context)         
        
endElement ()
void	endElement			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name)called when the end of an element has been detected. DEPRECATED: use xmlSAX2EndElement()
ctx: the user data (XML parser context) name: The element name         
        
entityDecl ()
void	entityDecl			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name, 					 int type, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * publicId, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * systemId, 					 libxml2-xmlstring.html#xmlCharxmlChar  * content)An entity definition has been parsed DEPRECATED: use xmlSAX2EntityDecl()
ctx: the user data (XML parser context) name: the entity name type: the entity type publicId: The public ID of the entity systemId: The system ID of the entity content: the entity value (without processing).         
        
externalSubset ()
void	externalSubset			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * ExternalID, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * SystemID)Callback on external subset declaration. DEPRECATED: use xmlSAX2ExternalSubset()
ctx: the user data (XML parser context) name: the root element name ExternalID: the external ID SystemID: the SYSTEM ID (e.g. filename or URL)         
        
getColumnNumber ()
int	getColumnNumber			(void * ctx)Provide the column number of the current parsing point. DEPRECATED: use xmlSAX2GetColumnNumber()
ctx: the user data (XML parser context) Returns: an int         
        
getEntity ()
libxml2-tree.html#xmlEntityPtrxmlEntityPtr 	getEntity		(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name)Get an entity by name DEPRECATED: use xmlSAX2GetEntity()
ctx: the user data (XML parser context) name: The entity name Returns: the libxml2-tree.html#xmlEntityPtrxmlEntityPtr  if found.         
        
getLineNumber ()
int	getLineNumber			(void * ctx)Provide the line number of the current parsing point. DEPRECATED: use xmlSAX2GetLineNumber()
ctx: the user data (XML parser context) Returns: an int         
        
getNamespace ()
libxml2-tree.html#xmlNsPtrxmlNsPtr 	getNamespace		(void * ctx)Get the current element namespace. DEPRECATED
ctx: the user data (XML parser context) Returns: the libxml2-tree.html#xmlNsPtrxmlNsPtr  or NULL if none         
        
getParameterEntity ()
libxml2-tree.html#xmlEntityPtrxmlEntityPtr 	getParameterEntity	(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name)Get a parameter entity by name DEPRECATED: use xmlSAX2GetParameterEntity()
ctx: the user data (XML parser context) name: The entity name Returns: the libxml2-tree.html#xmlEntityPtrxmlEntityPtr  if found.         
        
getPublicId ()
const libxml2-xmlstring.html#xmlCharxmlChar  *	getPublicId		(void * ctx)Provides the public ID e.g. "-//SGMLSOURCE//DTD DEMO//EN" DEPRECATED: use xmlSAX2GetPublicId()
ctx: the user data (XML parser context) Returns: a libxml2-xmlstring.html#xmlCharxmlChar  *         
        
getSystemId ()
const libxml2-xmlstring.html#xmlCharxmlChar  *	getSystemId		(void * ctx)Provides the system ID, basically URL or filename e.g. http://www.sgmlsource.com/dtds/memo.dtd DEPRECATED: use xmlSAX2GetSystemId()
ctx: the user data (XML parser context) Returns: a libxml2-xmlstring.html#xmlCharxmlChar  *         
        
globalNamespace ()
void	globalNamespace			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * href, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * prefix)An old global namespace has been parsed. DEPRECATED
ctx: the user data (XML parser context) href: the namespace associated URN prefix: the namespace prefix         
        
hasExternalSubset ()
int	hasExternalSubset		(void * ctx)Does this document has an external subset DEPRECATED: use xmlSAX2HasExternalSubset()
ctx: the user data (XML parser context) Returns: 1 if true         
        
hasInternalSubset ()
int	hasInternalSubset		(void * ctx)Does this document has an internal subset DEPRECATED: use xmlSAX2HasInternalSubset()
ctx: the user data (XML parser context) Returns: 1 if true         
        
ignorableWhitespace ()
void	ignorableWhitespace		(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * ch, 					 int len)receiving some ignorable whitespaces from the parser. UNUSED: by default the DOM building will use libxml2-SAX.html#characterscharacters  DEPRECATED: use xmlSAX2IgnorableWhitespace()
ctx: the user data (XML parser context) ch: a libxml2-xmlstring.html#xmlCharxmlChar  string len: the number of libxml2-xmlstring.html#xmlCharxmlChar         
        
initdocbDefaultSAXHandler ()
void	initdocbDefaultSAXHandler	( libxml2-parser.html#xmlSAXHandlerV1xmlSAXHandlerV1  * hdlr)Initialize the default DocBook SAX version 1 handler DEPRECATED: use xmlSAX2InitDocbDefaultSAXHandler() for the new SAX2 blocks
hdlr: the SAX handler         
        
inithtmlDefaultSAXHandler ()
void	inithtmlDefaultSAXHandler	( libxml2-parser.html#xmlSAXHandlerV1xmlSAXHandlerV1  * hdlr)Initialize the default HTML SAX version 1 handler DEPRECATED: use xmlSAX2InitHtmlDefaultSAXHandler() for the new SAX2 blocks
hdlr: the SAX handler         
        
initxmlDefaultSAXHandler ()
void	initxmlDefaultSAXHandler	( libxml2-parser.html#xmlSAXHandlerV1xmlSAXHandlerV1  * hdlr, 					 int warning)Initialize the default XML SAX version 1 handler DEPRECATED: use xmlSAX2InitDefaultSAXHandler() for the new SAX2 blocks
hdlr: the SAX handler warning: flag if non-zero sets the handler warning procedure         
        
internalSubset ()
void	internalSubset			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * ExternalID, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * SystemID)Callback on internal subset declaration. DEPRECATED: use xmlSAX2InternalSubset()
ctx: the user data (XML parser context) name: the root element name ExternalID: the external ID SystemID: the SYSTEM ID (e.g. filename or URL)         
        
isStandalone ()
int	isStandalone			(void * ctx)Is this document tagged standalone ? DEPRECATED: use xmlSAX2IsStandalone()
ctx: the user data (XML parser context) Returns: 1 if true         
        
namespaceDecl ()
void	namespaceDecl			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * href, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * prefix)A namespace has been parsed. DEPRECATED
ctx: the user data (XML parser context) href: the namespace associated URN prefix: the namespace prefix         
        
notationDecl ()
void	notationDecl			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * publicId, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * systemId)What to do when a notation declaration has been parsed. DEPRECATED: use xmlSAX2NotationDecl()
ctx: the user data (XML parser context) name: The name of the notation publicId: The public ID of the entity systemId: The system ID of the entity         
        
processingInstruction ()
void	processingInstruction		(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * target, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * data)A processing instruction has been parsed. DEPRECATED: use xmlSAX2ProcessingInstruction()
ctx: the user data (XML parser context) target: the target name data: the PI data's         
        
reference ()
void	reference			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name)called when an entity libxml2-SAX.html#referencereference  is detected. DEPRECATED: use xmlSAX2Reference()
ctx: the user data (XML parser context) name: The entity name         
        
resolveEntity ()
libxml2-tree.html#xmlParserInputPtrxmlParserInputPtr 	resolveEntity	(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * publicId, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * systemId)The entity loader, to control the loading of external entities, the application can either: - override this resolveEntity() callback in the SAX block - or better use the xmlSetExternalEntityLoader() function to set up it's own entity resolution routine DEPRECATED: use xmlSAX2ResolveEntity()
ctx: the user data (XML parser context) publicId: The public ID of the entity systemId: The system ID of the entity Returns: the libxml2-tree.html#xmlParserInputPtrxmlParserInputPtr  if inlined or NULL for DOM behaviour.         
        
setDocumentLocator ()
void	setDocumentLocator		(void * ctx, 					 libxml2-tree.html#xmlSAXLocatorPtrxmlSAXLocatorPtr  loc)Receive the document locator at startup, actually libxml2-globals.html#xmlDefaultSAXLocatorxmlDefaultSAXLocator  Everything is available on the context, so this is useless in our case. DEPRECATED
ctx: the user data (XML parser context) loc: A SAX Locator         
        
setNamespace ()
void	setNamespace			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name)Set the current element namespace. DEPRECATED
ctx: the user data (XML parser context) name: the namespace prefix         
        
startDocument ()
void	startDocument			(void * ctx)called when the document start being processed. DEPRECATED: use xmlSAX2StartDocument()
ctx: the user data (XML parser context)         
        
startElement ()
void	startElement			(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * fullname, 					 const libxml2-xmlstring.html#xmlCharxmlChar  ** atts)called when an opening tag has been processed. DEPRECATED: use xmlSAX2StartElement()
ctx: the user data (XML parser context) fullname: The element name, including namespace prefix atts: An array of name/value attributes pairs, NULL terminated         
        
unparsedEntityDecl ()
void	unparsedEntityDecl		(void * ctx, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * name, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * publicId, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * systemId, 					 const libxml2-xmlstring.html#xmlCharxmlChar  * notationName)What to do when an unparsed entity declaration is parsed DEPRECATED: use xmlSAX2UnparsedEntityDecl()
ctx: the user data (XML parser context) name: The name of the entity publicId: The public ID of the entity systemId: The system ID of the entity notationName: the name of the notation         
      
    
  
