dup Command

Duplicates the current line.

Scope: Line

Syntax

Parameter

Number 
The number of times the current line is duplicated. It must be zero or a positive integer value. The default is 1.

Description

The dup command duplicates the current line, copying all information including content, fonts, and structure.

The new line is placed after the current line, and the first character of the new line becomes the current position. If more than one new line is created, the first character of the last of the new lines becomes the current position. If no new lines are created, the current position is not moved.

If the line being duplicated is the last in a list of lines forming the current block, the block is extended to include the duplicated line.

By default, the line is duplicated once. A repetition count can be specified if desired.

Example

To copy the current line five times, type:

dup 5 

API Return Codes

-1 
The number specified was either outside the valid range or not a whole number. Issue the command again using a valid number.
-5 
You cannot make changes to the file because the readonly parameter is set to on.
-8 
Insufficient storage to continue.


block Command