Programmer Guide/Command Reference/POSITION

POSITION

#posId := POSITION xmlfile [*|positionString]

Create a new position identifier for the xml file xmlfile's selected element. If an asterisk is passed, or positionString is empty, an identifier, unique to this xmlfile, is automatically generated. The saved position is a "pointer" to the element of the XML file and can be used with the command SET xmlfile POSITION as well as many macro commands in the classes BDataSet, BStxIni and BXMLDoc.

Note that positionString may not contain a simple integer since it would interfere with internal indexing. If a simple integer is specified as the position string, it will be replaced with a unique identifier.See also IREF.