aboutsummaryrefslogtreecommitdiff
path: root/runtime/lua/vim/_meta/spell.lua
blob: c636db3b5353009b471fbf39a5f15d2ec4092afc (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
--- @meta

-- luacheck: no unused args

--- Check {str} for spelling errors. Similar to the Vimscript function
--- [spellbadword()].
---
--- Note: The behaviour of this function is dependent on: 'spelllang',
--- 'spellfile', 'spellcapcheck' and 'spelloptions' which can all be local to
--- the buffer. Consider calling this with [nvim_buf_call()].
---
--- Example:
---
--- ```lua
--- vim.spell.check("the quik brown fox")
--- -- =>
--- -- {
--- --     {'quik', 'bad', 5}
--- -- }
--- ```
---
--- @param str string
--- @return {[1]: string, [2]: 'bad'|'rare'|'local'|'caps', [3]: integer}[]
---   List of tuples with three items:
---     - The badly spelled word.
---     - The type of the spelling error:
---         "bad"   spelling mistake
---         "rare"  rare word
---         "local" word only valid in another region
---         "caps"  word should start with Capital
---     - The position in {str} where the word begins.
function vim.spell.check(str) end