Snabbreferens

Vimscript-funktioner Fusklapp

Snabbreferensguide för inbyggda Vimscript-funktioner: hantering av listor och dictionaries, buffertinspektion, markörrörelser och strängoperationer.

· Publicerad

En referensguide för Vims inbyggda skriptfunktioner och datastrukturer.

Datastrukturer

Dictionaries

let colors = {
  \ "apple": "red",
  \ "banana": "yellow"
}

echo colors["apple"]
echo get(colors, "apple")   " undertrycker fel om nyckeln saknas

call remove(colors, "apple")

" Inspektion och kontroller
if has_key(dict, 'foo')
if empty(dict)
keys(dict)
len(dict)

max(dict)
min(dict)
count(dict, 'x')
string(dict)

map(dict, 'v:val . "!"')
extend(s:fruits, { "cherry": "red" })
for key in keys(mydict)
  echo key . ': ' . mydict[key]
endfor

Listor

let mylist = [1, "two", 3, "four"]

let first = mylist[0]
let last  = mylist[-1]

" Säker hämtning med reservvärde
let second = get(mylist, 1)
let fallback = get(mylist, 10, "NONE")

Buffert & Markör

Buffertinspektion

line('.')             " Aktuellt radnummer
col('.')              " Aktuellt kolumnnummer
col('$')              " Sista kolumnen på aktuell rad

getline('.')          " Aktuell rad som sträng
getline(1)            " Rad 1 som sträng
getline(1, 5)         " Rad 1 till 5 som en lista av strängar
search('^$')          " Nummer för nästa tomma rad
search('^$', 'n')     " Hitta nästa tomma rad utan att flytta markören

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

nextnonblank(1)       " Nästa icke-tomma rad efter rad 1
prevnonblank(10)

Märken (Marks)

getpos("'a")          " Position för märke 'a'
setpos("'a", [0, 10, 5, 0])

getpos("'<")          " Startposition för visuell markering
getpos("'>")          " Slutposition för visuell markering

Markörpositionering

call cursor(line, col)
call cursor(line, col, off, curswant)

Filnamnsexpansion

expand('<cword>')      " Ord under markören
expand('<cfile>')      " Filsökväg under markören
expand('%')            " Aktuellt filnamn

" Modifierare:
" :p    Fullständig sökväg (/Users/name/project/file.txt)
" :h    Katalog (Head) (/Users/name/project)
" :t    Filnamn (Tail) (file.txt)
" :r    Basnamn utan filändelse (file)
" :e    Filändelse (txt)
" Exempel: expand('%:p:h')

Filer & Sökvägar

fnameescape('string')
fnamemodify('main.c', ':p:h')
fnamemodify(fname, ':e')
filereadable(fname)
getfsize('file.txt')
getcwd()

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

Matematik & Typer

Matematiska Operationer

fmod(9, 2)            " Modulo: 1.0
abs(-0.5)             " Absolutvärde
sqrt(9)               " Kvadratrot

trunc(1.84)           " 1.0
floor(1.84)           " 1.0
ceil(1.84)            " 2.0
float2nr(3.14)        " Konvertera float till heltal: 3

Typkonverteringar

str2float('0.2')
str2nr('240')
str2nr('ff', 16)      " Hexadecimal tolkning (Base-16)

string(0.3)           " Konvertera till sträng

Typkontroll

type(var) == type(0)            " Tal
type(var) == type("")           " Sträng
type(var) == type(function("tr")) " Funktionsreferens
type(var) == type([])           " Lista
type(var) == type({})           " Dictionary
type(var) == type(0.0)          " Flyttal

Strängar & Reguljära Uttryck

Strängmanipulering

if a =~ '\s*'
let clean = substitute(str, '\s\+', ' ', 'g')

strpart("abcdef", 3, 2)         " == "de" (Delsträng: förskjutning, längd)
strpart("abcdef", 3)            " == "def"
stridx("abcdef", "e")           " == 4 (Delsträng)
strridx("abcdef", "d")          " Omvänd indexsökning

matchstr('testing', 'test')     " == 'test' (Matchad text)
match('testing', 'test')        " == 0 (Startindex för matchning)
matchend('testing', 'test')     " == 4 (Slutindex för matchning)
match('testing', '\ctest')      " Ignorera skiftläge

split(str, '\zs')               " Dela sträng i teckenmatris

strlen(str)                     " Längd i byte
strchars(str)                   " Teckenantal (multibyte-kompatibel)
strdisplaywidth(str)            " Skärmkolumner

toupper(str)
tolower(str)
tr('foo', '_-', '  ')           " Teckenöversättning

Jämförelser

if name ==# 'John'     " Skiftlägeskänslig likhet
if name ==? 'John'     " Skiftlägesokänslig likhet
if name == 'John'      " Beroende på 'ignorecase'-inställning

if "hello" =~ '.*'     " Matchar mönster
if "hello" !~ '.*'     " Matchar inte mönster

Kommandon & Exekvering

Kör Kommandon

normal! ddahello
execute 'normal! ' . a:keys
wincmd J               " Kommando för fönsterförflyttning

Shell-kommandon

let output = system('ls ' . shellescape(expand('%:h')))

Register

getreg('*')            " Hämta urklippsinnehåll
getregtype('*')        " Registertyp: 'v' (tecken), 'V' (rad), '<ctrl-v>' (block)
setreg('*', 'new text')

Relaterade ämnen