Merge pull request #24747 from zeertzjq/vim-8.2.1969

vim-patch:8.2.{1969,1971,2075}: mapnew()

1 files changed, 15 insertions, 0 deletions

diff --git a/src/nvim/eval.lua b/src/nvim/eval.lua
index 8a36509f9a..97b10a46c0 100644
--- a/src/nvim/eval.lua
+++ b/src/nvim/eval.lua
@@ -6053,6 +6053,8 @@ M.funcs = {
       {expr1} must be a |List|, |Blob| or |Dictionary|.
       Replace each item in {expr1} with the result of evaluating
       {expr2}.  For a |Blob| each byte is replaced.
+      If the item type changes you may want to use |mapnew()| to
+      create a new List or Dictionary.
 
       {expr2} must be a |string| or |Funcref|.
 
@@ -6215,6 +6217,19 @@ M.funcs = {
     params = { { 'name', 'string' }, { 'mode', 'string' }, { 'abbr', 'any' } },
     signature = 'mapcheck({name} [, {mode} [, {abbr}]])',
   },
+  mapnew = {
+    args = 2,
+    base = 1,
+    desc = [=[
+      Like |map()| but instead of replacing items in {expr1} a new
+      List or Dictionary is created and returned.  {expr1} remains
+      unchanged.  Items can still be changed by {expr2}, if you
+      don't want that use |deepcopy()| first.
+    ]=],
+    name = 'mapnew',
+    params = { { 'expr1', 'any' }, { 'expr2', 'any' } },
+    signature = 'mapnew({expr1}, {expr2})',
+  },
   mapset = {
     args = 3,
     base = 1,