Site Map | Careers | Contact Us

• PRODUCTS
• SUPPORT
• RESOURCES

• PARTNERS
• CUSTOMERS
• ABOUT US

Home > Support > Documentation

osrtxml.h

Go to the documentation of this file.

/*
 * Copyright (C) 2003-2007 by 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

#ifdef BUILDXMLDLL
#define EXTERNXML __declspec(dllexport)
#elif defined (USEXMLDLL)
#define EXTERNXML __declspec(dllimport)
#else
#define EXTERNXML
#endif /* BUILDXMLDLL */

#include "rtxsrc/rtxCommon.h"
#include "rtxmlsrc/rtSaxDefs.h"
#include "rtxsrc/rtxDList.h"
#include "rtxsrc/rtxMemBuf.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     */

typedef enum { 
   OSXMLUTF8, 
   OSXMLUTF16
} OSXMLEncoding;

typedef enum { 
   OSSOAPNONE, OSSOAPBODY, OSSOAPFAULT
} OSXMLSOAPMsgType;

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

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

typedef struct {
   const OSUTF8CHAR* value;
   size_t 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 {
   int row;
   int num;
   int anyCase;
} OSXMLGroupDesc;

#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), \
OSCRTLSTRLEN ((const char*)str))

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

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

/*
 * 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       */
   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 (' ')  */
   OSOCTET spare;               /* for 32-bit field alignment           */
   OSXMLFacets facets;
   const OSUTF8CHAR* encodingStr;/* name of encoding ("UTF-8", "ISO-...")*/
   OSXMLBOM byteOrderMark;   
   struct OSXMLReader* pXmlPPReader; /* pull-parser reader object       */
} OSXMLCtxtInfo;

typedef enum { 
   OSXMLINIT, 
   OSXMLHEADER, 
   OSXMLSTART, 
   OSXMLATTR,
   OSXMLDATA, 
   OSXMLEND
} 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 OSDecimalFmt {
   OSINT8 totalDigits;        /* total significiant digits */
   OSINT8 fractionDigits;     /* maximum signficiant digits in fraction, 
                                 precision */
   OSINT8 fractionMinDigits;  /* minimum digits in fraction, if 
                                 fraction digits less than this value 
                                 trailing zeros will be added. */
   OSINT8 integerMaxDigits;   /* Maximum digits in integer part; if it is 0 
                                 and integer part is 0 then integer part 
                                 will be omitted, like .3, or -.3 */
   OSINT8 integerMinDigits;   /* Minimum digits in integer part, leading zeros
                                 will be added if necessary. */
   OSBOOL signPresent;        /* Indicates, sign must present, even if value 
                                 is positive. */
   OSBOOL pointPresent;       /* Indicates, decimal point must present, even 
                                 if value's fraction is 0 */
   OSUINT8 nPatterns;         /* number of patterns stored in 'patterns' */
   const char* const* patterns; /* patterns, used to verify value format is 
                                 correct */
} OSDecimalFmt;

typedef struct OSDoubleFmt {
   OSINT8 totalDigits;        /* total significiant digits */
   OSINT8 fractionDigits;     /* maximum signficiant digits in fraction, 
                                 precision */
   OSINT8 fractionMinDigits;  /* minimum digits in fraction, if 
                                 fraction digits less than this value 
                                 trailing zeros will be added. */
   OSINT8 integerMaxDigits;   /* Maximum digits in integer part; if it is 0 
                                 and integer part is 0 then integer part 
                                 will be omitted, like .3, or -.3 */
   OSINT8 integerMinDigits;   /* Minimum digits in integer part, leading zeros
                                 will be added if necessary. */
   OSINT8 expSymbol;          /* 'E' or 'e' only; 0 if no exp is expected, 
                                 -1 - default ('E') */
   OSINT16 expMinValue;       /* Minimum exponent value. By default - -infinity */
   OSINT16 expMaxValue;       /* Maximum exponent value. By default - infinity */
   OSINT8 expDigits;          /* Total digits in exponent part; if exponent's
                                 value is not enough, trailing zeros will be
                                 added */
   OSBOOL signPresent;        /* Indicates, sign must present, even if value 
                                 is positive. */
   OSBOOL pointPresent;       /* Indicates, decimal point must present, even 
                                 if value's fraction is 0 */
   OSBOOL expPresent;         /* Indicates, exponent must present, even 
                                 if its value is 0 */
   OSBOOL expSignPresent;     /* Indicates, exponent sign must present, even 
                                 if its value is > 0 */
} OSDoubleFmt;

