Tip 191 Printable Monobook Previous Next

created 2002 · complexity intermediate · author Kontra Gergely · version 5.7

Swapping lines and columns[edit | edit source]

The transpose.vim plugin can be used to transpose arrays of text, lines becoming columns and columns becoming lines. It can handle arrays of text or arrays of delimited fields.

Swapping lines[edit | edit source]

Swapping a line with the line directly above or below it is a common task when writing computer software. This tip provides some mappings for normal, insert and visual modes which make this more easily accomplished. Adding the following to your _vimrc file allows you to move a line (or multiple lines) of text up or down within a document using the <Control> and <Up>/<Down> arrow keys. This is similar to the <Alt> and <Up>/<Down> arrow text movement feature in Eclipse.

function! MoveLineUp()
  call MoveLineOrVisualUp(".", "")

function! MoveLineDown()
  call MoveLineOrVisualDown(".", "")

function! MoveVisualUp()
  call MoveLineOrVisualUp("'<", "'<,'>")
  normal gv

function! MoveVisualDown()
  call MoveLineOrVisualDown("'>", "'<,'>")
  normal gv

function! MoveLineOrVisualUp(line_getter, range)
  let l_num = line(a:line_getter)
  if l_num - v:count1 - 1 < 0
    let move_arg = "0"
    let move_arg = a:line_getter." -".(v:count1 + 1)
  call MoveLineOrVisualUpOrDown(a:range."move ".move_arg)

function! MoveLineOrVisualDown(line_getter, range)
  let l_num = line(a:line_getter)
  if l_num + v:count1 > line("$")
    let move_arg = "$"
    let move_arg = a:line_getter." +".v:count1
  call MoveLineOrVisualUpOrDown(a:range."move ".move_arg)

function! MoveLineOrVisualUpOrDown(move_arg)
  let col_num = virtcol(".")
  execute "silent! ".a:move_arg
  execute "normal! ".col_num."|"

nnoremap <silent> <C-Up> :<C-u>call MoveLineUp()<CR>
nnoremap <silent> <C-Down> :<C-u>call MoveLineDown()<CR>
inoremap <silent> <C-Up> <C-o>:call MoveLineUp()<CR>
inoremap <silent> <C-Down> <C-o>:call MoveLineDown()<CR>
"vnoremap <silent> <C-Up> :<C-u>call MoveVisualUp()<CR>
"vnoremap <silent> <C-Down> :<C-u>call MoveVisualDown()<CR>
xnoremap <silent> <C-Up> :<C-u>call MoveVisualUp()<CR>
xnoremap <silent> <C-Down> :<C-u>call MoveVisualDown()<CR>

The above mappings all take a count so 5<C-Up> would move the current line (or visual selection) 5 lines up.

They make use of the :move command to do the movement which avoids overwritting a register which other methods may suffer from. As :move wont move a line to an invalid location an extra check is made to move no further than the start (or end) of the file. The mappings are also careful to restore the original cursor location in the line (or selection) by first getting it with virtcol() and then restoring it with |.

See also[edit | edit source]

Related plugins[edit | edit source]

  • unimpaired.vim [e and ]e exchange current line with [count] lines above/below
  • LineJuggler plugin has [e and ]e (among other movement and duplication related mappings)
  • upAndDown.vim plugin implementing this tip

References[edit | edit source]

Comments[edit | edit source]

Community content is available under CC-BY-SA unless otherwise noted.