osrtxml.h

Go to the documentation of this file.

/*
 * Copyright (c) 2003-2022 Objective Systems, Inc.
 *
 * This software is furnished under a license and may be used and copied
 * only in accordance with the terms of such license and with the
 * inclusion of the above copyright notice. This software or any other
 * copies thereof may not be provided or otherwise made available to any
 * other person. No title to and ownership of the software is hereby
 * transferred.
 *
 * The information in this software is subject to change without notice
 * and should not be construed as a commitment by Objective Systems, Inc.
 *
 * PROPRIETARY NOTICE
 *
 * This software is an unpublished work subject to a confidentiality agreement
 * and is protected by copyright and trade secret law.  Unauthorized copying,
 * redistribution or other use of this work is prohibited.
 *
 * The above notice of copyright on this source code product does not indicate
 * any actual or intended publication of such source code.
 *
 *****************************************************************************/

#ifndef _OSRTXML_H_
#define _OSRTXML_H_

#define OSXMLNS12

#include "rtxsrc/rtxCommon.h"
#include "rtxmlsrc/rtSaxDefs.h"
#include "rtxsrc/rtxDList.h"
#include "rtxsrc/rtxMemBuf.h"
#include "rtxmlsrc/rtXmlExternDefs.h"
#include "rtxmlsrc/rtXmlErrCodes.h"
#include "rtxmlsrc/rtXmlNamespace.h"

/* XML specific context flags */

#define OSUPCASE        0x00008000  /* convert characters to upper case */
#define OSTERMSTART     0x00004000  /* term for start elem (>) needed   */
#define OSEMPTYELEM     0x00002000  /* element is empty (no content)    */
#define OSQUALATTR      0x00001000  /* qualified attribute              */
#define OSXMLFRAG       0x00000800  /* XML fragment (not full doc)      */
#define OSXMLNSSET      0x00000400  /* Indicates namespaces are set     */
#define OSXMLC14N       0x00000200  /* Flag used to indicate XML canonical
                                       encode when OSASN1XER is not set, or
                                       canonical XER when OSASN1XER is set. */
#define OSXSIATTR       0x00000100  /* add xsi ns decl to encoded msg   */
#define OSXMLNOCMPNS    0x00000080  /* match local names only           */
#define OSXSINIL        0x00000040  /* add xsi:nil decl to encoded msg  */
#define OSHASDEFAULT    0x00000010  /* decode should accept values which
                                       are empty after whitespace processing
                                       because the element has a default
                                       value                            */
#define OSASN1XER       0x00000008  /* if true, -xml code and runtime
                                       should produce XER encodings
                                       instead of Obj-Sys encodings     */

typedef enum {
   OSXMLUTF8,
   OSXMLUTF16,
   OSXMLUTF16BE,
   OSXMLUTF16LE,
   OSXMLLATIN1
} OSXMLEncoding;

typedef enum {
   OSSOAPNONE, OSSOAPHEADER, OSSOAPBODY, OSSOAPFAULT
} OSXMLSOAPMsgType;

typedef enum {
   OSXMLBOM_NO_BOM,
   OSXMLBOM_UTF32_BE,
   OSXMLBOM_UTF32_LE,
   OSXMLBOM_UTF16_BE,
   OSXMLBOM_UTF16_LE,
   OSXMLBOM_UTF8,
   OSXMLBOM_CHECK
} OSXMLBOM;

typedef struct OSXMLFacets {
   int totalDigits;
   int fractionDigits;
} OSXMLFacets;

typedef struct {
   const OSUTF8CHAR* value;
   OSSIZE length;
} OSXMLStrFragment;

typedef struct {
   OSXMLStrFragment mQName;
   OSXMLStrFragment mLocalName;
   OSXMLStrFragment mPrefix;
} OSXMLNameFragments;

typedef struct OSXMLItemDescr {
   OSXMLStrFragment localName;
   OSINT16 nsidx; /* namespace index */
} OSXMLItemDescr;

typedef OSXMLItemDescr OSXMLAttrDescr;
typedef OSXMLItemDescr OSXMLElemDescr;

typedef struct OSXMLElemIDRec {
   OSXMLElemDescr descr;
   OSUINT16 id;
} OSXMLElemIDRec;

typedef struct OSXMLGroupDesc {
   /* row: identifies the index in an OSXMLElemIDRec[] for the first element
      that is in this group.
   */
   int row;

   /* num: The number of elements that are in this group, each of which has
      a row in the OSXMLElemIDRec array.  Thus, if tab is such an array, the
      elements for this group are found in tab[row]..tab[row+num-1] */
   int num;

   /* anyCase: The id to return when an unexpected element is found when
      matching against the group. -1 if an unexpected element should not
      be matched.
   */
   int anyCase;
} OSXMLGroupDesc;

typedef struct OSXSDAnyType {
   OSXMLSTRING value;
   OSRTDList attrs;
} OSXSDAnyType;

typedef enum {
   OSXMLNSI_UNQUALIFIED = 0,
   OSXMLNSI_UNKNOWN = -1,
   OSXMLNSI_UNCHECKED = -2,
   OSXMLNSI_XSI = -3,
   OSXMLNSI_XMLNS = -4,
   OSXMLNSI_XML = -5,
   OSXMLNSI_SOAP_ENVELOPE = -6,
   OSXMLNSI_XSD = -7
} OSXMLNsIndex;

struct OSXMLReader;

#define OSXMLFRAGSEQUAL(frag1,frag2) \
(frag1.length==frag2.length && !memcmp(frag1.value,frag2.value,frag1.length))

#define OSXMLQNAMEEQUALS(xnamefrag,qnametext) rtxUTF8StrnEqual \
(xnamefrag.mQName.value, OSUTF8(qnametext), xnamefrag.mQName.length)

#define OSXMLSETUTF8DECPTR(pctxt,str) \
rtxInitContextBuffer (pctxt, OSRTSAFECONSTCAST (OSOCTET*, str), \
OSUTF8LEN (str))

#define IS_XMLNSATTR(name) \
((OSUTF8LEN(name) >= 5) && name[0] == 'x' && name[1] == 'm' && \
 name[2] == 'l' && name[3] == 'n' && name[4] == 's')

#define IS_XSIATTR(name) \
((OSUTF8LEN(name) >= 4) && name[0] == 'x' && name[1] == 's' && \
 name[2] == 'i' && name[3] == ':')

/* XML header declaration encoding strings */

static const char OSXMLHDRUTF8 [] = "UTF-8";
static const char OSXMLHDRUTF16 [] = "UTF-16";
static const char OSXMLHDRUTF16BE [] = "UTF-16BE";
static const char OSXMLHDRUTF16LE [] = "UTF-16LE";
static const char OSXMLHDRLATIN1 [] = "ISO-8859-1";

/*
 * NOTE: If a field is added to this structure, make sure to add code to
 * to rtXmlInitCtxtAppInfo in rtXmlContext.c to initialize it.
 */
