| **Navigation:**  [[introduction.htm|Language Reference]] > 7 - Reports > Report Structures >====== BREAK (declare group break structure) ====== | [[page overflow 1.htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[detail report detail line structure .htm|{{btn_next_n.gif|Next page}}]] | | || | //label// | **BREAK(**//variable//**)** [,**USE( )**] [,**NOCASE**] | | | //group break structures// | | | **END** | {{blk2blue.jpg|blk2blue.jpg}} | **BREAK** | Declares a group break structure. | | //label// | The name by which the structure is addressed in executable code. | | //variable// | The variable whose change in value signals the group break (PROP:BreakVar). | | **USE** | A field equate label to reference the BREAK structure in executable code (PROP:USE). | | **NOCASE** | Specifies the check for a changed value in the //variable// is case insensitive. | | //group break structures// | Group break HEADER, FOOTER, and DETAIL structures, and/or other nested BREAK structures. | The **BREAK** structure declares the //variable// which signals a group break when the value in the //variable// changes. A BREAK structure must be terminated with a period or END statement. It may contain its own HEADER, FOOTER, and DETAIL structures, and/or other nested BREAK structures. Only one HEADER and FOOTER are allowed in a BREAK structure; it may contain multiple DETAIL and/or BREAK structures. The HEADER and FOOTER structures that are declared within a BREAK structure are the group header and footer. They automatically print surrounding equivalent values in the group break //variable//. **Example:** **CustRpt REPORT             !Declare customer report** **Break1   ****BREAK****(SomeVariable)** **          HEADER           !begin group header declaration** **           !report controls** **          END              !end header declaration  ** **GroupDet  DETAIL** **           !report controls** **          END              !end detail declaration  ** **          FOOTER           ! begin group footer declaration** **           !report controls** **          END              !end footer declaration  ** **         ****END****               !end group break declaration  ** **        END                !End report declaration**