Initial import from libStreamedXML-1.2.7
This commit is contained in:
commit
8c470e4039
|
@ -0,0 +1,2 @@
|
||||||
|
obj
|
||||||
|
html
|
|
@ -0,0 +1,278 @@
|
||||||
|
GNU GENERAL PUBLIC LICENSE
|
||||||
|
Version 2, June 1991
|
||||||
|
|
||||||
|
Copyright (C) 1989, 1991 Free Software Foundation, Inc.
|
||||||
|
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||||
|
Everyone is permitted to copy and distribute verbatim copies
|
||||||
|
of this license document, but changing it is not allowed.
|
||||||
|
|
||||||
|
Preamble
|
||||||
|
|
||||||
|
The licenses for most software are designed to take away your
|
||||||
|
freedom to share and change it. By contrast, the GNU General Public
|
||||||
|
License is intended to guarantee your freedom to share and change free
|
||||||
|
software--to make sure the software is free for all its users. This
|
||||||
|
General Public License applies to most of the Free Software
|
||||||
|
Foundation's software and to any other program whose authors commit to
|
||||||
|
using it. (Some other Free Software Foundation software is covered by
|
||||||
|
the GNU Library General Public License instead.) You can apply it to
|
||||||
|
your programs, too.
|
||||||
|
|
||||||
|
When we speak of free software, we are referring to freedom, not
|
||||||
|
price. Our General Public Licenses are designed to make sure that you
|
||||||
|
have the freedom to distribute copies of free software (and charge for
|
||||||
|
this service if you wish), that you receive source code or can get it
|
||||||
|
if you want it, that you can change the software or use pieces of it
|
||||||
|
in new free programs; and that you know you can do these things.
|
||||||
|
|
||||||
|
To protect your rights, we need to make restrictions that forbid
|
||||||
|
anyone to deny you these rights or to ask you to surrender the rights.
|
||||||
|
These restrictions translate to certain responsibilities for you if you
|
||||||
|
distribute copies of the software, or if you modify it.
|
||||||
|
|
||||||
|
For example, if you distribute copies of such a program, whether
|
||||||
|
gratis or for a fee, you must give the recipients all the rights that
|
||||||
|
you have. You must make sure that they, too, receive or can get the
|
||||||
|
source code. And you must show them these terms so they know their
|
||||||
|
rights.
|
||||||
|
|
||||||
|
We protect your rights with two steps: (1) copyright the software, and
|
||||||
|
(2) offer you this license which gives you legal permission to copy,
|
||||||
|
distribute and/or modify the software.
|
||||||
|
|
||||||
|
Also, for each author's protection and ours, we want to make certain
|
||||||
|
that everyone understands that there is no warranty for this free
|
||||||
|
software. If the software is modified by someone else and passed on, we
|
||||||
|
want its recipients to know that what they have is not the original, so
|
||||||
|
that any problems introduced by others will not reflect on the original
|
||||||
|
authors' reputations.
|
||||||
|
|
||||||
|
Finally, any free program is threatened constantly by software
|
||||||
|
patents. We wish to avoid the danger that redistributors of a free
|
||||||
|
program will individually obtain patent licenses, in effect making the
|
||||||
|
program proprietary. To prevent this, we have made it clear that any
|
||||||
|
patent must be licensed for everyone's free use or not licensed at all.
|
||||||
|
|
||||||
|
The precise terms and conditions for copying, distribution and
|
||||||
|
modification follow.
|
||||||
|
|
||||||
|
GNU GENERAL PUBLIC LICENSE
|
||||||
|
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
|
||||||
|
|
||||||
|
0. This License applies to any program or other work which contains
|
||||||
|
a notice placed by the copyright holder saying it may be distributed
|
||||||
|
under the terms of this General Public License. The "Program", below,
|
||||||
|
refers to any such program or work, and a "work based on the Program"
|
||||||
|
means either the Program or any derivative work under copyright law:
|
||||||
|
that is to say, a work containing the Program or a portion of it,
|
||||||
|
either verbatim or with modifications and/or translated into another
|
||||||
|
language. (Hereinafter, translation is included without limitation in
|
||||||
|
the term "modification".) Each licensee is addressed as "you".
|
||||||
|
|
||||||
|
Activities other than copying, distribution and modification are not
|
||||||
|
covered by this License; they are outside its scope. The act of
|
||||||
|
running the Program is not restricted, and the output from the Program
|
||||||
|
is covered only if its contents constitute a work based on the
|
||||||
|
Program (independent of having been made by running the Program).
|
||||||
|
Whether that is true depends on what the Program does.
|
||||||
|
|
||||||
|
1. You may copy and distribute verbatim copies of the Program's
|
||||||
|
source code as you receive it, in any medium, provided that you
|
||||||
|
conspicuously and appropriately publish on each copy an appropriate
|
||||||
|
copyright notice and disclaimer of warranty; keep intact all the
|
||||||
|
notices that refer to this License and to the absence of any warranty;
|
||||||
|
and give any other recipients of the Program a copy of this License
|
||||||
|
along with the Program.
|
||||||
|
|
||||||
|
You may charge a fee for the physical act of transferring a copy, and
|
||||||
|
you may at your option offer warranty protection in exchange for a fee.
|
||||||
|
|
||||||
|
2. You may modify your copy or copies of the Program or any portion
|
||||||
|
of it, thus forming a work based on the Program, and copy and
|
||||||
|
distribute such modifications or work under the terms of Section 1
|
||||||
|
above, provided that you also meet all of these conditions:
|
||||||
|
|
||||||
|
a) You must cause the modified files to carry prominent notices
|
||||||
|
stating that you changed the files and the date of any change.
|
||||||
|
|
||||||
|
b) You must cause any work that you distribute or publish, that in
|
||||||
|
whole or in part contains or is derived from the Program or any
|
||||||
|
part thereof, to be licensed as a whole at no charge to all third
|
||||||
|
parties under the terms of this License.
|
||||||
|
|
||||||
|
c) If the modified program normally reads commands interactively
|
||||||
|
when run, you must cause it, when started running for such
|
||||||
|
interactive use in the most ordinary way, to print or display an
|
||||||
|
announcement including an appropriate copyright notice and a
|
||||||
|
notice that there is no warranty (or else, saying that you provide
|
||||||
|
a warranty) and that users may redistribute the program under
|
||||||
|
these conditions, and telling the user how to view a copy of this
|
||||||
|
License. (Exception: if the Program itself is interactive but
|
||||||
|
does not normally print such an announcement, your work based on
|
||||||
|
the Program is not required to print an announcement.)
|
||||||
|
|
||||||
|
These requirements apply to the modified work as a whole. If
|
||||||
|
identifiable sections of that work are not derived from the Program,
|
||||||
|
and can be reasonably considered independent and separate works in
|
||||||
|
themselves, then this License, and its terms, do not apply to those
|
||||||
|
sections when you distribute them as separate works. But when you
|
||||||
|
distribute the same sections as part of a whole which is a work based
|
||||||
|
on the Program, the distribution of the whole must be on the terms of
|
||||||
|
this License, whose permissions for other licensees extend to the
|
||||||
|
entire whole, and thus to each and every part regardless of who wrote it.
|
||||||
|
|
||||||
|
Thus, it is not the intent of this section to claim rights or contest
|
||||||
|
your rights to work written entirely by you; rather, the intent is to
|
||||||
|
exercise the right to control the distribution of derivative or
|
||||||
|
collective works based on the Program.
|
||||||
|
|
||||||
|
In addition, mere aggregation of another work not based on the Program
|
||||||
|
with the Program (or with a work based on the Program) on a volume of
|
||||||
|
a storage or distribution medium does not bring the other work under
|
||||||
|
the scope of this License.
|
||||||
|
|
||||||
|
3. You may copy and distribute the Program (or a work based on it,
|
||||||
|
under Section 2) in object code or executable form under the terms of
|
||||||
|
Sections 1 and 2 above provided that you also do one of the following:
|
||||||
|
|
||||||
|
a) Accompany it with the complete corresponding machine-readable
|
||||||
|
source code, which must be distributed under the terms of Sections
|
||||||
|
1 and 2 above on a medium customarily used for software interchange; or,
|
||||||
|
|
||||||
|
b) Accompany it with a written offer, valid for at least three
|
||||||
|
years, to give any third party, for a charge no more than your
|
||||||
|
cost of physically performing source distribution, a complete
|
||||||
|
machine-readable copy of the corresponding source code, to be
|
||||||
|
distributed under the terms of Sections 1 and 2 above on a medium
|
||||||
|
customarily used for software interchange; or,
|
||||||
|
|
||||||
|
c) Accompany it with the information you received as to the offer
|
||||||
|
to distribute corresponding source code. (This alternative is
|
||||||
|
allowed only for noncommercial distribution and only if you
|
||||||
|
received the program in object code or executable form with such
|
||||||
|
an offer, in accord with Subsection b above.)
|
||||||
|
|
||||||
|
The source code for a work means the preferred form of the work for
|
||||||
|
making modifications to it. For an executable work, complete source
|
||||||
|
code means all the source code for all modules it contains, plus any
|
||||||
|
associated interface definition files, plus the scripts used to
|
||||||
|
control compilation and installation of the executable. However, as a
|
||||||
|
special exception, the source code distributed need not include
|
||||||
|
anything that is normally distributed (in either source or binary
|
||||||
|
form) with the major components (compiler, kernel, and so on) of the
|
||||||
|
operating system on which the executable runs, unless that component
|
||||||
|
itself accompanies the executable.
|
||||||
|
|
||||||
|
If distribution of executable or object code is made by offering
|
||||||
|
access to copy from a designated place, then offering equivalent
|
||||||
|
access to copy the source code from the same place counts as
|
||||||
|
distribution of the source code, even though third parties are not
|
||||||
|
compelled to copy the source along with the object code.
|
||||||
|
|
||||||
|
4. You may not copy, modify, sublicense, or distribute the Program
|
||||||
|
except as expressly provided under this License. Any attempt
|
||||||
|
otherwise to copy, modify, sublicense or distribute the Program is
|
||||||
|
void, and will automatically terminate your rights under this License.
|
||||||
|
However, parties who have received copies, or rights, from you under
|
||||||
|
this License will not have their licenses terminated so long as such
|
||||||
|
parties remain in full compliance.
|
||||||
|
|
||||||
|
5. You are not required to accept this License, since you have not
|
||||||
|
signed it. However, nothing else grants you permission to modify or
|
||||||
|
distribute the Program or its derivative works. These actions are
|
||||||
|
prohibited by law if you do not accept this License. Therefore, by
|
||||||
|
modifying or distributing the Program (or any work based on the
|
||||||
|
Program), you indicate your acceptance of this License to do so, and
|
||||||
|
all its terms and conditions for copying, distributing or modifying
|
||||||
|
the Program or works based on it.
|
||||||
|
|
||||||
|
6. Each time you redistribute the Program (or any work based on the
|
||||||
|
Program), the recipient automatically receives a license from the
|
||||||
|
original licensor to copy, distribute or modify the Program subject to
|
||||||
|
these terms and conditions. You may not impose any further
|
||||||
|
restrictions on the recipients' exercise of the rights granted herein.
|
||||||
|
You are not responsible for enforcing compliance by third parties to
|
||||||
|
this License.
|
||||||
|
|
||||||
|
7. If, as a consequence of a court judgment or allegation of patent
|
||||||
|
infringement or for any other reason (not limited to patent issues),
|
||||||
|
conditions are imposed on you (whether by court order, agreement or
|
||||||
|
otherwise) that contradict the conditions of this License, they do not
|
||||||
|
excuse you from the conditions of this License. If you cannot
|
||||||
|
distribute so as to satisfy simultaneously your obligations under this
|
||||||
|
License and any other pertinent obligations, then as a consequence you
|
||||||
|
may not distribute the Program at all. For example, if a patent
|
||||||
|
license would not permit royalty-free redistribution of the Program by
|
||||||
|
all those who receive copies directly or indirectly through you, then
|
||||||
|
the only way you could satisfy both it and this License would be to
|
||||||
|
refrain entirely from distribution of the Program.
|
||||||
|
|
||||||
|
If any portion of this section is held invalid or unenforceable under
|
||||||
|
any particular circumstance, the balance of the section is intended to
|
||||||
|
apply and the section as a whole is intended to apply in other
|
||||||
|
circumstances.
|
||||||
|
|
||||||
|
It is not the purpose of this section to induce you to infringe any
|
||||||
|
patents or other property right claims or to contest validity of any
|
||||||
|
such claims; this section has the sole purpose of protecting the
|
||||||
|
integrity of the free software distribution system, which is
|
||||||
|
implemented by public license practices. Many people have made
|
||||||
|
generous contributions to the wide range of software distributed
|
||||||
|
through that system in reliance on consistent application of that
|
||||||
|
system; it is up to the author/donor to decide if he or she is willing
|
||||||
|
to distribute software through any other system and a licensee cannot
|
||||||
|
impose that choice.
|
||||||
|
|
||||||
|
This section is intended to make thoroughly clear what is believed to
|
||||||
|
be a consequence of the rest of this License.
|
||||||
|
|
||||||
|
8. If the distribution and/or use of the Program is restricted in
|
||||||
|
certain countries either by patents or by copyrighted interfaces, the
|
||||||
|
original copyright holder who places the Program under this License
|
||||||
|
may add an explicit geographical distribution limitation excluding
|
||||||
|
those countries, so that distribution is permitted only in or among
|
||||||
|
countries not thus excluded. In such case, this License incorporates
|
||||||
|
the limitation as if written in the body of this License.
|
||||||
|
|
||||||
|
9. The Free Software Foundation may publish revised and/or new versions
|
||||||
|
of the General Public License from time to time. Such new versions will
|
||||||
|
be similar in spirit to the present version, but may differ in detail to
|
||||||
|
address new problems or concerns.
|
||||||
|
|
||||||
|
Each version is given a distinguishing version number. If the Program
|
||||||
|
specifies a version number of this License which applies to it and "any
|
||||||
|
later version", you have the option of following the terms and conditions
|
||||||
|
either of that version or of any later version published by the Free
|
||||||
|
Software Foundation. If the Program does not specify a version number of
|
||||||
|
this License, you may choose any version ever published by the Free Software
|
||||||
|
Foundation.
|
||||||
|
|
||||||
|
10. If you wish to incorporate parts of the Program into other free
|
||||||
|
programs whose distribution conditions are different, write to the author
|
||||||
|
to ask for permission. For software which is copyrighted by the Free
|
||||||
|
Software Foundation, write to the Free Software Foundation; we sometimes
|
||||||
|
make exceptions for this. Our decision will be guided by the two goals
|
||||||
|
of preserving the free status of all derivatives of our free software and
|
||||||
|
of promoting the sharing and reuse of software generally.
|
||||||
|
|
||||||
|
NO WARRANTY
|
||||||
|
|
||||||
|
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
|
||||||
|
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
|
||||||
|
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
|
||||||
|
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
|
||||||
|
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
||||||
|
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
|
||||||
|
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
|
||||||
|
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
|
||||||
|
REPAIR OR CORRECTION.
|
||||||
|
|
||||||
|
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||||
|
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
|
||||||
|
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
|
||||||
|
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
|
||||||
|
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
|
||||||
|
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
|
||||||
|
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
|
||||||
|
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
|
||||||
|
POSSIBILITY OF SUCH DAMAGES.
|
|
@ -0,0 +1,14 @@
|
||||||
|
libCStreamedXML http://www.lwithers.me.uk/projects/libCStreamedXML/
|
||||||
|
========================================================================
|
||||||
|
(c)2006, Laurence Withers, <l@lwithers.me.uk>.
|
||||||
|
Released under the GNU GPLv2. See file COPYING or
|
||||||
|
http://www.gnu.org/copyleft/gpl.html for details.
|
||||||
|
|
||||||
|
Really Quick Instructions
|
||||||
|
-------------------------
|
||||||
|
|
||||||
|
To build: ./make.sh
|
||||||
|
To install: ./make.sh install
|
||||||
|
(you might want to set PREFIX, by default it's /usr/local)
|
||||||
|
|
||||||
|
This library has no dependencies other than the C library.
|
|
@ -0,0 +1,168 @@
|
||||||
|
<?xml version = '1.0'?>
|
||||||
|
<kdevelop>
|
||||||
|
<general>
|
||||||
|
<author>Laurence Withers</author>
|
||||||
|
<email>l@lwithers.me.uk</email>
|
||||||
|
<version>$VERSION$</version>
|
||||||
|
<projectmanagement>KDevCustomProject</projectmanagement>
|
||||||
|
<primarylanguage>C++</primarylanguage>
|
||||||
|
<ignoreparts/>
|
||||||
|
<projectdirectory>.</projectdirectory>
|
||||||
|
<absoluteprojectpath>false</absoluteprojectpath>
|
||||||
|
<description/>
|
||||||
|
<versioncontrol/>
|
||||||
|
</general>
|
||||||
|
<kdevcustomproject>
|
||||||
|
<run>
|
||||||
|
<mainprogram>/bin/true</mainprogram>
|
||||||
|
<directoryradio>executable</directoryradio>
|
||||||
|
<customdirectory>/</customdirectory>
|
||||||
|
<programargs/>
|
||||||
|
<terminal>false</terminal>
|
||||||
|
<autocompile>true</autocompile>
|
||||||
|
<envvars/>
|
||||||
|
</run>
|
||||||
|
<build>
|
||||||
|
<buildtool>make</buildtool>
|
||||||
|
<builddir/>
|
||||||
|
</build>
|
||||||
|
<make>
|
||||||
|
<abortonerror>false</abortonerror>
|
||||||
|
<numberofjobs>1</numberofjobs>
|
||||||
|
<prio>0</prio>
|
||||||
|
<dontact>false</dontact>
|
||||||
|
<makebin>./make.sh</makebin>
|
||||||
|
<defaulttarget>default</defaulttarget>
|
||||||
|
<makeoptions/>
|
||||||
|
<selectedenvironment>default</selectedenvironment>
|
||||||
|
<environments>
|
||||||
|
<default/>
|
||||||
|
</environments>
|
||||||
|
</make>
|
||||||
|
<general>
|
||||||
|
<activedir/>
|
||||||
|
</general>
|
||||||
|
</kdevcustomproject>
|
||||||
|
<kdevdebugger>
|
||||||
|
<general>
|
||||||
|
<dbgshell/>
|
||||||
|
<programargs/>
|
||||||
|
<gdbpath/>
|
||||||
|
<configGdbScript/>
|
||||||
|
<runShellScript/>
|
||||||
|
<runGdbScript/>
|
||||||
|
<breakonloadinglibs>true</breakonloadinglibs>
|
||||||
|
<separatetty>false</separatetty>
|
||||||
|
<floatingtoolbar>false</floatingtoolbar>
|
||||||
|
</general>
|
||||||
|
<display>
|
||||||
|
<staticmembers>false</staticmembers>
|
||||||
|
<demanglenames>true</demanglenames>
|
||||||
|
<outputradix>10</outputradix>
|
||||||
|
</display>
|
||||||
|
</kdevdebugger>
|
||||||
|
<kdevdoctreeview>
|
||||||
|
<ignoretocs>
|
||||||
|
<toc>ada</toc>
|
||||||
|
<toc>ada_bugs_gcc</toc>
|
||||||
|
<toc>bash</toc>
|
||||||
|
<toc>bash_bugs</toc>
|
||||||
|
<toc>clanlib</toc>
|
||||||
|
<toc>fortran_bugs_gcc</toc>
|
||||||
|
<toc>gnome1</toc>
|
||||||
|
<toc>gnustep</toc>
|
||||||
|
<toc>gtk</toc>
|
||||||
|
<toc>gtk_bugs</toc>
|
||||||
|
<toc>haskell</toc>
|
||||||
|
<toc>haskell_bugs_ghc</toc>
|
||||||
|
<toc>java_bugs_gcc</toc>
|
||||||
|
<toc>java_bugs_sun</toc>
|
||||||
|
<toc>kde2book</toc>
|
||||||
|
<toc>opengl</toc>
|
||||||
|
<toc>pascal_bugs_fp</toc>
|
||||||
|
<toc>php</toc>
|
||||||
|
<toc>php_bugs</toc>
|
||||||
|
<toc>perl</toc>
|
||||||
|
<toc>perl_bugs</toc>
|
||||||
|
<toc>python</toc>
|
||||||
|
<toc>python_bugs</toc>
|
||||||
|
<toc>qt-kdev3</toc>
|
||||||
|
<toc>ruby</toc>
|
||||||
|
<toc>ruby_bugs</toc>
|
||||||
|
<toc>sdl</toc>
|
||||||
|
<toc>sw</toc>
|
||||||
|
<toc>w3c-dom-level2-html</toc>
|
||||||
|
<toc>w3c-svg</toc>
|
||||||
|
<toc>w3c-uaag10</toc>
|
||||||
|
<toc>wxwidgets_bugs</toc>
|
||||||
|
</ignoretocs>
|
||||||
|
<ignoreqt_xml>
|
||||||
|
<toc>Guide to the Qt Translation Tools</toc>
|
||||||
|
<toc>Qt Assistant Manual</toc>
|
||||||
|
<toc>Qt Designer Manual</toc>
|
||||||
|
<toc>Qt Reference Documentation</toc>
|
||||||
|
<toc>qmake User Guide</toc>
|
||||||
|
</ignoreqt_xml>
|
||||||
|
<ignoredoxygen>
|
||||||
|
<toc>KDE Libraries (Doxygen)</toc>
|
||||||
|
</ignoredoxygen>
|
||||||
|
</kdevdoctreeview>
|
||||||
|
<kdevfilecreate>
|
||||||
|
<filetypes/>
|
||||||
|
<useglobaltypes>
|
||||||
|
<type ext="cpp" />
|
||||||
|
<type ext="h" />
|
||||||
|
</useglobaltypes>
|
||||||
|
</kdevfilecreate>
|
||||||
|
<cppsupportpart>
|
||||||
|
<filetemplates>
|
||||||
|
<interfacesuffix>.h</interfacesuffix>
|
||||||
|
<implementationsuffix>.cpp</implementationsuffix>
|
||||||
|
</filetemplates>
|
||||||
|
</cppsupportpart>
|
||||||
|
<kdevcppsupport>
|
||||||
|
<codecompletion>
|
||||||
|
<includeGlobalFunctions>true</includeGlobalFunctions>
|
||||||
|
<includeTypes>true</includeTypes>
|
||||||
|
<includeEnums>true</includeEnums>
|
||||||
|
<includeTypedefs>false</includeTypedefs>
|
||||||
|
<automaticCodeCompletion>true</automaticCodeCompletion>
|
||||||
|
<automaticArgumentsHint>true</automaticArgumentsHint>
|
||||||
|
<automaticHeaderCompletion>true</automaticHeaderCompletion>
|
||||||
|
<codeCompletionDelay>1</codeCompletionDelay>
|
||||||
|
<argumentsHintDelay>1</argumentsHintDelay>
|
||||||
|
<headerCompletionDelay>250</headerCompletionDelay>
|
||||||
|
</codecompletion>
|
||||||
|
<creategettersetter>
|
||||||
|
<prefixGet/>
|
||||||
|
<prefixSet>set</prefixSet>
|
||||||
|
<prefixVariable>m_,_</prefixVariable>
|
||||||
|
<parameterName>theValue</parameterName>
|
||||||
|
<inlineGet>true</inlineGet>
|
||||||
|
<inlineSet>true</inlineSet>
|
||||||
|
</creategettersetter>
|
||||||
|
<references/>
|
||||||
|
</kdevcppsupport>
|
||||||
|
<kdevdocumentation>
|
||||||
|
<projectdoc>
|
||||||
|
<docsystem/>
|
||||||
|
<docurl/>
|
||||||
|
<usermanualurl/>
|
||||||
|
</projectdoc>
|
||||||
|
</kdevdocumentation>
|
||||||
|
<kdevfileview>
|
||||||
|
<groups>
|
||||||
|
<hidenonprojectfiles>false</hidenonprojectfiles>
|
||||||
|
<hidenonlocation>false</hidenonlocation>
|
||||||
|
</groups>
|
||||||
|
<tree>
|
||||||
|
<hidepatterns>*.o,*.lo,CVS</hidepatterns>
|
||||||
|
<hidenonprojectfiles>false</hidenonprojectfiles>
|
||||||
|
<showvcsfields>false</showvcsfields>
|
||||||
|
</tree>
|
||||||
|
</kdevfileview>
|
||||||
|
<ctagspart>
|
||||||
|
<customArguments/>
|
||||||
|
<customTagfilePath/>
|
||||||
|
</ctagspart>
|
||||||
|
</kdevelop>
|
|
@ -0,0 +1,4 @@
|
||||||
|
# KDevelop Custom Project File List
|
||||||
|
src/lib/BottomHeader.h
|
||||||
|
src/lib/TopHeader.h
|
||||||
|
src/lib/TopSource.cpp
|
|
@ -0,0 +1,292 @@
|
||||||
|
#!/bin/bash
|
||||||
|
# libCStreamedXML/make.sh
|
||||||
|
#
|
||||||
|
# (c)2006, Laurence Withers, <l@lwithers.me.uk>.
|
||||||
|
# Released under the GNU GPLv2. See file COPYING or
|
||||||
|
# http://www.gnu.org/copyleft/gpl.html for details.
|
||||||
|
#
|
||||||
|
|
||||||
|
|
||||||
|
# This file is the script used to build libCStreamedXML. There are some
|
||||||
|
# options that can be edited; these are set below (or you can pass them
|
||||||
|
# in as variables).
|
||||||
|
[ -z "${CC}" ] && CC="gcc"
|
||||||
|
[ -z "${CXX}" ] && CXX="g++"
|
||||||
|
[ -z "${CFLAGS}" ] && CFLAGS="-g -O2 -W -Wall"
|
||||||
|
[ -z "${PREFIX}" ] && PREFIX="/usr/local"
|
||||||
|
[ -z "${LIBDIR}" ] && LIBDIR="${PREFIX}/lib"
|
||||||
|
[ -z "${BINDIR}" ] && BINDIR="${PREFIX}/bin"
|
||||||
|
[ -z "${INCLUDEDIR}" ] && INCLUDEDIR="${PREFIX}/include"
|
||||||
|
[ -z "${DOCSDIR}" ] && DOCSDIR="${PREFIX}/share/doc/libCStreamedXML"
|
||||||
|
|
||||||
|
# for pkg-config
|
||||||
|
[ -z "${PKGCONFDIR}" ] && PKGCONFDIR="${LIBDIR}/pkgconfig"
|
||||||
|
[ -z "${FINALLIBDIR}" ] && FINALLIBDIR="${LIBDIR}"
|
||||||
|
[ -z "${FINALINCLUDEDIR}" ] && FINALINCLUDEDIR="${INCLUDEDIR}"
|
||||||
|
|
||||||
|
# for SDCC-built firmware
|
||||||
|
[ -z "${HEXDIR}" ] && HEXDIR="${PREFIX}/share/firmware"
|
||||||
|
[ -z "${SDCC}" ] && SDCC="sdcc"
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# Get version information
|
||||||
|
source version || exit 1
|
||||||
|
VERSION="${VERMAJOR}.${VERMINOR}.${VERMICRO}"
|
||||||
|
if [ ! -z "${VEREXTRA}" ]
|
||||||
|
then
|
||||||
|
VERSION="${VERSION}-${VEREXTRA}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# Get standard functions
|
||||||
|
[ -z "${VERBOSE}" ] && VERBOSE="0"
|
||||||
|
source scripts/functions.sh || exit 1
|
||||||
|
|
||||||
|
|
||||||
|
# List of directories which will be emptied by clean.
|
||||||
|
OUTPUT_DIRS="obj html"
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# This function makes a monolithic file out of several source files. Its
|
||||||
|
# first argument is the name of the output file, and the second is the
|
||||||
|
# format of monolithic file to create (for example, "C" will cause the
|
||||||
|
# inclusion of "#line" directives at the top of each included file).
|
||||||
|
#
|
||||||
|
# It also examines the following variables:
|
||||||
|
# MONOLITHIC_TESTS if any file mentioned in this list is newer
|
||||||
|
# than the output file, then we recreate it
|
||||||
|
# MONOLITHIC_SOURCE a list (in order) of the source files
|
||||||
|
#
|
||||||
|
# Recognised formats are:
|
||||||
|
# none no special processing happens before each file
|
||||||
|
# C #line directives are inserted before each file
|
||||||
|
# and VERSION, VERMAJOR etc. are #defined
|
||||||
|
# Ch Like C, but for header files (no VERSION #defines)
|
||||||
|
#
|
||||||
|
make_monolithic() {
|
||||||
|
if [ $# -ne 2 ]
|
||||||
|
then
|
||||||
|
print_failure "make_monolithic() called with wrong number of arguments"
|
||||||
|
print_failure "(expecting 2, got $#)"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
MONOLITHIC_OUT=$1
|
||||||
|
|
||||||
|
# extract options
|
||||||
|
HASHLINE=0
|
||||||
|
VERDEFINE=0
|
||||||
|
if [ "$2" == "C" ]
|
||||||
|
then
|
||||||
|
HASHLINE=1
|
||||||
|
VERDEFINE=1
|
||||||
|
elif [ "$2" == "Ch" ]
|
||||||
|
then
|
||||||
|
HASHLINE=1
|
||||||
|
elif [ "$2" == "none" ]
|
||||||
|
then
|
||||||
|
HASHLINE=0 # dummy command
|
||||||
|
else
|
||||||
|
print_failure "make_monolithic() called with unknown format $2"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo " Building monolithic file '${MONOLITHIC_OUT}'..."
|
||||||
|
|
||||||
|
MODIFIED=0
|
||||||
|
for FILE in ${MONOLITHIC_TESTS} ${MONOLITHIC_SOURCE}
|
||||||
|
do
|
||||||
|
if [ ! -e "${FILE}" ]
|
||||||
|
then
|
||||||
|
print_failure "'${FILE}' does not exist"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ "${FILE}" -nt ${MONOLITHIC_OUT} ]
|
||||||
|
then
|
||||||
|
MODIFIED=1
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
if [ ${MODIFIED} -ne 0 ]
|
||||||
|
then
|
||||||
|
do_cmd mkdir -p $(dirname ${MONOLITHIC_OUT})
|
||||||
|
do_cmd rm -f ${MONOLITHIC_OUT} || exit 1
|
||||||
|
|
||||||
|
if [ ${VERDEFINE} -ne 0 ]
|
||||||
|
then
|
||||||
|
do_cmd_redir ${MONOLITHIC_OUT} echo "#define VERSION \"${VERSION}\"" || return 1
|
||||||
|
do_cmd_redir ${MONOLITHIC_OUT} echo "#define VERMAJOR ${VERMAJOR}" || return 1
|
||||||
|
do_cmd_redir ${MONOLITHIC_OUT} echo "#define VERMINOR ${VERMINOR}" || return 1
|
||||||
|
do_cmd_redir ${MONOLITHIC_OUT} echo "#define VERMICRO ${VERMICRO}" || return 1
|
||||||
|
do_cmd_redir ${MONOLITHIC_OUT} echo "#define VEREXTRA \"${VEREXTRA}\"" || return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
for FILE in ${MONOLITHIC_SOURCE}
|
||||||
|
do
|
||||||
|
if [ ${HASHLINE} -ne 0 ]
|
||||||
|
then
|
||||||
|
do_cmd_redir ${MONOLITHIC_OUT} echo "#line 1 \"${FILE}\"" || return 1
|
||||||
|
fi
|
||||||
|
do_cmd_redir ${MONOLITHIC_OUT} cat "${FILE}" || return 1
|
||||||
|
done
|
||||||
|
print_success "Done"
|
||||||
|
else
|
||||||
|
print_success "Up to date"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# This will build a directory tree, if required, with mode 0755. The
|
||||||
|
# argument is the directory to build.
|
||||||
|
build_dir_tree() {
|
||||||
|
# sanity check
|
||||||
|
if [ $# -ne 1 ]
|
||||||
|
then
|
||||||
|
print_failure "build_dir_tree() called with wrong number of arguments"
|
||||||
|
print_failure "(expecting 1, got $#)"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
local DIR="$1"
|
||||||
|
|
||||||
|
# if the directory already exists, return success
|
||||||
|
[ -d "${DIR}" ] && return 0
|
||||||
|
|
||||||
|
# if something with this name already exists, but not a directory,
|
||||||
|
# then fail
|
||||||
|
if [ -e "${DIR}" ]
|
||||||
|
then
|
||||||
|
print_failure "Failed to create directory '${DIR}'"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# build the directory, but if it fails, recurse a level (and handle
|
||||||
|
# the case where recursion fails)
|
||||||
|
mkdir "${DIR}" >& /dev/null
|
||||||
|
if [ $? -ne 0 ]
|
||||||
|
then
|
||||||
|
build_dir_tree $(dirname "${DIR}") || return 1
|
||||||
|
mkdir "${DIR}"
|
||||||
|
if [ $? -ne 0 ]
|
||||||
|
then
|
||||||
|
print_failure "Failed to create directory '${DIR}'"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
# set permissions on newly-created dir and return
|
||||||
|
chmod 0755 "${DIR}"
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# This will install a file. The first parameter is the source, and the
|
||||||
|
# second is the destination. The third is the octal mode.
|
||||||
|
install_file() {
|
||||||
|
# figure out if $2 is a directory or not
|
||||||
|
DEST_FILE="$2"
|
||||||
|
[ -d "$2" ] && DEST_FILE="$2/$(basename $1)"
|
||||||
|
|
||||||
|
echo " Installing: '$1' -> '$2'"
|
||||||
|
do_cmd cp -fP "$1" "${DEST_FILE}" || return 1
|
||||||
|
do_cmd chmod "$3" "${DEST_FILE}" || return 1
|
||||||
|
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# This will install a header file. It is basically similar to
|
||||||
|
# install_file(), only we strip out the #line directives.
|
||||||
|
install_header() {
|
||||||
|
DEST_FILE="$2"
|
||||||
|
[ -d "$2" ] && DEST_FILE="$2/$(basename $1)"
|
||||||
|
|
||||||
|
echo " Installing header: '$1' -> '$2'"
|
||||||
|
do_cmd rm -f ${DEST_FILE} || exit 1
|
||||||
|
do_cmd_redir ${DEST_FILE} sed -e "s,^#line.*,," $1 || exit 1
|
||||||
|
do_cmd chmod "$3" "${DEST_FILE}" || return 1
|
||||||
|
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# This installs a symlink. The first argument is the symlink's name; the
|
||||||
|
# second the symlink's source filename, and the third is the directory
|
||||||
|
# in which to create the symlink.
|
||||||
|
install_symlink() {
|
||||||
|
echo " Installing symlink: '$3/$2' -> '$1'"
|
||||||
|
|
||||||
|
( do_cmd cd $3; ln -sf $2 $1 ) || return 1
|
||||||
|
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
build_target() {
|
||||||
|
ITEMS="src/$1/build.default"
|
||||||
|
if [ ! -e "${ITEMS}" ]
|
||||||
|
then
|
||||||
|
ITEMS="$(find src -type f -name build.$1)"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ -z "${ITEMS}" ]
|
||||||
|
then
|
||||||
|
print_failure "Unrecognised target '$1'"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
for item in ${ITEMS}
|
||||||
|
do
|
||||||
|
do_cmd source ${item} || exit 1
|
||||||
|
done
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
########################################################################
|
||||||
|
# Main script
|
||||||
|
########################################################################
|
||||||
|
|
||||||
|
if [ $# -eq 0 ]
|
||||||
|
then
|
||||||
|
targets="default"
|
||||||
|
else
|
||||||
|
targets="$@"
|
||||||
|
fi
|
||||||
|
|
||||||
|
for func in ${targets}
|
||||||
|
do
|
||||||
|
case ${func} in
|
||||||
|
clean)
|
||||||
|
echo "Cleaning..."
|
||||||
|
rm -rf ${OUTPUT_DIRS}
|
||||||
|
print_success "Done"
|
||||||
|
;;
|
||||||
|
|
||||||
|
# bad Kdevelop! bad!
|
||||||
|
-j1)
|
||||||
|
;;
|
||||||
|
-k)
|
||||||
|
;;
|
||||||
|
|
||||||
|
*)
|
||||||
|
build_target ${func} || exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
|
||||||
|
exit 0
|
||||||
|
|
||||||
|
# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
# vim: expandtab:ts=4:sw=4
|
|
@ -0,0 +1,54 @@
|
||||||
|
#!/bin/bash
|
||||||
|
# libCStreamedXML/test.sh
|
||||||
|
#
|
||||||
|
# (c)2006, Laurence Withers, <l@lwithers.me.uk>.
|
||||||
|
# Released under the GNU GPLv2. See file COPYING or
|
||||||
|
# http://www.gnu.org/copyleft/gpl.html for details.
|
||||||
|
#
|
||||||
|
|
||||||
|
# Running this script on its own will display a summary of all the
|
||||||
|
# available tests; running it with arguments runs the relevant test.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# This runs a test, setting the correct library path.
|
||||||
|
run_test() {
|
||||||
|
EXE=obj/tests/$1
|
||||||
|
shift
|
||||||
|
if [ ! -x ${EXE} ]
|
||||||
|
then
|
||||||
|
echo "No such test '${EXE}'"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
LD_LIBRARY_PATH="obj" ${EXE} "$@" || return 1
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# This prints summary output from each test app.
|
||||||
|
print_tests() {
|
||||||
|
echo "Available tests"
|
||||||
|
echo "---------------------------------------------------------------------"
|
||||||
|
for EXE in obj/tests/*
|
||||||
|
do
|
||||||
|
[ -x ${EXE} ] || continue
|
||||||
|
NAME=$(echo ${EXE} | sed 's,obj/tests/,,')
|
||||||
|
echo -ne "${NAME}\t"
|
||||||
|
LD_LIBRARY_PATH="obj" ${EXE} --print-summary
|
||||||
|
done
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
# Main script
|
||||||
|
if [ $# -eq 0 ]
|
||||||
|
then
|
||||||
|
print_tests
|
||||||
|
exit 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
run_test $*
|
||||||
|
|
||||||
|
# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
# vim: expandtab:ts=4:sw=4
|
|
@ -0,0 +1,12 @@
|
||||||
|
build.c++.app
|
||||||
|
build.c++.lib
|
||||||
|
build.c++.qtapp
|
||||||
|
build.c++.tests
|
||||||
|
build.c.app
|
||||||
|
build.c.lib
|
||||||
|
build.c.tests
|
||||||
|
build.doxygen.docs
|
||||||
|
build.none.files
|
||||||
|
build.sdcc.firmware
|
||||||
|
module-create.sh
|
||||||
|
release.sh
|
|
@ -0,0 +1,68 @@
|
||||||
|
#!/bin/bash
|
||||||
|
# libCStreamedXML/scripts/functions.sh
|
||||||
|
#
|
||||||
|
# (c)2006, Laurence Withers, <l@lwithers.me.uk>.
|
||||||
|
# Released under the GNU GPLv2. See file COPYING or
|
||||||
|
# http://www.gnu.org/copyleft/gpl.html for details.
|
||||||
|
#
|
||||||
|
|
||||||
|
# Common functions
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# Print a success message
|
||||||
|
print_success() {
|
||||||
|
if [ -z "${TERM}" -o "${TERM}" == "dumb" ]
|
||||||
|
then
|
||||||
|
echo -n " - "
|
||||||
|
else
|
||||||
|
(echo -n -e " \E[32m* "; tput sgr0)
|
||||||
|
fi
|
||||||
|
echo $*
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# Print a failure message
|
||||||
|
print_failure() {
|
||||||
|
if [ -z "${TERM}" -o "${TERM}" == "dumb" ]
|
||||||
|
then
|
||||||
|
echo -n " *** "
|
||||||
|
else
|
||||||
|
(echo -n -e " \E[31m*** "; tput sgr0)
|
||||||
|
fi
|
||||||
|
echo $*
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# This function carries out a command, but reports its failure if
|
||||||
|
# necessary.
|
||||||
|
do_cmd() {
|
||||||
|
[ "${VERBOSE}" != "0" ] && echo "$@"
|
||||||
|
"$@"
|
||||||
|
if [ $? -ne 0 ]
|
||||||
|
then
|
||||||
|
print_failure "'$@' failed."
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# This function carries out a command, but reports its failure if
|
||||||
|
# necessary.
|
||||||
|
do_cmd_redir() {
|
||||||
|
DEST=$1
|
||||||
|
shift
|
||||||
|
[ "${VERBOSE}" != "0" ] && echo "$@ >> ${DEST}"
|
||||||
|
"$@" >> ${DEST}
|
||||||
|
if [ $? -ne 0 ]
|
||||||
|
then
|
||||||
|
print_failure "'$@' failed."
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
# vim: expandtab:ts=4:sw=4
|
|
@ -0,0 +1 @@
|
||||||
|
doxygen docs docs
|
|
@ -0,0 +1,146 @@
|
||||||
|
# libCStreamedXML/src/docs/Doxyfile.in
|
||||||
|
#
|
||||||
|
# (c)2006, Laurence Withers, <l@lwithers.me.uk>.
|
||||||
|
# Released under the GNU GPLv2. See file COPYING or
|
||||||
|
# http://www.gnu.org/copyleft/gpl.html for details.
|
||||||
|
#
|
||||||
|
|
||||||
|
PROJECT_NAME = libCStreamedXML
|
||||||
|
OUTPUT_DIRECTORY =
|
||||||
|
CREATE_SUBDIRS = NO
|
||||||
|
OUTPUT_LANGUAGE = English
|
||||||
|
USE_WINDOWS_ENCODING = NO
|
||||||
|
BRIEF_MEMBER_DESC = YES
|
||||||
|
REPEAT_BRIEF = YES
|
||||||
|
ABBREVIATE_BRIEF =
|
||||||
|
ALWAYS_DETAILED_SEC = NO
|
||||||
|
INLINE_INHERITED_MEMB = YES
|
||||||
|
FULL_PATH_NAMES = NO
|
||||||
|
STRIP_FROM_PATH =
|
||||||
|
STRIP_FROM_INC_PATH =
|
||||||
|
SHORT_NAMES = NO
|
||||||
|
JAVADOC_AUTOBRIEF = NO
|
||||||
|
MULTILINE_CPP_IS_BRIEF = YES
|
||||||
|
DETAILS_AT_TOP = YES
|
||||||
|
INHERIT_DOCS = YES
|
||||||
|
DISTRIBUTE_GROUP_DOC = NO
|
||||||
|
TAB_SIZE = 4
|
||||||
|
ALIASES =
|
||||||
|
OPTIMIZE_OUTPUT_FOR_C = NO
|
||||||
|
OPTIMIZE_OUTPUT_JAVA = NO
|
||||||
|
SUBGROUPING = YES
|
||||||
|
EXTRACT_ALL = NO
|
||||||
|
EXTRACT_PRIVATE = NO
|
||||||
|
EXTRACT_STATIC = NO
|
||||||
|
EXTRACT_LOCAL_CLASSES = NO
|
||||||
|
EXTRACT_LOCAL_METHODS = NO
|
||||||
|
HIDE_UNDOC_MEMBERS = NO
|
||||||
|
HIDE_UNDOC_CLASSES = NO
|
||||||
|
HIDE_FRIEND_COMPOUNDS = YES
|
||||||
|
HIDE_IN_BODY_DOCS = NO
|
||||||
|
INTERNAL_DOCS = NO
|
||||||
|
CASE_SENSE_NAMES = YES
|
||||||
|
HIDE_SCOPE_NAMES = NO
|
||||||
|
SHOW_INCLUDE_FILES = NO
|
||||||
|
INLINE_INFO = YES
|
||||||
|
SORT_MEMBER_DOCS = YES
|
||||||
|
SORT_BRIEF_DOCS = NO
|
||||||
|
SORT_BY_SCOPE_NAME = NO
|
||||||
|
GENERATE_TODOLIST = YES
|
||||||
|
GENERATE_TESTLIST = YES
|
||||||
|
GENERATE_BUGLIST = YES
|
||||||
|
GENERATE_DEPRECATEDLIST= YES
|
||||||
|
ENABLED_SECTIONS =
|
||||||
|
MAX_INITIALIZER_LINES = 30
|
||||||
|
SHOW_USED_FILES = NO
|
||||||
|
SHOW_DIRECTORIES = NO
|
||||||
|
FILE_VERSION_FILTER =
|
||||||
|
QUIET = YES
|
||||||
|
WARNINGS = YES
|
||||||
|
WARN_IF_UNDOCUMENTED = YES
|
||||||
|
WARN_IF_DOC_ERROR = YES
|
||||||
|
WARN_NO_PARAMDOC = YES
|
||||||
|
WARN_FORMAT = "$file:$line: $text"
|
||||||
|
WARN_LOGFILE =
|
||||||
|
FILE_PATTERNS =
|
||||||
|
RECURSIVE = NO
|
||||||
|
EXCLUDE =
|
||||||
|
EXCLUDE_SYMLINKS = NO
|
||||||
|
EXCLUDE_PATTERNS =
|
||||||
|
EXAMPLE_PATH =
|
||||||
|
EXAMPLE_PATTERNS =
|
||||||
|
EXAMPLE_RECURSIVE = NO
|
||||||
|
IMAGE_PATH = src/docs
|
||||||
|
INPUT_FILTER =
|
||||||
|
FILTER_PATTERNS =
|
||||||
|
FILTER_SOURCE_FILES = NO
|
||||||
|
SOURCE_BROWSER = NO
|
||||||
|
INLINE_SOURCES = NO
|
||||||
|
STRIP_CODE_COMMENTS = YES
|
||||||
|
REFERENCED_BY_RELATION = YES
|
||||||
|
REFERENCES_RELATION = YES
|
||||||
|
VERBATIM_HEADERS = NO
|
||||||
|
ALPHABETICAL_INDEX = YES
|
||||||
|
COLS_IN_ALPHA_INDEX = 5
|
||||||
|
IGNORE_PREFIX =
|
||||||
|
GENERATE_HTML = YES
|
||||||
|
HTML_OUTPUT = html
|
||||||
|
HTML_FILE_EXTENSION = .html
|
||||||
|
HTML_HEADER =
|
||||||
|
HTML_FOOTER =
|
||||||
|
HTML_STYLESHEET =
|
||||||
|
HTML_ALIGN_MEMBERS = YES
|
||||||
|
GENERATE_HTMLHELP = NO
|
||||||
|
CHM_FILE =
|
||||||
|
HHC_LOCATION =
|
||||||
|
GENERATE_CHI = NO
|
||||||
|
BINARY_TOC = NO
|
||||||
|
TOC_EXPAND = NO
|
||||||
|
DISABLE_INDEX = NO
|
||||||
|
ENUM_VALUES_PER_LINE = 4
|
||||||
|
GENERATE_TREEVIEW = NO
|
||||||
|
TREEVIEW_WIDTH = 250
|
||||||
|
GENERATE_LATEX = NO
|
||||||
|
GENERATE_RTF = NO
|
||||||
|
GENERATE_MAN = NO
|
||||||
|
GENERATE_XML = NO
|
||||||
|
GENERATE_AUTOGEN_DEF = NO
|
||||||
|
GENERATE_PERLMOD = NO
|
||||||
|
ENABLE_PREPROCESSING = YES
|
||||||
|
MACRO_EXPANSION = NO
|
||||||
|
EXPAND_ONLY_PREDEF = NO
|
||||||
|
SEARCH_INCLUDES = YES
|
||||||
|
INCLUDE_PATH =
|
||||||
|
INCLUDE_FILE_PATTERNS =
|
||||||
|
PREDEFINED = DOXYGEN
|
||||||
|
EXPAND_AS_DEFINED =
|
||||||
|
SKIP_FUNCTION_MACROS = YES
|
||||||
|
TAGFILES =
|
||||||
|
GENERATE_TAGFILE =
|
||||||
|
ALLEXTERNALS = NO
|
||||||
|
EXTERNAL_GROUPS = YES
|
||||||
|
PERL_PATH = /usr/bin/perl
|
||||||
|
CLASS_DIAGRAMS = YES
|
||||||
|
HIDE_UNDOC_RELATIONS = YES
|
||||||
|
HAVE_DOT = YES
|
||||||
|
CLASS_GRAPH = YES
|
||||||
|
COLLABORATION_GRAPH = YES
|
||||||
|
GROUP_GRAPHS = NO
|
||||||
|
UML_LOOK = NO
|
||||||
|
TEMPLATE_RELATIONS = NO
|
||||||
|
INCLUDE_GRAPH = NO
|
||||||
|
INCLUDED_BY_GRAPH = NO
|
||||||
|
CALL_GRAPH = NO
|
||||||
|
GRAPHICAL_HIERARCHY = YES
|
||||||
|
DIRECTORY_GRAPH = NO
|
||||||
|
DOT_IMAGE_FORMAT = png
|
||||||
|
DOT_PATH =
|
||||||
|
DOTFILE_DIRS =
|
||||||
|
MAX_DOT_GRAPH_WIDTH = 1024
|
||||||
|
MAX_DOT_GRAPH_HEIGHT = 1024
|
||||||
|
MAX_DOT_GRAPH_DEPTH = 0
|
||||||
|
DOT_TRANSPARENT = YES
|
||||||
|
DOT_MULTI_TARGETS = YES
|
||||||
|
GENERATE_LEGEND = YES
|
||||||
|
DOT_CLEANUP = YES
|
||||||
|
SEARCHENGINE = NO
|
|
@ -0,0 +1,20 @@
|
||||||
|
/* libCStreamedXML/src/docs/MainPage.dox
|
||||||
|
*
|
||||||
|
* (c)2006, Laurence Withers, <l@lwithers.me.uk>.
|
||||||
|
* Released under the GNU GPLv2. See file COPYING or
|
||||||
|
* http://www.gnu.org/copyleft/gpl.html for details.
|
||||||
|
*/
|
||||||
|
|
||||||
|
/*! \mainpage
|
||||||
|
|
||||||
|
libCStreamedXML is a C implementation of a
|
||||||
|
<a href="http://www.lwithers.me.uk/projects/StreamedXML/">
|
||||||
|
Streamed XML</a> processor. It is written using an efficient
|
||||||
|
state-machine. It is an ASCII-only Streamed XML processor.
|
||||||
|
|
||||||
|
*/
|
||||||
|
|
||||||
|
/* options for text editors
|
||||||
|
kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
vim: expandtab:ts=4:sw=4
|
||||||
|
*/
|
|
@ -0,0 +1 @@
|
||||||
|
source src/docs/build.docs
|
|
@ -0,0 +1,43 @@
|
||||||
|
# These are external variables, and shouldn't clash with anything else
|
||||||
|
# docs_BUILT
|
||||||
|
#
|
||||||
|
|
||||||
|
MONOLITHIC_DOC="${MONOLITHIC_DOC} $(echo src/docs/*.dox)"
|
||||||
|
build_target monolithic
|
||||||
|
|
||||||
|
if [ -z ${docs_BUILT} ]
|
||||||
|
then
|
||||||
|
echo "Building documentation with Doxygen..."
|
||||||
|
|
||||||
|
DOXYFILE=obj/Doxyfile.docs
|
||||||
|
|
||||||
|
if [ ! -e ${DOXYFILE} ]
|
||||||
|
then
|
||||||
|
do_cmd cp src/docs/Doxyfile.in ${DOXYFILE} || return 1
|
||||||
|
echo "INPUT = ${MONOLITHIC_DOC}" >> ${DOXYFILE}
|
||||||
|
echo "PROJECT_NUMBER = ${VERSION}" >> ${DOXYFILE}
|
||||||
|
fi
|
||||||
|
|
||||||
|
MODIFIED=0
|
||||||
|
for file in ${MONOLITHIC_DOC}
|
||||||
|
do
|
||||||
|
if [ ${file} -nt html/index.html ]
|
||||||
|
then
|
||||||
|
MODIFIED=1
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
if [ ${MODIFIED} -ne 0 ]
|
||||||
|
then
|
||||||
|
do_cmd doxygen ${DOXYFILE} || return 1
|
||||||
|
print_success "Documentation built"
|
||||||
|
else
|
||||||
|
print_success "Documentation is up to date"
|
||||||
|
fi
|
||||||
|
|
||||||
|
docs_BUILT=1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
# vim: expandtab:ts=4:sw=4
|
|
@ -0,0 +1 @@
|
||||||
|
source src/docs/build.install-docs
|
|
@ -0,0 +1,21 @@
|
||||||
|
build_target docs
|
||||||
|
|
||||||
|
# create documentation directories
|
||||||
|
echo "Installing documentation into ${DOCSDIR}"
|
||||||
|
build_dir_tree "${DOCSDIR}/html" || return 1
|
||||||
|
|
||||||
|
# copy across the Doxygen-generated documentation
|
||||||
|
for file in html/*
|
||||||
|
do
|
||||||
|
install_file ${file} ${DOCSDIR}/html 0644 || return 1
|
||||||
|
done
|
||||||
|
|
||||||
|
# copy across the generic files
|
||||||
|
for file in COPYING README
|
||||||
|
do
|
||||||
|
install_file ${file} ${DOCSDIR} 0644 || return 1
|
||||||
|
done
|
||||||
|
|
||||||
|
print_success "Documentation installed"
|
||||||
|
# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
# vim: expandtab:ts=4:sw=4
|
|
@ -0,0 +1 @@
|
||||||
|
c lib libCStreamedXML StreamedXML.h
|
|
@ -0,0 +1,14 @@
|
||||||
|
/* libCStreamedXML/src/libCStreamedXML/BottomHeader.h
|
||||||
|
*
|
||||||
|
* (c)2006, Laurence Withers, <l@lwithers.me.uk>.
|
||||||
|
* Released under the GNU GPLv2. See file COPYING or
|
||||||
|
* http://www.gnu.org/copyleft/gpl.html for details.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#endif
|
||||||
|
/*!@}*/
|
||||||
|
|
||||||
|
/* options for text editors
|
||||||
|
kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
vim: expandtab:ts=4:sw=4
|
||||||
|
*/
|
|
@ -0,0 +1,32 @@
|
||||||
|
/* libCStreamedXML/src/libCStreamedXML/TopHeader.h
|
||||||
|
*
|
||||||
|
* (c)2006, Laurence Withers, <l@lwithers.me.uk>.
|
||||||
|
* Released under the GNU GPLv2. See file COPYING or
|
||||||
|
* http://www.gnu.org/copyleft/gpl.html for details.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#ifndef HEADER_libCStreamedXML
|
||||||
|
#define HEADER_libCStreamedXML
|
||||||
|
|
||||||
|
// standard includes, or includes needed for type declarations
|
||||||
|
#include <sys/types.h>
|
||||||
|
|
||||||
|
/*! \defgroup libCStreamedXML libCStreamedXML interface.
|
||||||
|
|
||||||
|
libCStreamedXML is a C library for parsing Streamed XML data. It is somewhat simpler than the C++
|
||||||
|
library (it only parses ASCII data, not Unicode data). In future, the API could be extended to
|
||||||
|
use only fixed-size buffers, and not to call malloc() at all. This would be advantageous for small
|
||||||
|
embedded systems (e.g. PICs).
|
||||||
|
|
||||||
|
To parse Streamed XML, you must first create a parser context object with csxml_newParser(). Then
|
||||||
|
you set up the returned object by changing options and callback functions. Once set up correctly,
|
||||||
|
pass in data using the csxml_feedChar() and csxml_feedData() functions. Finally, free the parser
|
||||||
|
object with csxml_freeParser().
|
||||||
|
|
||||||
|
*/
|
||||||
|
/*!@{*/
|
||||||
|
|
||||||
|
/* options for text editors
|
||||||
|
kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
vim: expandtab:ts=4:sw=4
|
||||||
|
*/
|
|
@ -0,0 +1,20 @@
|
||||||
|
/* libCStreamedXML/src/libCStreamedXML/TopSource.c
|
||||||
|
*
|
||||||
|
* (c)2006, Laurence Withers, <l@lwithers.me.uk>.
|
||||||
|
* Released under the GNU GPLv2. See file COPYING or
|
||||||
|
* http://www.gnu.org/copyleft/gpl.html for details.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#include "StreamedXML.h"
|
||||||
|
|
||||||
|
// Below are all the includes used throughout the library.
|
||||||
|
#include <stdlib.h>
|
||||||
|
#include <string.h>
|
||||||
|
#include <stdio.h>
|
||||||
|
|
||||||
|
//#define DEBUG_STATE_MACHINE
|
||||||
|
|
||||||
|
/* options for text editors
|
||||||
|
kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
vim: expandtab:ts=4:sw=4
|
||||||
|
*/
|
|
@ -0,0 +1,100 @@
|
||||||
|
/* libCStreamedXML/src/libCStreamedXML/buffer.c
|
||||||
|
*
|
||||||
|
* (c)2006, Laurence Withers. Released under the GNU GPL. See file
|
||||||
|
* COPYING for more information / terms of license.
|
||||||
|
*/
|
||||||
|
|
||||||
|
static int do_realloc(struct csxml* ctx, struct csxml_buf* buf)
|
||||||
|
{
|
||||||
|
char* n = realloc(buf->data, buf->size << 1);
|
||||||
|
if(!n) {
|
||||||
|
ctx->outOfMemory(ctx, buf->size << 1);
|
||||||
|
return -1;
|
||||||
|
}
|
||||||
|
|
||||||
|
buf->size <<= 1;
|
||||||
|
buf->data = n;
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static int buffer_copy(struct csxml* ctx, struct csxml_buf* dest, const struct csxml_buf* src)
|
||||||
|
{
|
||||||
|
while(dest->size <= src->len) if(do_realloc(ctx, dest)) return -1;
|
||||||
|
strcpy(dest->data, src->data);
|
||||||
|
dest->len = src->len;
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static int buffer_strcat(struct csxml* ctx, struct csxml_buf* dest, const char* src)
|
||||||
|
{
|
||||||
|
size_t req = strlen(src) + dest->len;
|
||||||
|
while(req >= dest->size) if(do_realloc(ctx, dest)) return -1;
|
||||||
|
strcat(dest->data, src);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static int buffer_init(struct csxml* ctx, struct csxml_buf* buf)
|
||||||
|
{
|
||||||
|
memset(buf, 0, sizeof(buf));
|
||||||
|
buf->size = 256;
|
||||||
|
buf->data = malloc(buf->size);
|
||||||
|
if(!buf->data) {
|
||||||
|
ctx->outOfMemory(ctx, buf->size);
|
||||||
|
return -1;
|
||||||
|
}
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static void buffer_free(struct csxml_buf* buf)
|
||||||
|
{
|
||||||
|
free(buf->data);
|
||||||
|
memset(buf, 0, sizeof(struct csxml_buf));
|
||||||
|
}
|
||||||
|
|
||||||
|
static int do_realloc2(struct csxml* ctx, struct csxml_list* list)
|
||||||
|
{
|
||||||
|
size_t i, newlen = list->size ? (list->size << 1) : 4;
|
||||||
|
struct csxml_buf* n = realloc(list->data, newlen * sizeof(struct csxml_buf));
|
||||||
|
if(!n) {
|
||||||
|
ctx->outOfMemory(ctx, newlen * sizeof(struct csxml_buf));
|
||||||
|
return -1;
|
||||||
|
}
|
||||||
|
|
||||||
|
memset(n + list->size * sizeof(struct csxml_buf), 0, newlen * sizeof(struct csxml_buf));
|
||||||
|
for(i = 0; i < newlen; ++i) {
|
||||||
|
if(buffer_init(ctx, n + list->size + i)) return -1;
|
||||||
|
}
|
||||||
|
|
||||||
|
list->size = newlen;
|
||||||
|
list->data = n;
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static int list_push(struct csxml* ctx, struct csxml_list* list, struct csxml_buf* buf)
|
||||||
|
{
|
||||||
|
if((list->size == list->len) && do_realloc2(ctx, list)) return -1;
|
||||||
|
if(buffer_copy(ctx, list->data + list->len, buf)) return -1;
|
||||||
|
++list->len;
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static struct csxml_buf* list_pop(struct csxml_list* list)
|
||||||
|
{
|
||||||
|
return list->data + --list->len;
|
||||||
|
}
|
||||||
|
|
||||||
|
static void list_free(struct csxml_list* list)
|
||||||
|
{
|
||||||
|
size_t i;
|
||||||
|
|
||||||
|
for(i = 0; i < list->size; ++i) buffer_free(list->data + i);
|
||||||
|
free(list->data);
|
||||||
|
memset(list, 0, sizeof(struct csxml_list));
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/* options for text editors
|
||||||
|
kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
vim: expandtab:ts=4:sw=4
|
||||||
|
*/
|
|
@ -0,0 +1 @@
|
||||||
|
source src/libCStreamedXML/build.lib
|
|
@ -0,0 +1 @@
|
||||||
|
source src/libCStreamedXML/build.install-lib
|
|
@ -0,0 +1,36 @@
|
||||||
|
build_target libCStreamedXML
|
||||||
|
|
||||||
|
# make paths (this is for Gentoo in particular)
|
||||||
|
build_dir_tree "${LIBDIR}" || return 1
|
||||||
|
build_dir_tree "${PKGCONFDIR}" || return 1
|
||||||
|
build_dir_tree "${INCLUDEDIR}" || return 1
|
||||||
|
|
||||||
|
# install library
|
||||||
|
echo "Installing libraries into '${LIBDIR}'"
|
||||||
|
install_file ${libCStreamedXML} ${LIBDIR} 0755 || return 1
|
||||||
|
BASE="${libCStreamedXML_BASE}.so"
|
||||||
|
MAJOR="${BASE}.${SOMAJOR}"
|
||||||
|
MINOR="${MAJOR}.${SOMINOR}"
|
||||||
|
MICRO="${MINOR}.${SOMICRO}"
|
||||||
|
install_symlink "${MINOR}" "${MICRO}" "${LIBDIR}"
|
||||||
|
install_symlink "${MAJOR}" "${MINOR}" "${LIBDIR}"
|
||||||
|
install_symlink "${BASE}" "${MAJOR}" "${LIBDIR}"
|
||||||
|
|
||||||
|
# install header
|
||||||
|
echo "Installing header file '${libCStreamedXML_HEADER}' into ${INCLUDEDIR}"
|
||||||
|
install_header ${libCStreamedXML_HEADER} ${INCLUDEDIR} 0644 || return 1
|
||||||
|
|
||||||
|
# install pkgconfig file
|
||||||
|
echo "Installing package config file into ${PKGCONFDIR}"
|
||||||
|
PKGCONFFILE=${PKGCONFDIR}/libCStreamedXML.pc
|
||||||
|
do_cmd rm -f ${PKGCONFFILE}
|
||||||
|
do_cmd_redir ${PKGCONFFILE} sed \
|
||||||
|
-e "s,@VERSION@,${VERSION}," \
|
||||||
|
-e "s,@LIBDIR@,${FINALLIBDIR}," \
|
||||||
|
-e "s,@INCLUDEDIR@,${FINALINCLUDEDIR}," \
|
||||||
|
src/libCStreamedXML/pkgconf.in
|
||||||
|
do_cmd chmod 0644 ${PKGCONFFILE}
|
||||||
|
print_success "Done"
|
||||||
|
|
||||||
|
# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
# vim: expandtab:ts=4:sw=4
|
|
@ -0,0 +1,51 @@
|
||||||
|
# These are external variables, and shouldn't clash with anything else
|
||||||
|
# libCStreamedXML
|
||||||
|
# libCStreamedXML_BUILT
|
||||||
|
# libCStreamedXML_HEADER
|
||||||
|
# libCStreamedXML_BASE
|
||||||
|
|
||||||
|
if [ -z ${libCStreamedXML_BUILT} ]
|
||||||
|
then
|
||||||
|
libCStreamedXML_BASE=libCStreamedXML
|
||||||
|
source src/libCStreamedXML/soversion
|
||||||
|
|
||||||
|
libCStreamedXML="obj/${libCStreamedXML_BASE}.so.${SOMAJOR}.${SOMINOR}.${SOMICRO}"
|
||||||
|
SO_EXTRA="-lc"
|
||||||
|
|
||||||
|
echo "Building library ${libCStreamedXML}..."
|
||||||
|
|
||||||
|
do_cmd source src/libCStreamedXML/build.monolithic || return 1
|
||||||
|
|
||||||
|
MODIFIED=0
|
||||||
|
for test in ${MONOLITHIC_TESTS} ${HDR} ${SRC}
|
||||||
|
do
|
||||||
|
if [ ${test} -nt ${libCStreamedXML} ]
|
||||||
|
then
|
||||||
|
MODIFIED=1
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
if [ ${MODIFIED} -ne 0 ]
|
||||||
|
then
|
||||||
|
echo " Compiling"
|
||||||
|
|
||||||
|
SONAME="${libCStreamedXML_BASE}.so.${SOMAJOR}.${SOMINOR}"
|
||||||
|
do_cmd ${CC} ${CFLAGS} -Iobj -shared -fpic -o "${libCStreamedXML}" \
|
||||||
|
-Wl,-soname,${SONAME} \
|
||||||
|
${SRC} ${SO_EXTRA} || return 1
|
||||||
|
|
||||||
|
# make tests work
|
||||||
|
do_cmd ln -sf $(basename ${libCStreamedXML}) obj/${SONAME} || return 1
|
||||||
|
|
||||||
|
print_success "Library built"
|
||||||
|
else
|
||||||
|
print_success "Library up to date"
|
||||||
|
fi
|
||||||
|
|
||||||
|
libCStreamedXML_BUILT=1
|
||||||
|
libCStreamedXML_HEADER=${HDR}
|
||||||
|
|
||||||
|
fi
|
||||||
|
# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
# vim: expandtab:ts=4:sw=4
|
|
@ -0,0 +1,21 @@
|
||||||
|
# These are external variables, and shouldn't clash with anything else
|
||||||
|
# libCStreamedXML_MONOLITHIC
|
||||||
|
|
||||||
|
SRC="obj/libCStreamedXML.c"
|
||||||
|
HDR="obj/StreamedXML.h"
|
||||||
|
|
||||||
|
MONOLITHIC_TESTS="src/libCStreamedXML/build.lib src/libCStreamedXML/build.monolithic"
|
||||||
|
|
||||||
|
if [ -z "${libCStreamedXML_MONOLITHIC}" ]
|
||||||
|
then
|
||||||
|
MONOLITHIC_SOURCE="$(echo src/libCStreamedXML/{TopHeader,types,functions,BottomHeader}.h)"
|
||||||
|
make_monolithic ${HDR} Ch || return 1
|
||||||
|
|
||||||
|
MONOLITHIC_SOURCE="$(echo src/libCStreamedXML/{TopSource,buffer,defaults,parser}.c)"
|
||||||
|
make_monolithic ${SRC} C || return 1
|
||||||
|
|
||||||
|
libCStreamedXML_MONOLITHIC=1
|
||||||
|
MONOLITHIC_DOC="${MONOLITHIC_DOC} ${HDR}"
|
||||||
|
fi
|
||||||
|
# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
# vim: expandtab:ts=4:sw=4
|
|
@ -0,0 +1,79 @@
|
||||||
|
/* libCStreamedXML/src/libCStreamedXML/defaults.c
|
||||||
|
*
|
||||||
|
* (c)2006, Laurence Withers. Released under the GNU GPL. See file
|
||||||
|
* COPYING for more information / terms of license.
|
||||||
|
*/
|
||||||
|
|
||||||
|
static void default_notWellFormed(const struct csxml* ctx, const char* reason)
|
||||||
|
{
|
||||||
|
fprintf(stderr, "Streamed XML is not well formed.\n Line : %d\n Col : %d\n Reason: %s\n",
|
||||||
|
ctx->line + 1, ctx->col + 1, reason);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
static void default_outOfMemory(const struct csxml* ctx, size_t amount)
|
||||||
|
{
|
||||||
|
(void)ctx;
|
||||||
|
fprintf(stderr, "Streamed XML parser: out of memory allocating %lu bytes\n", (unsigned long)amount);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
static void default_unknownEntity(const struct csxml* ctx, const char* ent)
|
||||||
|
{
|
||||||
|
fprintf(stderr, "Unknown entity referenced in Streamed XML.\n Line: %d\n Col : %d\n Name: %s\n",
|
||||||
|
ctx->line + 1, ctx->col + 1, ent);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
static int default_discard(const struct csxml* ctx, const char* x)
|
||||||
|
{
|
||||||
|
(void)ctx;
|
||||||
|
(void)x;
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
static int default_cdata(const struct csxml* ctx, const char* data)
|
||||||
|
{
|
||||||
|
return ctx->content(ctx, data);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
static int default_discardPI(const struct csxml* ctx, const char* target, const char* data)
|
||||||
|
{
|
||||||
|
(void)ctx;
|
||||||
|
(void)target;
|
||||||
|
(void)data;
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
static int default_discardElem(const struct csxml* ctx, const char* elemName, int numAttrs)
|
||||||
|
{
|
||||||
|
(void)ctx;
|
||||||
|
(void)elemName;
|
||||||
|
(void)numAttrs;
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
static const char* default_discardEnt(const struct csxml* ctx, const char* ent)
|
||||||
|
{
|
||||||
|
(void)ctx;
|
||||||
|
(void)ent;
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/* options for text editors
|
||||||
|
kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
vim: expandtab:ts=4:sw=4
|
||||||
|
*/
|
|
@ -0,0 +1,102 @@
|
||||||
|
/* libCStreamedXML/src/libCStreamedXML/types.h
|
||||||
|
*
|
||||||
|
* (c)2006, Laurence Withers. Released under the GNU GPL. See file
|
||||||
|
* COPYING for more information / terms of license.
|
||||||
|
*/
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Allocate and set up a new parser object.
|
||||||
|
|
||||||
|
\retval 0 on error (see \a errno).
|
||||||
|
\returns Pointer to newly-allocated parser object.
|
||||||
|
|
||||||
|
Call this function to obtain a parser context object. The object is initially populated with
|
||||||
|
sensible defaults (\a expandEntities is 1, the error callback functions print messages to stderr,
|
||||||
|
the data callback functions discard the data, etc.).
|
||||||
|
|
||||||
|
*/
|
||||||
|
struct csxml* csxml_newParser();
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Free an existing parser object.
|
||||||
|
|
||||||
|
\param ctx The object to free (may be 0).
|
||||||
|
|
||||||
|
Frees a parser object and all of its associated data structures (strings, lists, etc.).
|
||||||
|
|
||||||
|
*/
|
||||||
|
void csxml_freeParser(struct csxml* ctx);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Parse a character.
|
||||||
|
|
||||||
|
\param ctx Parser context.
|
||||||
|
\param ch Character to parse.
|
||||||
|
\retval 0 on success.
|
||||||
|
\retval -1 on XML error.
|
||||||
|
\retval (non-0) if any callback function signals an error.
|
||||||
|
|
||||||
|
This function parses a single character. It will generate callbacks as appropriate. If one of the
|
||||||
|
callback functions returns a non-zero value, that value is returned from this function and the
|
||||||
|
object is put into an error state. If the streamed XML is not well formed, or some other parsing
|
||||||
|
error occurs, -1 will be returned and the object will be put into an error state.
|
||||||
|
|
||||||
|
Once in an error state, the function will simply discard data passed to it and return 0. However,
|
||||||
|
a lower-level parser is still running and is capable of matching stream restart markers, allowing
|
||||||
|
the parser to be reset.
|
||||||
|
|
||||||
|
*/
|
||||||
|
int csxml_feedChar(struct csxml* ctx, char ch);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Look up an entity.
|
||||||
|
|
||||||
|
\param ctx Parser context.
|
||||||
|
\param ent Entity name.
|
||||||
|
\retval 0 on error.
|
||||||
|
\returns Pointer to null-terminated string of expanded entity text.
|
||||||
|
|
||||||
|
This function is called to dereference entities. It handles the standard entities itself, and chains
|
||||||
|
on to the entityRef callback of the parser if needed. If the entity is not found, it calls the
|
||||||
|
unknownEntity callback and returns 0.
|
||||||
|
|
||||||
|
*/
|
||||||
|
const char* csxml_entityRef(struct csxml* ctx, const char* ent);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Reset parser.
|
||||||
|
|
||||||
|
\param ctx Parser context.
|
||||||
|
|
||||||
|
This function will reset the parser into its initial state, as though no data had yet been
|
||||||
|
encountered. This is called after stream restart markers for example.
|
||||||
|
|
||||||
|
*/
|
||||||
|
void csxml_reset(struct csxml* ctx);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Parse a block of data.
|
||||||
|
|
||||||
|
\param ctx Parser context.
|
||||||
|
\param data Pointer to block of data.
|
||||||
|
\param amt Number of bytes to parse.
|
||||||
|
|
||||||
|
This function will parse each character in the block of data. If an error is encountered, the usual
|
||||||
|
process (callback, error state) is followed, but this function will continue to feed in data. The
|
||||||
|
idea is that you continue to feed in data from your data source, which might have a restart marker
|
||||||
|
(at which point the parsing will once again continue).
|
||||||
|
|
||||||
|
*/
|
||||||
|
void csxml_feedData(struct csxml* ctx, const char* data, size_t amt);
|
||||||
|
|
||||||
|
/* options for text editors
|
||||||
|
kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
vim: expandtab:ts=4:sw=4
|
||||||
|
*/
|
|
@ -0,0 +1,693 @@
|
||||||
|
/* libCStreamedXML/src/libCStreamedXML/parser.c
|
||||||
|
*
|
||||||
|
* (c)2006, Laurence Withers. Released under the GNU GPL. See file
|
||||||
|
* COPYING for more information / terms of license.
|
||||||
|
*/
|
||||||
|
|
||||||
|
//#define DEBUG_STATE_MACHINE
|
||||||
|
|
||||||
|
#ifdef DEBUG_STATE_MACHINE
|
||||||
|
#include <stdio.h>
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#include <sys/types.h>
|
||||||
|
#include <stdlib.h>
|
||||||
|
#include <string.h>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
enum csxml_State {
|
||||||
|
StateNone, // at element or stream level
|
||||||
|
StateRestartMarker, // after <![RESTART[
|
||||||
|
StateRestartMarker1, // after first ]
|
||||||
|
StateRestartMarker2, // after second ]
|
||||||
|
StateOpen, // after <
|
||||||
|
StateOpenBang, // after <!
|
||||||
|
StateOpenCdataMarker, // after <![
|
||||||
|
StateCDATA,
|
||||||
|
StateCDATA1, // first ]
|
||||||
|
StateCDATA2, // second ]
|
||||||
|
StateData, // like StateNone, but don't skip whitespace
|
||||||
|
StateOpenComment, // after <!-
|
||||||
|
StateComment,
|
||||||
|
StateComment2,
|
||||||
|
StateComment3,
|
||||||
|
StatePI, // after <? (we are currently parsing the target)
|
||||||
|
StatePIData, // after target
|
||||||
|
StatePI2, // first ? encountered (in target)
|
||||||
|
StatePI3, // first ? encountered (in data)
|
||||||
|
StateClose, // "</" encountered
|
||||||
|
StateClosing, // "</x"
|
||||||
|
StateNeedClose2, // "</xyz "
|
||||||
|
StateElemName, // <x encountered
|
||||||
|
StateElemTag, // first space after "<name" encountered
|
||||||
|
StateElemAttrName,
|
||||||
|
StateElemAttrEq, // name=
|
||||||
|
StateElemAttrVal, // name=' or name="
|
||||||
|
StateElemAttrDone, // name='value'
|
||||||
|
StateNeedClose, // <elem/
|
||||||
|
StateEntity, // &
|
||||||
|
StateCharEntity, // &#
|
||||||
|
StateEntityName, // &x
|
||||||
|
StateError
|
||||||
|
};
|
||||||
|
|
||||||
|
static const char* xmlCdataMarker = "<![CDATA[";
|
||||||
|
static const char* xmlRestartMarker = "<![RESTART[";
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
enum TokenClass {
|
||||||
|
ClassInvalid,
|
||||||
|
ClassWhitespace,
|
||||||
|
ClassEntity,
|
||||||
|
ClassOther,
|
||||||
|
ClassOpenTag,
|
||||||
|
ClassNameChar,
|
||||||
|
ClassNameStartChar
|
||||||
|
};
|
||||||
|
|
||||||
|
static const enum TokenClass token_classes[] = {
|
||||||
|
ClassInvalid, ClassInvalid, ClassInvalid, ClassInvalid, // control chars 00--03
|
||||||
|
ClassInvalid, ClassInvalid, ClassInvalid, ClassInvalid, // control chars 04--07
|
||||||
|
ClassInvalid, ClassWhitespace, ClassWhitespace, ClassInvalid, // control 08, tab, newline, control 0B
|
||||||
|
ClassInvalid, ClassWhitespace, ClassInvalid, ClassInvalid, // control 0C, carriage return, control 0E--0F
|
||||||
|
ClassInvalid, ClassInvalid, ClassInvalid, ClassInvalid, // control chars 10--13
|
||||||
|
ClassInvalid, ClassInvalid, ClassInvalid, ClassInvalid, // control chars 14--17
|
||||||
|
ClassInvalid, ClassInvalid, ClassInvalid, ClassInvalid, // control chars 18--1B
|
||||||
|
ClassInvalid, ClassInvalid, ClassInvalid, ClassInvalid, // control chars 1C--1F
|
||||||
|
ClassWhitespace, ClassOther, ClassOther, ClassOther, // ' ', '!', '"', '#'
|
||||||
|
ClassOther, ClassOther, ClassEntity, ClassOther, // '$', '%', '&', '\''
|
||||||
|
ClassOther, ClassOther, ClassOther, ClassOther, // '(', ')', '*', '+'
|
||||||
|
ClassOther, ClassNameChar, ClassNameChar, ClassOther, // ',', '-', '.', '/'
|
||||||
|
ClassNameChar, ClassNameChar, ClassNameChar, ClassNameChar, // '0'--'3'
|
||||||
|
ClassNameChar, ClassNameChar, ClassNameChar, ClassNameChar, // '4'--'7'
|
||||||
|
ClassNameChar, ClassNameChar, ClassNameStartChar, ClassOther, // '8', '9', ':', ';'
|
||||||
|
ClassOpenTag, ClassOther, ClassOther, ClassOther, // '<', '=', '>', '?'
|
||||||
|
ClassOther, ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, // '@', 'A'--'C'
|
||||||
|
ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, // 'D'--'G'
|
||||||
|
ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, // 'H'--'K'
|
||||||
|
ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, // 'L'--'O'
|
||||||
|
ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, // 'P'--'S'
|
||||||
|
ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, // 'T'--'W'
|
||||||
|
ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, ClassOther, // 'X'--'Z', '['
|
||||||
|
ClassOther, ClassOther, ClassOther, ClassNameStartChar, // '\\', ']', '^', '_'
|
||||||
|
ClassOther, ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, // '`', 'a'--'c'
|
||||||
|
ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, // 'd'--'g'
|
||||||
|
ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, // 'h'--'k'
|
||||||
|
ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, // 'l'--'o'
|
||||||
|
ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, // 'p'--'s'
|
||||||
|
ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, // 't'--'w'
|
||||||
|
ClassNameStartChar, ClassNameStartChar, ClassNameStartChar, ClassOther, // 'x'--'z', '{'
|
||||||
|
ClassOther, ClassOther, ClassOther, ClassInvalid // '|', '}', '~', control 7F
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
int csxml_feedChar(struct csxml* ctx, char ch)
|
||||||
|
{
|
||||||
|
enum TokenClass c;
|
||||||
|
int try;
|
||||||
|
|
||||||
|
#ifdef DEBUG_STATE_MACHINE
|
||||||
|
printf("%p: Character '%c' (%02X), state %d, buffer %s\n", ctx, ch, ch, ctx->state, ctx->buffer.data);
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#define ERROR(_reason) do { \
|
||||||
|
ctx->state = StateError; \
|
||||||
|
ctx->notWellFormed(ctx, _reason); \
|
||||||
|
return -1; \
|
||||||
|
}while(0)
|
||||||
|
|
||||||
|
#define APPEND_CH(_whichbuf, _ch) do { \
|
||||||
|
ctx-> _whichbuf .data[ctx-> _whichbuf .len++] = _ch; \
|
||||||
|
if((ctx-> _whichbuf .len == ctx-> _whichbuf .size) && \
|
||||||
|
do_realloc(ctx, &ctx-> _whichbuf)) return -1; \
|
||||||
|
ctx-> _whichbuf .data[ctx-> _whichbuf .len] = 0; \
|
||||||
|
}while(0)
|
||||||
|
|
||||||
|
#define CLEAR_BUFFER(_whichbuf) do { \
|
||||||
|
ctx-> _whichbuf .data[0] = 0; \
|
||||||
|
ctx-> _whichbuf .len = 0; \
|
||||||
|
}while(0)
|
||||||
|
|
||||||
|
#define TRY(_x) do { \
|
||||||
|
try = (_x); \
|
||||||
|
if(try) { \
|
||||||
|
ctx->state = StateError; \
|
||||||
|
return try; \
|
||||||
|
} \
|
||||||
|
}while(0)
|
||||||
|
|
||||||
|
if(ch == xmlRestartMarker[ctx->restartCount]) {
|
||||||
|
if(++ctx->restartCount == 11) {
|
||||||
|
ctx->state = StateRestartMarker;
|
||||||
|
csxml_reset(ctx);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
ctx->restartCount = 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
if(ch & ~0x7F) c = ClassInvalid;
|
||||||
|
else c = token_classes[(int)ch];
|
||||||
|
|
||||||
|
if(ch == '\r') {
|
||||||
|
ctx->skipNextNewline = 1;
|
||||||
|
ch = '\n';
|
||||||
|
++ctx->line;
|
||||||
|
ctx->col = 0;
|
||||||
|
} else if(ch == '\n') {
|
||||||
|
if(ctx->skipNextNewline) return 0;
|
||||||
|
++ctx->line;
|
||||||
|
ctx->col = 0;
|
||||||
|
} else {
|
||||||
|
ctx->skipNextNewline = 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
if(c == ClassInvalid) ERROR("Restricted character encountered.");
|
||||||
|
|
||||||
|
// deal with char appropriately, according to state
|
||||||
|
switch(ctx->state) {
|
||||||
|
case StateError:
|
||||||
|
return 0;
|
||||||
|
|
||||||
|
case StateNone:
|
||||||
|
switch(c) {
|
||||||
|
case ClassWhitespace:
|
||||||
|
APPEND_CH(buffer, ch);
|
||||||
|
break;
|
||||||
|
|
||||||
|
case ClassOpenTag:
|
||||||
|
ctx->state = StateOpen;
|
||||||
|
if(ctx->buffer.len) TRY(ctx->whiteSpace(ctx, ctx->buffer.data));
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
break;
|
||||||
|
|
||||||
|
case ClassEntity:
|
||||||
|
if(ctx->expandEntities) {
|
||||||
|
if(!ctx->elementDepth) ERROR("Entities cannot appear at stream level.");
|
||||||
|
if(ctx->buffer.len) TRY(ctx->whiteSpace(ctx, ctx->buffer.data));
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
ctx->parsingAttr = 0;
|
||||||
|
ctx->state = StateEntity;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
|
||||||
|
// fall through
|
||||||
|
default:
|
||||||
|
if(!ctx->elementDepth) ERROR("Content cannot appear at stream level.");
|
||||||
|
ctx->state = StateData;
|
||||||
|
if(ctx->buffer.len) TRY(ctx->whiteSpace(ctx, ctx->buffer.data));
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
APPEND_CH(buffer, ch);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateData:
|
||||||
|
switch(c) {
|
||||||
|
case ClassOpenTag:
|
||||||
|
ctx->state = StateOpen;
|
||||||
|
TRY(ctx->content(ctx, ctx->buffer.data));
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
break;
|
||||||
|
|
||||||
|
case ClassEntity:
|
||||||
|
ctx->parsingAttr = 0;
|
||||||
|
ctx->state = StateEntity;
|
||||||
|
break;
|
||||||
|
|
||||||
|
default:
|
||||||
|
APPEND_CH(buffer, ch);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateCDATA:
|
||||||
|
if(ch == ']') ctx->state = StateCDATA1;
|
||||||
|
else APPEND_CH(buffer, ch);
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateCDATA1:
|
||||||
|
if(ch == ']') ctx->state = StateCDATA2;
|
||||||
|
else {
|
||||||
|
APPEND_CH(buffer, ']');
|
||||||
|
APPEND_CH(buffer, ch);
|
||||||
|
ctx->state = StateCDATA;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateCDATA2:
|
||||||
|
if(ch == '>') {
|
||||||
|
ctx->state = StateNone;
|
||||||
|
TRY(ctx->cdata(ctx, ctx->buffer.data));
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
} else if(ch == ']') {
|
||||||
|
APPEND_CH(buffer, ']');
|
||||||
|
} else {
|
||||||
|
APPEND_CH(buffer, ']');
|
||||||
|
APPEND_CH(buffer, ']');
|
||||||
|
APPEND_CH(buffer, ch);
|
||||||
|
ctx->state = StateCDATA;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateRestartMarker:
|
||||||
|
if(ch == ']') ctx->state = StateRestartMarker1;
|
||||||
|
else APPEND_CH(buffer, ch);
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateRestartMarker1:
|
||||||
|
if(ch == ']') ctx->state = StateRestartMarker2;
|
||||||
|
else {
|
||||||
|
APPEND_CH(buffer, ']');
|
||||||
|
APPEND_CH(buffer, ch);
|
||||||
|
ctx->state = StateRestartMarker;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateRestartMarker2:
|
||||||
|
if(ch == '>') {
|
||||||
|
TRY(ctx->streamRestart(ctx, ctx->buffer.data));
|
||||||
|
csxml_reset(ctx);
|
||||||
|
|
||||||
|
} else if(ch == ']') {
|
||||||
|
APPEND_CH(buffer, ']');
|
||||||
|
|
||||||
|
} else {
|
||||||
|
APPEND_CH(buffer, ']');
|
||||||
|
APPEND_CH(buffer, ']');
|
||||||
|
APPEND_CH(buffer, ch);
|
||||||
|
ctx->state = StateRestartMarker;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateOpen:
|
||||||
|
switch(c) {
|
||||||
|
case ClassNameStartChar:
|
||||||
|
ctx->state = StateElemName;
|
||||||
|
ctx->elemAttrNames.len = 0;
|
||||||
|
ctx->elemAttrVals.len = 0;
|
||||||
|
CLEAR_BUFFER(elemName);
|
||||||
|
APPEND_CH(elemName, ch);
|
||||||
|
break;
|
||||||
|
|
||||||
|
default:
|
||||||
|
if(ch == '!') ctx->state = StateOpenBang;
|
||||||
|
else if(ch == '?') {
|
||||||
|
ctx->state = StatePI;
|
||||||
|
CLEAR_BUFFER(buffer2);
|
||||||
|
} else if(ch == '/') {
|
||||||
|
if(!ctx->elementDepth) ERROR("Encountered a close tag at stream level.");
|
||||||
|
ctx->state = StateClose;
|
||||||
|
} else ERROR("Invalid start character for element.");
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StatePI:
|
||||||
|
if(ch == '?') ctx->state = StatePI2;
|
||||||
|
else if(c == ClassWhitespace) {
|
||||||
|
ctx->state = StatePIData;
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
} else APPEND_CH(buffer2, ch);
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StatePI2:
|
||||||
|
if(ch != '>') ERROR("Invalid target for PI");
|
||||||
|
else {
|
||||||
|
ctx->state = StateNone;
|
||||||
|
TRY(ctx->PI(ctx, ctx->buffer2.data, 0));
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StatePIData:
|
||||||
|
if(ch == '?') ctx->state = StatePI3;
|
||||||
|
else APPEND_CH(buffer, ch);
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StatePI3:
|
||||||
|
if(ch == '>') {
|
||||||
|
ctx->state = StateNone;
|
||||||
|
TRY(ctx->PI(ctx, ctx->buffer2.data, ctx->buffer.data));
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
} else if(ch == '?') {
|
||||||
|
APPEND_CH(buffer, '?');
|
||||||
|
} else {
|
||||||
|
APPEND_CH(buffer, '?');
|
||||||
|
APPEND_CH(buffer, ch);
|
||||||
|
ctx->state = StatePIData;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateOpenBang:
|
||||||
|
if(ch == '[') {
|
||||||
|
// restart markers handled by lower layer
|
||||||
|
ctx->state = StateOpenCdataMarker;
|
||||||
|
ctx->xmlCount = 3;
|
||||||
|
if(!ctx->elementDepth) ERROR("CDATA sections not valid at stream level.");
|
||||||
|
} else if(ch == '-') ctx->state = StateOpenComment;
|
||||||
|
else ERROR("Invalid special tag.");
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateOpenCdataMarker:
|
||||||
|
if(ch != xmlCdataMarker[ctx->xmlCount]) ERROR("Invalid marked section.");
|
||||||
|
if(!xmlCdataMarker[++ctx->xmlCount]) ctx->state = StateCDATA;
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateOpenComment:
|
||||||
|
if(ch != '-') ERROR("Invalid special tag.");
|
||||||
|
ctx->state = StateComment;
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateComment:
|
||||||
|
if(ch == '-') ctx->state = StateComment2;
|
||||||
|
else APPEND_CH(buffer, ch);
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateComment2:
|
||||||
|
if(ch == '-') ctx->state = StateComment3;
|
||||||
|
else {
|
||||||
|
APPEND_CH(buffer, '-');
|
||||||
|
APPEND_CH(buffer, ch);
|
||||||
|
ctx->state = StateComment;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateComment3:
|
||||||
|
if(ch != '>') ERROR("`--' not valid in comments");
|
||||||
|
ctx->state = StateNone;
|
||||||
|
TRY(ctx->comment(ctx, ctx->buffer.data));
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateElemName:
|
||||||
|
switch(c) {
|
||||||
|
case ClassWhitespace:
|
||||||
|
ctx->state = StateElemTag;
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
break;
|
||||||
|
|
||||||
|
case ClassNameStartChar:
|
||||||
|
case ClassNameChar:
|
||||||
|
APPEND_CH(elemName, ch);
|
||||||
|
break;
|
||||||
|
|
||||||
|
default:
|
||||||
|
switch(ch) {
|
||||||
|
case L'>':
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
TRY(list_push(ctx, &ctx->elemStack, &ctx->elemName));
|
||||||
|
ctx->state = StateNone;
|
||||||
|
TRY(ctx->element(ctx, ctx->elemName.data, 0));
|
||||||
|
++ctx->elementDepth;
|
||||||
|
break;
|
||||||
|
|
||||||
|
case L'/':
|
||||||
|
ctx->state = StateNeedClose;
|
||||||
|
break;
|
||||||
|
|
||||||
|
default:
|
||||||
|
ERROR("Invalid character in tag name.");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateElemTag:
|
||||||
|
switch(c) {
|
||||||
|
case ClassWhitespace:
|
||||||
|
break;
|
||||||
|
|
||||||
|
case ClassNameStartChar:
|
||||||
|
ctx->state = StateElemAttrName;
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
APPEND_CH(buffer, ch);
|
||||||
|
break;
|
||||||
|
|
||||||
|
default:
|
||||||
|
switch(ch) {
|
||||||
|
case '>':
|
||||||
|
TRY(list_push(ctx, &ctx->elemStack, &ctx->elemName));
|
||||||
|
ctx->state = StateNone;
|
||||||
|
TRY(ctx->element(ctx, ctx->elemName.data, ctx->elemAttrNames.len));
|
||||||
|
++ctx->elementDepth;
|
||||||
|
break;
|
||||||
|
|
||||||
|
case '/':
|
||||||
|
ctx->state = StateNeedClose;
|
||||||
|
break;
|
||||||
|
|
||||||
|
default:
|
||||||
|
ERROR("Invalid character in tag.");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateElemAttrName:
|
||||||
|
switch(c) {
|
||||||
|
case ClassNameStartChar:
|
||||||
|
case ClassNameChar:
|
||||||
|
APPEND_CH(buffer, ch);
|
||||||
|
break;
|
||||||
|
|
||||||
|
default:
|
||||||
|
if(ch != '=') ERROR("Invalid character in attribute name.");
|
||||||
|
TRY(list_push(ctx, &ctx->elemAttrNames, &ctx->buffer));
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
ctx->state = StateElemAttrEq;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateElemAttrEq:
|
||||||
|
if(ch == '\'') ctx->singleQuote = 1;
|
||||||
|
else if(ch == '"') ctx->singleQuote = 0;
|
||||||
|
else ERROR("Invalid character in attribute.");
|
||||||
|
ctx->state = StateElemAttrVal;
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateElemAttrVal:
|
||||||
|
if((ctx->singleQuote && ch == '\'') || (!ctx->singleQuote && ch == '"')) {
|
||||||
|
TRY(list_push(ctx, &ctx->elemAttrVals, &ctx->buffer));
|
||||||
|
ctx->state = StateElemAttrDone;
|
||||||
|
} else if(ctx->expandEntities && ch == L'&') {
|
||||||
|
ctx->parsingAttr = 1;
|
||||||
|
ctx->state = StateEntity;
|
||||||
|
} else APPEND_CH(buffer, ch);
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateElemAttrDone:
|
||||||
|
switch(c) {
|
||||||
|
case ClassWhitespace:
|
||||||
|
ctx->state = StateElemTag;
|
||||||
|
break;
|
||||||
|
|
||||||
|
default:
|
||||||
|
if(ch == '/') {
|
||||||
|
ctx->state = StateNeedClose;
|
||||||
|
} else if(ch == '>') {
|
||||||
|
ctx->state = StateNone;
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
TRY(ctx->element(ctx, ctx->elemName.data, ctx->elemAttrVals.len));
|
||||||
|
TRY(list_push(ctx, &ctx->elemStack, &ctx->elemName));
|
||||||
|
++ctx->elementDepth;
|
||||||
|
} else ERROR("Invalid character after attribute.");
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateNeedClose:
|
||||||
|
if(ch != '>') ERROR("Stray `/' in open tag.");
|
||||||
|
ctx->state = StateNone;
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
TRY(ctx->element(ctx, ctx->elemName.data, ctx->elemAttrVals.len));
|
||||||
|
TRY(ctx->closeTag(ctx, ctx->elemName.data));
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateClose:
|
||||||
|
if(c != ClassNameStartChar) ERROR("Invalid character in close tag name.");
|
||||||
|
APPEND_CH(buffer, ch);
|
||||||
|
ctx->state = StateClosing;
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateClosing:
|
||||||
|
switch(c) {
|
||||||
|
case ClassNameStartChar:
|
||||||
|
case ClassNameChar:
|
||||||
|
APPEND_CH(buffer, ch);
|
||||||
|
break;
|
||||||
|
|
||||||
|
case ClassWhitespace:
|
||||||
|
ctx->state = StateNeedClose2;
|
||||||
|
break;
|
||||||
|
|
||||||
|
default:
|
||||||
|
if(ch != '>') ERROR("Invalid character in close tag name.");
|
||||||
|
TRY(buffer_copy(ctx, &ctx->elemName, list_pop(&ctx->elemStack)));
|
||||||
|
if(strcmp(ctx->elemName.data, ctx->buffer.data)) ERROR("Mismatched close tag.");
|
||||||
|
ctx->state = StateNone;
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
TRY(ctx->closeTag(ctx, ctx->elemName.data));
|
||||||
|
--ctx->elementDepth;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateNeedClose2:
|
||||||
|
if(c == ClassWhitespace) break;
|
||||||
|
if(ch != '>') ERROR("Invalid data in close tag.");
|
||||||
|
TRY(buffer_copy(ctx, &ctx->elemName, list_pop(&ctx->elemStack)));
|
||||||
|
if(strcmp(ctx->elemName.data, ctx->buffer.data)) ERROR("Mismatched close tag.");
|
||||||
|
ctx->state = StateNone;
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
TRY(ctx->closeTag(ctx, ctx->elemName.data));
|
||||||
|
--ctx->elementDepth;
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateEntity:
|
||||||
|
if(ch == '#') {
|
||||||
|
ctx->state = StateCharEntity;
|
||||||
|
ctx->entityChar = 0;
|
||||||
|
} else if(c == ClassNameStartChar) {
|
||||||
|
CLEAR_BUFFER(buffer2);
|
||||||
|
APPEND_CH(buffer2, ch);
|
||||||
|
ctx->state = StateEntityName;
|
||||||
|
} else ERROR("Invalid entity name.");
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateCharEntity:
|
||||||
|
if(ch == ';') {
|
||||||
|
APPEND_CH(buffer, ctx->entityChar);
|
||||||
|
ctx->state = ctx->parsingAttr ? StateElemAttrVal : StateData;
|
||||||
|
break;
|
||||||
|
|
||||||
|
} else if(ch >= '0' && ch <= '9') {
|
||||||
|
ctx->entityChar *= 10;
|
||||||
|
ctx->entityChar += (ch - '0');
|
||||||
|
if(!ctx->entityChar || ctx->entityChar > 126) ERROR("Character code out of range in character entity.");
|
||||||
|
} else ERROR("Invalid character in character entity.");
|
||||||
|
break;
|
||||||
|
|
||||||
|
case StateEntityName:
|
||||||
|
if(ch == ';') {
|
||||||
|
const char* e = csxml_entityRef(ctx, ctx->buffer2.data);
|
||||||
|
TRY(!e || buffer_strcat(ctx, &ctx->buffer, e));
|
||||||
|
ctx->state = ctx->parsingAttr ? StateElemAttrVal : StateData;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
if(c != ClassNameChar && c != ClassNameStartChar) ERROR("Invalid entity name.");
|
||||||
|
APPEND_CH(buffer2, ch);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
++ctx->col;
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
const char* csxml_entityRef(struct csxml* ctx, const char* ent)
|
||||||
|
{
|
||||||
|
const char* q = 0;
|
||||||
|
|
||||||
|
if(!strcmp(ent, "quot")) return "\"";
|
||||||
|
if(!strcmp(ent, "amp")) return "&";
|
||||||
|
if(!strcmp(ent, "apos")) return "'";
|
||||||
|
if(!strcmp(ent, "lt")) return "<";
|
||||||
|
if(!strcmp(ent, "gt")) return ">";
|
||||||
|
|
||||||
|
q = ctx->entityRef(ctx, ent);
|
||||||
|
if(!q) {
|
||||||
|
ctx->state = StateError;
|
||||||
|
ctx->unknownEntity(ctx, ent);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
return q;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
void csxml_reset(struct csxml* ctx)
|
||||||
|
{
|
||||||
|
CLEAR_BUFFER(buffer);
|
||||||
|
CLEAR_BUFFER(buffer2);
|
||||||
|
CLEAR_BUFFER(elemName);
|
||||||
|
ctx->state = StateNone;
|
||||||
|
ctx->xmlCount = 0;
|
||||||
|
ctx->elementDepth = 0;
|
||||||
|
ctx->restartCount = 0;
|
||||||
|
ctx->skipNextNewline = 0;
|
||||||
|
ctx->parsingAttr = 0;
|
||||||
|
ctx->line = 0;
|
||||||
|
ctx->col = 0;
|
||||||
|
ctx->elemStack.len = 0;
|
||||||
|
ctx->elemAttrNames.len = 0;
|
||||||
|
ctx->elemAttrVals.len = 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
#undef ERROR
|
||||||
|
#undef APPEND_CH
|
||||||
|
#undef CLEAR_BUFFER
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
void csxml_freeParser(struct csxml* ctx)
|
||||||
|
{
|
||||||
|
if(!ctx) return;
|
||||||
|
buffer_free(&ctx->buffer);
|
||||||
|
buffer_free(&ctx->buffer2);
|
||||||
|
buffer_free(&ctx->elemName);
|
||||||
|
list_free(&ctx->elemStack);
|
||||||
|
list_free(&ctx->elemAttrNames);
|
||||||
|
list_free(&ctx->elemAttrVals);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
struct csxml* csxml_newParser()
|
||||||
|
{
|
||||||
|
struct csxml* ctx = 0;
|
||||||
|
|
||||||
|
ctx = malloc(sizeof(struct csxml));
|
||||||
|
if(!ctx) return 0;
|
||||||
|
memset(ctx, 0, sizeof(struct csxml));
|
||||||
|
|
||||||
|
if(buffer_init(ctx, &ctx->buffer) || buffer_init(ctx, &ctx->buffer2) || buffer_init(ctx, &ctx->elemName)) {
|
||||||
|
csxml_freeParser(ctx);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
ctx->expandEntities = 1;
|
||||||
|
|
||||||
|
ctx->notWellFormed = default_notWellFormed;
|
||||||
|
ctx->outOfMemory = default_outOfMemory;
|
||||||
|
ctx->unknownEntity = default_unknownEntity;
|
||||||
|
ctx->whiteSpace = default_discard;
|
||||||
|
ctx->content = default_discard;
|
||||||
|
ctx->cdata = default_cdata;
|
||||||
|
ctx->streamRestart = default_discard;
|
||||||
|
ctx->PI = default_discardPI;
|
||||||
|
ctx->comment = default_discard;
|
||||||
|
ctx->element = default_discardElem;
|
||||||
|
ctx->closeTag = default_discard;
|
||||||
|
ctx->entityRef = default_discardEnt;
|
||||||
|
|
||||||
|
return ctx;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
void csxml_feedData(struct csxml* ctx, const char* data, size_t amt)
|
||||||
|
{
|
||||||
|
while(amt--) csxml_feedChar(ctx, *data++);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/* options for text editors
|
||||||
|
kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
vim: expandtab:ts=4:sw=4
|
||||||
|
*/
|
|
@ -0,0 +1,21 @@
|
||||||
|
# libCStreamedXML/src/lib/libCStreamedXML/pkgconf.in
|
||||||
|
#
|
||||||
|
# Metadata file for pkg-config
|
||||||
|
# ( http://www.freedesktop.org/software/pkgconfig/ )
|
||||||
|
#
|
||||||
|
# (c)2006, Laurence Withers, <l@lwithers.me.uk>.
|
||||||
|
# Released under the GNU GPLv2. See file COPYING or
|
||||||
|
# http://www.gnu.org/copyleft/gpl.html for details.
|
||||||
|
#
|
||||||
|
|
||||||
|
# Name, description
|
||||||
|
Name: libCStreamedXML
|
||||||
|
Description: C library for parsing Streamed XML
|
||||||
|
Version: @VERSION@
|
||||||
|
|
||||||
|
# Requirements
|
||||||
|
Requires:
|
||||||
|
|
||||||
|
# Compilation information
|
||||||
|
Libs: -L@LIBDIR@ -lCStreamedXML
|
||||||
|
Cflags: -I@INCLUDEDIR@
|
|
@ -0,0 +1,17 @@
|
||||||
|
# libCStreamedXML/src/libCStreamedXML/soversion
|
||||||
|
#
|
||||||
|
# (c)2006, Laurence Withers, <l@lwithers.me.uk>.
|
||||||
|
# Released under the GNU GPLv2. See file COPYING or
|
||||||
|
# http://www.gnu.org/copyleft/gpl.html for details.
|
||||||
|
#
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# SOMAJOR and SOMINOR are included in the library's soname. They need to
|
||||||
|
# be bumped on a binary-incompatible release. They are both single
|
||||||
|
# integers.
|
||||||
|
SOMAJOR=0
|
||||||
|
SOMINOR=0
|
||||||
|
|
||||||
|
# SOMICRO is bumped every time there is a binary-compatible release.
|
||||||
|
SOMICRO=5
|
|
@ -0,0 +1,322 @@
|
||||||
|
/* libCStreamedXML/src/libCStreamedXML/types.h
|
||||||
|
*
|
||||||
|
* (c)2006, Laurence Withers. Released under the GNU GPL. See file
|
||||||
|
* COPYING for more information / terms of license.
|
||||||
|
*/
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief String buffer.
|
||||||
|
|
||||||
|
This type implements a simple string buffer. The string should be kept null-terminated. The \a data
|
||||||
|
pointer is reallocated as necessary (i.e. when \a len becomes equal to \a size). \a len is the
|
||||||
|
string length (excluding terminating null) and \a size is the size of the allocated buffer. It is
|
||||||
|
never valid for \a data or \a size to be 0.
|
||||||
|
|
||||||
|
*/
|
||||||
|
struct csxml_buf {
|
||||||
|
/// Pointer to string (null terminated).
|
||||||
|
char* data;
|
||||||
|
|
||||||
|
/// Length of string (excluding null).
|
||||||
|
size_t len;
|
||||||
|
|
||||||
|
/// Size of allocated buffer.
|
||||||
|
size_t size;
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief String list.
|
||||||
|
|
||||||
|
This type implements a dynamic array of strings (using the struct csxml_buf type). The \a data
|
||||||
|
pointer is reallocated as necessary (i.e. when \a len becomes equal to \a size). \a len is the
|
||||||
|
number of valid elements in the array and \a size is the size of the allocated buffer. It is valid
|
||||||
|
for \a data and \a size to be zero.
|
||||||
|
|
||||||
|
*/
|
||||||
|
struct csxml_list {
|
||||||
|
/// Array of buffers (all allocated elements are valid and initialised).
|
||||||
|
struct csxml_buf* data;
|
||||||
|
|
||||||
|
/// Number of elements in use.
|
||||||
|
size_t len;
|
||||||
|
|
||||||
|
/// Number of allocated elements.
|
||||||
|
size_t size;
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Streamed XML parser context.
|
||||||
|
|
||||||
|
This structure contains all the details of a Streamed XML parsing operation. Most fields are
|
||||||
|
internal to the parser and should not be touched; those are briefly documented here. You may want to
|
||||||
|
change the \a expandEntities option, examine the \a line and \a col variables, and change the
|
||||||
|
callback functions.
|
||||||
|
|
||||||
|
Those members marked Internal: are subject to change (either in semantics, type or existence).
|
||||||
|
|
||||||
|
*/
|
||||||
|
struct csxml {
|
||||||
|
/// Option: change "&lt;" to "<", etc. if non-zero (the default). Change to 0 to leave
|
||||||
|
/// entities inline.
|
||||||
|
int expandEntities;
|
||||||
|
|
||||||
|
/// Current line (from 0, starts from last restart marker).
|
||||||
|
int line;
|
||||||
|
/// Current column (from 0, starts from last restart marker).
|
||||||
|
int col;
|
||||||
|
|
||||||
|
/// List of attribute names for current element.
|
||||||
|
struct csxml_list elemAttrNames;
|
||||||
|
/// List of attribute values for current element.
|
||||||
|
struct csxml_list elemAttrVals;
|
||||||
|
|
||||||
|
/// User data.
|
||||||
|
void* user;
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Error callback: Streamed XML is not well formed.
|
||||||
|
|
||||||
|
\param ctx Parsing context.
|
||||||
|
\param reason Human-readable description of error.
|
||||||
|
|
||||||
|
This function is called whenever badly-formed Streamed XML is encountered (e.g. if content is
|
||||||
|
encountered at stream-level).
|
||||||
|
|
||||||
|
The default implementation prints a formatted message to \a stderr.
|
||||||
|
|
||||||
|
*/
|
||||||
|
void (*notWellFormed)(const struct csxml* ctx, const char* reason);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Error callback: out of memory.
|
||||||
|
|
||||||
|
\param ctx Parsing context.
|
||||||
|
\param amount Number of bytes we tried to allocate.
|
||||||
|
|
||||||
|
This function is called whenever a dynamic string resizing operation (or similar) fails. It is
|
||||||
|
called with the number of bytes the library attempted to allocate.
|
||||||
|
|
||||||
|
The default implementation prints a formatted message to \a stderr.
|
||||||
|
|
||||||
|
\todo When parsing extremely long content sections, we could just call the content() callback
|
||||||
|
when memory is low rather than failing altogether.
|
||||||
|
|
||||||
|
*/
|
||||||
|
void (*outOfMemory)(const struct csxml* ctx, size_t amount);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Error callback: reference to unknown entity.
|
||||||
|
|
||||||
|
\param ctx Parsing context.
|
||||||
|
\param ent Name of the referenced entity.
|
||||||
|
|
||||||
|
If an entity is referenced by name (e.g. "&myEntity;" is encountered) but the lookup in the
|
||||||
|
default entity list and through the entityRef() callback fails to resolve the content, this
|
||||||
|
function is called.
|
||||||
|
|
||||||
|
The default implementation prints a formatted message to \a stderr.
|
||||||
|
|
||||||
|
*/
|
||||||
|
void (*unknownEntity)(const struct csxml* ctx, const char* ent);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Callback: whitespace.
|
||||||
|
|
||||||
|
\param ctx Parsing context.
|
||||||
|
\param ws Pointer to string of whitespace.
|
||||||
|
\returns Zero on success, non-zero on error.
|
||||||
|
|
||||||
|
This function is called whenever a block of whitespace is encountered at stream level or
|
||||||
|
immediately after some structural element (i.e. on leading whitespace within elements). It is
|
||||||
|
generally safe to discard it, unless you need to reproduce the file verbatim. Once content is
|
||||||
|
encountered within an element, any further whitespace will be reported through the content()
|
||||||
|
callback, up to the next structural element.
|
||||||
|
|
||||||
|
The default implementation discards the data.
|
||||||
|
|
||||||
|
*/
|
||||||
|
int (*whiteSpace)(const struct csxml* ctx, const char* ws);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Callback: content.
|
||||||
|
|
||||||
|
\param ctx Parsing context.
|
||||||
|
\param content Pointer to string of cdata.
|
||||||
|
\returns Zero on success, non-zero on error.
|
||||||
|
|
||||||
|
This function is called whenever textual content (cdata) is encountered inside an element. It
|
||||||
|
may be called multiple times simultaneously, in which case the data from each call should be
|
||||||
|
concatenated. If \a expandEntities is non-zero, then this function will also be called with the
|
||||||
|
expanded text from any entities encountered, rather than the entities themselves.
|
||||||
|
|
||||||
|
The default implementation discards the data.
|
||||||
|
|
||||||
|
*/
|
||||||
|
int (*content)(const struct csxml* ctx, const char* content);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Callback: cdata block.
|
||||||
|
|
||||||
|
\param ctx Parsing context.
|
||||||
|
\param cdata Pointer to string of cdata.
|
||||||
|
\returns Zero on success, non-zero on error.
|
||||||
|
|
||||||
|
This function is called for all data inside a CDATA marked section. It is useful to
|
||||||
|
differentiate between cdata encoded in this manner and normal cdata if you are trying to
|
||||||
|
reproduce the orginal file verbatim.
|
||||||
|
|
||||||
|
The default implementation calls content() with the same data.
|
||||||
|
|
||||||
|
*/
|
||||||
|
int (*cdata)(const struct csxml* ctx, const char* cdata);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Callback: stream restart marker.
|
||||||
|
|
||||||
|
\param ctx Parsing context.
|
||||||
|
\param marker Pointer to marker string.
|
||||||
|
\returns Zero on success, non-zero on error.
|
||||||
|
|
||||||
|
Whenever a stream restart marker is encountered, this function is called with the data found
|
||||||
|
inside the marker.
|
||||||
|
|
||||||
|
The default implementation ignores the data (but note that the parser state is always reset,
|
||||||
|
regardless of what the callback does).
|
||||||
|
|
||||||
|
*/
|
||||||
|
int (*streamRestart)(const struct csxml* ctx, const char* marker);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Callback: processing instruction.
|
||||||
|
|
||||||
|
\param ctx Parsing context.
|
||||||
|
\param target PI target.
|
||||||
|
\param data PI data (may be 0).
|
||||||
|
\returns Zero on success, non-zero on error.
|
||||||
|
|
||||||
|
This callback is used to report processing instructions (PIs). If the PI has no data, then the
|
||||||
|
\a data variable can be set to 0.
|
||||||
|
|
||||||
|
The default implementation ignores the data.
|
||||||
|
|
||||||
|
*/
|
||||||
|
int (*PI)(const struct csxml* ctx, const char* target, const char* data);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Callback: comment.
|
||||||
|
|
||||||
|
\param ctx Parsing context.
|
||||||
|
\param comment Pointer to comment string data.
|
||||||
|
\returns Zero on success, non-zero on error.
|
||||||
|
|
||||||
|
This callback is used to report comments. It is only useful if you wish to reproduce the source
|
||||||
|
file verbatim (for instance, you want to alter some data in a file but preserve user comments).
|
||||||
|
|
||||||
|
The default implementation ignores the data.
|
||||||
|
|
||||||
|
*/
|
||||||
|
int (*comment)(const struct csxml* ctx, const char* comment);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Callback: element.
|
||||||
|
|
||||||
|
\param ctx Parsing context.
|
||||||
|
\param elemName Pointer to element name string.
|
||||||
|
\param numAttrs Number of attributes.
|
||||||
|
\returns Zero on success, non-zero on error.
|
||||||
|
|
||||||
|
This callback is used whenever an element open tag is encountered. To parse attributes, use the
|
||||||
|
numAttrs variable to determine how many there are, and then access them with:
|
||||||
|
|
||||||
|
<pre> // get attribute name
|
||||||
|
const char* elemName = ctx->elemAttrNames.data[i].data;
|
||||||
|
|
||||||
|
// get attribute value
|
||||||
|
const char* elemValue = ctx->elemAttrVals.data[i].data;</pre>
|
||||||
|
|
||||||
|
In the case of an empty element, the closeTag() callback will be called immediately afterwards.
|
||||||
|
|
||||||
|
The default implemenation ignores the data.
|
||||||
|
|
||||||
|
*/
|
||||||
|
int (*element)(const struct csxml* ctx, const char* elemName, int numAttrs);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Callback: close tag.
|
||||||
|
|
||||||
|
\param ctx Parsing context.
|
||||||
|
\param elemName Element name.
|
||||||
|
\returns Zero on success, non-zero on error.
|
||||||
|
|
||||||
|
This function is called whenever an element close tag is encountered. The element name will
|
||||||
|
always match the open tag element name (if not, the Streamed XML is not well formed, and an
|
||||||
|
error will be signalled before this callback is triggered).
|
||||||
|
|
||||||
|
The default implementation ignores the data.
|
||||||
|
|
||||||
|
*/
|
||||||
|
int (*closeTag)(const struct csxml* ctx, const char* elemName);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/*! \brief Callback: entity reference.
|
||||||
|
|
||||||
|
\param ctx Parsing context.
|
||||||
|
\param ent Entity name.
|
||||||
|
\retval 0 if the entity name does not match any known entity.
|
||||||
|
\returns Pointer to null-terminated string data for expanding entity.
|
||||||
|
|
||||||
|
This function is called whenever \a expandEntities is true and an entity is encountered in cdata
|
||||||
|
or an attribute value. It is only called if the entity does not match one of the five built-in
|
||||||
|
defaults. You only need to provide an implementation if you know about some additional entities.
|
||||||
|
|
||||||
|
The default implementation returns 0 ("no such entity").
|
||||||
|
|
||||||
|
*/
|
||||||
|
const char* (*entityRef)(const struct csxml* ctx, const char* ent);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/// Internal: string buffer.
|
||||||
|
struct csxml_buf buffer;
|
||||||
|
/// Internal: string buffer.
|
||||||
|
struct csxml_buf buffer2;
|
||||||
|
/// Internal: string buffer.
|
||||||
|
struct csxml_buf elemName;
|
||||||
|
/// Internal: stack of element names, used to match open/close tags.
|
||||||
|
struct csxml_list elemStack;
|
||||||
|
/// Internal: state machine state.
|
||||||
|
int state;
|
||||||
|
/// Internal: for matching strings.
|
||||||
|
int xmlCount;
|
||||||
|
/// Internal: depth in element tree (0 = stream level).
|
||||||
|
int elementDepth;
|
||||||
|
/// Internal: for matching against restart marker string.
|
||||||
|
int restartCount;
|
||||||
|
/// Internal: for stripping windows line endings.
|
||||||
|
int skipNextNewline;
|
||||||
|
/// Internal: flag to check if we are currently parsing an attribute while expanding an entity.
|
||||||
|
int parsingAttr;
|
||||||
|
/// Internal: flag to record if current attribute was quoted with ' or " char.
|
||||||
|
int singleQuote;
|
||||||
|
/// Internal: used to expand character entities.
|
||||||
|
int entityChar;
|
||||||
|
};
|
||||||
|
|
||||||
|
/* options for text editors
|
||||||
|
kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
vim: expandtab:ts=4:sw=4
|
||||||
|
*/
|
|
@ -0,0 +1 @@
|
||||||
|
c tests tests libCStreamedXML
|
|
@ -0,0 +1,3 @@
|
||||||
|
source src/tests/build.tests
|
||||||
|
# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
# vim: expandtab:ts=4:sw=4
|
|
@ -0,0 +1,43 @@
|
||||||
|
# These are external variables, and shouldn't clash with anything else
|
||||||
|
# tests_BUILT
|
||||||
|
#
|
||||||
|
|
||||||
|
build_target libCStreamedXML || return 1
|
||||||
|
|
||||||
|
if [ -z ${tests_BUILT} ]
|
||||||
|
then
|
||||||
|
LIBS="${libCStreamedXML} "
|
||||||
|
EXTRAS=""
|
||||||
|
|
||||||
|
echo "Building test programs..."
|
||||||
|
do_cmd mkdir -p obj/tests || return 1
|
||||||
|
|
||||||
|
for SRC in src/tests/*.c
|
||||||
|
do
|
||||||
|
TEST="obj/tests/$(basename ${SRC} | sed -e 's,.c$,,')"
|
||||||
|
MODIFIED=0
|
||||||
|
for file in ${LIBS} ${SRC} src/tests/build.tests
|
||||||
|
do
|
||||||
|
if [ ${file} -nt ${TEST} ]
|
||||||
|
then
|
||||||
|
MODIFIED=1
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
if [ ${MODIFIED} -ne 0 ]
|
||||||
|
then
|
||||||
|
do_cmd ${CC} -Iobj ${CFLAGS} -o ${TEST} ${SRC} ${LIBS} ${EXTRAS} || return 1
|
||||||
|
print_success "Built ${TEST}"
|
||||||
|
else
|
||||||
|
print_success "${TEST} is up to date"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
print_success "All tests built"
|
||||||
|
|
||||||
|
tests_BUILT=1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
# vim: expandtab:ts=4:sw=4
|
|
@ -0,0 +1,137 @@
|
||||||
|
/* libCStreamedXML/src/tests/callback.c
|
||||||
|
*
|
||||||
|
* (c)2006, Laurence Withers, <l@lwithers.me.uk>.
|
||||||
|
* Released under the GNU GPLv2. See file COPYING or
|
||||||
|
* http://www.gnu.org/copyleft/gpl.html for details.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#include "StreamedXML.h"
|
||||||
|
|
||||||
|
#include <stdio.h>
|
||||||
|
#include <string.h>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
int echo_whiteSpace(const struct csxml* ctx, const char* ws)
|
||||||
|
{
|
||||||
|
(void)ctx;
|
||||||
|
printf("Whitespace: ``%s''\n", ws);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
int echo_content(const struct csxml* ctx, const char* data)
|
||||||
|
{
|
||||||
|
(void)ctx;
|
||||||
|
printf("Content: ``%s''\n", data);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
int echo_cdata(const struct csxml* ctx, const char* data)
|
||||||
|
{
|
||||||
|
(void)ctx;
|
||||||
|
printf("CDATA: ``%s''\n", data);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
int echo_streamRestart(const struct csxml* ctx, const char* data)
|
||||||
|
{
|
||||||
|
(void)ctx;
|
||||||
|
printf("Stream restart marker: ``%s''\n", data);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
int echo_PI(const struct csxml* ctx, const char* target, const char* data)
|
||||||
|
{
|
||||||
|
(void)ctx;
|
||||||
|
printf("PI: target ``%s'', data ", target);
|
||||||
|
if(data) printf("``%s''\n", data);
|
||||||
|
else printf("not specified\n");
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
int echo_comment(const struct csxml* ctx, const char* data)
|
||||||
|
{
|
||||||
|
(void)ctx;
|
||||||
|
printf("Comment: ``%s''\n", data);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
int echo_element(const struct csxml* ctx, const char* elemName, int numAttrs)
|
||||||
|
{
|
||||||
|
int i;
|
||||||
|
|
||||||
|
printf("Open tag: <%s> (%d attributes)\n", elemName, numAttrs);
|
||||||
|
for(i = 0; i < numAttrs; ++i) printf(" %s='%s'\n", ctx->elemAttrNames.data[i].data, ctx->elemAttrVals.data[i].data);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
int echo_closeTag(const struct csxml* ctx, const char* elemName)
|
||||||
|
{
|
||||||
|
(void)ctx;
|
||||||
|
printf("Close tag: </%s>\n", elemName);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
const char* echo_entityRef(const struct csxml* ctx, const char* ent)
|
||||||
|
{
|
||||||
|
(void)ctx;
|
||||||
|
printf("Entity reference: ``%s''\n", ent);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
int main(int argc, char* argv[])
|
||||||
|
{
|
||||||
|
FILE* fp = 0;
|
||||||
|
char buf[1024];
|
||||||
|
size_t amt;
|
||||||
|
struct csxml* ctx = 0;
|
||||||
|
|
||||||
|
if(argc == 2 && !strcmp(argv[1], "--print-summary")) {
|
||||||
|
printf("Tests the callback functions.\n");
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
if(argc != 2) {
|
||||||
|
fprintf(stderr, "Expecting filename.\n");
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
fp = fopen(argv[1], "r");
|
||||||
|
if(!fp) {
|
||||||
|
fprintf(stderr, "Error opening '%s' for input.\n", argv[1]);
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
ctx = csxml_newParser();
|
||||||
|
if(!ctx) {
|
||||||
|
fprintf(stderr, "Couldn't allocate a new parser.\n");
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
ctx->whiteSpace = echo_whiteSpace;
|
||||||
|
ctx->content = echo_content;
|
||||||
|
ctx->cdata = echo_cdata;
|
||||||
|
ctx->streamRestart = echo_streamRestart;
|
||||||
|
ctx->PI = echo_PI;
|
||||||
|
ctx->comment = echo_comment;
|
||||||
|
ctx->element = echo_element;
|
||||||
|
ctx->closeTag = echo_closeTag;
|
||||||
|
ctx->entityRef = echo_entityRef;
|
||||||
|
|
||||||
|
while(!feof(fp)) {
|
||||||
|
amt = fread(buf, 1, sizeof(buf), fp);
|
||||||
|
csxml_feedData(ctx, buf, amt);
|
||||||
|
}
|
||||||
|
|
||||||
|
csxml_freeParser(ctx);
|
||||||
|
fclose(fp);
|
||||||
|
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* options for text editors
|
||||||
|
kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
vim: expandtab:ts=4:sw=4
|
||||||
|
*/
|
|
@ -0,0 +1,35 @@
|
||||||
|
/* libCStreamedXML/src/tests/???.c
|
||||||
|
*
|
||||||
|
* (c)2006, Laurence Withers, <l@lwithers.me.uk>.
|
||||||
|
* Released under the GNU GPLv2. See file COPYING or
|
||||||
|
* http://www.gnu.org/copyleft/gpl.html for details.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#include "StreamedXML.h"
|
||||||
|
|
||||||
|
#include <stdio.h>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
int main(int argc, char* argv[])
|
||||||
|
{
|
||||||
|
if(argc == 2 && !strcmp(argv[1], "--print-summary")) {
|
||||||
|
printf("One line summary.\n");
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
if(argc == 1) {
|
||||||
|
// empty argument list
|
||||||
|
}
|
||||||
|
|
||||||
|
int ret = 0;
|
||||||
|
|
||||||
|
// TODO
|
||||||
|
|
||||||
|
return ret;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* options for text editors
|
||||||
|
kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
vim: expandtab:ts=4:sw=4
|
||||||
|
*/
|
|
@ -0,0 +1,19 @@
|
||||||
|
# libCStreamedXML/version
|
||||||
|
#
|
||||||
|
# (c)2006, Laurence Withers, <l@lwithers.me.uk>.
|
||||||
|
# Released under the GNU GPLv2. See file COPYING or
|
||||||
|
# http://www.gnu.org/copyleft/gpl.html for details.
|
||||||
|
#
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# VERSION contains the full version number of the library, which is
|
||||||
|
# expected to be in 'major.minor.micro' format. It can optionally be
|
||||||
|
# suffixed with a string.
|
||||||
|
VERMAJOR=1
|
||||||
|
VERMINOR=2
|
||||||
|
VERMICRO=8
|
||||||
|
VEREXTRA=""
|
||||||
|
|
||||||
|
# kate: replace-trailing-space-save true; space-indent true; tab-width 4;
|
||||||
|
# vim: expandtab:ts=4:sw=4
|
Loading…
Reference in New Issue