Guardian Procedure Calls Reference Manual

last
input
INT(32):value
specifies 1000 times the line number of the last line in the range of lines to be renumbered. If
a negative value is specified, the line number of the last line in the file is used.
start
input
INT(32):value
specifies 1000 times the line number to be assigned to the first renumbered line. If this parameter
is omitted, the old line number is retained for the first renumbered line unless first is a
negative value, in which case 1000 is used for start.
increment
input
INT(32):value
specifies 1000 times the value to be added to each successive line number when renumbering
lines. If this parameter is omitted, 1000 is used unless the value represented by start has a
fractional part (that is, if start, when divided by 1000, contains a value to the right of the
decimal point); in that case, the value used is the largest power of 10 that does not exceed
the value of the fractional part. If last is a negative value, 1000 is used for increment.
Returned Value
INT
Outcome of the call. The value is a file-system error code or one of these values:
Exhausted valid line numbers.-6
Unable to complete renumbering; file is unchanged.-10
Example
In this example, NUMBEREDIT renumbers lines 50 through 100 in the specified file. After the call,
these same lines will be numbered starting at 49 with successive line numbers increasing by an
increment of 0.100.
INT(32) first := 50000D;
INT(32) last := 100000D;
INT(32) start := 49000D;INT(32)
increment := 100D;
.
.
err := NUMBEREDIT ( filenumber, first, last,
start, increment );
Related Programming Manual
For programming information about the NUMBEREDIT procedure, see the Guardian Programmer's
Guide.
882 Guardian Procedure Calls (N)