kevin/neovim
1
Fork 0
mirror of https://github.com/neovim/neovim.git synced 2024-12-19 18:55:14 -07:00
Code Issues Packages Projects Releases Wiki Activity

vim-patch:b8170143c8f8 (#27387)

Browse Source 
runtime(doc): further improve docs about List/Blob += operator

closes: vim/vim#13990

b8170143c8
This commit is contained in:
zeertzjq 2024-02-08 19:07:31 +08:00 committed by GitHub
parent b162adbb7c
commit 2a7c4aca42
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 28 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
runtime/doc/eval.txt
View File

@ -252,12 +252,15 @@ List concatenation ~
*list-concatenation*
Two lists can be concatenated with the "+" operator: >
:let longlist = mylist + [5, 6]
A list can be concatenated with another one in place using the "+=" operator or |extend()|: >
:let longlist = [5, 6] + mylist
To prepend or append an item, turn it into a list by putting [] around it.
A list can be concatenated with another one in-place using |:let+=| or
|extend()|: >
:let mylist += [7, 8]
:call extend(mylist, [7, 8])
To prepend or append an item, turn the item into a list by putting [] around
it. To change a list in-place, refer to |list-modification| below.
<
See |list-modification| below for more about changing a list in-place.
Sublist ~
@ -376,8 +379,7 @@ To change part of a list you can specify the first and last item to be
modified. The value must at least have the number of items in the range: >
:let list[3:5] = [3, 4, 5]
To add items to a List in-place, you can use the += operator
|list-concatenation|: >
To add items to a List in-place, you can use |:let+=| (|list-concatenation|): >
:let listA = [1, 2]
:let listA += [3, 4]
<
@ -697,12 +699,15 @@ This calls Doit() with 0x11, 0x22 and 0x33.
Blob concatenation ~
*blob-concatenation*
Two blobs can be concatenated with the "+" operator: >
:let longblob = myblob + 0z4455
:let longblob = 0z4455 + myblob
<
A blob can be concatenated with another one in-place using |:let+=|: >
:let myblob += 0z6677
To change a blob in-place see |blob-modification| below.
<
See |blob-modification| below for more about changing a blob in-place.
Part of a blob ~
@ -745,6 +750,18 @@ To change part of a blob you can specify the first and last byte to be
modified. The value must have the same number of bytes in the range: >
:let blob[3:5] = 0z334455
To add items to a Blob in-place, you can use |:let+=| (|blob-concatenation|): >
:let blobA = 0z1122
:let blobA += 0z3344
<
When two variables refer to the same Blob, changing one Blob in-place will
cause the referenced Blob to be changed in-place: >
:let blobA = 0z1122
:let blobB = blobA
:let blobB += 0z3344
:echo blobA
0z11223344
<
You can also use the functions |add()|, |remove()| and |insert()|.
@ -1893,6 +1910,8 @@ This does NOT work: >
:let {var} ..= {expr1} Like ":let {var} = {var} .. {expr1}".
These fail if {var} was not set yet and when the type
of {var} and {expr1} don't fit the operator.
`+=` modifies a |List| or a |Blob| in-place instead of
creating a new one.
:let ${env-name} = {expr1} *:let-environment* *:let-$*