#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 */

EXTERNXML int rtXmlInitContext (OSCTXT* pctxt);

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, size_t srcDataSize, 
    size_t* pNumOcts, size_t* pSrcDataLen);

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

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

EXTERNXML int rtXmlDecBase64StrValue (OSCTXT* pctxt, 
                                      OSOCTET* pvalue, OSUINT32* pnocts, 
                                      size_t bufSize, size_t 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 rtXmlDecDynHexStr (OSCTXT* pctxt, OSDynOctStr* pvalue);

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


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

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

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

EXTERNXML int rtXmlDecHexStrValue (OSCTXT* pctxt,
   const OSUTF8CHAR* const inpdata, size_t nbytes, OSOCTET* pvalue, 
   OSUINT32* pnbits, OSINT32 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 rtXmlEncAnyAttr (OSCTXT* pctxt, OSRTDList* pAnyAttrList);

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

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

EXTERNXML int rtXmlEncBase64StrValue (OSCTXT* pctxt, OSUINT32 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, size_t attrNameLen);

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

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

EXTERNXML int rtXmlEncBinStrValue (OSCTXT* pctxt, 
                                   OSUINT32 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, 
                                size_t attrNameLen);

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, 
                                   size_t attrNameLen,
                                   const OSDecimalFmt* pFmtSpec);

EXTERNXML int rtXmlEncDecimalValue (OSCTXT* pctxt, OSREAL value,
                                    const OSDecimalFmt* pFmtSpec,
                                    char* pDestBuf, size_t 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, 
                                  size_t attrNameLen,
                                  const OSDoubleFmt* pFmtSpec);

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, 
                                 size_t 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, OSUINT32 nocts, 
                                 const OSOCTET* value, 
                                 const OSUTF8CHAR* elemName, 
                                 OSXMLNamespace* pNS);

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

EXTERNXML int rtXmlEncHexStrValue (OSCTXT* pctxt, 
                                   OSUINT32 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, 
                               size_t 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 rtXmlEncInt64 (OSCTXT* pctxt, OSINT64 value, 
                             const OSUTF8CHAR* elemName, 
                             OSXMLNamespace* pNS);

EXTERNXML int rtXmlEncInt64Value (OSCTXT* pctxt, OSINT64 value);

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

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

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

#ifndef OSXMLNS12
EXTERNXML int rtXmlEncNSAttrs (OSCTXT* pctxt);
#else
EXTERNXML int rtXmlEncNSAttrs (OSCTXT* pctxt, OSRTDList* pNSAttrs);
#endif

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

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

EXTERNXML int rtXmlEncSoapArrayTypeAttr2 
(OSCTXT* pctxt, const OSUTF8CHAR* name, size_t nameLen, 
 const OSUTF8CHAR* value, size_t valueLen, size_t 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); 

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, size_t valueLen);

EXTERNXML int rtXmlEncTermStartElement (OSCTXT* pctxt);

EXTERNXML int rtXmlEncUnicodeStr (OSCTXT* pctxt, 
                                  const OSUNICHAR* value, 
                                  OSUINT32 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, size_t nameLen, 
                                 const OSUTF8CHAR* value, size_t 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, 
                                size_t attrNameLen);

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

EXTERNXML int rtXmlEncUInt64Value (OSCTXT* pctxt, OSUINT64 value);

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

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

EXTERNXML int rtXmlFreeInputSource (OSCTXT* pctxt);

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

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

/*EXTERNXML int rtXmlFinalizeMemBuf (OSRTMEMBUF* pMemBuf);*/

#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, size_t 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 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 int rtXmlSetXSITypeAttr (OSCTXT* pctxt, const OSUTF8CHAR* xsiType);

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

#include "rtxmlsrc/rtXmlNamespace.h"

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

EXTERNXML int rtXmlMatchBase64Str 
(OSCTXT* pctxt, size_t minLength, size_t 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 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,
                                   size_t 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 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, size_t 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 void rtXmlTreatWhitespaces (OSCTXT* pctxt, int whiteSpaceType);

EXTERNXML void rtErrXmlInit (void);

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

EXTERNXML int rtXmlpDecAnyAttrStr 
(OSCTXT* pctxt, const OSUTF8CHAR** ppAttrStr, size_t index);

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

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

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

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

EXTERNXML int rtXmlpDecBool (OSCTXT* pctx