Skip to content

Go to a label

This custom action action transfers the package execution to the statement marked by the specified label. To mark a statement, you must first declare the label using the "Define a label" custom action. See an example below.

Property Name Data Type Description
LabelName TLabelName (String) Identifies the label the script will jump to. A label name can be any valid identifier or any numeral between 0 and 9999, like LABEL1, RETURN25, etc.

All labels must be declared with a "Define a label" custom action before they can be used with a Go To Label custom action.

Example of using Go to label

On this screenshot you can see an example of the use of "Define a label"/"Go to a label" custom actions. We ask end users for their name and create a kind of loop: they will be prompted to enter their name until they answer a non-blank value.

This can be used to check values provided by users (folders, etc...), to jump to specific blocs of instructions when a condition is not met, etc...

Some restrictions you should know

  • "Go to a label" custom actions should not be used too much: only for simple examples like the previous one.

  • Although you are allowed to do this, you should not jump to a label that is not in the same event as the "goto" action. Paquet Builder automatically adds internal actions that occur between the events: if you use incorrect jumps, this can have unpredictable effects.

  • If a goto-label statement is not correctly defined, the C code compiler will raise an exception when compiling the script generated from custom actions.

All available actions