https://github.com/yijunyu/srcsax

https://github.com/yijunyu/srcsax

Last synced: 10 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/yijunyu/srcsax
• Owner: yijunyu
• Created: 2018-12-23T20:35:44.000Z (about 6 years ago)
• Default Branch: conda-osx
• Last Pushed: 2018-12-26T11:59:02.000Z (about 6 years ago)
• Last Synced: 2024-11-06T03:46:23.413Z (about 2 months ago)
• Language: C++
• Size: 71.3 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README

Awesome Lists containing this project

README

        
srcML SAX2Framework

Framework provides a simplified sax2 interface built

off of libxml2 library for srcML documents.  The

framework automatically handles srcML archives and

non-archives.

srcMLControlHandler provides the control mechanism

inwhich to setup and parse a srcML file. User specific

handling is specified through inheriting from the

srcMLHandler which is supplied to the parse method.

SAX2srcMLHandler implements the actual libxml2 parts and calls

the necessary handler functions from srcMLHandler.  startDocument

and endDocument are called exactly once.  startRoot and endRoot

are also called exactly once for the begining and ending of the 

root element.  startUnit and endUnit are called once each for

each inner unit. All other open and closing tags are handled

by startElementNs and endElementNs. Character data is handled

by charactersRoot called for characters that occur directly within

a root tag between units, and charactersUnit which is called

for all character data occuring within a unit.  Two additional

function comment and cdataBlock are called when their XML

equivalents are encountered, however, these are not generally

included in srcML documents.  Overide methods to get the

intended behaviour.

Parsing can be stopped at any point by calling stop_parser.

For usage examples, including running in a separate thread see examples.

Author: Michael John Decker

Email:  [email protected]