cheatsheets/vimscript-snippets.md

title
Vimscript snippets

Functions

Inspecting the buffer

getline('.')
getline(1)
getline(1, 0)
line('.')      " current line number
search("^$")   " next blank line

getcurpos()   " [bufnum, lnum, col, off, curswant]
getpos('.')

expand('<cword>') " word under cursor
expand("%") " current file

Command line

Files

fnameescape("string")
fnamemodify("main.c", ":p:h")
filereadable(fname)
fnamemodify(fname, ':e')   " current file extension - see expand()
getfsize('file.txt')
getcwd()

Math

fmod(9, 2)  " modulus
floor(1.84)
ceil(1.84)
abs(-0.5)

Strings

if a =~ '\s*'

Binding

Bind function to key and command

command! YoFunctionHere call s:YoFunctionHere()
nnoremap <silent> x :call <SID>FunctionHere()<CR>
function! s:FunctionHere()
endfunction

Executing

Execute normal keystrokes

Running commands

normal 'ddahello'
exe 'normal ^C'  " with expansions
wincmd J

Call a function in insert mode

inoremap X <CR>=script#myfunction()<CR>
inoremap <F2> <C-R>=MyVimFunc()?'':''<CR>

Checking plugins

if globpath(&rtp, "plugin/commentary.vim") != ""

Autoload

" autoload/hello.vim
if exists("g:hello_loaded") | finish | endif
let g:hello_loaded=1

function hello#method()
endfunction

" calling hello#method() will load only if autoload()