This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

Branch (b)

branch

Syntax:

bnumber[t|f]

Description:

This command allows you to branch over number-1 command lines. When neither t nor f are appended, the command branches unconditionally. If t is appended, it branches if the condition register is TRUE. If f is appended it branches if the condition register is FALSE. The condition register is not affected by the branch. Branches are often used inside macros defined by the Translate (t) command and make little sense when executed directly.

If number is zero then the current command line is re-executed. If number is one, then the rest of the current command line is skipped. If number is greater than one, then number-1 command lines will be read and discarded. A command line is considered as a string of characters terminated by a linefeed separator (\0A).

The Branch command cannot be used inside a Global (g) or Until (u) command.

Current line:

Not affected.

Condition register:

Not affected.