XSLTC Interface

Table 13-1 summarizes the methods of available through the XSLTVM Interface.

XmlXvmCompileBuffer

Compile an XSLT stylesheet from buffer into bytecode. Compiler flags could be one or more of the following:

• XMLXVM_DEBUG forces compiler to include debug information into the bytecode

• XMLXVM_STRIPSPACE is equivalent to <xsl:strip-space elements="*"/>.

The generated bytecode resides in a compiler buffer which is freed when next stylesheet is compiled or when compiler object is deleted. Hence, if the bytecode is to be reused it should be copied into another location.

ub2 *XmlXvmCompileBuffer(
   xmlxvmcomp *comp,
   oratext *buffer,
   ub4 length, 
   oratext *baseURI,
   xmlxvmflag flags,
   xmlerr *error);

comp

IN

buffer

IN

length

IN

baseuri

IN

flags

IN

error

OUT

(ub2 *) bytecode or NULL on error

XmlXvmCompileDom

Compile an XSLT stylesheet from DOM into bytecode. Compiler flags could be one or more of the following:

• XMLXVM_DEBUG forces compiler to include debug information into the bytecode

• XMLXVM_STRIPSPACE is equivalent to <xsl:strip-space elements="*"/>.

The generated bytecode resides in a compiler buffer which is freed when next stylesheet is compiled or when compiler object is deleted. Hence, if the bytecode is to be reused it should be copied into another location.

ub2 *XmlXvmCompileDom(
   xmlxvmcomp *comp,
   xmldocnode *root,
   xmlxvmflag flags,
   xmlerr *error);

comp

IN

rooot

IN

flags

IN

error

OUT

(ub2 *) bytecode or NULL on error

XmlXvmCompileFile

Compile XSLT stylesheet from file into bytecode. Compiler flags could be one or more of the following:

• XMLXVM_DEBUG forces compiler to include debug information into the bytecode

• XMLXVM_STRIPSPACE is equivalent to <xsl:strip-space elements="*"/>.

The generated bytecode resides in a compiler buffer which is freed when next stylesheet is compiled or when compiler object is deleted. Hence, if the bytecode is to be reused it should be copied into another location.

ub2 *XmlXvmCompileFile(
   xmlxvmcomp *comp, 
   oratext *path,
   oratext *baseURI,
   xmlxvmflag flags,
   xmlerr *error);

comp

IN

path

IN

baseuri

IN

flags

IN

error

OUT

(ub2 *) bytecode or NULL on error

XmlXvmCompileURI

Compile XSLT stylesheet from URI into bytecode. Compiler flags could be one or more of the following:

• XMLXVM_DEBUG forces compiler to include debug information into the bytecode

• XMLXVM_STRIPSPACE is equivalent to <xsl:strip-space elements="*"/>.

The generated bytecode resides in a compiler buffer which is freed when next stylesheet is compiled or when compiler object is deleted. Hence, if the bytecode is to be reused it should be copied into another location.

ub2 *XmlXvmCompileURI(
   xmlxvmcomp *comp, 
   oratext *uri, 
   xmlxvmflag flags, 
   xmlerr *error);

comp

IN

uri

IN

flags

IN

error

OUT

(ub2 *) bytecode or NULL on error

XmlXvmCompileXPath

Compiles an XPath expression. The optional pfxmap is used to map namespace prefixes to URIs in the XPath expression. It is an array of prefix, URI values, ending in NULL, and so on.

ub2 *XmlXvmCompileXPath(
   xmlxvmcomp *comp, 
   oratext *xpath,
   oratext **pfxmap,
   xmlerr *error);

comp

IN

xpath

IN

pfxmap

IN

error

OUT

(ub2 *) XPath expression bytecode or NULL on error

XmlXvmCreateComp

Create an XSLT compiler object. The XSLT compiler is used to compile XSLT stylesheets into bytecode.

xmlxvmcomp *XmlXvmCreateComp(
   xmlctx *xctx);

xctx

IN

(xmlxvmcomp *) XSLT compiler object, or NULL on error

XmlXvmDestroyComp

Destroys an XSLT compiler object

void XmlXvmDestroyComp(
   xmlxvmcomp *comp);

comp

IN

XmlXvmGetBytecodeLength

The bytecode length is needed when the bytecode is to be copied or when it is set into XSLTVM.

ub4 XmlXvmGetBytecodeLength(
   ub2 *bytecode,
   xmlerr *error);

bytecode

IN

error

OUT

(ub4) The bytecode length in bytes.