BREAK Function (Report, XMLport)

Exits from a loop or a trigger in a data item trigger of a report or XMLport.

CurrReport.BREAK

CurrXMLPort.BREAK

Remarks

BREAK causes the current trigger to end. When used inside a loop, such as a WHILE-DO or REPEAT-UNTIL construction, BREAK interrupts the loop and causes the current trigger to end.

Compare this with the QUIT Function (DATAPORT, REPORT, XMLPORT).

Tip

You can also use the C/AL BREAK Statement to exit an iteration or loop. The difference is that the BREAK statement does not terminate the trigger; it just exits the loop.

Example

This example of code in a trigger on a report object requires that you create the following variable and text constant in the C/AL Globals window.

Variable name DataType

MyVar

Integer

Text constant ENU value

Text000

The variable is now %1.

MyVar := 0;
REPEAT
  MyVar := MyVar + 1;
  IF MyVar = 5 THEN
    CurrReport.BREAK;
  MESSAGE(Text000,MyVar);
UNTIL Myvar = 10;
MESSAGE('After REPEAT-UNTIL loop'); //This statement is never called.

When you run the previous code, the loop will end when MyVar is 5 and the execution of the current trigger ends. Statements after the loop are not executed.

See Also

Concepts

C/AL BREAK Statement

Other Resources

REPORT Data Type
XMLPORT Data Type