XBinder XML Runtime  XBinder Version 3.0.x
Macros | Functions
XML encode functions.

Macros

#define rtxPrintNSAttrs(name, data)   rtXmlPrintNSAttrs(name,&data)
 
#define rtXmlFinalizeMemBuf(pMemBuf)
 
#define rtXmlGetEncBufPtr(pctxt)   (pctxt)->buffer.data
 This macro returns the start address of the encoded XML message. More...
 
#define rtXmlGetEncBufLen(pctxt)   (pctxt)->buffer.byteIndex
 This macro returns the length of the encoded XML message. More...
 

Functions

EXTERNXML int rtXmlEncAny (OSCTXT *pctxt, OSXMLSTRING *pvalue, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a variable of the XSD any type. More...
 
EXTERNXML int rtXmlEncAnyStr (OSCTXT *pctxt, const OSUTF8CHAR *pvalue, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 
EXTERNXML int rtXmlEncAnyTypeValue (OSCTXT *pctxt, const OSUTF8CHAR *pvalue)
 This function encodes a variable of the XSD anyType type. More...
 
EXTERNXML int rtXmlEncAnyAttr (OSCTXT *pctxt, OSRTDList *pAnyAttrList)
 This function encodes a list of OSAnyAttr attributes in which the name and value are given as a UTF-8 string. More...
 
EXTERNXML int rtXmlEncBase64Binary (OSCTXT *pctxt, OSSIZE nocts, const OSOCTET *value, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a variable of the XSD base64Binary type. More...
 
EXTERNXML int rtXmlEncBase64BinaryAttr (OSCTXT *pctxt, OSUINT32 nocts, const OSOCTET *value, const OSUTF8CHAR *attrName, OSSIZE attrNameLen)
 This function encodes a variable of the XSD base64Binary type as an attribute. More...
 
EXTERNXML int rtXmlEncBase64StrValue (OSCTXT *pctxt, OSSIZE nocts, const OSOCTET *value)
 This function encodes a variable of the XSD base64Binary type. More...
 
EXTERNXML int rtXmlEncBigInt (OSCTXT *pctxt, const OSUTF8CHAR *value, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a variable of the XSD integer type. More...
 
EXTERNXML int rtXmlEncBigIntAttr (OSCTXT *pctxt, const OSUTF8CHAR *value, const OSUTF8CHAR *attrName, OSSIZE attrNameLen)
 This function encodes an XSD integer attribute value. More...
 
EXTERNXML int rtXmlEncBigIntValue (OSCTXT *pctxt, const OSUTF8CHAR *value)
 This function encodes an XSD integer attribute value. More...
 
EXTERNXML int rtXmlEncBitString (OSCTXT *pctxt, OSSIZE nbits, const OSOCTET *value, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a variable of the ASN.1 BIT STRING type. More...
 
EXTERNXML int rtXmlEncBitStringExt (OSCTXT *pctxt, OSSIZE nbits, const OSOCTET *value, OSSIZE dataSize, const OSOCTET *extValue, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a variable of the ASN.1 BIT STRING type. More...
 
EXTERNXML int rtXmlEncBinStrValue (OSCTXT *pctxt, OSSIZE nbits, const OSOCTET *data)
 This function encodes a binary string value as a sequence of '1's and '0's. More...
 
EXTERNXML int rtXmlEncBool (OSCTXT *pctxt, OSBOOL value, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a variable of the XSD boolean type. More...
 
EXTERNXML int rtXmlEncBoolValue (OSCTXT *pctxt, OSBOOL value)
 This function encodes a variable of the XSD boolean type. More...
 
EXTERNXML int rtXmlEncBoolAttr (OSCTXT *pctxt, OSBOOL value, const OSUTF8CHAR *attrName, OSSIZE attrNameLen)
 This function encodes an XSD boolean attribute value. More...
 
EXTERNXML int rtXmlEncCanonicalSort (OSCTXT *pctxt, OSCTXT *pBufCtxt, OSRTSList *pList)
 Sort (as for CXER, Canonical-XER) and encode previously encoded SET OF components. More...
 
EXTERNXML int rtXmlEncComment (OSCTXT *pctxt, const OSUTF8CHAR *comment)
 This function encodes an XML comment. More...
 
EXTERNXML int rtXmlEncDate (OSCTXT *pctxt, const OSXSDDateTime *pvalue, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a variable of the XSD 'date' type as a string. More...
 
EXTERNXML int rtXmlEncDateValue (OSCTXT *pctxt, const OSXSDDateTime *pvalue)
 This function encodes a variable of the XSD 'date' type as a string. More...
 
EXTERNXML int rtXmlEncTime (OSCTXT *pctxt, const OSXSDDateTime *pvalue, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a variable of the XSD 'time' type as an string. More...
 
EXTERNXML int rtXmlEncTimeValue (OSCTXT *pctxt, const OSXSDDateTime *pvalue)
 This function encodes a variable of the XSD 'time' type as an string. More...
 
EXTERNXML int rtXmlEncDateTime (OSCTXT *pctxt, const OSXSDDateTime *pvalue, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a numeric date/time value into an XML string representation. More...
 
EXTERNXML int rtXmlEncDateTimeValue (OSCTXT *pctxt, const OSXSDDateTime *pvalue)
 This function encodes a numeric date/time value into an XML string representation. More...
 
EXTERNXML int rtXmlEncDecimal (OSCTXT *pctxt, OSREAL value, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS, const OSDecimalFmt *pFmtSpec)
 This function encodes a variable of the XSD decimal type. More...
 
EXTERNXML int rtXmlEncDecimalAttr (OSCTXT *pctxt, OSREAL value, const OSUTF8CHAR *attrName, OSSIZE attrNameLen, const OSDecimalFmt *pFmtSpec)
 This function encodes a variable of the XSD decimal type as an attribute. More...
 
EXTERNXML int rtXmlEncDecimalValue (OSCTXT *pctxt, OSREAL value, const OSDecimalFmt *pFmtSpec, char *pDestBuf, OSSIZE destBufSize)
 This function encodes a value of the XSD decimal type. More...
 
EXTERNXML int rtXmlEncDouble (OSCTXT *pctxt, OSREAL value, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS, const OSDoubleFmt *pFmtSpec)
 This function encodes a variable of the XSD double type. More...
 
EXTERNXML int rtXmlEncDoubleAttr (OSCTXT *pctxt, OSREAL value, const OSUTF8CHAR *attrName, OSSIZE attrNameLen, const OSDoubleFmt *pFmtSpec)
 This function encodes a variable of the XSD double type as an attribute. More...
 
EXTERNXML int rtXmlEncDoubleNormalValue (OSCTXT *pctxt, OSREAL value, const OSDoubleFmt *pFmtSpec, int defaultPrecision)
 This function encodes a normal (not +/-INF or NaN) value of the XSD double or float type. More...
 
EXTERNXML int rtXmlEncDoubleValue (OSCTXT *pctxt, OSREAL value, const OSDoubleFmt *pFmtSpec, int defaultPrecision)
 This function encodes a value of the XSD double or float type. More...
 
EXTERNXML int rtXmlEncEmptyElement (OSCTXT *pctxt, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS, OSRTDList *pNSAttrs, OSBOOL terminate)
 This function encodes an enpty element tag value (<elemName/>). More...
 
EXTERNXML int rtXmlEncEndDocument (OSCTXT *pctxt)
 This function adds trailor information and a null terminator at the end of the XML document being encoded. More...
 
EXTERNXML int rtXmlEncEndElement (OSCTXT *pctxt, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes an end element tag value (</elemName>). More...
 
EXTERNXML int rtXmlEncEndSoapEnv (OSCTXT *pctxt)
 This function encodes a SOAP envelope end element tag (<SOAP-ENV:Envelope/>). More...
 
EXTERNXML int rtXmlEncEndSoapElems (OSCTXT *pctxt, OSXMLSOAPMsgType msgtype)
 This function encodes SOAP end element tags. More...
 
EXTERNXML int rtXmlEncFloat (OSCTXT *pctxt, OSREAL value, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS, const OSDoubleFmt *pFmtSpec)
 This function encodes a variable of the XSD float type. More...
 
EXTERNXML int rtXmlEncFloatAttr (OSCTXT *pctxt, OSREAL value, const OSUTF8CHAR *attrName, OSSIZE attrNameLen, const OSDoubleFmt *pFmtSpec)
 This function encodes a variable of the XSD float type as an attribute. More...
 
EXTERNXML int rtXmlEncGYear (OSCTXT *pctxt, const OSXSDDateTime *pvalue, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a numeric gYear element into an XML string representation. More...
 
EXTERNXML int rtXmlEncGYearMonth (OSCTXT *pctxt, const OSXSDDateTime *pvalue, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a numeric gYearMonth element into an XML string representation. More...
 
EXTERNXML int rtXmlEncGMonth (OSCTXT *pctxt, const OSXSDDateTime *pvalue, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a numeric gMonth element into an XML string representation. More...
 
EXTERNXML int rtXmlEncGMonthDay (OSCTXT *pctxt, const OSXSDDateTime *pvalue, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a numeric gMonthDay element into an XML string representation. More...
 
EXTERNXML int rtXmlEncGDay (OSCTXT *pctxt, const OSXSDDateTime *pvalue, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a numeric gDay element into an XML string representation. More...
 
EXTERNXML int rtXmlEncGYearValue (OSCTXT *pctxt, const OSXSDDateTime *pvalue)
 This function encodes a numeric gYear value into an XML string representation. More...
 
EXTERNXML int rtXmlEncGYearMonthValue (OSCTXT *pctxt, const OSXSDDateTime *pvalue)
 This function encodes a numeric gYearMonth value into an XML string representation. More...
 
EXTERNXML int rtXmlEncGMonthValue (OSCTXT *pctxt, const OSXSDDateTime *pvalue)
 This function encodes a numeric gMonth value into an XML string representation. More...
 
EXTERNXML int rtXmlEncGMonthDayValue (OSCTXT *pctxt, const OSXSDDateTime *pvalue)
 This function encodes a numeric gMonthDay value into an XML string representation. More...
 
EXTERNXML int rtXmlEncGDayValue (OSCTXT *pctxt, const OSXSDDateTime *pvalue)
 This function encodes a numeric gDay value into an XML string representation. More...
 
EXTERNXML int rtXmlEncHexBinary (OSCTXT *pctxt, OSSIZE nocts, const OSOCTET *value, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a variable of the XSD hexBinary type. More...
 
EXTERNXML int rtXmlEncHexBinaryAttr (OSCTXT *pctxt, OSUINT32 nocts, const OSOCTET *value, const OSUTF8CHAR *attrName, OSSIZE attrNameLen)
 This function encodes a variable of the XSD hexBinary type as an attribute. More...
 
EXTERNXML int rtXmlEncHexStrValue (OSCTXT *pctxt, OSSIZE nocts, const OSOCTET *data)
 This function encodes a variable of the XSD hexBinary type. More...
 
EXTERNXML int rtXmlEncIndent (OSCTXT *pctxt)
 This function adds indentation whitespace to the output stream. More...
 
EXTERNXML int rtXmlEncInt (OSCTXT *pctxt, OSINT32 value, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a variable of the XSD integer type. More...
 
EXTERNXML int rtXmlEncIntValue (OSCTXT *pctxt, OSINT32 value)
 This function encodes a variable of the XSD integer type. More...
 
EXTERNXML int rtXmlEncIntAttr (OSCTXT *pctxt, OSINT32 value, const OSUTF8CHAR *attrName, OSSIZE attrNameLen)
 This function encodes a variable of the XSD integer type as an attribute (name="value"). More...
 
EXTERNXML int rtXmlEncIntPattern (OSCTXT *pctxt, OSINT32 value, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS, const OSUTF8CHAR *pattern)
 This function encodes a variable of the XSD integer type using a pattern to specify the format of the integer value. More...
 
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)
 This function encodes a variable of the XSD integer type. More...
 
EXTERNXML int rtXmlEncInt64Pattern (OSCTXT *pctxt, OSINT64 value, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS, const OSUTF8CHAR *pattern)
 
EXTERNXML int rtXmlEncInt64Value (OSCTXT *pctxt, OSINT64 value)
 This function encodes a variable of the XSD integer type. More...
 
EXTERNXML int rtXmlEncInt64PatternValue (OSCTXT *pctxt, OSINT64 value, const OSUTF8CHAR *pattern)
 
EXTERNXML int rtXmlEncInt64Attr (OSCTXT *pctxt, OSINT64 value, const OSUTF8CHAR *attrName, OSSIZE attrNameLen)
 This function encodes a variable of the XSD integer type as an attribute (name="value"). More...
 
EXTERNXML int rtXmlEncNamedBits (OSCTXT *pctxt, const OSBitMapItem *pBitMap, OSSIZE nbits, const OSOCTET *pvalue, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a variable of the ASN.1 BIT STRING type. More...
 
EXTERNXML int rtXmlEncNamedBitsValue (OSCTXT *pctxt, const OSBitMapItem *pBitMap, OSSIZE nbits, const OSOCTET *pvalue)
 
EXTERNXML int rtXmlEncNSAttrs (OSCTXT *pctxt, OSRTDList *pNSAttrs)
 This function encodes namespace declaration attributes at the beginning of an XML document. More...
 
EXTERNXML int rtXmlPrintNSAttrs (const char *name, const OSRTDList *data)
 This function prints a list of namespace attributes. More...
 
EXTERNXML int rtXmlEncReal10 (OSCTXT *pctxt, const OSUTF8CHAR *pvalue, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a variable of the ASN.1 REAL base 10 type. More...
 
EXTERNXML int rtXmlEncSoapArrayTypeAttr (OSCTXT *pctxt, const OSUTF8CHAR *name, const OSUTF8CHAR *value, OSSIZE itemCount)
 This function encodes the special SOAP encoding attrType attribute which specifies the number and type of elements in a SOAP array. More...
 
EXTERNXML int rtXmlEncSoapArrayTypeAttr2 (OSCTXT *pctxt, const OSUTF8CHAR *name, OSSIZE nameLen, const OSUTF8CHAR *value, OSSIZE valueLen, OSSIZE itemCount)
 
EXTERNXML int rtXmlEncStartDocument (OSCTXT *pctxt)
 This function encodes the XML header text at the beginning of an XML document. More...
 
EXTERNXML int rtXmlEncBOM (OSCTXT *pctxt)
 This function encodes the Unicode byte order mark header at the start of the document. More...
 
EXTERNXML int rtXmlEncStartElement (OSCTXT *pctxt, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS, OSRTDList *pNSAttrs, OSBOOL terminate)
 This function encodes a start element tag value (<elemName>). More...
 
EXTERNXML int rtXmlEncStartSoapEnv (OSCTXT *pctxt, OSRTDList *pNSAttrs)
 This function encodes a SOAP envelope start element tag. More...
 
EXTERNXML int rtXmlEncStartSoapElems (OSCTXT *pctxt, OSXMLSOAPMsgType msgtype)
 This function encodes a SOAP envelope start element tag and an optional SOAP body or fault tag. More...
 
EXTERNXML int rtXmlEncString (OSCTXT *pctxt, OSXMLSTRING *pxmlstr, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a variable of the XSD string type. More...
 
EXTERNXML int rtXmlEncStringValue (OSCTXT *pctxt, const OSUTF8CHAR *value)
 This function encodes a variable of the XSD string type. More...
 
EXTERNXML int rtXmlEncStringValue2 (OSCTXT *pctxt, const OSUTF8CHAR *value, OSSIZE valueLen)
 This function encodes a variable of the XSD string type. More...
 
EXTERNXML int rtXmlEncTermStartElement (OSCTXT *pctxt)
 This function terminates a currently open XML start element by adding either a '>' or '/>' (if empty) terminator. More...
 
EXTERNXML int rtXmlEncUnicodeStr (OSCTXT *pctxt, const OSUNICHAR *value, OSSIZE nchars, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a Unicode string value. More...
 
EXTERNXML int rtXmlEncUTF8Attr (OSCTXT *pctxt, const OSUTF8CHAR *name, const OSUTF8CHAR *value)
 This function encodes an attribute in which the name and value are given as a null-terminated UTF-8 strings. More...
 
EXTERNXML int rtXmlEncUTF8Attr2 (OSCTXT *pctxt, const OSUTF8CHAR *name, OSSIZE nameLen, const OSUTF8CHAR *value, OSSIZE valueLen)
 This function encodes an attribute in which the name and value are given as a UTF-8 strings with lengths. More...
 
EXTERNXML int rtXmlEncUTF8Str (OSCTXT *pctxt, const OSUTF8CHAR *value, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a UTF-8 string value. More...
 
EXTERNXML int rtXmlEncUInt (OSCTXT *pctxt, OSUINT32 value, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a variable of the XSD unsigned integer type. More...
 
EXTERNXML int rtXmlEncUIntValue (OSCTXT *pctxt, OSUINT32 value)
 This function encodes a variable of the XSD unsigned integer type. More...
 
EXTERNXML int rtXmlEncUIntAttr (OSCTXT *pctxt, OSUINT32 value, const OSUTF8CHAR *attrName, OSSIZE attrNameLen)
 This function encodes a variable of the XSD unsigned integer type as an attribute (name="value"). More...
 
EXTERNXML int rtXmlEncUInt64 (OSCTXT *pctxt, OSUINT64 value, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS)
 This function encodes a variable of the XSD integer type. More...
 
EXTERNXML int rtXmlEncUInt64Pattern (OSCTXT *pctxt, OSUINT64 value, const OSUTF8CHAR *elemName, OSXMLNamespace *pNS, const OSUTF8CHAR *pattern)
 
EXTERNXML int rtXmlEncUInt64Value (OSCTXT *pctxt, OSUINT64 value)
 This function encodes a variable of the XSD integer type. More...
 
EXTERNXML int rtXmlEncUInt64PatternValue (OSCTXT *pctxt, OSUINT64 value, const OSUTF8CHAR *pattern)
 
EXTERNXML int rtXmlEncUInt64Attr (OSCTXT *pctxt, OSUINT64 value, const OSUTF8CHAR *attrName, OSSIZE attrNameLen)
 This function encodes a variable of the XSD integer type as an attribute (name="value"). More...
 
EXTERNXML int rtXmlEncXSIAttrs (OSCTXT *pctxt, OSBOOL needXSI)
 This function encodes XML schema instance (XSI) attributes at the beginning of an XML document. More...
 
EXTERNXML int rtXmlEncXSITypeAttr (OSCTXT *pctxt, const OSUTF8CHAR *value)
 This function encodes an XML schema instance (XSI) type attribute value (xsi:type="value"). More...
 
EXTERNXML int rtXmlEncXSITypeAttr2 (OSCTXT *pctxt, const OSUTF8CHAR *typeNsUri, const OSUTF8CHAR *typeName)
 This function encodes an XML schema instance (XSI) type attribute value (xsi:type="pfx:value"). More...
 
EXTERNXML int rtXmlEncXSINilAttr (OSCTXT *pctxt)
 This function encodes an XML nil attribute (xsi:nil="true"). More...
 
EXTERNXML int rtXmlFreeInputSource (OSCTXT *pctxt)
 This function closes an input source that was previously created with one of the create input source functions such as 'rtXmlCreateFileInputSource'. More...
 
EXTERNXML OSBOOL rtXmlStrCmpAsc (const OSUTF8CHAR *text1, const char *text2)
 
EXTERNXML OSBOOL rtXmlStrnCmpAsc (const OSUTF8CHAR *text1, const char *text2, OSSIZE len)
 
EXTERNXML int rtXmlSetEncBufPtr (OSCTXT *pctxt, OSOCTET *bufaddr, OSSIZE bufsiz)
 This function is used to set the internal buffer within the run-time library encoding context. More...
 
EXTERNXML int rtXmlGetIndent (OSCTXT *pctxt)
 This function returns current XML output indent value. More...
 
EXTERNXML OSBOOL rtXmlGetWriteBOM (OSCTXT *pctxt)
 This function returns whether the Unicode byte order mark will be encoded. More...
 
EXTERNXML int rtXmlGetIndentChar (OSCTXT *pctxt)
 This function returns current XML output indent character value (default is space). More...
 

Detailed Description

Macro Definition Documentation

◆ rtXmlFinalizeMemBuf

#define rtXmlFinalizeMemBuf (   pMemBuf)
Value:
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)

Definition at line 2605 of file osrtxml.h.

◆ rtXmlGetEncBufLen

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

This macro returns the length of the encoded XML message.

Parameters
pctxtPointer to a context structure.

Definition at line 2657 of file osrtxml.h.

◆ rtXmlGetEncBufPtr

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

This macro returns the start address of the encoded XML message.

If a static buffer was used, this is simply the start address of the buffer. If dynamic encoding was done, this will return the start address of the dynamic buffer allocated by the encoder.

Parameters
pctxtPointer to a context structure.

Definition at line 2650 of file osrtxml.h.

Function Documentation

◆ rtXmlEncAny()

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

This function encodes a variable of the XSD any type.

This is considered to be a fully-wrapped element of any type (for example: <myType>myData</myType>)

Parameters
pctxtPointer to context block structure.
pvalueValue to be encoded. This is a string containing the fully-encoded XML text to be copied to the output stream.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSPointer to namespace structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncAnyAttr()

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

This function encodes a list of OSAnyAttr attributes in which the name and value are given as a UTF-8 string.

Parameters
pctxtPointer to context block structure.
pAnyAttrListList of attributes.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncAnyTypeValue()

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

This function encodes a variable of the XSD anyType type.

This is considered to be a fully-wrapped element of any type, possibly containing attributes. (for example: * <myType>myData</myType>)

Parameters
pctxtPointer to context block structure.
pvalueValue to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncBase64Binary()

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

This function encodes a variable of the XSD base64Binary type.

Parameters
pctxtPointer to context block structure.
noctsNumber of octets in the value string.
valueValue to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSPointer to namespace structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncBase64BinaryAttr()

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

This function encodes a variable of the XSD base64Binary type as an attribute.

Parameters
pctxtPointer to context block structure.
noctsNumber of octets in the value string.
valueValue to be encoded.
attrNameXML attribute name. A name must be provided.
attrNameLenLength in bytes of the attribute name.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncBase64StrValue()

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

This function encodes a variable of the XSD base64Binary type.

It just puts the encoded value in the destination buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
noctsNumber of octets in the value string.
valueValue to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncBigInt()

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

This function encodes a variable of the XSD integer type.

In this case, the integer is assumed to be of a larger size than can fit in a C or C++ long type (normally 32 or 64 bits). For example, parameters used to calculate security values are typically larger than these sizes.

Items of this type are stored in character string constant variables. They can be represented as decimal strings (with no prefixes), as hexadecimal strings starting with a "0x" prefix, as octal strings starting with a "0o" prefix or as binary strings starting with a "0b" prefix. Other radixes are currently not supported.

Parameters
pctxtPointer to context block structure.
valueA pointer to a character string containing the value to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSPointer to namespace structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncBigIntAttr()

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

This function encodes an XSD integer attribute value.

In this case, the integer is assumed to be of a larger size than can fit in a C or C++ long type (normally 32 or 64 bits).

Parameters
pctxtPointer to context block structure.
valueA pointer to a character string containing the value to be encoded.
attrNameXML attribute name. A name must be provided.
attrNameLenLength in bytes of the attribute name.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncBigIntValue()

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

This function encodes an XSD integer attribute value.

In this case, the integer is assumed to be of a larger size than can fit in a C or C++ long type (normally 32 or 64 bits). This function just puts the encoded value in the destination buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
valueA pointer to a character string containing the value to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncBinStrValue()

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

This function encodes a binary string value as a sequence of '1's and '0's.

Parameters
pctxtPointer to context block structure.
nbitsNumber of bits in the value string.
dataValue to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncBitString()

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

This function encodes a variable of the ASN.1 BIT STRING type.

The encoded data is a sequence of '1's and '0's. This is only used if named bits are not specified in the string (

See also
rtXmlEncNamedBits).
Parameters
pctxtPointer to context block structure.
nbitsNumber of bits in the bit string.
valueValue to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSPointer to namespace structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncBitStringExt()

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

This function encodes a variable of the ASN.1 BIT STRING type.

The encoded data is a sequence of '1's and '0's. This is used for BIT STRINGs with extdata member present.

Parameters
pctxtPointer to context block structure.
nbitsNumber of bits in the bit string.
valueValue to be encoded.
dataSizeSize of data member.
extValueValue of extdata to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSPointer to namespace structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncBOM()

EXTERNXML int rtXmlEncBOM ( OSCTXT *  pctxt)

This function encodes the Unicode byte order mark header at the start of the document.

It is called by rtXmlEncStartDocument and does not need to be called manually.

Parameters
pctxtPointer to context block structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncBool()

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

This function encodes a variable of the XSD boolean type.

Parameters
pctxtPointer to context block structure.
valueBoolean value to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSPointer to namespace structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncBoolAttr()

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

This function encodes an XSD boolean attribute value.

Parameters
pctxtPointer to context block structure.
valueBoolean value to be encoded.
attrNameXML attribute name. A name must be provided.
attrNameLenLength in bytes of the attribute name.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncBoolValue()

EXTERNXML int rtXmlEncBoolValue ( OSCTXT *  pctxt,
OSBOOL  value 
)

This function encodes a variable of the XSD boolean type.

It just puts the encoded value in the destination buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
valueBoolean value to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncCanonicalSort()

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

Sort (as for CXER, Canonical-XER) and encode previously encoded SET OF components.

Parameters
pctxtContext to use to encode the sorted encoding
pBufCtxtContext previously used to encode the components which are to be sorted.
pListList of OSRTBufLocDescr identifying the location of each of the components' encodings within pBufCtxt.

◆ rtXmlEncComment()

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

This function encodes an XML comment.

The given text will be inserted in between XML comment start and end elements ().

Parameters
pctxtPointer to context block structure.
commentThe comment text.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncDate()

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

This function encodes a variable of the XSD 'date' type as a string.

This version of the function is used to encode an OSXSDDateTime value into CCYY-MM-DD format.

Parameters
pctxtPointer to context block structure.
pvalueOSXSDDateTime type pointer points to a OSXSDDateTime value to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSPointer to namespace structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncDateTime()

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

This function encodes a numeric date/time value into an XML string representation.

Parameters
pctxtPointer to context block structure.
pvaluePointer to value to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSPointer to namespace structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncDateTimeValue()

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

This function encodes a numeric date/time value into an XML string representation.

It just puts the encoded value in the destination buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
pvaluePointer to value to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncDateValue()

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

This function encodes a variable of the XSD 'date' type as a string.

This version of the function is used to encode an OSXSDDateTime value into CCYY-MM-DD format. This function just puts the encoded value in the destination buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
pvalueOSXSDDateTime type pointer points to a OSXSDDateTime value to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncDecimal()

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

This function encodes a variable of the XSD decimal type.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSPointer to namespace structure.
pFmtSpecPointer to format specification structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncDecimalAttr()

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

This function encodes a variable of the XSD decimal type as an attribute.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
attrNameXML attribute name. A name must be provided.
attrNameLenLength of XML attribute name.
pFmtSpecPointer to format specification structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncDecimalValue()

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

This function encodes a value of the XSD decimal type.

It just puts the encoded value in the destination buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
pFmtSpecPointer to format specification structure.
pDestBufPointer to a destination buffer. If NULL (destBufSize should be 0) the encoded value will be put in pctxt->buffer or in stream associated with the pctxt.
destBufSizeThe size of the destination buffer. Must be 0, if pDestBuf is NULL.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncDouble()

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

This function encodes a variable of the XSD double type.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSPointer to namespace structure.
pFmtSpecPointer to format specification structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncDoubleAttr()

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

This function encodes a variable of the XSD double type as an attribute.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
attrNameXML attribute name. A name must be provided.
attrNameLenLength of XML attribute name.
pFmtSpecPointer to format specification structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncDoubleNormalValue()

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

This function encodes a normal (not +/-INF or NaN) value of the XSD double or float type.

It just puts the encoded value in the destination buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
pFmtSpecPointer to format specification structure.
defaultPrecisionDefault precision of the value. For float, it is 6, for double it is 15.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncDoubleValue()

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

This function encodes a value of the XSD double or float type.

It just puts the encoded value in the destination buffer or stream without any tags. Special real values +/-INF and NaN are encoded as "INF", "-INF", and "NaN", respectively.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
pFmtSpecPointer to format specification structure.
defaultPrecisionDefault precision of the value. For float, it is 6, for double it is 15.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncEmptyElement()

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

This function encodes an enpty element tag value (<elemName/>).

Parameters
pctxtPointer to context block structure.
elemNameXML element name.
pNSXML namespace information (prefix and URI).
pNSAttrsList of namespace attributes to be added to element.
terminateAdd closing '>' character.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncEndDocument()

EXTERNXML int rtXmlEncEndDocument ( OSCTXT *  pctxt)

This function adds trailor information and a null terminator at the end of the XML document being encoded.

Parameters
pctxtPointer to context block structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncEndElement()

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

This function encodes an end element tag value (</elemName>).

Parameters
pctxtPointer to context block structure.
elemNameXML element name.
pNSXML namespace information (prefix and URI).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncEndSoapElems()

EXTERNXML int rtXmlEncEndSoapElems ( OSCTXT *  pctxt,
OSXMLSOAPMsgType  msgtype 
)

This function encodes SOAP end element tags.

If will add a SOAP body or fault end tag based on the SOAP message type argument. It will then add an envelope end element tag.

Parameters
pctxtPointer to context block structure.
msgtypeSOAP message type (body, fault, or none)
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncEndSoapEnv()

EXTERNXML int rtXmlEncEndSoapEnv ( OSCTXT *  pctxt)

This function encodes a SOAP envelope end element tag (<SOAP-ENV:Envelope/>).

Parameters
pctxtPointer to context block structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncFloat()

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

This function encodes a variable of the XSD float type.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
pFmtSpecPointer to format specification structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncFloatAttr()

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

This function encodes a variable of the XSD float type as an attribute.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
attrNameXML attribute name. A name must be provided.
attrNameLenLength of XML attribute name.
pFmtSpecPointer to format specification structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncGDay()

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

This function encodes a numeric gDay element into an XML string representation.

Parameters
pctxtPointer to context block structure.
pvaluePointer to value to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncGDayValue()

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

This function encodes a numeric gDay value into an XML string representation.

It just puts the encoded value into the buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
pvaluePointer to value to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncGMonth()

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

This function encodes a numeric gMonth element into an XML string representation.

Parameters
pctxtPointer to context block structure.
pvaluePointer to value to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncGMonthDay()

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

This function encodes a numeric gMonthDay element into an XML string representation.

Parameters
pctxtPointer to context block structure.
pvaluePointer to value to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncGMonthDayValue()

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

This function encodes a numeric gMonthDay value into an XML string representation.

It just puts the encoded value into the buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
pvaluePointer to value to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncGMonthValue()

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

This function encodes a numeric gMonth value into an XML string representation.

It just puts the encoded value into the buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
pvaluePointer to value to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncGYear()

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

This function encodes a numeric gYear element into an XML string representation.

Parameters
pctxtPointer to context block structure.
pvaluePointer to value to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncGYearMonth()

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

This function encodes a numeric gYearMonth element into an XML string representation.

Parameters
pctxtPointer to context block structure.
pvaluePointer to value to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncGYearMonthValue()

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

This function encodes a numeric gYearMonth value into an XML string representation.

It just puts the encoded value into the buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
pvaluePointer to value to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncGYearValue()

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

This function encodes a numeric gYear value into an XML string representation.

It just puts the encoded value into the buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
pvaluePointer to value to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncHexBinary()

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

This function encodes a variable of the XSD hexBinary type.

Parameters
pctxtPointer to context block structure.
noctsNumber of octets in the value string.
valueValue to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncHexBinaryAttr()

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

This function encodes a variable of the XSD hexBinary type as an attribute.

Parameters
pctxtPointer to context block structure.
noctsNumber of octets in the value string.
valueValue to be encoded.
attrNameXML attribute name. A name must be provided.
attrNameLenLength of XML attribute name.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncHexStrValue()

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

This function encodes a variable of the XSD hexBinary type.

It just puts the encoded value in the destination buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
noctsNumber of octets in the value string.
dataValue to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncIndent()

EXTERNXML int rtXmlEncIndent ( OSCTXT *  pctxt)

This function adds indentation whitespace to the output stream.

The amount of indentation to add is determined by the level member variable in the context structure and the OSXMLINDENT constant value.

Parameters
pctxtPointer to context block structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncInt()

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

This function encodes a variable of the XSD integer type.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncInt64()

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

This function encodes a variable of the XSD integer type.

This version of the function is used for 64-bit integer values.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncInt64Attr()

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

This function encodes a variable of the XSD integer type as an attribute (name="value").

This version of the function is used for 64-bit integer values.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
attrNameXML attribute name.
attrNameLenLength (in bytes) of the attribute name.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncInt64Value()

EXTERNXML int rtXmlEncInt64Value ( OSCTXT *  pctxt,
OSINT64  value 
)

This function encodes a variable of the XSD integer type.

This version of the function is used for 64-bit integer values. It just puts the encoded value in the destination buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncIntAttr()

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

This function encodes a variable of the XSD integer type as an attribute (name="value").

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
attrNameXML attribute name.
attrNameLenLength (in bytes) of the attribute name.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncIntPattern()

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

This function encodes a variable of the XSD integer type using a pattern to specify the format of the integer value.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
patternPattern of the encoded value.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncIntValue()

EXTERNXML int rtXmlEncIntValue ( OSCTXT *  pctxt,
OSINT32  value 
)

This function encodes a variable of the XSD integer type.

It just puts the encoded value in the destination buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncNamedBits()

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

This function encodes a variable of the ASN.1 BIT STRING type.

In this case, a set of named bits was provided in the schema for the bit values. The encoding is a list of the named bit identifers corresponding to each set bit in the bit string value.

Parameters
pctxtPointer to context block structure.
pBitMapBit map equating symbolic bit names to bit numbers.
nbitsNumber of bits in the sit string value.
pvalueBit string value to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSPointer to namespace structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncNSAttrs()

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

This function encodes namespace declaration attributes at the beginning of an XML document.

The attributes to be encoded are stored in the namespace list provided, or within the context if a NULL pointer is passed for pNSAttrs. Namespaces are added to this list by using the namespace utility functions.

Parameters
pctxtPointer to context block structure.
pNSAttrsPointer to list of namespace attributes.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncReal10()

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

This function encodes a variable of the ASN.1 REAL base 10 type.

Parameters
pctxtA pointer to a context structure. This provides a storage area for the function to store all working variables that must be maintained between function calls.
pvalueA pointer to an REAL base 10 value.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
Returns
Completion status of operation:
  • 0 (0) = success,
  • negative return value is error.

◆ rtXmlEncSoapArrayTypeAttr()

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

This function encodes the special SOAP encoding attrType attribute which specifies the number and type of elements in a SOAP array.

The form of this attribute is 'attrType="\<type\>[count]"'.

Parameters
pctxtPointer to context block structure.
nameAttribute name (NS prefix + arrayType)
valueUTF-8 string value to be encoded.
itemCountCount of the number of elements in the array.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncStartDocument()

EXTERNXML int rtXmlEncStartDocument ( OSCTXT *  pctxt)

This function encodes the XML header text at the beginning of an XML document.

This is normally the following:

<?xml version="1.0" encoding="UTF-8"?>

Parameters
pctxtPointer to context block structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncStartElement()

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

This function encodes a start element tag value (<elemName>).

Parameters
pctxtPointer to context block structure.
elemNameXML element name. Empty string and null are treated equivalently.
pNSXML namespace information (prefix and URI). If the prefix is NULL, this method will search the context's namespace stack for a prefix to use.
pNSAttrsList of namespace attributes to be added to element.
terminateAdd closing '>' character.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncStartSoapElems()

EXTERNXML int rtXmlEncStartSoapElems ( OSCTXT *  pctxt,
OSXMLSOAPMsgType  msgtype 
)

This function encodes a SOAP envelope start element tag and an optional SOAP body or fault tag.

This includes all of the standard SOAP namespace attributes.

Parameters
pctxtPointer to context block structure.
msgtypeSOAP message type (body, fault, or none)
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncStartSoapEnv()

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

This function encodes a SOAP envelope start element tag.

This includes all of the standard SOAP namespace attributes.

Parameters
pctxtPointer to context block structure.
pNSAttrsList of namespace attributes to be added to SOAP envelope.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncString()

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

This function encodes a variable of the XSD string type.

Parameters
pctxtPointer to context block structure.
pxmlstrXML string value to be encoded.
elemNameXML element name. If either null or empty string is passed, no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncStringValue()

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

This function encodes a variable of the XSD string type.

Parameters
pctxtPointer to context block structure.
valueXML string value to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncStringValue2()

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

This function encodes a variable of the XSD string type.

Parameters
pctxtPointer to context block structure.
valueXML string value to be encoded.
valueLenUTF-8 string value length (in octets).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncTermStartElement()

EXTERNXML int rtXmlEncTermStartElement ( OSCTXT *  pctxt)

This function terminates a currently open XML start element by adding either a '>' or '/>' (if empty) terminator.

It will also add XSI attributes to the element.

Parameters
pctxtPointer to context block structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncTime()

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

This function encodes a variable of the XSD 'time' type as an string.

This version of the function is used to encode OSXSDDateTime value into any of following format in different condition as stated below. (1) hh-mm-ss.ss used if tz_flag = false (2) hh-mm-ss.ssZ used if tz_flag = false and tzo = 0 (3) hh-mm-ss.ss+HH:MM if tz_flag = false and tzo > 0 (4) hh-mm-ss.ss-HH:MM-HH:MM if tz_flag = false and tzo < 0

Parameters
pctxtPointer to context block structure.
pvalueOSXSDDateTime type pointer points to a OSXSDDateTime value to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSPointer to namespace structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncTimeValue()

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

This function encodes a variable of the XSD 'time' type as an string.

This version of the function just puts the encoded value in the destination buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
pvalueOSXSDDateTime type pointer points to a OSXSDDateTime value to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncUInt()

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

This function encodes a variable of the XSD unsigned integer type.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncUInt64()

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

This function encodes a variable of the XSD integer type.

This version of the function is used when constraints cause an unsigned 64-bit integer variable to be used.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncUInt64Attr()

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

This function encodes a variable of the XSD integer type as an attribute (name="value").

This version of the function is used for unsigned 64-bit integer values.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
attrNameXML attribute name.
attrNameLenLength (in bytes) of the attribute name.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncUInt64Value()

EXTERNXML int rtXmlEncUInt64Value ( OSCTXT *  pctxt,
OSUINT64  value 
)

This function encodes a variable of the XSD integer type.

This version of the function is used when constraints cause an unsigned 64-bit integer variable to be used. It writes the encoded value to the destination buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncUIntAttr()

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

This function encodes a variable of the XSD unsigned integer type as an attribute (name="value").

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
attrNameXML attribute name.
attrNameLenLength (in bytes) of the attribute name.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncUIntValue()

EXTERNXML int rtXmlEncUIntValue ( OSCTXT *  pctxt,
OSUINT32  value 
)

This function encodes a variable of the XSD unsigned integer type.

It just puts the encoded value in the destination buffer or stream without any tags.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncUnicodeStr()

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

This function encodes a Unicode string value.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded. This is a pointer to an array of 16-bit integer values.
ncharsNumber of characters in value array.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncUTF8Attr()

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

This function encodes an attribute in which the name and value are given as a null-terminated UTF-8 strings.

Parameters
pctxtPointer to context block structure.
nameAttribute name.
valueUTF-8 string value to be encoded.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncUTF8Attr2()

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

This function encodes an attribute in which the name and value are given as a UTF-8 strings with lengths.

Parameters
pctxtPointer to context block structure.
nameAttribute name.
nameLenAttribute name length (in octets).
valueUTF-8 string value to be encoded.
valueLenUTF-8 string value length (in octets).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncUTF8Str()

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

This function encodes a UTF-8 string value.

Parameters
pctxtPointer to context block structure.
valueValue to be encoded.
elemNameXML element name. A name must be provided. If an empty string is passed (""), no element tag is added to the encoded value.
pNSXML namespace information (prefix and URI).
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncXSIAttrs()

EXTERNXML int rtXmlEncXSIAttrs ( OSCTXT *  pctxt,
OSBOOL  needXSI 
)

This function encodes XML schema instance (XSI) attributes at the beginning of an XML document.

The encoded attributes include the XSI namespace declaration, the XSD schema location attribute, and the XSD no namespace schema location attribute.

The XSI namespace declaration will only be added to the document if schema location attributes exist or the 'needXSI' flag (see below) is set.

Parameters
pctxtPointer to context block structure.
needXSIThis flag is set to true to indicate the XSI namespace declaration is required to support XML items in the main document body such as xsi:type or xsi:nil.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncXSINilAttr()

EXTERNXML int rtXmlEncXSINilAttr ( OSCTXT *  pctxt)

This function encodes an XML nil attribute (xsi:nil="true").

Parameters
pctxtPointer to context block structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncXSITypeAttr()

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

This function encodes an XML schema instance (XSI) type attribute value (xsi:type="value").

Parameters
pctxtPointer to context block structure.
valueXSI type attribute value.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlEncXSITypeAttr2()

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

This function encodes an XML schema instance (XSI) type attribute value (xsi:type="pfx:value").

This will encode namespace declarations for the xsi namespace and for the typeNsUri namespace, if needed.

Parameters
pctxtPointer to context block structure.
typeNsUriThe type's namespace URI. Either null or empty if none.
typeNameThe type's name.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlFreeInputSource()

EXTERNXML int rtXmlFreeInputSource ( OSCTXT *  pctxt)

This function closes an input source that was previously created with one of the create input source functions such as 'rtXmlCreateFileInputSource'.

Parameters
pctxtPointer to context block structure.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlGetIndent()

EXTERNXML int rtXmlGetIndent ( OSCTXT *  pctxt)

This function returns current XML output indent value.

Parameters
pctxtPointer to OSCTXT structure
Returns
Current indent value (>= 0) if OK, negative status code if error.

◆ rtXmlGetIndentChar()

EXTERNXML int rtXmlGetIndentChar ( OSCTXT *  pctxt)

This function returns current XML output indent character value (default is space).

Parameters
pctxtPointer to OSCTXT structure
Returns
Current indent character (> 0) if OK, negative status code if error.

◆ rtXmlGetWriteBOM()

EXTERNXML OSBOOL rtXmlGetWriteBOM ( OSCTXT *  pctxt)

This function returns whether the Unicode byte order mark will be encoded.

Parameters
pctxtPointer to OSCTXT structure.
Returns
TRUE if BOM is to be encoded, FALSE if not or if context uninitialized.

◆ rtXmlPrintNSAttrs()

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

This function prints a list of namespace attributes.

Parameters
nameName to print.
dataList of namespace attributes.
Returns
Completion status of operation:
  • 0 = success,
  • negative return value is error.

◆ rtXmlSetEncBufPtr()

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

This function is used to set the internal buffer within the run-time library encoding context.

It must be called after the context variable is initialized by the rtxInitContext function and before any other compiler generated or run-time library encode function.

This function should not be called with a context that has an associated stream open, but if it is, the stream may be automatically closed.

Parameters
pctxtPointer to a context structure. This provides a storage area for the function to store all working variables that must be maintained between function calls.
bufaddrA pointer to a memory buffer to use to encode a message. The buffer should be declared as an array of unsigned characters (OCTETs). This parameter can be set to NULL to specify dynamic encoding (i.e., the encode functions will dynamically allocate a buffer to hold the encoded message).
bufsizThe length of the memory buffer in bytes. Should be set to zero if NULL was specified for bufaddr (i.e. dynamic encoding was selected).