From aee29e51a6eb5db8f39c16f817527594d1c456d3 Mon Sep 17 00:00:00 2001 From: "Justin M. Keyes" Date: Sat, 9 Feb 2019 16:38:36 +0100 Subject: API: nvim_create_buf: add `scratch` parameter Creating a scratch buffer is a chore/ritual, and would be more useful/common if formally exposed. --- src/nvim/api/vim.c | 35 ++++++++++++++++++++++++----------- 1 file changed, 24 insertions(+), 11 deletions(-) (limited to 'src/nvim/api/vim.c') diff --git a/src/nvim/api/vim.c b/src/nvim/api/vim.c index 86e243c4f0..5a4d0a11e7 100644 --- a/src/nvim/api/vim.c +++ b/src/nvim/api/vim.c @@ -955,23 +955,36 @@ void nvim_set_current_win(Window window, Error *err) } } -/// Create new empty buffer +/// Creates a new, empty, unnamed buffer. /// -/// @param listed whether the buffer should be listed +/// @param listed Controls 'buflisted' +/// @param scratch Creates a "throwaway" |scratch-buffer| for temporary work +/// (always 'nomodified') /// @param[out] err Error details, if any -/// @return the buffer handle or 0 when error -Buffer nvim_create_buf(Boolean listed, Error *err) +/// @return Buffer handle, or 0 on error +/// +/// @see buf_open_scratch +Buffer nvim_create_buf(Boolean listed, Boolean scratch, Error *err) FUNC_API_SINCE(6) { try_start(); - Buffer buffer = buflist_add(NULL, - BLN_NOOPT | BLN_NEW | (listed ? BLN_LISTED : 0)); - if (!try_end(err) && buffer == 0) { - api_set_error(err, - kErrorTypeException, - "Failed to create buffer"); + buf_T *buf = buflist_new(NULL, NULL, (linenr_T)0, + BLN_NOOPT | BLN_NEW | (listed ? BLN_LISTED : 0)); + try_end(err); + if (buf == NULL) { + if (!ERROR_SET(err)) { + api_set_error(err, kErrorTypeException, "Failed to create buffer"); + } + return 0; + } + if (scratch) { + WITH_BUFFER(buf, { + set_option_value("bh", 0L, "hide", OPT_LOCAL); + set_option_value("bt", 0L, "nofile", OPT_LOCAL); + set_option_value("swf", 0L, NULL, OPT_LOCAL); + }); } - return buffer; + return buf->b_fnum; } /// Gets the current list of tabpage handles. -- cgit