BUMP

ANSI, NCHAR

The BUMP instruction increments or decrements the form pointer of the destination string variable. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

dest

Required. A previously defined Character String Variable or National Character String Variable whose form pointer is modified.

sep

Required. A comma or one of the following prepositions: BY, TO, OF, FROM, USING, WITH, IN, or INTO.

count

Required. A previously defined Numeric Variable, decimal constant, Expression, or equivalent {ctrl} character added to the form-pointer of the {dest} variable.

Flags Affected: EOS

Note the following:

1. If the {count} operand is not specified, the Form Pointer of {dest} is incremented by one.

2. If the {count} operand is specified, the Form Pointer of {dest} is incremented by the value specified or the integer value of the variable (i.e., 5 if 5.75).

3. If the new Form Pointer exceeds the Length Pointer or is beyond of the physical boundaries of {dest}, the Form Pointer does not change and the EOS Condition Flag is set.

4. Enhanced ARRAY processing is supported for the BUMP instruction.

See Also: Example Code, RESET, Character String Instructions