Object Reference : Object View and Procedure Reference : Spool
Move an object in a spool.
spool_name.move(options) object_arg
where object_arg is the object to be moved specified as an integer position in the spool or the name of an existing object in the spool. The options specify the destination position. If neither a location nor offset are specified in the options, the object will be moved to the end of the spool.
loc = arg
arg may be an integer position in the spool or the name of an existing object in the spool. The object will be moved before or after arg, as specified by the offset option below. An object name must include its path if it is a child of another spool. For example, use “spool1/gr1” to specify a graph GR1 in spool SPOOL1.
offset = arg
arg indicates that the object should be inserted relative to the object specified in the “loc=” option above. arg may be “before” or “after” (default= “before”).
In addition, if the location specified by the “loc=” option corresponds to a spool object, arg may be “first” or “last”, where the object will be inserted as the first or last object in the spool object specified (default= “last”).
To move the first object in SPOOL01 to the end of the spool:
spool01.move 1
To move TAB1 to the beginning of SPOOL01:
spool01.move(offset=first) tab1
Given objects GR1 and TAB1,
spool01.move(loc=gr1) tab1
moves TAB1 to the current location of GR1. All objects from GR1 onward are pushed down the list of objects.
Alternately, if SP1 is an embedded spool.
spool01.move(loc=sp1, offset=last) 3
moves the third object to the end of SP1. If “offset=last” is omitted, the object will be moved to just before SP1.
To refer to a child object of a spool, you must specify the object’s path. For instance, given a spool SPOOL01 containing the spool SP1 which in turn contains the graph G2:
spool01.move(loc=sp1/g2) tab1
moves TAB1 before graph G2 in spool SP1, and moves the remaining objects down.
For additional discussion of spools see “Spool Objects”.
See also Spool::insert.