Editing Moving lines up or down

{{TipImported
|id=646
|previous=645
|next=647
|created=2004
|complexity=basic
|author=
|version=6.0
|rating=80/42
|category1=Moving
|category2=
}}
Programmers often want to move a line of text up or down, or to some other position. We start by explaining the basics (cut and paste, as well as move), and show how to append to a register. An amazing trick with the redo register is then [[#Reordering up to nine lines|presented]] (useful for reordering up to nine lines), and there is a set of mappings so you can press a key to move the current line, or a block of selected lines, up or down.

==Cut and paste==
Cut the line that you want to move by typing <code>dd</code>, or visually select some lines (press <code>V</code> then move the cursor) and type <code>d</code> to cut the selected block.

You can cut several lines, or blocks of text, by appending to a register using an uppercase letter, for example:
*
*Move to the wanted destination.
*Press <code>"ap</code> to paste after the line with the cursor, or <code>"aP</code> to paste before.

==Move command==
You can move a line, or a block of lines, with the <code>:m</code> command. Examples:
{| class="cleartable"
| <code>:m 12</code> || move current line to after line 12
|-
| <code>:m 0</code> || move current line to before first line
|-
| <code>:m $</code> || move current line to after last line
|-
| <code>:m 'a</code> || move current line to after line with mark <code>a</code> (see [[using marks]])
|-
| <code>:m 'a-1</code> || move current line to before line with mark <code>a</code>
|-
| <code>:m '}-1</code> || move current line to the end of the current paragraph
|}

For clarity, a space is shown after the <code>:m</code> commands above, but that space is not required.

To move a block of lines, use the same command but visually select the lines before entering the move command. You can also use arbitrary [[ranges]] with the move command. Examples:
{| class="cleartable"
| <code>:5,7m 21</code> || move lines 5, 6 and 7 to after line 21
|-
| <code>:5,7m 0</code> || move lines 5, 6 and 7 to before first line
|-
| <code>:5,7m $</code> || move lines 5, 6 and 7 to after last line
|-
| <code>:.,.+4m 21</code> || move 5 lines starting at current line to after line 21
|-
| <code>:,+4m14</code> || same (<code>.</code> for current line is assumed)
|}

==Reordering up to nine lines==
The following example lines can be moved to a different order by deleting each line in turn (starting with the line that will be first when the move is complete):
<pre>
line 3
line 9
line 8
line 1
line 5
line 7
line 2
line 6
line 4
</pre>

Move the cursor to "line&nbsp;1" and type <code>dd</code> to delete the line. Go to "line&nbsp;2" and press <code>.</code> to repeat (delete another line). Repeat this on "line&nbsp;3", and so on, until everything has been deleted in order.

Now type <code>"1P</code> to paste the contents of register 1 before the cursor.

Repeat with the dot command, eight times:
<pre>
........
</pre>

The first dot command pastes register 2, and the next pastes register 3, and so on. The result is that all the lines are pasted, in the correct order.

You have to press <code>.</code> eight times (using a count like <code>8.</code> will insert the same line eight times). See {{help|redo-register}}

==Mappings to move lines==
The following mappings in your [[vimrc]] provide a quick way to move lines of text up or down. The mappings work in normal, insert and visual modes, allowing you to move the current line, or a selected block of lines.
<pre>
nnoremap <A-j> :m .+1<CR>==
nnoremap <A-k> :m .-2<CR>==
inoremap <A-j> <Esc>:m .+1<CR>==gi
inoremap <A-k> <Esc>:m .-2<CR>==gi
vnoremap <A-j> :m '>+1<CR>gv=gv
vnoremap <A-k> :m '<-2<CR>gv=gv
</pre>

In normal mode or in insert mode, press Alt-j to move the current line down, or press Alt-k to move the current line up.

After visually selecting a block of lines (for example, by pressing <code>V</code> then moving the cursor down), press Alt-j to move the whole block down, or press Alt-k to move the block up.

===Explanation===
The command <code>:m .+1</code> (which can be abbreviated to <code>:m+</code>) moves the current line to after line number <code>.+1</code> (current line number + 1). That is, the current line is moved down one line.

The command <code>:m .-2</code> (which can be abbreviated to <code>:m-2</code>) moves the current line to after line number <code>.-2</code> (current line number − 2). That is, the current line is moved up one line.

After visually selecting some lines, entering <code>:m '>+1</code> moves the selected lines to after line number <code>'>+1</code> (one line after the last selected line; <code>'></code> is a mark assigned by Vim to identify the selection end). That is, the block of selected lines is moved down one line.

The <code>==</code> re-indents the line to suit its new position. For the visual-mode mappings, <code>gv</code> reselects the last visual block and <code>=</code> re-indents that block.

==See also==
*[[VimTip191|Transposing]] enhanced mappings (better at maintaining cursor position?)
*[[VimTip344|Cut or copy lines without counting the lines]] ''(needs to be fixed)''
*[http://stackoverflow.com/questions/741814/move-entire-line-up-and-down-in-vim  stackoverflow - Move entire line up and down in Vim]
*[https://stackoverflow.com/questions/7501092/can-i-map-alt-key-in-vim/15399297#15399297 stackoverflow - Alt keys in Vim on OS X]

==Comments==
@@ Line 15: / Line 15: @@
 ==Cut and paste==
 Cut the line that you want to move by typing <code>dd</code>, or visually select some lines (press <code>V</code> then move the cursor) and type <code>d</code> to cut the selected block.
-Then move the cursor, and paste the text at the new position (press <code>p</code> to paste after the line with the cursor, or <code>P</code> to paste before).
 You can cut several lines, or blocks of text, by appending to a register using an uppercase letter, for example:
+*
-*Move to the first line you wish to move; type <code>"add</code> to delete it to register <code>a</code>.
-*Move to another line; type <code>"Add</code> to delete it and ''append'' to the same register.
-*Move to another line; type <code>"Add</code> to delete it and ''append'' to the same register.
-**or type "." for the same effect
-*Select a range of lines vith V; type <code>"Ad</code> to delete the entire range and append it to the same register.
-*Continue in this fashion.
 *Move to the wanted destination.
 *Press <code>"ap</code> to paste after the line with the cursor, or <code>"aP</code> to paste before.