IsSelectionPrefix (XmlDoc function)

Check if prefix has XPath-selection association (XmlDoc class)

IsSelectionPrefix determines whether its argument is a prefix that can be used in an XPath expression. IsSelectionPrefix returns the value True if its argument is currently associated (either with the null string or with a namespace URI) as a prefix that you can use in an XPath expression. Otherwise, it returns False.

Syntax

%boolean = doc:IsSelectionPrefix( prefix)

Syntax terms

%boolean	A declared enumeration object of type Boolean to contain the returned value (True or False) of IsSelectionPrefix.
doc	An XmlDoc object expression.
prefix	A string prefix (the part of the name before the colon) for a node. This is a Unicode string argument; prior to Sirius Mods Version 7.6, this is an EBCDIC string. Its length must be at most 255 characters.

Usage notes

• IsSelectionPrefix has no cancellation conditions other than the usual requirement that the method obj8ect not be Null.
• IsSelectionPrefix is available in Sirius Mods Version 7.0 and later.

Examples

In the following example fragment, the code is testing for a new prefix to use in an XPath expression, to avoid having to change any existing prefix associations:

... for %i from 1 to 100 if %doc:isSelectionPrefix('p' With %i) eq false then loop end end if end for %doc:selectionNamespace('p' with %i) = 'urn:localxxx' %node = %inpNode:selectSingleNode(%p With %i - with ':infoChild') %doc:deleteSelectionPrefix('p' with %i) ...

See also

• DeleteSelectionPrefix is useful in conjunction with IsSelectionPrefix to delete the selected subtree.
• SelectionNamespace specifies the namespace URI associated with a prefix, when the prefix is used in an XPath expression.

XmlDoc class XmlNode class XmlNodelist class	List of XmlDoc methods List of XmlNode methods List of XmlNodelist methods List of XmlDoc API methods	XmlDoc methods syntax XmlNode methods syntax XmlNodelist methods syntax
Notation conventions for methods