XPath and XSLT functions

The following functions return values of the appropriate type from in an XML string. The XML string can be stored in an XML data field or in a string data field.

Function What it does

xmlbooleanexpr

Evaluates a Boolean XPath expression.

xmlintegerexpr

Evaluates an integer XPath expression.

xmlfloatexpr Evaluates a float XPath expression.
xmlstringexpr Evaluates a string XPath expression.
xmlstringarrayexpr Evaluates a string array XPath expression.

The following functions manipulate an XML string

Function What it does
xmlinsertbefore Inserts an XML string into a source XML string before a particular node.
xmlinsertafter Inserts an XML string into a source XML string after a particular node.
xmlinsertchildfirst Inserts an XML string into a source XML string as the first child of a particular node.
xmlinsertchildlast Inserts an XML string into a source XML string as the last child of a particular node.
xmlremove Removes a node from an XML string.
xmlrename Renames a node in an XML string.
xmltransform Transforms an XML string using the specified style sheet.

 

xmlbooleanexpr

Returns the result of a Boolean XPath expression.

Use the following syntax:

xmlbooleanexpr (src, context, xpath_expr)

where:

src

is the source XML string

context

string containing an XPath expression

xpath_expr

string containing a Boolean XPath expression value

 

xmlintegerexpr

Returns the result of an integer XPath expression

Use the following syntax:

xmlintegerexpr (src, context, xpath_expr)

where:

src

is the source XML string

context

string containing an XPath expression

xpath_expr

string containing an integer XPath expression value

 

xmlfloatexpr

Returns the result of a float XPath expression.

Use the following syntax:

xmlfloatexpr (src, context, xpath_expr)

where:

src

is the source XML string

context

string containing an XPath expression

xpath_expr

string containing a float XPath expression value

xmlstringexpr

Returns the result of a string XPath expression.

Use the following syntax:

xmlstringexpr (src, context, xpath_expr)

where:

src

is the source XML string

context

string containing an XPath expression

xpath_expr

string containing a string XPath expression value

xmlstringarrayexpr

Returns the result of a string array XPath expression.

Use the following syntax:

xmlstringarrayexpr (src, context, xpath_expr)

where:

src

the source XML string

context

string containing an XPath expression

xpath_expr

string containing a string array XPath expression value

 

xmlinsertbefore

Inserts a string before a particular XPath expression

Use the following syntax:

xmlinsertbefore (src, context, xpath_expr, token)

where:

src

the source XML string

context

the location path from src to start the xpath_expr evaluation.

xpath_expr

string returning a single node of src where token will be inserted

  token string to be inserted before the node returned by xpath_expr

 

xmlinsertafter

Inserts a string after a particular XPath expression

Use the following syntax:

xmlinsertafter (src, context, xpath_expr, token)

where:

src

the source XML string

context

the location path from src to start the xpath_expr evaluation.

xpath_expr

string returning a single node of src where token will be inserted

  token string to be inserted after the node returned by xpath_expr

 

xmlinsertchildfirst

Inserts a string as a first child node of the returned node.

Use the following syntax:

xmlinsertchildfirst (src, context, xpath_expr, token)

where:

src

the source XML string

context

the location path from src to start the xpath_expr evaluation.

xpath_expr

string returning a single node of src where token will be inserted

  token string to be inserted as the first child node of the node returned by xpath_expr

 

xmlinsertchildlast

Inserts a string as the last child node of the returned node.

Use the following syntax:

xmlinsertchildlast (src, context, xpath_expr, token)

where:

src

the source XML string

context

the location path from src to start the xpath_expr evaluation.

xpath_expr

string returning a single node of src where token will be inserted

  token the string to be inserted as the last child node of the node returned by xpath_expr

 

xmlremove

Removes the node returned by xpath_expr.

Use the following syntax:

xmlremove (src, context, xpath_expr)

where:

src

the source XML string

context

the location path from src to start the xpath_expr evaluation.

xpath_expr

the string to be removed

 

xmlrename

Renames the node returned by the xpath_expr to new_name. The context is the location path from src to start the xpath_expr evaluation.

Use the following syntax:

xxmlrename (src, context, xpath_expr, new_name)

where:

src

the source XML string

context

the location path from src to start the xpath_expr evaluation

xpath_expr

node to be renamed

  new_name the new name of the node

xmltransform

Returns the transformation of the <src> parameter based on the style sheet. The style sheet must be an XSLT style sheet. Note that no Java™ code is supported in the style-sheet.

Use the following syntax:

xmltransform (src, style-sheet)

where:

src

the source XML string

style-sheet

a string expression containing either an XSLT style sheet or the filename of an XSLT style sheet. If it is a filename, the file must reside in the /fnsw/local/sd/xsl directory (FNSW_LOC/sd/xsl in Windows) or a subdirectory.