vim.text

Run diff on strings {a} and {b}. Any indices returned by this function, either directly or via callback arguments, are 1-based.

Examples:

vim.text.diff('a\n', 'b\nc\n')
-- =>
-- @@ -1 +1,2 @@
-- -a
-- +b
-- +c

vim.text.diff('a\n', 'b\nc\n', {result_type = 'indices'})
-- =>
-- {
--   {1, 1, 1, 2}
-- }

Hex encode a string.

Hex decode a string.

Sets the indent (i.e. the common leading whitespace) of non-empty lines in text to size spaces/tabs.

Indent is calculated by number of consecutive indent chars.

• The first indented, non-empty line decides the indent char (space/tab):
• SPC SPC TAB … = two-space indent.
• TAB SPC … = one-tab indent.
• Set opts.expandtab to treat tabs as spaces.

To "dedent" (remove the common indent), pass size=0:

vim.print(vim.text.indent(0, ' a\n  b\n'))

To adjust relative-to an existing indent, call indent() twice:

local indented, old_indent = vim.text.indent(0, ' a\n b\n')
indented = vim.text.indent(old_indent + 2, indented)
vim.print(indented)

To ignore the final, blank line when calculating the indent, use gsub() before calling indent():

local text = '  a\n  b\n '
vim.print(vim.text.indent(0, (text:gsub('\n[\t ]+\n?$', '\n'))))