Mercurial > vim
diff runtime/doc/eval.txt @ 14039:acb2dc112b06 v8.1.0037
patch 8.1.0037: cannot easily append lines to another buffer
commit https://github.com/vim/vim/commit/ca851593a660f08aba5c134f90c238d4a3e983e6
Author: Bram Moolenaar <Bram@vim.org>
Date: Wed Jun 6 21:04:07 2018 +0200
patch 8.1.0037: cannot easily append lines to another buffer
Problem: Cannot easily append lines to another buffer.
Solution: Add appendbufline().
author | Christian Brabandt <cb@256bit.org> |
---|---|
date | Wed, 06 Jun 2018 21:15:05 +0200 |
parents | dc67449d648c |
children | cbad3b3f46b2 |
line wrap: on
line diff
--- a/runtime/doc/eval.txt +++ b/runtime/doc/eval.txt @@ -2560,6 +2560,21 @@ append({lnum}, {expr}) *append()* 0 for success. Example: > :let failed = append(line('$'), "# THE END") :let failed = append(0, ["Chapter 1", "the beginning"]) + +appendbufline({expr}, {lnum}, {text}) *appendbufline()* + Like |append()| but append the text in buffer {expr}. + + For the use of {expr}, see |bufname()|. + + {lnum} is used like with |append()|. Note that using |line()| + would use the current buffer, not the one appending to. + Use "$" to append at the end of the buffer. + + On success 0 is returned, on failure 1 is returned. + + If {expr} is not a valid buffer or {lnum} is not valid, an + error message is given. Example: > + :let failed = appendbufline(13, 0, "# THE START") < *argc()* argc() The result is the number of files in the argument list of the