IsSelectionPrefix (XmlDoc function)

From m204wiki
Revision as of 00:46, 1 June 2011 by JAL2 (talk | contribs)
Jump to navigation Jump to search

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.