splitjoin Command

Splits a line or joins two lines.

Scope: File

Syntax

Parameters

split 
Splits the current line into two lines.
join 
Joins two lines together.

Description

The splitjoin command either splits a line or joins two lines together. If the split option is specified, or if no option is specified and there is a non-blank character under or to the right of the cursor, the current line is split into two lines. The current position remains at the end of the first line.

The join option joins any following line to the end of the current line. A join is also carried out if no option is specified and there are only blank characters to the right of the current position.

There are some exceptions. The splitjoin command ignores show lines and treats a sequence of flowed lines as continuous text. If the cursor is beyond the end of the line, splitjoin first pads the line with the pad character, regardless of whether a split or join is to be done.

Example

To split a line, place the cursor at the place where you want the current line to end and type:

splitjoin split 

API Return Codes

-1 
A parameter issued with the command was not valid. Check the command 's syntax requirements and then issue the command again using a valid parameter.
-5 
You cannot make changes to the file because the readonly parameter is set to on.

pad Parameter
show Parameter