_____ _________ ________  ___ ___ _________ ________
       /  __/ \_  ____/ \       ) | | | | \_  ____/ \       )
       \__ \   |   _)_  | __  _/  | | | |  |   _)_  | __  _/
       ___\ \  |      \ | | \ \   \ \_/ /  |      \ | | \ \  solutions
       \____/ /_____  / /_/  \ \   \   /  /_____  / /_/  \ \
                    \/        \/    \_/         \/        \/

           (c) Lada 'Ray' Lostak (c) Orcave (c) 2002-2005
Content:

  _SIMPLE_ Software Developer Kit

History:

  2005-01-05 Ray        - initial version


XML functions
-------------
STLC provides 2 basic XML related functions:

    xmlParse

        parses XML document and create full tree structure
        all allocated memory belongs to heap (texts,struc nodes, ...)
        it is real XML parsers with few limitations:
            no UTF-8
            no user entities
            no combining 'text' and 'tags' - element can include as childs more elements or 
               eaxctly one 'text' part

    xmlAnalyze

        simple XML/DTD analyze and information reader function. DTD structure is defined by XML:

            <elem name="element_name" [dst="int"] [haveval="bool"]>
               <attr name="attrib_name" [required="bool"] [dst="int"]>
               <attr name...
                   <elem name="child_element_name"...
              .
              .
              .

            Structure is checked in given 'tree' order. Attributes belongs to its parents. If
            attribute 'dst' is included, it takes integer offset, where 'value' in destination
            array will be stored. For attributes, its value is stored, for elements, its
            text contents is strored. 'haveval' attribute means, that element can include text
            contents. 'required' means, that attribute HAVE TO BE filled in original XML. If
            any difference occurs, SYNTAX_ERROR is returned. Blanks before 'text conetnts' are
            skipped.

            This simple structure have to be valid XML document.

        Example:

            XML source:
            
                <skey_sign xx="vul">
                  <login>
                    <username>reb909</username>
                    <key>$pass_md5</key>
                  </login>
                </skey_sign>

            simple DTD:

                <elem name="skey_sign">
                  <attr name="xx" dst="2"  required="1"/>
                  <elem name="login">
                    <elem name="key" dst="1" haveval="1"/>
                    <elem name="username" dst="0" haveval="1"/>
                  </elem>
                </elem>

            Output:

                1. no error (valid XML and valid for given DTD struct)
                2. result array contents

                    0: reb909
                    1: $pass_md5
                    2: vul