Map (對應)

1. 按鍵對應 mapping 巨集

:map <F2> a<C-R>=strftime("%c")<CR><Esc>

1.1 MAP 命令 :map-commands

:imap aa foo
:imap aaa bar

:map @@ foo
:unmap @@ | print

unmap @@ 
unmap @@     " comment

unmap @@|    " comment

1.2 特殊引數 :map-arguments

:map <buffer>  ,w  /[.,;]<CR>

:map <buffer>  ,w  /[#&!]<CR>

:unmap <buffer> ,w
:mapclear <buffer>

:map <silent> ,h /Header<CR>

:map <silent> ,h :exe ":silent normal /Header\r"<CR>

:map <unique> ,w  /[#&!]<CR>

:map ,w  /[#&!]<CR>
:map <buffer> <unique> ,w  /[.,;]<CR>

:inoremap <expr> . <SID>InsertDot()

func StoreColumn()
  let g:column = col('.')
  return 'x'
endfunc
nnoremap <expr> x StoreColumn()
nmap ! f!x

nmap ! f!<Ignore>x

inoremap <expr> <C-L> nr2char(getchar())
inoremap <expr> <C-L>x "foo"

let counter = 0
inoremap <expr> <C-L> ListItem()
inoremap <expr> <C-R> ListReset()
func ListItem()
  let g:counter += 1
  return g:counter .. '. '
endfunc
func ListReset()
  let g:counter = 0
  return ''
endfunc

noremap x <Cmd>echo mode(1)<CR>

nnoremap <F3> aText <Cmd>echo mode(1)<CR> Added<Esc>

1.3 對應與模式 :map-modes

:omap { w

onoremap <silent> F :<C-U>normal! 0f(hviw<CR>

:map    xx something-difficult
:ounmap xx

1.4 列出對應 map-listing

:verbose map <C-W>*
n  <C-W>*      * <C-W><C-S>*
        Last set from ~/.config/nvim/init.vim

1.5 對應特殊按鍵 :map-special-keys

1.6 特殊字元 :map-special-chars

:map  <F8>  <Nop>
:map! <F8>  <Nop>

:set encoding=latin1
:imap <M-C> foo
:set encoding=utf-8

map <Leader>A  oanother line<Esc>

map \A  oanother line<Esc>

let mapleader = ","

map ,A  oanother line<Esc>

:map <buffer> <LocalLeader>A  oanother line<Esc>

:map  _ls  :!ls -l %:S<CR>:echo "the end"<CR>

1.7 要映射哪些按鍵 map-which-keys

1.8 範例 map-examples

:map <F3>  o#include
:map <M-g> /foo<CR>cwbar<Esc>
:map _x    d/END/e<CR>
:map! qq   quadrillion questions

:map <F4>  3w

:map <F4>  @='3w'<CR>

1.9 使用映射 map-typing

:map <buffer> <nowait> \a   :echo "Local \a"<CR>
:map                   \abc :echo "Global \abc"<CR>

:map <F1><Esc>OP :echo "yes"<CR>

:map ab abcd

:noremap k j
:noremap j k

:map x y
:map y x

1.10 映射 ALT 鍵 :map-alt-keys

1.11 映射 META 鍵 :map-meta-keys

:imap <T-b> terrible

:imap <D-b> barritone

1.13 映射運算符 :map-operator

nnoremap <expr> <F4> CountSpaces()
xnoremap <expr> <F4> CountSpaces()
" doubling <F4> works on a line
nnoremap <expr> <F4><F4> CountSpaces() .. '_'
function CountSpaces(context = {}, type = '') abort
  if a:type == ''
    let context = #{
      \ dot_command: v:false,
      \ extend_block: '',
      \ virtualedit: [&l:virtualedit, &g:virtualedit],
      \ }
    let &operatorfunc = function('CountSpaces', [context])
    set virtualedit=block
    return 'g@'
  endif
  let save = #{
    \ clipboard: &clipboard,
    \ selection: &selection,
    \ virtualedit: [&l:virtualedit, &g:virtualedit],
    \ register: getreginfo('"'),
    \ visual_marks: [getpos("'<"), getpos("'>")],
    \ }
  try
    set clipboard= selection=inclusive virtualedit=
    let commands = #{
      \ line: "'[V']",
      \ char: "`[v`]",
      \ block: "`[\<C-V>`]",
      \ }[a:type]
    let [_, _, col, off] = getpos("']")
    if off != 0
      let vcol = getline("'[")->strpart(0, col + off)->strdisplaywidth()
      if vcol >= [line("'["), '$']->virtcol() - 1
        let a:context.extend_block = '$'
      else
        let a:context.extend_block = vcol .. '|'
      endif
    endif
    if a:context.extend_block != ''
      let commands ..= 'oO' .. a:context.extend_block
    endif
    let commands ..= 'y'
    execute 'silent noautocmd keepjumps normal! ' .. commands
    echomsg getreg('"')->count(' ')
  finally
    call setreg('"', save.register)
    call setpos("'<", save.visual_marks[0])
    call setpos("'>", save.visual_marks[1])
    let &clipboard = save.clipboard
    let &selection = save.selection
    let [&l:virtualedit, &g:virtualedit] = get(a:context.dot_command ? save : a:context, 'virtualedit')
    let a:context.dot_command = v:true
  endtry
endfunction

nnoremap <F4> <Cmd>let &opfunc='{t ->
                        \ getline(".")
                        \ ->split("\\zs")
                        \ ->insert("\"", col("'']"))
                        \ ->insert("\"", col("''[") - 1)
                        \ ->join("")
                        \ ->setline(".")}'<CR>g@

2. 縮寫 abbreviation abbreviations Abbreviations

:ab hh        hello

:ab foo   four old otters

:ab #i #include

:ab ;; <endofline>

:iab if if ()<Left>

func Eatchar(pat)
   let c = nr2char(getchar(0))
   return (c =~ a:pat) ? '' : c
endfunc
iabbr <silent> if if ()<Left><C-R>=Eatchar('\s')<CR>

:abb <buffer> FF  for (i = 0; i < ; ++i)

:verbose abbreviate
!  teh                 the
        Last set from /home/abcd/vim/abbr.vim

3. 本機映射和函式 script-local

:map <SID>Add

let &includexpr = expand('<SID>') .. 'My_includeexpr()'

func s:ScriptNumber()
  return matchstr(expand('<SID>'), '<SNR>\zs\d\+\ze_')
endfunc

4. 使用者定義的命令 user-commands

:command Rename ...
:command Renumber ...
:Rena                                " Means "Rename"
:Renu                                " Means "Renumber"
:Ren                                " Error - ambiguous
:command Paste ...

filter Pyth command

:verbose command TOhtml

:let s:error = "None"
:command -nargs=1 Error echoerr <args>

:source script1.vim
:let s:error = "Wrong!"
:Error s:error

:function {func}(ArgLead, CmdLine, CursorPos)

:com -complete=custom,ListUsers -nargs=1 Finger !finger <args>
:fun ListUsers(A,L,P)
:    return system("cut -d: -f1 /etc/passwd")
:endfun

:com -nargs=1 -bang -complete=customlist,EditFileComplete
                    \ EditFile edit<bang> <args>
:fun EditFileComplete(A,L,P)
:    return split(globpath(&path, a:A), "\n")
:endfun

function cmdpreview(opts, ns, buf)

-- If invoked as a preview callback, performs 'inccommand' preview by
-- highlighting trailing whitespace in the current buffer.
local function trim_space_preview(opts, preview_ns, preview_buf)
  vim.cmd('hi clear Whitespace')
  local line1 = opts.line1
  local line2 = opts.line2
  local buf = vim.api.nvim_get_current_buf()
  local lines = vim.api.nvim_buf_get_lines(buf, line1 - 1, line2, false)
  local preview_buf_line = 0
  for i, line in ipairs(lines) do
    local start_idx, end_idx = string.find(line, '%s+$')
    if start_idx then
      -- Highlight the match
      vim.api.nvim_buf_add_highlight(
        buf,
        preview_ns,
        'Substitute',
        line1 + i - 2,
        start_idx - 1,
        end_idx
      )
      -- Add lines and set highlights in the preview buffer
      -- if inccommand=split
      if preview_buf then
        local prefix = string.format('|%d| ', line1 + i - 1)
        vim.api.nvim_buf_set_lines(
          preview_buf,
          preview_buf_line,
          preview_buf_line,
          false,
          { prefix .. line }
        )
        vim.api.nvim_buf_add_highlight(
          preview_buf,
          preview_ns,
          'Substitute',
          preview_buf_line,
          #prefix + start_idx - 1,
          #prefix + end_idx
        )
        preview_buf_line = preview_buf_line + 1
      end
    end
  end
  -- Return the value of the preview type
  return 2
end
-- Trims all trailing whitespace in the current buffer.
local function trim_space(opts)
  local line1 = opts.line1
  local line2 = opts.line2
  local buf = vim.api.nvim_get_current_buf()
  local lines = vim.api.nvim_buf_get_lines(buf, line1 - 1, line2, false)
  local new_lines = {}
  for i, line in ipairs(lines) do
    new_lines[i] = string.gsub(line, '%s+$', '')
  end
  vim.api.nvim_buf_set_lines(buf, line1 - 1, line2, false, new_lines)
end
-- Create the user command
vim.api.nvim_create_user_command(
  'TrimTrailingWhitespace',
  trim_space,
  { nargs = '?', range = '%', addr = 'lines', preview = trim_space_preview }
)

command! -nargs=+ -complete=file MyEdit
            \ for f in expand(<q-args>, 0, 1) |
            \ exe '<mods> split ' .. f |
            \ endfor
function! SpecialEdit(files, mods)
    for f in expand(a:files, 0, 1)
        exe a:mods .. ' split ' .. f
    endfor
endfunction
command! -nargs=+ -complete=file Sedit
            \ call SpecialEdit(<q-args>, <q-mods>)

" Delete everything after here to the end
:com Ddel +,$d
" Rename the current buffer
:com -nargs=1 -bang -complete=file Ren f <args>|w<bang>
" Replace a range with the contents of a file
" (Enter this all as one line)
:com -range -nargs=1 -complete=file
      Replace <line1>-pu_|<line1>,<line2>d|r <args>|<line1>d
" Count the number of lines in the range
:com! -range -nargs=0 Lines  echo <line2> - <line1> + 1 "lines"

:com -nargs=* Mycmd call Myfunc(<f-args>)

:Mycmd arg1 arg2

:call Myfunc("arg1","arg2")

:function Allargs(command)
:   let i = 0
:   while i < argc()
:          if filereadable(argv(i))
:             execute "e " .. argv(i)
:             execute a:command
:      endif
:      let i = i + 1
:   endwhile
:endfunction
:command -nargs=+ -complete=command Allargs call Allargs(<q-args>)

:Allargs %s/foo/bar/ge|update

:call Allargs("%s/foo/bar/ge|update")