typedef struct {
   OSFreeCtxtAppInfoPtr  pFreeFunc; /* Free function pointer            */
   OSResetCtxtAppInfoPtr pResetFunc;/* Reset function pointer           */
   OSUTF8CHAR* schemaLocation;  /* xsi:schemaLocation attribute         */
   OSUTF8CHAR* noNSSchemaLoc;   /* xsi:noNamespaceSchemaLocation attr   */
   OSUTF8CHAR* xsiTypeAttr;     /* xsi:type attribute value             */
   OSXMLEncoding encoding;      /* XML document encoding (ex. UTF-8)    */
   OSRTDList namespaceList;     /* list of OSXMLNamespace               */
   OSRTDList encodedNSList;     /* list of encoded OSXMLNamespace       */
   OSRTDList sortedAttrList;    /* list of sorted attributes            */
   OSXMLNSPfxLinkStack nsPfxLinkStack;
   OSXMLNSURITable nsURITable;
   OSRTMEMBUF  memBuf;          /* memory buffer for character method   */
   OSINT32 mSaxLevel;
   OSINT32 mSkipLevel;
   OSUINT32 maxSaxErrors;       /* maximum number of errors             */
   OSUINT32 errorsCnt;          /* counter of errors                    */
   OSUINT8 indent;              /* XML output indent                    */
   OSBOOL  mbCdataProcessed;    /* CDATA section was processed          */
   char    indentChar;          /* indent char, default is space (' ')  */
   OSUINT8 soapVersion;         /* SOAP version (11 or 12)              */
   OSXMLFacets facets;
   const OSUTF8CHAR* encodingStr;/* name of encoding ("UTF-8", "ISO-...")*/
   OSXMLBOM byteOrderMark;
   struct OSXMLReader* pXmlPPReader; /* pull-parser reader object       */
   /* fields for encode canonical XML*/
   OSRTBuffer savedBuffer;
   OSRTFLAGS savedFlags;
   OSOCTET* attrsBuff;
   OSSIZE attrsBuffSize;
   OSSIZE attrStartPos;
} OSXMLCtxtInfo;

/*
Options for encoding an ASN.1 REAL type to XML.
OSXMLREALOBJSYS: follow Obj-Sys XML rules
OSXMLREALBXER: follow basic-XER rules
OSXMLREALEXERMODS: follow extended-XER rules for when MODIFIED-ENCODINGS is
   given.
OSXMLREALEXERDEC: follow extended-XER rules for when DECIMAL is given.

*/
typedef enum {
   OSXMLREALOBJSYS,
   OSXMLREALBXER,
   OSXMLREALEXERMODS,
   OSXMLREALEXERDEC
} OSXMLREALEncoding;

typedef enum {
   OSXMLINIT,
   OSXMLHEADER,
   OSXMLSTART,
   OSXMLATTR,
   OSXMLDATA,
   OSXMLEND,
   OSXMLCOMMENT
} OSXMLState;

typedef struct OSXMLQName {
   const OSUTF8CHAR* nsPrefix;
   const OSUTF8CHAR* ncName;
} OSXMLQName;

struct OSSAXHandlerBase;

typedef struct OSIntegerFmt {
   OSINT8 integerMaxDigits;   /* Maximum digits in integer part;
                                 leading zeros will be added, if necessary. */
   OSBOOL signPresent;        /* Indicates, sign must present, even if value
                                 is positive. */
} OSIntegerFmt;


typedef struct {
   OSSIZE offset;
   OSSIZE length;
   OSSIZE prefixLength;
   OSSIZE nameLength;
} OSXMLSortedAttrOffset;

#define OSXMLINDENT     3

#ifdef XML_UNICODE
#define rtXmlErrAddStrParm rtxErrAddUniStrParm
#else
#define rtXmlErrAddStrParm rtxErrAddStrParm
#endif

typedef enum {
   OSXMLWSM_PRESERVE = 0,
   OSXMLWSM_REPLACE,
   OSXMLWSM_COLLAPSE
} OSXMLWhiteSpaceMode;

