SHIFT [ HPTOOLSET XL Reference Manual ] MPE/iX 5.0 Documentation
HPTOOLSET XL Reference Manual
SHIFT
Allows you to shift a block of text to the right or left by a specified
number of characters or from one column to another.
Syntax
SHI[FT] line rangelist [|FROM| column number] {|TO| column number}
{ L number }
{ R number }
[Q[UIET]]
Parameters
Line Rangelist Identifies the range(s) of lines you want to
shift. If more than one range is specified,
they should be separated by commas. A line
range has the form: line position [/line
position] or ALL.
FROM Column Number Identifies the column from which the specified
range of lines will be shifted. The number
specified must be greater than 0 and less than
or equal to the record length of your file. If
this parameter is omitted, the entire line will
be shifted.
TO Column Number The column number to which the specified range
of lines will be shifted. The number specified
must be greater than 0 and less than or equal
to the record length of your edit file.
L Number The number of columns you want the test shifted
left. The number specified must be a positive
integer less than the record length of your
edit file.
R Number The number of columns you want the text shifted
right. The number specified must be a positive
integer less than the record length of your
edit file.
QUIET Suppresses output to $STDLIST.
Description
Any text that is shifted past the first column or the defined LINELENGTH
parameter (SET EDIT) will be truncated. TOOLSET/XL automatically pads
lines with blanks as necessary. This command can be cancelled with the
UNDO command.
Example
(1) >>SHIFT 12/15 to 7
Shifts lines 12 through 25 so that they will begin at column 7.
(2) >>SHIFT 1/10 R 3
Shifts lines 1 through 10 to the right by 3 characters.
MPE/iX 5.0 Documentation