ArborX


:

Longname: :   Open the Documentation Legend
Released: not available 
Created: not available 
See also: { } <?{> <?}> <?:>

Summary
It is often desirable to re-execute certain sections of a script, for example in a loop. 3B2 provides this facility with its :label and }, { macros.
Example extract

The simple script below illustrates the use of labels and jump forward and jump backward macros:

 }skip 1
 @skip this 2
 :skip 3
 @Hello 4

Syntax (X.XX)
label:b The name of the label with corresponding jump name, comprising any alpha numeric combination to 31 characters pre 3B2 v7.51a.
Version specific informationv7.51a  Post 3B2 v7.51a label names are now unlimited.

Labels are used as targets for the jump macros. Label and jump macros in this form are only available within scripts executed with trun. They are only seen by the script processor, not the normal macro processor. The only place where this might cause confusion is in macro files executed with run.

A label is any sequence of characters preceded by a : (colon) character. The label must always appear on a line of its own.

Example

This example illustrates the multiple combined uses of scripting loops labels and jumps in a small script that resets values of a set of variable arrays, (see also Variables).

 ^max_param=10 1
 ^param_array_incr=0 2
 :set_param_vars 3
 ^param_array_incr++ 4
 ?=^(^param_array_incr),^(^max_param) }exit_set_param_vars 5
 ^assd_com(^param_array_incr)= 6
 ^group_type(^param_array_incr)= 7
 ^param_nm(^param_array_incr)= 8
 ^param_typc(^param_array_incr)= 9
 ^param_descript(^param_array_incr)= 10
 {set_param_vars 11
 :exit_set_param_vars 12

Document created on 08-Feb-2003 (revision 1)