#ifdef __cplusplus
extern "C" {
#endif

/* run-time XML function prototypes */

#ifndef rtXmlInitContext

EXTERNXML int rtXmlInitContext (OSCTXT* pctxt);
#endif

EXTERNXML int rtXmlInitContextUsingKey
(OSCTXT* pctxt, const OSOCTET* key, OSSIZE keylen);

EXTERNXML int rtXmlInitCtxtAppInfo (OSCTXT* pctxt);

EXTERNXML int rtXmlCreateFileInputSource (OSCTXT* pctxt, const char* filepath);

EXTERNXML OSBOOL rtXmlCmpQName
(const OSUTF8CHAR* qname1, const OSUTF8CHAR* name2, const OSUTF8CHAR* nsPrefix2);

EXTERNXML int rtXmlGetBase64StrDecodedLen
   (const OSUTF8CHAR* inpdata, OSSIZE srcDataSize,
    OSSIZE* pNumOcts, OSSIZE* pSrcDataLen);

EXTERNXML void rtXmlMemFreeAnyAttrs (OSCTXT* pctxt, OSRTDList* pAnyAttrList);

EXTERNXML int rtXmlDecBase64Binary (OSRTMEMBUF* pMemBuf,
                                    const OSUTF8CHAR* inpdata,
                                    OSSIZE length);

EXTERNXML int rtXmlDecBase64Str (OSCTXT* pctxt,
                                 OSOCTET* pvalue, OSUINT32* pnocts,
                                 OSINT32 bufsize);


EXTERNXML int rtXmlDecBase64Str64 (OSCTXT* pctxt,
                                 OSOCTET* pvalue, OSSIZE* pnocts,
                                 OSSIZE bufsize);


EXTERNXML int rtXmlDecBase64StrValue (OSCTXT* pctxt,
                                      OSOCTET* pvalue, OSUINT32* pnocts,
                                      OSSIZE bufSize, OSSIZE srcDataLen);


EXTERNXML int rtXmlDecBase64StrValue64 (OSCTXT* pctxt,
                                      OSOCTET* pvalue, OSSIZE* pnocts,
                                      OSSIZE bufSize, OSSIZE srcDataLen);

EXTERNXML int rtXmlDecBigInt
(OSCTXT* pctxt, const OSUTF8CHAR** ppvalue);

EXTERNXML int rtXmlDecBool (OSCTXT* pctxt, OSBOOL* pvalue);

EXTERNXML int rtXmlDecDate (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlDecTime (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlDecDateTime (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlDecDecimal (OSCTXT* pctxt, OSREAL* pvalue);

EXTERNXML int rtXmlDecDouble (OSCTXT* pctxt, OSREAL* pvalue);

EXTERNXML int rtXmlDecDynBase64Str (OSCTXT* pctxt, OSDynOctStr* pvalue);


EXTERNXML int rtXmlDecDynBase64Str64 (OSCTXT* pctxt, OSDynOctStr64* pvalue);


EXTERNXML int rtXmlDecDynHexStr (OSCTXT* pctxt, OSDynOctStr* pvalue);


EXTERNXML int rtXmlDecDynHexStr64 (OSCTXT* pctxt, OSDynOctStr64* pvalue);


EXTERNXML int rtXmlDecEmptyElement (OSCTXT* pctxt);

EXTERNXML int rtXmlDecUTF8Str
(OSCTXT* pctxt, OSUTF8CHAR* outdata, OSSIZE max_len);


EXTERNXML int rtXmlDecDynUTF8Str (OSCTXT* pctxt, const OSUTF8CHAR** outdata);

EXTERNXML int rtXmlDecHexBinary (OSRTMEMBUF* pMemBuf,
                                 const OSUTF8CHAR* inpdata,
                                 OSSIZE length);

EXTERNXML int rtXmlDecHexStr (OSCTXT* pctxt,
                              OSOCTET* pvalue, OSUINT32* pnocts,
                              OSINT32 bufsize);

EXTERNXML int rtXmlDecHexStr64 (OSCTXT* pctxt,
                              OSOCTET* pvalue, OSSIZE* pnocts,
                              OSSIZE bufsize);

EXTERNXML int rtXmlDecHexStrValue (OSCTXT* pctxt,
   const OSUTF8CHAR* const inpdata, OSSIZE nbytes, OSOCTET* pvalue,
   OSUINT32* pnbits, OSINT32 bufsize);

EXTERNXML int rtXmlDecHexStrValue64 (OSCTXT* pctxt,
   const OSUTF8CHAR* const inpdata, OSSIZE nbytes, OSOCTET* pvalue,
   OSSIZE* pnbits, OSSIZE bufsize);


EXTERNXML int rtXmlDecGYear (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlDecGYearMonth (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlDecGMonth (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlDecGMonthDay (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlDecGDay (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlDecInt (OSCTXT* pctxt, OSINT32* pvalue);

EXTERNXML int rtXmlDecInt8 (OSCTXT* pctxt, OSINT8* pvalue);

EXTERNXML int rtXmlDecInt16 (OSCTXT* pctxt, OSINT16* pvalue);

EXTERNXML int rtXmlDecInt64 (OSCTXT* pctxt, OSINT64* pvalue);

EXTERNXML int rtXmlDecUInt (OSCTXT* pctxt, OSUINT32* pvalue);

EXTERNXML int rtXmlDecUInt8 (OSCTXT* pctxt, OSUINT8* pvalue);

EXTERNXML int rtXmlDecUInt16 (OSCTXT* pctxt, OSUINT16* pvalue);

EXTERNXML int rtXmlDecUInt64 (OSCTXT* pctxt, OSUINT64* pvalue);

EXTERNXML int rtXmlDecNSAttr
(OSCTXT* pctxt, const OSUTF8CHAR* attrName, const OSUTF8CHAR* attrValue,
 OSRTDList* pNSAttrs, const OSUTF8CHAR* nsTable[], OSUINT32 nsTableRowCount);

EXTERNXML const OSUTF8CHAR* rtXmlDecQName
(OSCTXT* pctxt, const OSUTF8CHAR* qname, const OSUTF8CHAR** prefix);

EXTERNXML int rtXmlDecXSIAttr
   (OSCTXT* pctxt, const OSUTF8CHAR* attrName, const OSUTF8CHAR* attrValue);

EXTERNXML int rtXmlDecXSIAttrs (OSCTXT* pctxt, const OSUTF8CHAR* const* attrs,
   const char* typeName);

EXTERNXML int rtXmlDecXmlStr (OSCTXT* pctxt, OSXMLSTRING* outdata);

EXTERNXML int rtXmlParseElementName (OSCTXT* pctxt, OSUTF8CHAR** ppName);

EXTERNXML int rtXmlParseElemQName (OSCTXT* pctxt, OSXMLQName* pQName);

EXTERNXML int rtXmlEncAny (OSCTXT* pctxt, OSXMLSTRING* pvalue,
                           const OSUTF8CHAR* elemName,
                           OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncAnyStr
(OSCTXT* pctxt, const OSUTF8CHAR* pvalue,
 const OSUTF8CHAR* elemName, OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncAnyTypeValue (OSCTXT* pctxt, const OSUTF8CHAR* pvalue);

EXTERNXML int rtXmlEncAnyAttr (OSCTXT* pctxt, OSRTDList* pAnyAttrList);

EXTERNXML int rtXmlEncBase64Binary (OSCTXT* pctxt, OSSIZE nocts,
                                    const OSOCTET* value,
                                    const OSUTF8CHAR* elemName,
                                    OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncBase64BinaryAttr
   (OSCTXT* pctxt, OSUINT32 nocts, const OSOCTET* value,
    const OSUTF8CHAR* attrName, OSSIZE attrNameLen);

EXTERNXML int rtXmlEncBase64StrValue (OSCTXT* pctxt, OSSIZE nocts,
                                      const OSOCTET* value);


EXTERNXML int rtXmlEncBigInt (OSCTXT* pctxt, const OSUTF8CHAR* value,
                              const OSUTF8CHAR* elemName,
                              OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncBigIntAttr (OSCTXT* pctxt, const OSUTF8CHAR* value,
                       const OSUTF8CHAR* attrName, OSSIZE attrNameLen);

EXTERNXML int rtXmlEncBigIntValue (OSCTXT* pctxt, const OSUTF8CHAR* value);

EXTERNXML int rtXmlEncBitString (OSCTXT* pctxt, OSSIZE nbits,
                                 const OSOCTET* value,
                                 const OSUTF8CHAR* elemName,
                                 OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncBitStringExt (OSCTXT* pctxt, OSSIZE nbits,
                                    const OSOCTET* value,
                                    OSSIZE dataSize,
                                    const OSOCTET* extValue,
                                    const OSUTF8CHAR* elemName,
                                    OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncBinStrValue (OSCTXT* pctxt,
                                   OSSIZE nbits,
                                   const OSOCTET* data);

EXTERNXML int rtXmlEncBool (OSCTXT* pctxt, OSBOOL value,
                            const OSUTF8CHAR* elemName,
                            OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncBoolValue (OSCTXT* pctxt, OSBOOL value);

EXTERNXML int rtXmlEncBoolAttr (OSCTXT* pctxt, OSBOOL value,
                                const OSUTF8CHAR* attrName,
                                OSSIZE attrNameLen);

EXTERNXML int rtXmlEncCanonicalSort(OSCTXT* pctxt, OSCTXT* pBufCtxt,
                                    OSRTSList* pList);


EXTERNXML int rtXmlEncComment (OSCTXT* pctxt, const OSUTF8CHAR* comment);

EXTERNXML int rtXmlEncDate (OSCTXT* pctxt, const OSXSDDateTime* pvalue,
                            const OSUTF8CHAR* elemName,
                            OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncDateValue
   (OSCTXT* pctxt, const OSXSDDateTime* pvalue);

EXTERNXML int rtXmlEncTime (OSCTXT* pctxt, const OSXSDDateTime* pvalue,
                            const OSUTF8CHAR* elemName,
                            OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncTimeValue
   (OSCTXT* pctxt, const OSXSDDateTime* pvalue);

EXTERNXML int rtXmlEncDateTime (OSCTXT* pctxt, const OSXSDDateTime* pvalue,
                                const OSUTF8CHAR* elemName,
                                OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncDateTimeValue
   (OSCTXT* pctxt, const OSXSDDateTime* pvalue);

EXTERNXML int rtXmlEncDecimal (OSCTXT* pctxt, OSREAL value,
                               const OSUTF8CHAR* elemName,
                               OSXMLNamespace* pNS,
                               const OSDecimalFmt* pFmtSpec);

EXTERNXML int rtXmlEncDecimalAttr (OSCTXT* pctxt, OSREAL value,
                                   const OSUTF8CHAR* attrName,
                                   OSSIZE attrNameLen,
                                   const OSDecimalFmt* pFmtSpec);

EXTERNXML int rtXmlEncDecimalValue (OSCTXT* pctxt, OSREAL value,
                                    const OSDecimalFmt* pFmtSpec,
                                    char* pDestBuf, OSSIZE destBufSize);

EXTERNXML int rtXmlEncDouble (OSCTXT* pctxt, OSREAL value,
                              const OSUTF8CHAR* elemName,
                              OSXMLNamespace* pNS,
                              const OSDoubleFmt* pFmtSpec);

EXTERNXML int rtXmlEncDoubleAttr (OSCTXT* pctxt, OSREAL value,
                                  const OSUTF8CHAR* attrName,
                                  OSSIZE attrNameLen,
                                  const OSDoubleFmt* pFmtSpec);

EXTERNXML int rtXmlEncDoubleNormalValue (OSCTXT* pctxt, OSREAL value,
                                   const OSDoubleFmt* pFmtSpec,
                                   int defaultPrecision);

EXTERNXML int rtXmlEncDoubleValue (OSCTXT* pctxt, OSREAL value,
                                   const OSDoubleFmt* pFmtSpec,
                                   int defaultPrecision);

EXTERNXML int rtXmlEncEmptyElement (OSCTXT* pctxt,
                                    const OSUTF8CHAR* elemName,
                                    OSXMLNamespace* pNS,
                                    OSRTDList* pNSAttrs,
                                    OSBOOL terminate);

EXTERNXML int rtXmlEncEndDocument (OSCTXT* pctxt);

EXTERNXML int rtXmlEncEndElement (OSCTXT* pctxt,
                                  const OSUTF8CHAR* elemName,
                                  OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncEndSoapEnv (OSCTXT* pctxt);

EXTERNXML int rtXmlEncEndSoapElems (OSCTXT* pctxt, OSXMLSOAPMsgType msgtype);

EXTERNXML int rtXmlEncFloat (OSCTXT* pctxt, OSREAL value,
                             const OSUTF8CHAR* elemName,
                             OSXMLNamespace* pNS,
                             const OSDoubleFmt* pFmtSpec);

EXTERNXML int rtXmlEncFloatAttr (OSCTXT* pctxt, OSREAL value,
                                 const OSUTF8CHAR* attrName,
                                 OSSIZE attrNameLen,
                                 const OSDoubleFmt* pFmtSpec);

EXTERNXML int rtXmlEncGYear (OSCTXT* pctxt, const OSXSDDateTime* pvalue,
                             const OSUTF8CHAR* elemName,
                             OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncGYearMonth (OSCTXT* pctxt, const OSXSDDateTime* pvalue,
                                  const OSUTF8CHAR* elemName,
                                  OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncGMonth (OSCTXT* pctxt, const OSXSDDateTime* pvalue,
                              const OSUTF8CHAR* elemName,
                              OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncGMonthDay (OSCTXT* pctxt, const OSXSDDateTime* pvalue,
                                 const OSUTF8CHAR* elemName,
                                 OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncGDay (OSCTXT* pctxt, const OSXSDDateTime* pvalue,
                            const OSUTF8CHAR* elemName,
                            OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncGYearValue
   (OSCTXT* pctxt, const OSXSDDateTime* pvalue);

EXTERNXML int rtXmlEncGYearMonthValue
   (OSCTXT* pctxt, const OSXSDDateTime* pvalue);

EXTERNXML int rtXmlEncGMonthValue
   (OSCTXT* pctxt, const OSXSDDateTime* pvalue);

EXTERNXML int rtXmlEncGMonthDayValue
   (OSCTXT* pctxt, const OSXSDDateTime* pvalue);

EXTERNXML int rtXmlEncGDayValue
   (OSCTXT* pctxt, const OSXSDDateTime* pvalue);

EXTERNXML int rtXmlEncHexBinary (OSCTXT* pctxt, OSSIZE nocts,
                                 const OSOCTET* value,
                                 const OSUTF8CHAR* elemName,
                                 OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncHexBinaryAttr
   (OSCTXT* pctxt, OSUINT32 nocts, const OSOCTET* value,
    const OSUTF8CHAR* attrName, OSSIZE attrNameLen);

EXTERNXML int rtXmlEncHexStrValue (OSCTXT* pctxt,
                                   OSSIZE nocts,
                                   const OSOCTET* data);

EXTERNXML int rtXmlEncIndent (OSCTXT* pctxt);

EXTERNXML int rtXmlEncInt (OSCTXT* pctxt, OSINT32 value,
                           const OSUTF8CHAR* elemName,
                           OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncIntValue (OSCTXT* pctxt, OSINT32 value);

EXTERNXML int rtXmlEncIntAttr (OSCTXT* pctxt, OSINT32 value,
                               const OSUTF8CHAR* attrName,
                               OSSIZE attrNameLen);

EXTERNXML int rtXmlEncIntPattern (OSCTXT* pctxt, OSINT32 value,
                                  const OSUTF8CHAR* elemName,
                                  OSXMLNamespace* pNS,
                                  const OSUTF8CHAR* pattern);

EXTERNXML int rtXmlEncIntPatternValue (OSCTXT* pctxt, OSINT32 value,
                                       const OSUTF8CHAR* pattern);

EXTERNXML int rtXmlEncUIntPattern (OSCTXT* pctxt, OSUINT32 value,
                                  const OSUTF8CHAR* elemName,
                                  OSXMLNamespace* pNS,
                                  const OSUTF8CHAR* pattern);

EXTERNXML int rtXmlEncUIntPatternValue (OSCTXT* pctxt, OSUINT32 value,
                                       const OSUTF8CHAR* pattern);

EXTERNXML int rtXmlEncInt64 (OSCTXT* pctxt, OSINT64 value,
                             const OSUTF8CHAR* elemName,
                             OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncInt64Pattern (OSCTXT* pctxt, OSINT64 value,
                                    const OSUTF8CHAR* elemName,
                                    OSXMLNamespace* pNS,
                                    const OSUTF8CHAR* pattern);

EXTERNXML int rtXmlEncInt64Value (OSCTXT* pctxt, OSINT64 value);
EXTERNXML int rtXmlEncInt64PatternValue (OSCTXT* pctxt, OSINT64 value,
                                         const OSUTF8CHAR* pattern);

EXTERNXML int rtXmlEncInt64Attr (OSCTXT* pctxt, OSINT64 value,
                                 const OSUTF8CHAR* attrName,
                                 OSSIZE attrNameLen);

EXTERNXML int rtXmlEncNamedBits
(OSCTXT* pctxt, const OSBitMapItem* pBitMap, OSSIZE nbits,
 const OSOCTET* pvalue, const OSUTF8CHAR* elemName, OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncNamedBitsValue
(OSCTXT* pctxt, const OSBitMapItem* pBitMap, OSSIZE nbits,
 const OSOCTET* pvalue);

EXTERNXML int rtXmlEncNSAttrs (OSCTXT* pctxt, OSRTDList* pNSAttrs);

EXTERNXML int rtXmlPrintNSAttrs (const char* name, const OSRTDList* data);

/* The following is required for backward compatibility */
#define rtxPrintNSAttrs(name,data) rtXmlPrintNSAttrs(name,&data)

EXTERNXML int rtXmlEncReal10
(OSCTXT *pctxt, const OSUTF8CHAR *pvalue, const OSUTF8CHAR* elemName,
 OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncSoapArrayTypeAttr
(OSCTXT* pctxt, const OSUTF8CHAR* name, const OSUTF8CHAR* value,
 OSSIZE itemCount);

EXTERNXML int rtXmlEncSoapArrayTypeAttr2
(OSCTXT* pctxt, const OSUTF8CHAR* name, OSSIZE nameLen,
 const OSUTF8CHAR* value, OSSIZE valueLen, OSSIZE itemCount);

EXTERNXML int rtXmlEncStartDocument (OSCTXT* pctxt);

EXTERNXML int rtXmlEncBOM (OSCTXT* pctxt);
EXTERNXML int rtXmlEncStartElement (OSCTXT* pctxt,
                                    const OSUTF8CHAR* elemName,
                                    OSXMLNamespace* pNS,
                                    OSRTDList* pNSAttrs,
                                    OSBOOL terminate);

EXTERNXML int rtXmlEncStartSoapEnv (OSCTXT* pctxt, OSRTDList* pNSAttrs);

EXTERNXML int rtXmlEncStartSoapElems
(OSCTXT* pctxt, OSXMLSOAPMsgType msgtype);

EXTERNXML int rtXmlEncString (OSCTXT* pctxt,
                              OSXMLSTRING* pxmlstr,
                              const OSUTF8CHAR* elemName,
                              OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncStringValue (OSCTXT* pctxt, const OSUTF8CHAR* value);

EXTERNXML int rtXmlEncStringValue2
   (OSCTXT* pctxt, const OSUTF8CHAR* value, OSSIZE valueLen);

EXTERNXML int rtXmlEncTermStartElement (OSCTXT* pctxt);

EXTERNXML int rtXmlEncUnicodeStr (OSCTXT* pctxt,
                                  const OSUNICHAR* value,
                                  OSSIZE nchars,
                                  const OSUTF8CHAR* elemName,
                                  OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncUTF8Attr (OSCTXT* pctxt,
                                const OSUTF8CHAR* name,
                                const OSUTF8CHAR* value);

EXTERNXML int rtXmlEncUTF8Attr2 (OSCTXT* pctxt,
                                 const OSUTF8CHAR* name, OSSIZE nameLen,
                                 const OSUTF8CHAR* value, OSSIZE valueLen);

EXTERNXML int rtXmlEncUTF8Str (OSCTXT* pctxt,
                               const OSUTF8CHAR* value,
                               const OSUTF8CHAR* elemName,
                               OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncUInt (OSCTXT* pctxt, OSUINT32 value,
                            const OSUTF8CHAR* elemName,
                            OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncUIntValue (OSCTXT* pctxt, OSUINT32 value);

EXTERNXML int rtXmlEncUIntAttr (OSCTXT* pctxt, OSUINT32 value,
                                const OSUTF8CHAR* attrName,
                                OSSIZE attrNameLen);

EXTERNXML int rtXmlEncUInt64 (OSCTXT* pctxt, OSUINT64 value,
                              const OSUTF8CHAR* elemName,
                              OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncUInt64Pattern (OSCTXT* pctxt, OSUINT64 value,
                                     const OSUTF8CHAR* elemName,
                                     OSXMLNamespace* pNS,
                                     const OSUTF8CHAR* pattern);

EXTERNXML int rtXmlEncUInt64Value (OSCTXT* pctxt, OSUINT64 value);
EXTERNXML int rtXmlEncUInt64PatternValue (OSCTXT* pctxt, OSUINT64 value,
                                          const OSUTF8CHAR* pattern);

EXTERNXML int rtXmlEncUInt64Attr (OSCTXT* pctxt, OSUINT64 value,
                                  const OSUTF8CHAR* attrName,
                                  OSSIZE attrNameLen);

EXTERNXML int rtXmlEncXSIAttrs (OSCTXT* pctxt, OSBOOL needXSI);

EXTERNXML int rtXmlEncXSITypeAttr (OSCTXT* pctxt, const OSUTF8CHAR* value);

EXTERNXML int rtXmlEncXSITypeAttr2 (OSCTXT* pctxt,
                                    const OSUTF8CHAR* typeNsUri,
                                    const OSUTF8CHAR* typeName);

EXTERNXML int rtXmlEncXSINilAttr (OSCTXT* pctxt);

EXTERNXML int rtXmlFreeInputSource (OSCTXT* pctxt);

EXTERNXML OSBOOL rtXmlStrCmpAsc (const OSUTF8CHAR* text1, const char* text2);

EXTERNXML OSBOOL rtXmlStrnCmpAsc (const OSUTF8CHAR* text1,
                                  const char* text2, OSSIZE len);

#define rtXmlFinalizeMemBuf(pMemBuf) do { \
(pMemBuf)->pctxt->buffer.data = (pMemBuf)->buffer + (pMemBuf)->startidx; \
(pMemBuf)->pctxt->buffer.size =                                      \
((pMemBuf)->usedcnt - (pMemBuf)->startidx);                          \
(pMemBuf)->pctxt->buffer.dynamic = FALSE;                            \
(pMemBuf)->pctxt->buffer.byteIndex = 0;                              \
rtxMemBufReset (pMemBuf);                                            \
} while(0)

EXTERNXML int rtXmlSetEncBufPtr
(OSCTXT* pctxt, OSOCTET* bufaddr, OSSIZE bufsiz);

#define rtXmlGetEncBufPtr(pctxt) (pctxt)->buffer.data

#define rtXmlGetEncBufLen(pctxt) (pctxt)->buffer.byteIndex


EXTERNXML int rtXmlGetIndent (OSCTXT* pctxt);


EXTERNXML OSBOOL rtXmlGetWriteBOM (OSCTXT* pctxt);

EXTERNXML int rtXmlGetIndentChar (OSCTXT* pctxt);
EXTERNXML int rtXmlPrepareContext (OSCTXT* pctxt);

EXTERNXML int rtXmlSetEncC14N (OSCTXT* pctxt, OSBOOL value);

EXTERNXML int rtXmlSetEncXSINamespace (OSCTXT* pctxt, OSBOOL value);

EXTERNXML int rtXmlSetEncXSINilAttr (OSCTXT* pctxt, OSBOOL value);

EXTERNXML int rtXmlSetDigitsFacets
   (OSCTXT* pctxt, int totalDigits, int fractionDigits);

EXTERNXML int rtXmlSetEncDocHdr (OSCTXT* pctxt, OSBOOL value);

EXTERNXML int rtXmlSetEncodingStr
(OSCTXT* pctxt, const OSUTF8CHAR* encodingStr);

EXTERNXML int rtXmlSetFormatting (OSCTXT* pctxt, OSBOOL doFormatting);

EXTERNXML int rtXmlSetIndent (OSCTXT* pctxt, OSUINT8 indent);

EXTERNXML int rtXmlSetIndentChar (OSCTXT* pctxt, char indentChar);

EXTERNXML void rtXmlSetNamespacesSet (OSCTXT* pctxt, OSBOOL value);

EXTERNXML int rtXmlSetNSPrefixLinks (OSCTXT* pctxt, OSRTDList* pNSAttrs);

EXTERNXML int rtXmlSetSchemaLocation
(OSCTXT* pctxt, const OSUTF8CHAR* schemaLocation);

EXTERNXML int rtXmlSetNoNSSchemaLocation
(OSCTXT* pctxt, const OSUTF8CHAR* schemaLocation);

EXTERNXML void rtXmlSetSoapVersion (OSCTXT* pctxt, OSUINT8 version);

EXTERNXML int rtXmlSetXSITypeAttr (OSCTXT* pctxt, const OSUTF8CHAR* xsiType);

EXTERNXML int rtXmlSetWriteBOM (OSCTXT* pctxt, OSBOOL write);

#include "rtxmlsrc/rtXmlNamespace.h"

EXTERNXML int rtXmlMatchHexStr
(OSCTXT* pctxt, OSSIZE minLength, OSSIZE maxLength);

EXTERNXML int rtXmlMatchBase64Str
(OSCTXT* pctxt, OSSIZE minLength, OSSIZE maxLength);

EXTERNXML int rtXmlMatchDate (OSCTXT* pctxt);

EXTERNXML int rtXmlMatchTime (OSCTXT* pctxt);

EXTERNXML int rtXmlMatchDateTime (OSCTXT* pctxt);

EXTERNXML int rtXmlMatchGYear (OSCTXT* pctxt);

EXTERNXML int rtXmlMatchGYearMonth (OSCTXT* pctxt);

EXTERNXML int rtXmlMatchGMonth (OSCTXT* pctxt);

EXTERNXML int rtXmlMatchGMonthDay (OSCTXT* pctxt);

EXTERNXML int rtXmlMatchGDay (OSCTXT* pctxt);

EXTERNXML OSUTF8CHAR* rtXmlNewQName
(OSCTXT* pctxt, const OSUTF8CHAR* localName, const OSUTF8CHAR* prefix);

EXTERNXML OSBOOL rtXmlCmpBase64Str (OSUINT32 nocts1,
                                    const OSOCTET* data1,
                                    const OSUTF8CHAR* data2);

EXTERNXML OSBOOL rtXmlCmpHexStr (OSUINT32 nocts1,
                                 const OSOCTET* data1,
                                 const OSUTF8CHAR* data2);

EXTERNXML OSBOOL rtXmlCmpHexChar (OSUTF8CHAR ch, OSOCTET hexval);

EXTERNXML int rtSaxGetAttributeID (const OSUTF8CHAR* attrName,
                                   OSSIZE nAttr,
                                   const OSUTF8CHAR* attrNames[],
                                   OSUINT32 attrPresent[]);

EXTERNXML const OSUTF8CHAR* rtSaxGetAttrValue
(const OSUTF8CHAR* attrName, const OSUTF8CHAR* const* attrs);

EXTERNXML OSINT16 rtSaxGetElemID
(OSINT16* pState, OSINT16 prevElemIdx, const OSUTF8CHAR* localName,
#ifdef OSXMLNS12
 OSINT32 nsidx, /* namespace index */
#endif
const OSSAXElemTableRec idtab[], const OSINT16* fstab,
 OSINT16 fstabRows, OSINT16 fstabCols);

EXTERNXML OSINT16 rtSaxGetElemID8
(OSINT16* pState, OSINT16 prevElemIdx, const OSUTF8CHAR* localName,
#ifdef OSXMLNS12
 OSINT32 nsidx, /* namespace index */
#endif
 const OSSAXElemTableRec idtab[], const OSINT8* fstab,
 OSINT16 fstabRows, OSINT16 fstabCols);

EXTERNXML OSINT16 rtSaxFindElemID
(OSINT16* pState, OSINT16 prevElemIdx, const OSUTF8CHAR* localName,
#ifdef OSXMLNS12
 OSINT32 nsidx, /* namespace index */
#endif
 const OSSAXElemTableRec idtab[], const OSINT16* fstab,
 OSINT16 fstabRows, OSINT16 fstabCols);

EXTERNXML OSINT16 rtSaxFindElemID8
(OSINT16* pState, OSINT16 prevElemIdx, const OSUTF8CHAR* localName,
#ifdef OSXMLNS12
 OSINT32 nsidx, /* namespace index */
#endif
 const OSSAXElemTableRec idtab[], const OSINT8* fstab,
 OSINT16 fstabRows, OSINT16 fstabCols);

EXTERNXML OSBOOL rtSaxHasXMLNSAttrs (const OSUTF8CHAR* const* attrs);

EXTERNXML OSBOOL rtSaxIsEmptyBuffer (OSCTXT* pctxt);

EXTERNXML OSINT16 rtSaxLookupElemID
(OSCTXT* pctxt, OSINT16* pState, OSINT16 prevElemIdx,
 const OSUTF8CHAR* localName, const OSUTF8CHAR* qName,
#ifdef OSXMLNS12
 OSINT32 nsidx, /* namespace index */
#endif
 const OSSAXElemTableRec idtab[], const OSINT16* fstab,
 OSINT16 fstabRows, OSINT16 fstabCols);

EXTERNXML OSINT16 rtSaxLookupElemID8
(OSCTXT* pctxt, OSINT16* pState, OSINT16 prevElemIdx,
 const OSUTF8CHAR* localName, const OSUTF8CHAR* qName,
#ifdef OSXMLNS12
 OSINT32 nsidx, /* namespace index */
#endif
 const OSSAXElemTableRec idtab[], const OSINT8* fstab,
 OSINT16 fstabRows, OSINT16 fstabCols);

EXTERNXML int rtSaxStrListParse
(OSCTXT* pctxt, OSRTMEMBUF *pMemBuf, OSRTDList* pvalue);

EXTERNXML int rtSaxSortAttrs
(OSCTXT* pctxt, const OSUTF8CHAR* const* attrs, OSUINT16** order);

EXTERNXML int rtSaxStrListMatch (OSCTXT* pctxt);

EXTERNXML OSBOOL rtSaxTestFinal (OSINT16 state,
                                 OSINT16 currElemIdx,
                                 const int* fstab,
                                 int fstabRows, int fstabCols);

EXTERNXML OSBOOL rtSaxTestFinal8 (OSINT16 state,
                                  OSINT16 currElemIdx,
                                  const OSINT8* fstab,
                                 int fstabRows, int fstabCols);

EXTERNXML int rtSaxSetSkipLevelToCurrent (OSCTXT* pctxt, int stat);

EXTERNXML OSUINT32 rtSaxSetMaxErrors (OSCTXT* pctxt, OSUINT32 maxErrors);

EXTERNXML OSUINT32 rtSaxGetMaxErrors (OSCTXT* pctxt);

EXTERNXML int rtSaxTestAttributesPresent (OSCTXT* pctxt,
   const OSUINT32* attrPresent, const OSUINT32* reqAttrMask,
   const OSUTF8CHAR* const* attrNames, OSSIZE numOfAttrs,
   const char* parentTypeName);

EXTERNXML OSBOOL rtSaxIncErrors (OSCTXT* pctxt);

EXTERNXML int rtSaxReportUnexpAttrs (OSCTXT* pctxt,
    const OSUTF8CHAR* const* attrs,
    const char* typeName);

EXTERNXML int rtXmlWriteToFile (OSCTXT* pctxt, const char* filename);

EXTERNXML int rtXmlWriteUTF16ToFile (OSCTXT* pctxt, const char* filename);

EXTERNXML void rtXmlTreatWhitespaces (OSCTXT* pctxt, int whiteSpaceType);

EXTERNXML int rtXmlCheckBuffer (OSCTXT* pctxt, OSSIZE byte_count);

EXTERNXML void rtErrXmlInit (OSVOIDARG);
EXTERNXML int rtXmlPutChar (OSCTXT* pctxt, const OSUTF8CHAR value);
EXTERNXML int rtXmlWriteChars
(OSCTXT* pctxt, const OSUTF8CHAR* value, OSSIZE len);

EXTERNXML int rtXmlpDecAny (OSCTXT* pctxt, const OSUTF8CHAR** pvalue);

EXTERNXML int rtXmlpDecAny2 (OSCTXT* pctxt, OSUTF8CHAR** pvalue);

EXTERNXML int rtXmlpDecAnyAttrStr
(OSCTXT* pctxt, const OSUTF8CHAR** ppAttrStr, OSSIZE attrIndex);

EXTERNXML int rtXmlpDecAnyElem (OSCTXT* pctxt, const OSUTF8CHAR** pvalue);

EXTERNXML int rtXmlpDecBase64Str
(OSCTXT* pctxt, OSOCTET* pvalue, OSUINT32* pnocts, OSSIZE bufsize);


EXTERNXML int rtXmlpDecBase64Str64
(OSCTXT* pctxt, OSOCTET* pvalue, OSSIZE* pnocts, OSSIZE bufsize);


EXTERNXML int rtXmlpDecBigInt (OSCTXT* pctxt, const OSUTF8CHAR** pvalue);

EXTERNXML int rtXmlpDecBitString
(OSCTXT* pctxt, OSOCTET* pvalue, OSUINT32* pnbits, OSUINT32 bufsize);

EXTERNXML int rtXmlpDecBitString64
(OSCTXT* pctxt, OSOCTET* pvalue, OSSIZE* pnbits, OSSIZE bufsize);

EXTERNXML int rtXmlpDecBitStringExt(OSCTXT* pctxt, OSOCTET* pvalue,
      OSUINT32* pnbits, OSOCTET** ppextdata, OSUINT32 bufsize);

EXTERNXML int rtXmlpDecBitStringExt64(OSCTXT* pctxt, OSOCTET* pvalue,
      OSSIZE* pnbits, OSOCTET** ppextdata, OSSIZE bufsize);

EXTERNXML int rtXmlpDecBool (OSCTXT* pctxt, OSBOOL* pvalue);

EXTERNXML int rtXmlpDecDate (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlpDecDateTime (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlpDecDecimal (OSCTXT* pctxt, OSREAL* pvalue,
   int totalDigits, int fractionDigits);

EXTERNXML int rtXmlpDecDouble (OSCTXT* pctxt, OSREAL* pvalue);

#define OSXMLREALENC_OBJSYS 0x1F   /* Obj-Sys XML encoding rules */
#define OSXMLREALENC_BXER 0x10     /* basic-XER */
#define OSXMLREALENC_EXERMODS 0x1B /* extended-XER with MODIFIED-ENCODINGS */
#define OSXMLREALENC_EXERDECIMAL 0x03 /* extended-XER with DECIMAL */

EXTERNXML int rtXmlpDecDoubleExt (OSCTXT* pctxt, OSUINT8 flags,
                                       OSREAL* pvalue);


EXTERNXML int rtXmlpDecDynBase64Str (OSCTXT* pctxt, OSDynOctStr* pvalue);


EXTERNXML int rtXmlpDecDynBase64Str64 (OSCTXT* pctxt, OSDynOctStr64* pvalue);

EXTERNXML int rtXmlpDecDynBitString (OSCTXT* pctxt, OSDynOctStr* pvalue);

EXTERNXML int rtXmlpDecDynHexStr (OSCTXT* pctxt, OSDynOctStr* pvalue);

EXTERNXML int rtXmlpDecDynHexStr64 (OSCTXT* pctxt, OSDynOctStr64* pvalue);

EXTERNXML int rtXmlpDecDynUnicodeStr
(OSCTXT* pctxt, const OSUNICHAR** ppdata, OSSIZE* pnchars);

EXTERNXML int rtXmlpDecDynUTF8Str (OSCTXT* pctxt, const OSUTF8CHAR** outdata);


EXTERNXML int rtXmlpDecUTF8Str
(OSCTXT* pctxt, OSUTF8CHAR* out, OSSIZE max_len);

EXTERNXML int rtXmlpDecGDay (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlpDecGMonth (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlpDecGMonthDay (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlpDecGYear (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlpDecGYearMonth (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlpDecHexStr
(OSCTXT* pctxt, OSOCTET* pvalue, OSUINT32* pnocts, OSSIZE bufsize);

EXTERNXML int rtXmlpDecHexStr64
(OSCTXT* pctxt, OSOCTET* pvalue, OSSIZE* pnocts, OSSIZE bufsize);

EXTERNXML int rtXmlpDecInt (OSCTXT* pctxt, OSINT32* pvalue);

EXTERNXML int rtXmlpDecInt8 (OSCTXT* pctxt, OSINT8* pvalue);

EXTERNXML int rtXmlpDecInt16 (OSCTXT* pctxt, OSINT16* pvalue);

EXTERNXML int rtXmlpDecInt64 (OSCTXT* pctxt, OSINT64* pvalue);

EXTERNXML int rtXmlpDecNamedBits
(OSCTXT* pctxt, const OSBitMapItem* pBitMap,
 OSOCTET* pvalue, OSUINT32* pnbits, OSUINT32 bufsize);

EXTERNXML int rtXmlpDecNamedBits64
(OSCTXT* pctxt, const OSBitMapItem* pBitMap,
 OSOCTET* pvalue, OSSIZE* pnbits, OSSIZE bufsize);

EXTERNXML int rtXmlpDecStrList (OSCTXT* pctxt, OSRTDList* plist);

EXTERNXML int rtXmlpDecTime (OSCTXT* pctxt, OSXSDDateTime* pvalue);

EXTERNXML int rtXmlpDecUInt (OSCTXT* pctxt, OSUINT32* pvalue);

EXTERNXML int rtXmlpDecUInt8 (OSCTXT* pctxt, OSOCTET* pvalue);

EXTERNXML int rtXmlpDecUInt16 (OSCTXT* pctxt, OSUINT16* pvalue);

EXTERNXML int rtXmlpDecUInt64 (OSCTXT* pctxt, OSUINT64* pvalue);

#if defined OSSIZE_IS_32BITS
   #define rtXmlpDecSize(pctxt, pvalue) rtXmlpDecUInt(pctxt, pvalue)
#elif defined OSSIZE_IS_64BITS
   #define rtXmlpDecSize(pctxt, pvalue) rtXmlpDecUInt64(pctxt, pvalue)
#endif

EXTERNXML int rtXmlpDecXmlStr (OSCTXT* pctxt, OSXMLSTRING* outdata);

EXTERNXML int rtXmlpDecXmlStrList (OSCTXT* pctxt, OSRTDList* plist);

EXTERNXML int rtXmlpDecXSIAttr
(OSCTXT* pctxt, const OSXMLNameFragments* attrName);

EXTERNXML int rtXmlpDecXSITypeAttr
(OSCTXT* pctxt, const OSXMLNameFragments* attrName,
 const OSUTF8CHAR** ppAttrValue);

EXTERNXML int rtXmlpGetAttributeID
(const OSXMLStrFragment* attrName, OSINT16 nsidx,
 OSSIZE nAttr, const OSXMLAttrDescr attrNames[], OSUINT32 attrPresent[]);

EXTERNXML int rtXmlpGetNextElem
(OSCTXT* pctxt, OSXMLElemDescr* pElem, OSINT32 level);

EXTERNXML int rtXmlpGetNextElemID
(OSCTXT* pctxt, const OSXMLElemIDRec* tab, OSSIZE nrows, OSINT32 level,
 OSBOOL continueParse);

EXTERNXML int rtXmlpMarkLastEventActive (OSCTXT* pctxt);

EXTERNXML int rtXmlpMatchStartTag
   (OSCTXT* pctxt, const OSUTF8CHAR* elemLocalName, OSINT16 nsidx);

EXTERNXML int rtXmlpMatchEndTag (OSCTXT* pctxt, OSINT32 level);

EXTERNXML OSBOOL rtXmlpHasAttributes (OSCTXT* pctxt);

EXTERNXML int rtXmlpGetAttributeCount (OSCTXT* pctxt);

EXTERNXML int rtXmlpSelectAttribute
(OSCTXT* pctxt, OSXMLNameFragments* pAttr,  OSINT16* nsidx, OSSIZE attrIndex);

EXTERNXML OSINT32 rtXmlpGetCurrentLevel (OSCTXT* pctxt);

EXTERNXML void rtXmlpSetWhiteSpaceMode
   (OSCTXT* pctxt, OSXMLWhiteSpaceMode whiteSpaceMode);

EXTERNXML OSBOOL rtXmlpSetMixedContentMode
   (OSCTXT* pctxt, OSBOOL mixedContentMode);

EXTERNXML void rtXmlpSetListMode (OSCTXT* pctxt);

EXTERNXML OSBOOL rtXmlpListHasItem (OSCTXT* pctxt);

EXTERNXML void rtXmlpCountListItems (OSCTXT* pctxt, OSSIZE* itemCnt);

EXTERNXML int rtXmlpGetNextSeqElemID2
(OSCTXT* pctxt, const OSXMLElemIDRec* tab, const OSXMLGroupDesc* pGroup,
 int groups, int curID, int lastMandatoryID, OSBOOL groupMode,
 OSBOOL checkRepeat);

EXTERNXML int rtXmlpGetNextSeqElemID
(OSCTXT* pctxt, const OSXMLElemIDRec* tab, const OSXMLGroupDesc* pGroup,
 int curID, int lastMandatoryID, OSBOOL groupMode);

EXTERNXML int rtXmlpGetNextSeqElemIDExt
(OSCTXT* pctxt, const OSXMLElemIDRec* tab, const OSXMLGroupDesc* ppGroup,
 const OSBOOL* extRequired, int postExtRootID,
 int curID, int lastMandatoryID, OSBOOL groupMode);


EXTERNXML int rtXmlpGetNextAllElemID
(OSCTXT* pctxt, const OSXMLElemIDRec* tab, OSSIZE nrows,
 const OSUINT8* pOrder, OSSIZE nOrder, OSSIZE maxOrder, int anyID);

EXTERNXML int rtXmlpGetNextAllElemID16
(OSCTXT* pctxt, const OSXMLElemIDRec* tab, OSSIZE nrows,
 const OSUINT16* pOrder, OSSIZE nOrder, OSSIZE maxOrder, int anyID);


EXTERNXML int rtXmlpGetNextAllElemID32
(OSCTXT* pctxt, const OSXMLElemIDRec* tab, OSSIZE nrows,
 const OSUINT32* pOrder, OSSIZE nOrder, OSSIZE maxOrder, int anyID);


EXTERNXML void rtXmlpSetNamespaceTable
(OSCTXT* pctxt, const OSUTF8CHAR* namespaceTable[], OSSIZE nmNamespaces);

EXTERNXML int rtXmlpCreateReader (OSCTXT* pctxt);

EXTERNXML void rtXmlpHideAttributes (OSCTXT* pctxt);

EXTERNXML OSBOOL rtXmlpNeedDecodeAttributes (OSCTXT* pctxt);

EXTERNXML void rtXmlpMarkPos (OSCTXT* pctxt);

EXTERNXML void rtXmlpRewindToMarkedPos (OSCTXT* pctxt);

EXTERNXML void rtXmlpResetMarkedPos (OSCTXT* pctxt);

EXTERNXML int rtXmlpGetXSITypeAttr
(OSCTXT* pctxt, const OSUTF8CHAR** ppAttrValue, OSINT16* nsidx,
 OSSIZE* pLocalOffs);

EXTERNXML int rtXmlpGetXmlnsAttrs (OSCTXT* pctxt, OSRTDList* pNSAttrs);

EXTERNXML int rtXmlpDecXSIAttrs (OSCTXT* pctxt);

EXTERNXML OSBOOL rtXmlpIsEmptyElement (OSCTXT* pctxt);

EXTERNXML int rtXmlEncAttrC14N (OSCTXT* pctxt);

EXTERNXML struct OSXMLReader* rtXmlpGetReader (OSCTXT* pctxt);

EXTERNXML OSBOOL rtXmlpIsLastEventDone (OSCTXT* pctxt);

EXTERNXML int rtXmlpGetXSITypeIndex
(OSCTXT* pctxt, const OSXMLItemDescr typetab[], OSSIZE typetabsiz);

EXTERNXML int rtXmlpLookupXSITypeIndex
(OSCTXT* pctxt, const OSUTF8CHAR* pXsiType, OSINT16 xsiTypeIdx,
 const OSXMLItemDescr typetab[], OSSIZE typetabsiz);

EXTERNXML void rtXmlpForceDecodeAsGroup (OSCTXT* pctxt);

EXTERNXML OSBOOL rtXmlpIsDecodeAsGroup (OSCTXT* pctxt);

EXTERNXML OSBOOL rtXmlpIsUTF8Encoding (OSCTXT* pctxt);

EXTERNXML int rtXmlpReadBytes (OSCTXT* pctxt, OSOCTET* pbuf, OSSIZE nbytes);

#ifdef __cplusplus
}
#endif

#endif