ILE C/C++ Compiler Reference


margins



>>-#--pragma--margins--(--left margin--,--+-right margin-+--)--><
                                          '-*------------'
 
 

Description

Specifies the left and right margins to be used as the first and last column, respectively, when scanning the records of the source member where the #pragma directive occurs.

The margin setting applies only to the source member in which it is located and has no effect on any source members named on include directives in the member.

Parameters

left margin
Must be a number greater than zero but less than 32 754. The left margin should be less than the right margin.

right margin
Must be a number greater than zero but less than 32 754, or an asterisk (*). The right margin should be greater than the left margin. The compiler scans between the left margin and the right margin. The compiler scans from the left margin specified to the end of the input record, if an asterisk is specified as the value of right margin.

Notes on Usage

The #pragma margins directive takes effect on the line following the directive and remains in effect until another #pragma margins or nomargins directive is encountered or the end of the source member is reached.

The #pragma margins and #pragma sequence directives can be used together. If these two #pragma directives reserve the same columns, the #pragma sequence directive has priority, and the columns are reserved for sequence numbers.

For example, if the #pragma margins directive specifies margins of 1 and 20, and the #pragma sequence directive specifies columns 15 to 25 for sequence numbers, the margins in effect are 1 and 14, and the columns reserved for sequence numbers are 15 to 25.

If the margins specified are not in the supported range or the margins contain non-numeric values, a warning message is issued during compilation and the directive is ignored.

See also pragmas nomargins and sequence.


[ Top of Page | Previous Page | Next Page | Table of Contents ]