STx 3.9 Documentation

Book

Command Reference

Previous

NUM

Next

PRINTDIALOG

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.

© 2009 The Austrian Academy of Sciences Acoustics Research Institute