CPL Cursor Preceding Line
Move the cursor up n lines, to the start of the line.
CSI Pn F
- Defaults
- Pn = 1
- ECMA-48
- §8.3.13 CPL – Cursor Preceding Line, p. 35
- VT510
- CPL—Cursor Previous Line
Move the cursor Pn lines up and to the first character position of that line. A 0 is taken as 1. The VT510 manual calls it Cursor Previous Line.
It is a CUU followed by a carriage return, and behaves as those two do. The cursor stops at the top margin, or the first line if it started above the margin, and never scrolls. With left and right margins set, it goes to the left margin rather than the first column.
DEC STD 070 does not define CPL. The VT510 manual does, as does xterm.
Validation
CPL-1: The previous line
\e[3;3H
\e[F
X
|_____|
|X____|
|_____|
CPL-2: n lines up
\e[3;3H
\e[2F
X
|X____|
|_____|
|_____|
CPL-3: Stops at the top margin, without scrolling
\e[4;1H
A
\e[2;4r # region is lines 2 to 4
\e[3;3H
\e[9F
X
|_____|
|X____|
|_____|
|A____|
CPL-4: To the left margin
\e[?69h # allow left and right margins
\e[2;4s # margins at columns 2 and 4
\e[2;3H
\e[F
X
|_X___|
|_____|