Mercurial > vim

annotate runtime/doc/eval.txt @ 23602:7b3317e959e3 v8.2.2343

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
patch 8.2.2343: Vim9: return type of readfile() is any Commit: https://github.com/vim/vim/commit/c423ad77ed763c11ba67729bbf63c1cf0915231f Author: Bram Moolenaar <Bram@vim.org> Date: Wed Jan 13 20:38:03 2021 +0100 patch 8.2.2343: Vim9: return type of readfile() is any Problem: Vim9: return type of readfile() is any. Solution: Add readblob() so that readfile() can be expected to always return a list of strings. (closes #7671)
author Bram Moolenaar <Bram@vim.org>
date Wed, 13 Jan 2021 20:45:04 +0100
parents d3e064f54890
children 1816ea68c022
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
23602
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
1 *eval.txt* For Vim version 8.2. Last change: 2021 Jan 13
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4 VIM REFERENCE MANUAL by Bram Moolenaar
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7 Expression evaluation *expression* *expr* *E15* *eval*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9 Using expressions is introduced in chapter 41 of the user manual |usr_41.txt|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11 Note: Expression evaluation can be disabled at compile time. If this has been
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
12 done, the features in this document are not available. See |+eval| and
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
13 |no-eval-feature|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14
19181
94eda51ba9ba patch 8.2.0149: maintaining a Vim9 branch separately is more work
Bram Moolenaar <Bram@vim.org>
parents: 19163
diff changeset
15 This file is about the backwards compatible Vim script. For Vim9 script,
94eda51ba9ba patch 8.2.0149: maintaining a Vim9 branch separately is more work
Bram Moolenaar <Bram@vim.org>
parents: 19163
diff changeset
16 which executes much faster, supports type checking and much more, see
94eda51ba9ba patch 8.2.0149: maintaining a Vim9 branch separately is more work
Bram Moolenaar <Bram@vim.org>
parents: 19163
diff changeset
17 |vim9.txt|.
94eda51ba9ba patch 8.2.0149: maintaining a Vim9 branch separately is more work
Bram Moolenaar <Bram@vim.org>
parents: 19163
diff changeset
18
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
19 1. Variables |variables|
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
20 1.1 Variable types
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
21 1.2 Function references |Funcref|
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
22 1.3 Lists |Lists|
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
23 1.4 Dictionaries |Dictionaries|
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
24 1.5 Blobs |Blobs|
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
25 1.6 More about variables |more-variables|
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
26 2. Expression syntax |expression-syntax|
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
27 3. Internal variable |internal-variables|
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
28 4. Builtin Functions |functions|
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
29 5. Defining functions |user-functions|
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
30 6. Curly braces names |curly-braces-names|
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
31 7. Commands |expression-commands|
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
32 8. Exception handling |exception-handling|
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
33 9. Examples |eval-examples|
16223
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
34 10. Vim script version |vimscript-version|
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
35 11. No +eval feature |no-eval-feature|
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
36 12. The sandbox |eval-sandbox|
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
37 13. Textlock |textlock|
17456
e414281d8bb4 patch 8.1.1726: the eval.txt help file is too big
Bram Moolenaar <Bram@vim.org>
parents: 17450
diff changeset
38
e414281d8bb4 patch 8.1.1726: the eval.txt help file is too big
Bram Moolenaar <Bram@vim.org>
parents: 17450
diff changeset
39 Testing support is documented in |testing.txt|.
e414281d8bb4 patch 8.1.1726: the eval.txt help file is too big
Bram Moolenaar <Bram@vim.org>
parents: 17450
diff changeset
40 Profiling is documented at |profiling|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43 1. Variables *variables*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
45 1.1 Variable types ~
15579
391ac26c9412 patch 8.1.0797: error E898 is used twice
Bram Moolenaar <Bram@vim.org>
parents: 15571
diff changeset
46 *E712* *E896* *E897* *E899*
17909
cc953757ed2a Runtime files update.
Bram Moolenaar <Bram@vim.org>
parents: 17857
diff changeset
47 There are ten types of variables:
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
48
18831
6848b809a26e Runtime file updates.
Bram Moolenaar <Bram@vim.org>
parents: 18790
diff changeset
49 *Number* *Integer*
6848b809a26e Runtime file updates.
Bram Moolenaar <Bram@vim.org>
parents: 18790
diff changeset
50 Number A 32 or 64 bit signed number. |expr-number|
19477
2bb0e80fcd32 patch 8.2.0296: mixing up "long long" and __int64 may cause problems
Bram Moolenaar <Bram@vim.org>
parents: 19400
diff changeset
51 The number of bits is available in |v:numbersize|.
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
52 Examples: -123 0x10 0177 0o177 0b1011
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
53
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
54 Float A floating point number. |floating-point-format| *Float*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
55 {only when compiled with the |+float| feature}
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
56 Examples: 123.456 1.15e-6 -1.1e3
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
57
9041
34c45ee4210d commit https://github.com/vim/vim/commit/06481427005a9dae39721087df94855f7d4d1feb
Christian Brabandt <cb@256bit.org>
parents: 8951
diff changeset
58 *E928*
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
59 String A NUL terminated string of 8-bit unsigned characters (bytes).
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
60 |expr-string| Examples: "ab\txx\"--" 'x-z''a,c'
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
61
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
62 List An ordered sequence of items, see |List| for details.
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
63 Example: [1, 2, ['a', 'b']]
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
64
370
3a21825ad207 updated for version 7.0095
vimboss
parents: 359
diff changeset
65 Dictionary An associative, unordered array: Each entry has a key and a
3a21825ad207 updated for version 7.0095
vimboss
parents: 359
diff changeset
66 value. |Dictionary|
17368
6604ecb7a615 patch 8.1.1683: dictionary with string keys is longer than needed
Bram Moolenaar <Bram@vim.org>
parents: 17366
diff changeset
67 Examples:
6604ecb7a615 patch 8.1.1683: dictionary with string keys is longer than needed
Bram Moolenaar <Bram@vim.org>
parents: 17366
diff changeset
68 {'blue': "#0000ff", 'red': "#ff0000"}
17413
40417757dffd patch 8.1.1705: using ~{} for a literal dict is not nice
Bram Moolenaar <Bram@vim.org>
parents: 17387
diff changeset
69 #{blue: "#0000ff", red: "#ff0000"}
370
3a21825ad207 updated for version 7.0095
vimboss
parents: 359
diff changeset
70
7957
b74549818500 commit https://github.com/vim/vim/commit/835dc636a5350f610b62f110227d2363b5b2880a
Christian Brabandt <cb@256bit.org>
parents: 7935
diff changeset
71 Funcref A reference to a function |Funcref|.
b74549818500 commit https://github.com/vim/vim/commit/835dc636a5350f610b62f110227d2363b5b2880a
Christian Brabandt <cb@256bit.org>
parents: 7935
diff changeset
72 Example: function("strlen")
9104
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
73 It can be bound to a dictionary and arguments, it then works
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
74 like a Partial.
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
75 Example: function("Callback", [arg], myDict)
7957
b74549818500 commit https://github.com/vim/vim/commit/835dc636a5350f610b62f110227d2363b5b2880a
Christian Brabandt <cb@256bit.org>
parents: 7935
diff changeset
76
8178
e77efd7a7dad commit https://github.com/vim/vim/commit/02e83b438ea7071fdb176dabbaefea319ab2d686
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
77 Special |v:false|, |v:true|, |v:none| and |v:null|. *Special*
e77efd7a7dad commit https://github.com/vim/vim/commit/02e83b438ea7071fdb176dabbaefea319ab2d686
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
78
8881
ed0b39dd7fd6 commit https://github.com/vim/vim/commit/ebf7dfa6f121c82f97d2adca3d45fbaba9ad8f7e
Christian Brabandt <cb@256bit.org>
parents: 8876
diff changeset
79 Job Used for a job, see |job_start()|. *Job* *Jobs*
ed0b39dd7fd6 commit https://github.com/vim/vim/commit/ebf7dfa6f121c82f97d2adca3d45fbaba9ad8f7e
Christian Brabandt <cb@256bit.org>
parents: 8876
diff changeset
80
ed0b39dd7fd6 commit https://github.com/vim/vim/commit/ebf7dfa6f121c82f97d2adca3d45fbaba9ad8f7e
Christian Brabandt <cb@256bit.org>
parents: 8876
diff changeset
81 Channel Used for a channel, see |ch_open()|. *Channel* *Channels*
7957
b74549818500 commit https://github.com/vim/vim/commit/835dc636a5350f610b62f110227d2363b5b2880a
Christian Brabandt <cb@256bit.org>
parents: 7935
diff changeset
82
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
83 Blob Binary Large Object. Stores any sequence of bytes. See |Blob|
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
84 for details
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
85 Example: 0zFF00ED015DAF
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
86 0z is an empty Blob.
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
87
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
88 The Number and String types are converted automatically, depending on how they
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
89 are used.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
90
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
91 Conversion from a Number to a String is by making the ASCII representation of
2581
e8a482a7fa6c Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
92 the Number. Examples:
e8a482a7fa6c Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
93 Number 123 --> String "123" ~
e8a482a7fa6c Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
94 Number 0 --> String "0" ~
e8a482a7fa6c Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
95 Number -1 --> String "-1" ~
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2120
diff changeset
96 *octal*
21409
2c40e60017a8 patch 8.2.1255: cannot use a lambda with quickfix functions
Bram Moolenaar <Bram@vim.org>
parents: 21381
diff changeset
97 Conversion from a String to a Number only happens in legacy Vim script, not in
2c40e60017a8 patch 8.2.1255: cannot use a lambda with quickfix functions
Bram Moolenaar <Bram@vim.org>
parents: 21381
diff changeset
98 Vim9 script. It is done by converting the first digits to a number.
2c40e60017a8 patch 8.2.1255: cannot use a lambda with quickfix functions
Bram Moolenaar <Bram@vim.org>
parents: 21381
diff changeset
99 Hexadecimal "0xf9", Octal "017" or "0o17", and Binary "0b10"
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
100 numbers are recognized
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
101 NOTE: when using |scriptversion-4| octal with a leading "0" is not recognized.
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
102 The 0o notation requires patch 8.2.0886.
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
103 If the String doesn't start with digits, the result is zero.
7477
05cf4cc72a9f commit https://github.com/vim/vim/commit/fa7353428f705f7a13465a1943dddeede4083023
Christian Brabandt <cb@256bit.org>
parents: 7384
diff changeset
104 Examples:
2581
e8a482a7fa6c Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
105 String "456" --> Number 456 ~
e8a482a7fa6c Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
106 String "6bar" --> Number 6 ~
e8a482a7fa6c Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
107 String "foo" --> Number 0 ~
e8a482a7fa6c Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
108 String "0xf1" --> Number 241 ~
e8a482a7fa6c Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
109 String "0100" --> Number 64 ~
20665
6ff992bf4c82 patch 8.2.0886: cannot use octal numbers in scriptversion 4
Bram Moolenaar <Bram@vim.org>
parents: 20649
diff changeset
110 String "0o100" --> Number 64 ~
7477
05cf4cc72a9f commit https://github.com/vim/vim/commit/fa7353428f705f7a13465a1943dddeede4083023
Christian Brabandt <cb@256bit.org>
parents: 7384
diff changeset
111 String "0b101" --> Number 5 ~
2581
e8a482a7fa6c Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
112 String "-8" --> Number -8 ~
e8a482a7fa6c Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
113 String "+8" --> Number 0 ~
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
114
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
115 To force conversion from String to Number, add zero to it: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
116 :echo "0100" + 0
782
d20041a02ee5 updated for version 7.0228
vimboss
parents: 777
diff changeset
117 < 64 ~
d20041a02ee5 updated for version 7.0228
vimboss
parents: 777
diff changeset
118
d20041a02ee5 updated for version 7.0228
vimboss
parents: 777
diff changeset
119 To avoid a leading zero to cause octal conversion, or for using a different
d20041a02ee5 updated for version 7.0228
vimboss
parents: 777
diff changeset
120 base, use |str2nr()|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
121
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
122 *TRUE* *FALSE* *Boolean*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
123 For boolean operators Numbers are used. Zero is FALSE, non-zero is TRUE.
22723
5b7ea82bc18f Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22689
diff changeset
124 You can also use |v:false| and |v:true|. In Vim9 script |false| and |true|.
22171
d4c7b3e9cd17 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22077
diff changeset
125 When TRUE is returned from a function it is the Number one, FALSE is the
d4c7b3e9cd17 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22077
diff changeset
126 number zero.
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
127
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
128 Note that in the command: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
129 :if "foo"
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
130 :" NOT executed
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
131 "foo" is converted to 0, which means FALSE. If the string starts with a
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
132 non-zero number it means TRUE: >
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
133 :if "8foo"
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
134 :" executed
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
135 To test for a non-empty string, use empty(): >
3893
c3036f1dca68 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3875
diff changeset
136 :if !empty("foo")
22492
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
137
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
138 < *falsy* *truthy*
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
139 An expression can be used as a condition, ignoring the type and only using
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
140 whether the value is "sort of true" or "sort of false". Falsy is:
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
141 the number zero
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
142 empty string, blob, list or dictionary
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
143 Other values are truthy. Examples:
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
144 0 falsy
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
145 1 truthy
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
146 -1 truthy
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
147 0.0 falsy
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
148 0.1 truthy
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
149 '' falsy
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
150 'x' truthy
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
151 [] falsy
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
152 [0] truthy
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
153 {} falsy
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
154 #{x: 1} truthy
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
155 0z falsy
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
156 0z00 truthy
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
157
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
158 *non-zero-arg*
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
159 Function arguments often behave slightly different from |TRUE|: If the
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
160 argument is present and it evaluates to a non-zero Number, |v:true| or a
10140
b11ceef7116e commit https://github.com/vim/vim/commit/64d8e25bf6efe5f18b032563521c3ce278c316ab
Christian Brabandt <cb@256bit.org>
parents: 10054
diff changeset
161 non-empty String, then the value is considered to be TRUE.
12756
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
162 Note that " " and "0" are also non-empty strings, thus considered to be TRUE.
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
163 A List, Dictionary or Float is not a Number or String, thus evaluate to FALSE.
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
164
8061
abd64cf67bcf commit https://github.com/vim/vim/commit/38a55639d603823efcf2d2fdf542dbffdeb60b75
Christian Brabandt <cb@256bit.org>
parents: 8031
diff changeset
165 *E745* *E728* *E703* *E729* *E730* *E731* *E908* *E910* *E913*
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
166 *E974* *E975* *E976*
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
167 |List|, |Dictionary|, |Funcref|, |Job|, |Channel| and |Blob| types are not
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
168 automatically converted.
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
169
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
170 *E805* *E806* *E808*
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
171 When mixing Number and Float the Number is converted to Float. Otherwise
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
172 there is no automatic conversion of Float. You can use str2float() for String
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
173 to Float, printf() for Float to String and float2nr() for Float to Number.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
174
8061
abd64cf67bcf commit https://github.com/vim/vim/commit/38a55639d603823efcf2d2fdf542dbffdeb60b75
Christian Brabandt <cb@256bit.org>
parents: 8031
diff changeset
175 *E891* *E892* *E893* *E894* *E907* *E911* *E914*
7707
41768bcebc9b commit https://github.com/vim/vim/commit/13d5aeef56e3140a8eb8f40c7062aa1c5700f76e
Christian Brabandt <cb@256bit.org>
parents: 7703
diff changeset
176 When expecting a Float a Number can also be used, but nothing else.
41768bcebc9b commit https://github.com/vim/vim/commit/13d5aeef56e3140a8eb8f40c7062aa1c5700f76e
Christian Brabandt <cb@256bit.org>
parents: 7703
diff changeset
177
8512
5104f96b6ecf commit https://github.com/vim/vim/commit/f6f32c38bf3319144a84a01a154c8c91939e7acf
Christian Brabandt <cb@256bit.org>
parents: 8502
diff changeset
178 *no-type-checking*
5104f96b6ecf commit https://github.com/vim/vim/commit/f6f32c38bf3319144a84a01a154c8c91939e7acf
Christian Brabandt <cb@256bit.org>
parents: 8502
diff changeset
179 You will not get an error if you try to change the type of a variable.
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
180
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
181
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
182 1.2 Function references ~
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
183 *Funcref* *E695* *E718*
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
184 A Funcref variable is obtained with the |function()| function, the |funcref()|
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
185 function or created with the lambda expression |expr-lambda|. It can be used
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
186 in an expression in the place of a function name, before the parenthesis
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
187 around the arguments, to invoke the function it refers to. Example: >
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
188
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
189 :let Fn = function("MyFunc")
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
190 :echo Fn()
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
191 < *E704* *E705* *E707*
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
192 A Funcref variable must start with a capital, "s:", "w:", "t:" or "b:". You
5340
22da5ab9aaa1 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
193 can use "g:" but the following name must still start with a capital. You
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
194 cannot have both a Funcref variable and a function with the same name.
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
195
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
196 A special case is defining a function and directly assigning its Funcref to a
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
197 Dictionary entry. Example: >
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
198 :function dict.init() dict
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
199 : let self.val = 0
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
200 :endfunction
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
201
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
202 The key of the Dictionary can start with a lower case letter. The actual
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
203 function name is not used here. Also see |numbered-function|.
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
204
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
205 A Funcref can also be used with the |:call| command: >
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
206 :call Fn()
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
207 :call dict.init()
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
208
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
209 The name of the referenced function can be obtained with |string()|. >
119
e8f07016e34d updated for version 7.0042
vimboss
parents: 114
diff changeset
210 :let func = string(Fn)
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
211
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
212 You can use |call()| to invoke a Funcref and use a list variable for the
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
213 arguments: >
119
e8f07016e34d updated for version 7.0042
vimboss
parents: 114
diff changeset
214 :let r = call(Fn, mylist)
9104
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
215 <
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
216 *Partial*
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
217 A Funcref optionally binds a Dictionary and/or arguments. This is also called
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
218 a Partial. This is created by passing the Dictionary and/or arguments to
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
219 function() or funcref(). When calling the function the Dictionary and/or
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
220 arguments will be passed to the function. Example: >
9104
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
221
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
222 let Cb = function('Callback', ['foo'], myDict)
14999
2b30a2b4bde2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 14964
diff changeset
223 call Cb('bar')
9104
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
224
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
225 This will invoke the function as if using: >
14999
2b30a2b4bde2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 14964
diff changeset
226 call myDict.Callback('foo', 'bar')
9104
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
227
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
228 This is very useful when passing a function around, e.g. in the arguments of
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
229 |ch_open()|.
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
230
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
231 Note that binding a function to a Dictionary also happens when the function is
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
232 a member of the Dictionary: >
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
233
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
234 let myDict.myFunction = MyFunction
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
235 call myDict.myFunction()
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
236
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
237 Here MyFunction() will get myDict passed as "self". This happens when the
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
238 "myFunction" member is accessed. When making assigning "myFunction" to
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
239 otherDict and calling it, it will be bound to otherDict: >
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
240
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
241 let otherDict.myFunction = myDict.myFunction
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
242 call otherDict.myFunction()
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
243
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
244 Now "self" will be "otherDict". But when the dictionary was bound explicitly
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
245 this won't happen: >
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
246
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
247 let myDict.myFunction = function(MyFunction, myDict)
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
248 let otherDict.myFunction = myDict.myFunction
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
249 call otherDict.myFunction()
2242a5766417 commit https://github.com/vim/vim/commit/1d429610bf9e99a6252be8abbc910d6667e4d1da
Christian Brabandt <cb@256bit.org>
parents: 9097
diff changeset
250
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
251 Here "self" will be "myDict", because it was bound explicitly.
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
252
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
253
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
254 1.3 Lists ~
5814
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5808
diff changeset
255 *list* *List* *Lists* *E686*
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
256 A List is an ordered sequence of items. An item can be of any type. Items
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
257 can be accessed by their index number. Items can be added and removed at any
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
258 position in the sequence.
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
259
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
260
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
261 List creation ~
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
262 *E696* *E697*
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
263 A List is created with a comma separated list of items in square brackets.
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
264 Examples: >
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
265 :let mylist = [1, two, 3, "four"]
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
266 :let emptylist = []
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
267
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
268 An item can be any expression. Using a List for an item creates a
842
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
269 List of Lists: >
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
270 :let nestlist = [[11, 12], [21, 22], [31, 32]]
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
271
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
272 An extra comma after the last item is ignored.
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
273
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
274
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
275 List index ~
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
276 *list-index* *E684*
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
277 An item in the List can be accessed by putting the index in square brackets
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
278 after the List. Indexes are zero-based, thus the first item has index zero. >
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
279 :let item = mylist[0] " get the first item: 1
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
280 :let item = mylist[2] " get the third item: 3
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
281
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
282 When the resulting item is a list this can be repeated: >
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
283 :let item = nestlist[0][1] " get the first list, second item: 12
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
284 <
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
285 A negative index is counted from the end. Index -1 refers to the last item in
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
286 the List, -2 to the last but one item, etc. >
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
287 :let last = mylist[-1] " get the last item: "four"
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
288
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
289 To avoid an error for an invalid index use the |get()| function. When an item
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
290 is not available it returns zero or the default value you specify: >
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
291 :echo get(mylist, idx)
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
292 :echo get(mylist, idx, "NONE")
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
293
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
294
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
295 List concatenation ~
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
296
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
297 Two lists can be concatenated with the "+" operator: >
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
298 :let longlist = mylist + [5, 6]
119
e8f07016e34d updated for version 7.0042
vimboss
parents: 114
diff changeset
299 :let mylist += [7, 8]
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
300
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
301 To prepend or append an item turn the item into a list by putting [] around
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
302 it. To change a list in-place see |list-modification| below.
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
303
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
304
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
305 Sublist ~
9737
35ce559b8553 commit https://github.com/vim/vim/commit/bc8801c9317eb721a2ee91322669f2dd5d136380
Christian Brabandt <cb@256bit.org>
parents: 9723
diff changeset
306 *sublist*
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
307 A part of the List can be obtained by specifying the first and last index,
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
308 separated by a colon in square brackets: >
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
309 :let shortlist = mylist[2:-1] " get List [3, "four"]
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
310
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
311 Omitting the first index is similar to zero. Omitting the last index is
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
312 similar to -1. >
90
9d4f762cc1d9 updated for version 7.0036
vimboss
parents: 87
diff changeset
313 :let endlist = mylist[2:] " from item 2 to the end: [3, "four"]
9d4f762cc1d9 updated for version 7.0036
vimboss
parents: 87
diff changeset
314 :let shortlist = mylist[2:2] " List with one item: [3]
9d4f762cc1d9 updated for version 7.0036
vimboss
parents: 87
diff changeset
315 :let otherlist = mylist[:] " make a copy of the List
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
316
842
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
317 If the first index is beyond the last item of the List or the second item is
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
318 before the first item, the result is an empty list. There is no error
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
319 message.
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
320
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
321 If the second index is equal to or greater than the length of the list the
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
322 length minus one is used: >
829
dc8197342755 updated for version 7.0d04
vimboss
parents: 825
diff changeset
323 :let mylist = [0, 1, 2, 3]
dc8197342755 updated for version 7.0d04
vimboss
parents: 825
diff changeset
324 :echo mylist[2:8] " result: [2, 3]
dc8197342755 updated for version 7.0d04
vimboss
parents: 825
diff changeset
325
270
a20218704019 updated for version 7.0072
vimboss
parents: 258
diff changeset
326 NOTE: mylist[s:e] means using the variable "s:e" as index. Watch out for
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
327 using a single letter variable before the ":". Insert a space when needed:
270
a20218704019 updated for version 7.0072
vimboss
parents: 258
diff changeset
328 mylist[s : e].
a20218704019 updated for version 7.0072
vimboss
parents: 258
diff changeset
329
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
330
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
331 List identity ~
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
332 *list-identity*
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
333 When variable "aa" is a list and you assign it to another variable "bb", both
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
334 variables refer to the same list. Thus changing the list "aa" will also
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
335 change "bb": >
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
336 :let aa = [1, 2, 3]
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
337 :let bb = aa
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
338 :call add(aa, 4)
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
339 :echo bb
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
340 < [1, 2, 3, 4]
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
341
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
342 Making a copy of a list is done with the |copy()| function. Using [:] also
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
343 works, as explained above. This creates a shallow copy of the list: Changing
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
344 a list item in the list will also change the item in the copied list: >
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
345 :let aa = [[1, 'a'], 2, 3]
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
346 :let bb = copy(aa)
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
347 :call add(aa, 4)
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
348 :let aa[0][1] = 'aaa'
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
349 :echo aa
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
350 < [[1, aaa], 2, 3, 4] >
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
351 :echo bb
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
352 < [[1, aaa], 2, 3]
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
353
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
354 To make a completely independent list use |deepcopy()|. This also makes a
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
355 copy of the values in the list, recursively. Up to a hundred levels deep.
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
356
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
357 The operator "is" can be used to check if two variables refer to the same
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
358 List. "isnot" does the opposite. In contrast "==" compares if two lists have
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
359 the same value. >
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
360 :let alist = [1, 2, 3]
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
361 :let blist = [1, 2, 3]
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
362 :echo alist is blist
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
363 < 0 >
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
364 :echo alist == blist
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
365 < 1
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
366
323
03b3684919e3 updated for version 7.0084
vimboss
parents: 314
diff changeset
367 Note about comparing lists: Two lists are considered equal if they have the
03b3684919e3 updated for version 7.0084
vimboss
parents: 314
diff changeset
368 same length and all items compare equal, as with using "==". There is one
388
f92bb1845823 updated for version 7.0101
vimboss
parents: 375
diff changeset
369 exception: When comparing a number with a string they are considered
f92bb1845823 updated for version 7.0101
vimboss
parents: 375
diff changeset
370 different. There is no automatic type conversion, as with using "==" on
f92bb1845823 updated for version 7.0101
vimboss
parents: 375
diff changeset
371 variables. Example: >
f92bb1845823 updated for version 7.0101
vimboss
parents: 375
diff changeset
372 echo 4 == "4"
323
03b3684919e3 updated for version 7.0084
vimboss
parents: 314
diff changeset
373 < 1 >
388
f92bb1845823 updated for version 7.0101
vimboss
parents: 375
diff changeset
374 echo [4] == ["4"]
323
03b3684919e3 updated for version 7.0084
vimboss
parents: 314
diff changeset
375 < 0
03b3684919e3 updated for version 7.0084
vimboss
parents: 314
diff changeset
376
388
f92bb1845823 updated for version 7.0101
vimboss
parents: 375
diff changeset
377 Thus comparing Lists is more strict than comparing numbers and strings. You
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
378 can compare simple values this way too by putting them in a list: >
388
f92bb1845823 updated for version 7.0101
vimboss
parents: 375
diff changeset
379
f92bb1845823 updated for version 7.0101
vimboss
parents: 375
diff changeset
380 :let a = 5
f92bb1845823 updated for version 7.0101
vimboss
parents: 375
diff changeset
381 :let b = "5"
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
382 :echo a == b
388
f92bb1845823 updated for version 7.0101
vimboss
parents: 375
diff changeset
383 < 1 >
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
384 :echo [a] == [b]
388
f92bb1845823 updated for version 7.0101
vimboss
parents: 375
diff changeset
385 < 0
323
03b3684919e3 updated for version 7.0084
vimboss
parents: 314
diff changeset
386
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
387
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
388 List unpack ~
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
389
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
390 To unpack the items in a list to individual variables, put the variables in
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
391 square brackets, like list items: >
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
392 :let [var1, var2] = mylist
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
393
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
394 When the number of variables does not match the number of items in the list
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
395 this produces an error. To handle any extra items from the list append ";"
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
396 and a variable name: >
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
397 :let [var1, var2; rest] = mylist
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
398
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
399 This works like: >
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
400 :let var1 = mylist[0]
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
401 :let var2 = mylist[1]
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
402 :let rest = mylist[2:]
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
403
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
404 Except that there is no error if there are only two items. "rest" will be an
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
405 empty list then.
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
406
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
407
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
408 List modification ~
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
409 *list-modification*
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
410 To change a specific item of a list use |:let| this way: >
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
411 :let list[4] = "four"
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
412 :let listlist[0][3] = item
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
413
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
414 To change part of a list you can specify the first and last item to be
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
415 modified. The value must at least have the number of items in the range: >
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
416 :let list[3:5] = [3, 4, 5]
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
417
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
418 Adding and removing items from a list is done with functions. Here are a few
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
419 examples: >
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
420 :call insert(list, 'a') " prepend item 'a'
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
421 :call insert(list, 'a', 3) " insert item 'a' before list[3]
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
422 :call add(list, "new") " append String item
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
423 :call add(list, [1, 2]) " append a List as one new item
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
424 :call extend(list, [1, 2]) " extend the list with two more items
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
425 :let i = remove(list, 3) " remove item 3
108
375b1d0f97b0 updated for version 7.0040
vimboss
parents: 102
diff changeset
426 :unlet list[3] " idem
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
427 :let l = remove(list, 3, -1) " remove items 3 to last item
108
375b1d0f97b0 updated for version 7.0040
vimboss
parents: 102
diff changeset
428 :unlet list[3 : ] " idem
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
429 :call filter(list, 'v:val !~ "x"') " remove items with an 'x'
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
430
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
431 Changing the order of items in a list: >
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
432 :call sort(list) " sort a list alphabetically
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
433 :call reverse(list) " reverse the order of items
5747
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
434 :call uniq(sort(list)) " sort and remove duplicates
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
435
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
436
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
437 For loop ~
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
438
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
439 The |:for| loop executes commands for each item in a list. A variable is set
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
440 to each item in the list in sequence. Example: >
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
441 :for item in mylist
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
442 : call Doit(item)
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
443 :endfor
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
444
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
445 This works like: >
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
446 :let index = 0
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
447 :while index < len(mylist)
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
448 : let item = mylist[index]
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
449 : :call Doit(item)
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
450 : let index = index + 1
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
451 :endwhile
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
452
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
453 If all you want to do is modify each item in the list then the |map()|
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
454 function will be a simpler method than a for loop.
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
455
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
456 Just like the |:let| command, |:for| also accepts a list of variables. This
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
457 requires the argument to be a list of lists. >
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
458 :for [lnum, col] in [[1, 3], [2, 8], [3, 0]]
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
459 : call Doit(lnum, col)
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
460 :endfor
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
461
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
462 This works like a |:let| command is done for each list item. Again, the types
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
463 must remain the same to avoid an error.
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
464
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
465 It is also possible to put remaining items in a List variable: >
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
466 :for [i, j; rest] in listlist
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
467 : call Doit(i, j)
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
468 : if !empty(rest)
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
469 : echo "remainder: " . string(rest)
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
470 : endif
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
471 :endfor
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
472
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
473
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
474 List functions ~
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
475 *E714*
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
476 Functions that are useful with a List: >
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
477 :let r = call(funcname, list) " call a function with an argument list
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
478 :if empty(list) " check if list is empty
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
479 :let l = len(list) " number of items in list
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
480 :let big = max(list) " maximum value in list
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
481 :let small = min(list) " minimum value in list
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
482 :let xs = count(list, 'x') " count nr of times 'x' appears in list
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
483 :let i = index(list, 'x') " index of first 'x' in list
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
484 :let lines = getline(1, 10) " get ten text lines from buffer
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
485 :call append('$', lines) " append text lines in buffer
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
486 :let list = split("a b c") " create list from items in a string
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
487 :let string = join(list, ', ') " create string from list items
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
488 :let s = string(list) " String representation of list
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
489 :call map(list, '">> " . v:val') " prepend ">> " to each item
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
490
258
f93df7322443 updated for version 7.0070
vimboss
parents: 236
diff changeset
491 Don't forget that a combination of features can make things simple. For
f93df7322443 updated for version 7.0070
vimboss
parents: 236
diff changeset
492 example, to add up all the numbers in a list: >
f93df7322443 updated for version 7.0070
vimboss
parents: 236
diff changeset
493 :exe 'let sum = ' . join(nrlist, '+')
f93df7322443 updated for version 7.0070
vimboss
parents: 236
diff changeset
494
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
495
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
496 1.4 Dictionaries ~
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
497 *dict* *Dict* *Dictionaries* *Dictionary*
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
498 A Dictionary is an associative array: Each entry has a key and a value. The
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
499 entry can be located with the key. The entries are stored without a specific
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
500 ordering.
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
501
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
502
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
503 Dictionary creation ~
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
504 *E720* *E721* *E722* *E723*
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
505 A Dictionary is created with a comma separated list of entries in curly
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
506 braces. Each entry has a key and a value, separated by a colon. Each key can
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
507 only appear once. Examples: >
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
508 :let mydict = {1: 'one', 2: 'two', 3: 'three'}
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
509 :let emptydict = {}
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
510 < *E713* *E716* *E717*
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
511 A key is always a String. You can use a Number, it will be converted to a
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
512 String automatically. Thus the String '4' and the number 4 will find the same
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
513 entry. Note that the String '04' and the Number 04 are different, since the
17368
6604ecb7a615 patch 8.1.1683: dictionary with string keys is longer than needed
Bram Moolenaar <Bram@vim.org>
parents: 17366
diff changeset
514 Number will be converted to the String '4'. The empty string can also be used
6604ecb7a615 patch 8.1.1683: dictionary with string keys is longer than needed
Bram Moolenaar <Bram@vim.org>
parents: 17366
diff changeset
515 as a key.
17758
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
516 *literal-Dict* *#{}*
17413
40417757dffd patch 8.1.1705: using ~{} for a literal dict is not nice
Bram Moolenaar <Bram@vim.org>
parents: 17387
diff changeset
517 To avoid having to put quotes around every key the #{} form can be used. This
17368
6604ecb7a615 patch 8.1.1683: dictionary with string keys is longer than needed
Bram Moolenaar <Bram@vim.org>
parents: 17366
diff changeset
518 does require the key to consist only of ASCII letters, digits, '-' and '_'.
6604ecb7a615 patch 8.1.1683: dictionary with string keys is longer than needed
Bram Moolenaar <Bram@vim.org>
parents: 17366
diff changeset
519 Example: >
18669
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
520 :let mydict = #{zero: 0, one_key: 1, two-key: 2, 333: 3}
17413
40417757dffd patch 8.1.1705: using ~{} for a literal dict is not nice
Bram Moolenaar <Bram@vim.org>
parents: 17387
diff changeset
521 Note that 333 here is the string "333". Empty keys are not possible with #{}.
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
522
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
523 A value can be any expression. Using a Dictionary for a value creates a
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
524 nested Dictionary: >
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
525 :let nestdict = {1: {11: 'a', 12: 'b'}, 2: {21: 'c'}}
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
526
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
527 An extra comma after the last entry is ignored.
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
528
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
529
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
530 Accessing entries ~
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
531
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
532 The normal way to access an entry is by putting the key in square brackets: >
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
533 :let val = mydict["one"]
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
534 :let mydict["four"] = 4
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
535
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
536 You can add new entries to an existing Dictionary this way, unlike Lists.
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
537
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
538 For keys that consist entirely of letters, digits and underscore the following
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
539 form can be used |expr-entry|: >
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
540 :let val = mydict.one
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
541 :let mydict.four = 4
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
542
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
543 Since an entry can be any type, also a List and a Dictionary, the indexing and
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
544 key lookup can be repeated: >
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
545 :echo dict.key[idx].key
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
546
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
547
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
548 Dictionary to List conversion ~
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
549
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
550 You may want to loop over the entries in a dictionary. For this you need to
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
551 turn the Dictionary into a List and pass it to |:for|.
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
552
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
553 Most often you want to loop over the keys, using the |keys()| function: >
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
554 :for key in keys(mydict)
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
555 : echo key . ': ' . mydict[key]
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
556 :endfor
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
557
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
558 The List of keys is unsorted. You may want to sort them first: >
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
559 :for key in sort(keys(mydict))
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
560
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
561 To loop over the values use the |values()| function: >
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
562 :for v in values(mydict)
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
563 : echo "value: " . v
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
564 :endfor
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
565
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
566 If you want both the key and the value use the |items()| function. It returns
15131
bc1a8d21c811 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15062
diff changeset
567 a List in which each item is a List with two items, the key and the value: >
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
568 :for [key, value] in items(mydict)
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
569 : echo key . ': ' . value
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
570 :endfor
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
571
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
572
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
573 Dictionary identity ~
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
574 *dict-identity*
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
575 Just like Lists you need to use |copy()| and |deepcopy()| to make a copy of a
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
576 Dictionary. Otherwise, assignment results in referring to the same
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
577 Dictionary: >
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
578 :let onedict = {'a': 1, 'b': 2}
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
579 :let adict = onedict
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
580 :let adict['a'] = 11
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
581 :echo onedict['a']
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
582 11
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
583
327
8f38b35904c0 updated for version 7.0085
vimboss
parents: 323
diff changeset
584 Two Dictionaries compare equal if all the key-value pairs compare equal. For
8f38b35904c0 updated for version 7.0085
vimboss
parents: 323
diff changeset
585 more info see |list-identity|.
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
586
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
587
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
588 Dictionary modification ~
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
589 *dict-modification*
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
590 To change an already existing entry of a Dictionary, or to add a new entry,
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
591 use |:let| this way: >
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
592 :let dict[4] = "four"
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
593 :let dict['one'] = item
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
594
108
375b1d0f97b0 updated for version 7.0040
vimboss
parents: 102
diff changeset
595 Removing an entry from a Dictionary is done with |remove()| or |:unlet|.
375b1d0f97b0 updated for version 7.0040
vimboss
parents: 102
diff changeset
596 Three ways to remove the entry with key "aaa" from dict: >
375b1d0f97b0 updated for version 7.0040
vimboss
parents: 102
diff changeset
597 :let i = remove(dict, 'aaa')
375b1d0f97b0 updated for version 7.0040
vimboss
parents: 102
diff changeset
598 :unlet dict.aaa
375b1d0f97b0 updated for version 7.0040
vimboss
parents: 102
diff changeset
599 :unlet dict['aaa']
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
600
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
601 Merging a Dictionary with another is done with |extend()|: >
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
602 :call extend(adict, bdict)
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
603 This extends adict with all entries from bdict. Duplicate keys cause entries
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
604 in adict to be overwritten. An optional third argument can change this.
119
e8f07016e34d updated for version 7.0042
vimboss
parents: 114
diff changeset
605 Note that the order of entries in a Dictionary is irrelevant, thus don't
e8f07016e34d updated for version 7.0042
vimboss
parents: 114
diff changeset
606 expect ":echo adict" to show the items from bdict after the older entries in
e8f07016e34d updated for version 7.0042
vimboss
parents: 114
diff changeset
607 adict.
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
608
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
609 Weeding out entries from a Dictionary can be done with |filter()|: >
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
610 :call filter(dict, 'v:val =~ "x"')
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
611 This removes all entries from "dict" with a value not matching 'x'.
20552
74e3316c1d5a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20522
diff changeset
612 This can also be used to remove all entries: >
74e3316c1d5a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20522
diff changeset
613 call filter(dict, 0)
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
614
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
615
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
616 Dictionary function ~
4159
8b86b69546a9 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 4157
diff changeset
617 *Dictionary-function* *self* *E725* *E862*
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
618 When a function is defined with the "dict" attribute it can be used in a
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
619 special way with a dictionary. Example: >
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
620 :function Mylen() dict
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
621 : return len(self.data)
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
622 :endfunction
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
623 :let mydict = {'data': [0, 1, 2, 3], 'len': function("Mylen")}
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
624 :echo mydict.len()
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
625
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
626 This is like a method in object oriented programming. The entry in the
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
627 Dictionary is a |Funcref|. The local variable "self" refers to the dictionary
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
628 the function was invoked from.
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
629
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
630 It is also possible to add a function without the "dict" attribute as a
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
631 Funcref to a Dictionary, but the "self" variable is not available then.
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
632
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
633 *numbered-function* *anonymous-function*
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
634 To avoid the extra name for the function it can be defined and directly
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
635 assigned to a Dictionary in this way: >
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
636 :let mydict = {'data': [0, 1, 2, 3]}
6741
fbc1131f0ba5 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6697
diff changeset
637 :function mydict.len()
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
638 : return len(self.data)
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
639 :endfunction
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
640 :echo mydict.len()
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
641
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
642 The function will then get a number and the value of dict.len is a |Funcref|
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
643 that references this function. The function can only be used through a
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
644 |Funcref|. It will automatically be deleted when there is no |Funcref|
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
645 remaining that refers to it.
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
646
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
647 It is not necessary to use the "dict" attribute for a numbered function.
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
648
2488
def0e3934129 Preparations for 7.3d release.
Bram Moolenaar <bram@vim.org>
parents: 2465
diff changeset
649 If you get an error for a numbered function, you can find out what it is with
def0e3934129 Preparations for 7.3d release.
Bram Moolenaar <bram@vim.org>
parents: 2465
diff changeset
650 a trick. Assuming the function is 42, the command is: >
def0e3934129 Preparations for 7.3d release.
Bram Moolenaar <bram@vim.org>
parents: 2465
diff changeset
651 :function {42}
def0e3934129 Preparations for 7.3d release.
Bram Moolenaar <bram@vim.org>
parents: 2465
diff changeset
652
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
653
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
654 Functions for Dictionaries ~
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
655 *E715*
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
656 Functions that can be used with a Dictionary: >
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
657 :if has_key(dict, 'foo') " TRUE if dict has entry with key "foo"
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
658 :if empty(dict) " TRUE if dict is empty
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
659 :let l = len(dict) " number of items in dict
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
660 :let big = max(dict) " maximum value in dict
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
661 :let small = min(dict) " minimum value in dict
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
662 :let xs = count(dict, 'x') " count nr of times 'x' appears in dict
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
663 :let s = string(dict) " String representation of dict
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
664 :call map(dict, '">> " . v:val') " prepend ">> " to each item
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
665
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
666
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
667 1.5 Blobs ~
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
668 *blob* *Blob* *Blobs* *E978*
16158
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
669 A Blob is a binary object. It can be used to read an image from a file and
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
670 send it over a channel, for example.
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
671
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
672 A Blob mostly behaves like a |List| of numbers, where each number has the
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
673 value of an 8-bit byte, from 0 to 255.
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
674
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
675
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
676 Blob creation ~
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
677
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
678 A Blob can be created with a |blob-literal|: >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
679 :let b = 0zFF00ED015DAF
15571
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
680 Dots can be inserted between bytes (pair of hex characters) for readability,
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
681 they don't change the value: >
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
682 :let b = 0zFF00.ED01.5DAF
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
683
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
684 A blob can be read from a file with |readfile()| passing the {type} argument
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
685 set to "B", for example: >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
686 :let b = readfile('image.png', 'B')
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
687
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
688 A blob can be read from a channel with the |ch_readblob()| function.
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
689
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
690
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
691 Blob index ~
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
692 *blob-index* *E979*
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
693 A byte in the Blob can be accessed by putting the index in square brackets
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
694 after the Blob. Indexes are zero-based, thus the first byte has index zero. >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
695 :let myblob = 0z00112233
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
696 :let byte = myblob[0] " get the first byte: 0x00
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
697 :let byte = myblob[2] " get the third byte: 0x22
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
698
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
699 A negative index is counted from the end. Index -1 refers to the last byte in
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
700 the Blob, -2 to the last but one byte, etc. >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
701 :let last = myblob[-1] " get the last byte: 0x33
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
702
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
703 To avoid an error for an invalid index use the |get()| function. When an item
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
704 is not available it returns -1 or the default value you specify: >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
705 :echo get(myblob, idx)
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
706 :echo get(myblob, idx, 999)
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
707
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
708
15615
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
709 Blob iteration ~
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
710
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
711 The |:for| loop executes commands for each byte of a Blob. The loop variable is
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
712 set to each byte in the Blob. Example: >
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
713 :for byte in 0z112233
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
714 : call Doit(byte)
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
715 :endfor
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
716 This calls Doit() with 0x11, 0x22 and 0x33.
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
717
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
718
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
719 Blob concatenation ~
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
720
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
721 Two blobs can be concatenated with the "+" operator: >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
722 :let longblob = myblob + 0z4455
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
723 :let myblob += 0z6677
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
724
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
725 To change a blob in-place see |blob-modification| below.
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
726
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
727
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
728 Part of a blob ~
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
729
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
730 A part of the Blob can be obtained by specifying the first and last index,
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
731 separated by a colon in square brackets: >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
732 :let myblob = 0z00112233
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
733 :let shortblob = myblob[1:2] " get 0z1122
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
734 :let shortblob = myblob[2:-1] " get 0z2233
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
735
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
736 Omitting the first index is similar to zero. Omitting the last index is
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
737 similar to -1. >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
738 :let endblob = myblob[2:] " from item 2 to the end: 0z2233
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
739 :let shortblob = myblob[2:2] " Blob with one byte: 0z22
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
740 :let otherblob = myblob[:] " make a copy of the Blob
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
741
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
742 If the first index is beyond the last byte of the Blob or the second index is
15725
a3e2e7948ee4 patch 8.1.0870: Vim doesn't use the new ConPTY support in Windows 10
Bram Moolenaar <Bram@vim.org>
parents: 15711
diff changeset
743 before the first index, the result is an empty Blob. There is no error
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
744 message.
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
745
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
746 If the second index is equal to or greater than the length of the list the
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
747 length minus one is used: >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
748 :echo myblob[2:8] " result: 0z2233
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
749
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
750
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
751 Blob modification ~
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
752 *blob-modification*
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
753 To change a specific byte of a blob use |:let| this way: >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
754 :let blob[4] = 0x44
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
755
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
756 When the index is just one beyond the end of the Blob, it is appended. Any
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
757 higher index is an error.
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
758
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
759 To change a sequence of bytes the [:] notation can be used: >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
760 let blob[1:3] = 0z445566
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
761 The length of the replaced bytes must be exactly the same as the value
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
762 provided. *E972*
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
763
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
764 To change part of a blob you can specify the first and last byte to be
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
765 modified. The value must have the same number of bytes in the range: >
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
766 :let blob[3:5] = 0z334455
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
767
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
768 You can also use the functions |add()|, |remove()| and |insert()|.
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
769
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
770
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
771 Blob identity ~
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
772
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
773 Blobs can be compared for equality: >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
774 if blob == 0z001122
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
775 And for equal identity: >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
776 if blob is otherblob
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
777 < *blob-identity* *E977*
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
778 When variable "aa" is a Blob and you assign it to another variable "bb", both
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
779 variables refer to the same Blob. Then the "is" operator returns true.
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
780
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
781 When making a copy using [:] or |copy()| the values are the same, but the
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
782 identity is different: >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
783 :let blob = 0z112233
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
784 :let blob2 = blob
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
785 :echo blob == blob2
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
786 < 1 >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
787 :echo blob is blob2
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
788 < 1 >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
789 :let blob3 = blob[:]
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
790 :echo blob == blob3
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
791 < 1 >
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
792 :echo blob is blob3
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
793 < 0
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
794
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
795 Making a copy of a Blob is done with the |copy()| function. Using [:] also
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
796 works, as explained above.
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
797
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
798
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
799 1.6 More about variables ~
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
800 *more-variables*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
801 If you need to know the type of a variable or expression, use the |type()|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
802 function.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
803
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
804 When the '!' flag is included in the 'viminfo' option, global variables that
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
805 start with an uppercase letter, and don't contain a lowercase letter, are
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
806 stored in the viminfo file |viminfo-file|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
807
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
808 When the 'sessionoptions' option contains "global", global variables that
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
809 start with an uppercase letter and contain at least one lowercase letter are
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
810 stored in the session file |session-file|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
811
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
812 variable name can be stored where ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
813 my_var_6 not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
814 My_Var_6 session file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
815 MY_VAR_6 viminfo file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
816
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
817
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
818 It's possible to form a variable name with curly braces, see
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
819 |curly-braces-names|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
820
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
821 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
822 2. Expression syntax *expression-syntax*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
823
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
824 Expression syntax summary, from least to most significant:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
825
10218
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
826 |expr1| expr2
10048
43efa4f5a8ea commit https://github.com/vim/vim/commit/89bcfda6834aba724d12554a34b9ed49f5789fd5
Christian Brabandt <cb@256bit.org>
parents: 10038
diff changeset
827 expr2 ? expr1 : expr1 if-then-else
43efa4f5a8ea commit https://github.com/vim/vim/commit/89bcfda6834aba724d12554a34b9ed49f5789fd5
Christian Brabandt <cb@256bit.org>
parents: 10038
diff changeset
828
43efa4f5a8ea commit https://github.com/vim/vim/commit/89bcfda6834aba724d12554a34b9ed49f5789fd5
Christian Brabandt <cb@256bit.org>
parents: 10038
diff changeset
829 |expr2| expr3
16219
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
830 expr3 || expr3 ... logical OR
10048
43efa4f5a8ea commit https://github.com/vim/vim/commit/89bcfda6834aba724d12554a34b9ed49f5789fd5
Christian Brabandt <cb@256bit.org>
parents: 10038
diff changeset
831
43efa4f5a8ea commit https://github.com/vim/vim/commit/89bcfda6834aba724d12554a34b9ed49f5789fd5
Christian Brabandt <cb@256bit.org>
parents: 10038
diff changeset
832 |expr3| expr4
16219
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
833 expr4 && expr4 ... logical AND
10048
43efa4f5a8ea commit https://github.com/vim/vim/commit/89bcfda6834aba724d12554a34b9ed49f5789fd5
Christian Brabandt <cb@256bit.org>
parents: 10038
diff changeset
834
43efa4f5a8ea commit https://github.com/vim/vim/commit/89bcfda6834aba724d12554a34b9ed49f5789fd5
Christian Brabandt <cb@256bit.org>
parents: 10038
diff changeset
835 |expr4| expr5
43efa4f5a8ea commit https://github.com/vim/vim/commit/89bcfda6834aba724d12554a34b9ed49f5789fd5
Christian Brabandt <cb@256bit.org>
parents: 10038
diff changeset
836 expr5 == expr5 equal
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
837 expr5 != expr5 not equal
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
838 expr5 > expr5 greater than
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
839 expr5 >= expr5 greater than or equal
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
840 expr5 < expr5 smaller than
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
841 expr5 <= expr5 smaller than or equal
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
842 expr5 =~ expr5 regexp matches
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
843 expr5 !~ expr5 regexp doesn't match
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
844
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
845 expr5 ==? expr5 equal, ignoring case
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
846 expr5 ==# expr5 equal, match case
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
847 etc. As above, append ? for ignoring case, # for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
848 matching case
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
849
15615
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
850 expr5 is expr5 same |List|, |Dictionary| or |Blob| instance
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
851 expr5 isnot expr5 different |List|, |Dictionary| or |Blob|
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
852 instance
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
853
10048
43efa4f5a8ea commit https://github.com/vim/vim/commit/89bcfda6834aba724d12554a34b9ed49f5789fd5
Christian Brabandt <cb@256bit.org>
parents: 10038
diff changeset
854 |expr5| expr6
16219
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
855 expr6 + expr6 ... number addition, list or blob concatenation
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
856 expr6 - expr6 ... number subtraction
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
857 expr6 . expr6 ... string concatenation
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
858 expr6 .. expr6 ... string concatenation
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
859
10048
43efa4f5a8ea commit https://github.com/vim/vim/commit/89bcfda6834aba724d12554a34b9ed49f5789fd5
Christian Brabandt <cb@256bit.org>
parents: 10038
diff changeset
860 |expr6| expr7
16219
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
861 expr7 * expr7 ... number multiplication
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
862 expr7 / expr7 ... number division
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
863 expr7 % expr7 ... number modulo
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
864
10048
43efa4f5a8ea commit https://github.com/vim/vim/commit/89bcfda6834aba724d12554a34b9ed49f5789fd5
Christian Brabandt <cb@256bit.org>
parents: 10038
diff changeset
865 |expr7| expr8
43efa4f5a8ea commit https://github.com/vim/vim/commit/89bcfda6834aba724d12554a34b9ed49f5789fd5
Christian Brabandt <cb@256bit.org>
parents: 10038
diff changeset
866 ! expr7 logical NOT
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
867 - expr7 unary minus
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
868 + expr7 unary plus
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
869
10048
43efa4f5a8ea commit https://github.com/vim/vim/commit/89bcfda6834aba724d12554a34b9ed49f5789fd5
Christian Brabandt <cb@256bit.org>
parents: 10038
diff changeset
870 |expr8| expr9
43efa4f5a8ea commit https://github.com/vim/vim/commit/89bcfda6834aba724d12554a34b9ed49f5789fd5
Christian Brabandt <cb@256bit.org>
parents: 10038
diff changeset
871 expr8[expr1] byte of a String or item of a |List|
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
872 expr8[expr1 : expr1] substring of a String or sublist of a |List|
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
873 expr8.name entry in a |Dictionary|
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
874 expr8(expr1, ...) function call with |Funcref| variable
17620
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
875 expr8->name(expr1, ...) |method| call
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
876
10218
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
877 |expr9| number number constant
26
404aac550f35 updated for version 7.0017
vimboss
parents: 24
diff changeset
878 "string" string constant, backslash is special
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
879 'string' string constant, ' is doubled
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
880 [expr1, ...] |List|
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
881 {expr1: expr1, ...} |Dictionary|
17620
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
882 #{key: expr1, ...} |Dictionary|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
883 &option option value
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
884 (expr1) nested expression
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
885 variable internal variable
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
886 va{ria}ble internal variable with curly braces
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
887 $VAR environment variable
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
888 @r contents of register 'r'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
889 function(expr1, ...) function call
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
890 func{ti}on(expr1, ...) function call with curly braces
9527
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
891 {args -> expr1} lambda expression
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
892
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
893
16219
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
894 "..." indicates that the operations in this level can be concatenated.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
895 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
896 &nu || &list && &shell == "csh"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
897
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
898 All expressions within one level are parsed from left to right.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
899
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
900
22565
17c4178f26ea Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22492
diff changeset
901 expr1 *expr1* *trinary* *falsy-operator* *??* *E109*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
902 -----
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
903
22492
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
904 The trinary operator: expr2 ? expr1 : expr1
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
905 The falsy operator: expr2 ?? expr1
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
906
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
907 Trinary operator ~
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
908
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
909 The expression before the '?' is evaluated to a number. If it evaluates to
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
910 |TRUE|, the result is the value of the expression between the '?' and ':',
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
911 otherwise the result is the value of the expression after the ':'.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
912 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
913 :echo lnum == 1 ? "top" : lnum
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
914
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
915 Since the first expression is an "expr2", it cannot contain another ?:. The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
916 other two expressions can, thus allow for recursive use of ?:.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
917 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
918 :echo lnum == 1 ? "top" : lnum == 1000 ? "last" : lnum
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
919
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
920 To keep this readable, using |line-continuation| is suggested: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
921 :echo lnum == 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
922 :\ ? "top"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
923 :\ : lnum == 1000
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
924 :\ ? "last"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
925 :\ : lnum
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
926
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
927 You should always put a space before the ':', otherwise it can be mistaken for
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
928 use in a variable such as "a:1".
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
929
22492
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
930 Falsy operator ~
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
931
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
932 This is also known as the "null coalescing operator", but that's too
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
933 complicated, thus we just call it the falsy operator.
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
934
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
935 The expression before the '??' is evaluated. If it evaluates to
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
936 |truthy|, this is used as the result. Otherwise the expression after the '??'
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
937 is evaluated and used as the result. This is most useful to have a default
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
938 value for an expression that may result in zero or empty: >
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
939 echo theList ?? 'list is empty'
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
940 echo GetName() ?? 'unknown'
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
941
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
942 These are similar, but not equal: >
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
943 expr2 ?? expr1
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
944 expr2 ? expr2 : expr1
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
945 In the second line "expr2" is evaluated twice.
0e03ef68e738 patch 8.2.1794: no falsy Coalescing operator
Bram Moolenaar <Bram@vim.org>
parents: 22446
diff changeset
946
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
947
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
948 expr2 and expr3 *expr2* *expr3*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
949 ---------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
950
10038
7cf4e210cf3c commit https://github.com/vim/vim/commit/04186095346daa60e82e981dad114de2b641d672
Christian Brabandt <cb@256bit.org>
parents: 10027
diff changeset
951 expr3 || expr3 .. logical OR *expr-barbar*
7cf4e210cf3c commit https://github.com/vim/vim/commit/04186095346daa60e82e981dad114de2b641d672
Christian Brabandt <cb@256bit.org>
parents: 10027
diff changeset
952 expr4 && expr4 .. logical AND *expr-&&*
7cf4e210cf3c commit https://github.com/vim/vim/commit/04186095346daa60e82e981dad114de2b641d672
Christian Brabandt <cb@256bit.org>
parents: 10027
diff changeset
953
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
954 The "||" and "&&" operators take one argument on each side. The arguments
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
955 are (converted to) Numbers. The result is:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
956
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
957 input output ~
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
958 n1 n2 n1 || n2 n1 && n2 ~
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
959 |FALSE| |FALSE| |FALSE| |FALSE|
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
960 |FALSE| |TRUE| |TRUE| |FALSE|
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
961 |TRUE| |FALSE| |TRUE| |FALSE|
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
962 |TRUE| |TRUE| |TRUE| |TRUE|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
963
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
964 The operators can be concatenated, for example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
965
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
966 &nu || &list && &shell == "csh"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
967
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
968 Note that "&&" takes precedence over "||", so this has the meaning of: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
969
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
970 &nu || (&list && &shell == "csh")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
971
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
972 Once the result is known, the expression "short-circuits", that is, further
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
973 arguments are not evaluated. This is like what happens in C. For example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
974
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
975 let a = 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
976 echo a || b
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
977
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
978 This is valid even if there is no variable called "b" because "a" is |TRUE|,
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
979 so the result must be |TRUE|. Similarly below: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
980
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
981 echo exists("b") && b == "yes"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
982
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
983 This is valid whether "b" has been defined or not. The second clause will
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
984 only be evaluated if "b" has been defined.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
985
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
986
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
987 expr4 *expr4*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
988 -----
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
989
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
990 expr5 {cmp} expr5
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
991
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
992 Compare two expr5 expressions, resulting in a 0 if it evaluates to false, or 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
993 if it evaluates to true.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
994
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
995 *expr-==* *expr-!=* *expr->* *expr->=*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
996 *expr-<* *expr-<=* *expr-=~* *expr-!~*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
997 *expr-==#* *expr-!=#* *expr->#* *expr->=#*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
998 *expr-<#* *expr-<=#* *expr-=~#* *expr-!~#*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
999 *expr-==?* *expr-!=?* *expr->?* *expr->=?*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1000 *expr-<?* *expr-<=?* *expr-=~?* *expr-!~?*
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
1001 *expr-is* *expr-isnot* *expr-is#* *expr-isnot#*
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
1002 *expr-is?* *expr-isnot?*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1003 use 'ignorecase' match case ignore case ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1004 equal == ==# ==?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1005 not equal != !=# !=?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1006 greater than > ># >?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1007 greater than or equal >= >=# >=?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1008 smaller than < <# <?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1009 smaller than or equal <= <=# <=?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1010 regexp matches =~ =~# =~?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1011 regexp doesn't match !~ !~# !~?
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
1012 same instance is is# is?
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
1013 different instance isnot isnot# isnot?
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1014
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1015 Examples:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1016 "abc" ==# "Abc" evaluates to 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1017 "abc" ==? "Abc" evaluates to 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1018 "abc" == "Abc" evaluates to 1 if 'ignorecase' is set, 0 otherwise
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1019
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
1020 *E691* *E692*
12756
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
1021 A |List| can only be compared with a |List| and only "equal", "not equal",
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
1022 "is" and "isnot" can be used. This compares the values of the list,
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
1023 recursively. Ignoring case means case is ignored when comparing item values.
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
1024
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
1025 *E735* *E736*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1026 A |Dictionary| can only be compared with a |Dictionary| and only "equal", "not
12756
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
1027 equal", "is" and "isnot" can be used. This compares the key/values of the
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
1028 |Dictionary| recursively. Ignoring case means case is ignored when comparing
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
1029 item values.
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
1030
8951
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
1031 *E694*
9407
619a98a67f67 commit https://github.com/vim/vim/commit/e18dbe865d190e74fb5d43ac8bc6ac22507d0223
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
1032 A |Funcref| can only be compared with a |Funcref| and only "equal", "not
619a98a67f67 commit https://github.com/vim/vim/commit/e18dbe865d190e74fb5d43ac8bc6ac22507d0223
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
1033 equal", "is" and "isnot" can be used. Case is never ignored. Whether
619a98a67f67 commit https://github.com/vim/vim/commit/e18dbe865d190e74fb5d43ac8bc6ac22507d0223
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
1034 arguments or a Dictionary are bound (with a partial) matters. The
619a98a67f67 commit https://github.com/vim/vim/commit/e18dbe865d190e74fb5d43ac8bc6ac22507d0223
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
1035 Dictionaries must also be equal (or the same, in case of "is") and the
619a98a67f67 commit https://github.com/vim/vim/commit/e18dbe865d190e74fb5d43ac8bc6ac22507d0223
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
1036 arguments must be equal (or the same).
619a98a67f67 commit https://github.com/vim/vim/commit/e18dbe865d190e74fb5d43ac8bc6ac22507d0223
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
1037
619a98a67f67 commit https://github.com/vim/vim/commit/e18dbe865d190e74fb5d43ac8bc6ac22507d0223
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
1038 To compare Funcrefs to see if they refer to the same function, ignoring bound
619a98a67f67 commit https://github.com/vim/vim/commit/e18dbe865d190e74fb5d43ac8bc6ac22507d0223
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
1039 Dictionary and arguments, use |get()| to get the function name: >
619a98a67f67 commit https://github.com/vim/vim/commit/e18dbe865d190e74fb5d43ac8bc6ac22507d0223
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
1040 if get(Part1, 'name') == get(Part2, 'name')
619a98a67f67 commit https://github.com/vim/vim/commit/e18dbe865d190e74fb5d43ac8bc6ac22507d0223
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
1041 " Part1 and Part2 refer to the same function
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1042
15615
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
1043 Using "is" or "isnot" with a |List|, |Dictionary| or |Blob| checks whether
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
1044 the expressions are referring to the same |List|, |Dictionary| or |Blob|
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
1045 instance. A copy of a |List| is different from the original |List|. When
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
1046 using "is" without a |List|, |Dictionary| or |Blob|, it is equivalent to
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
1047 using "equal", using "isnot" equivalent to using "not equal". Except that
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
1048 a different type means the values are different: >
8534
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
1049 echo 4 == '4'
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
1050 1
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
1051 echo 4 is '4'
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
1052 0
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
1053 echo 0 is []
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
1054 0
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
1055 "is#"/"isnot#" and "is?"/"isnot?" can be used to match and ignore case.
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
1056
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1057 When comparing a String with a Number, the String is converted to a Number,
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1058 and the comparison is done on Numbers. This means that: >
8534
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
1059 echo 0 == 'x'
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
1060 1
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
1061 because 'x' converted to a Number is zero. However: >
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
1062 echo [0] == ['x']
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
1063 0
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
1064 Inside a List or Dictionary this conversion is not used.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1065
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1066 When comparing two Strings, this is done with strcmp() or stricmp(). This
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1067 results in the mathematical difference (comparing byte values), not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1068 necessarily the alphabetical difference in the local language.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1069
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1070 When using the operators with a trailing '#', or the short version and
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
1071 'ignorecase' is off, the comparing is done with strcmp(): case matters.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1072
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1073 When using the operators with a trailing '?', or the short version and
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
1074 'ignorecase' is set, the comparing is done with stricmp(): case is ignored.
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
1075
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
1076 'smartcase' is not used.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1077
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1078 The "=~" and "!~" operators match the lefthand argument with the righthand
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1079 argument, which is used as a pattern. See |pattern| for what a pattern is.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1080 This matching is always done like 'magic' was set and 'cpoptions' is empty, no
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1081 matter what the actual value of 'magic' or 'cpoptions' is. This makes scripts
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1082 portable. To avoid backslashes in the regexp pattern to be doubled, use a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1083 single-quote string, see |literal-string|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1084 Since a string is considered to be a single line, a multi-line pattern
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1085 (containing \n, backslash-n) will not match. However, a literal NL character
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1086 can be matched like an ordinary character. Examples:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1087 "foo\nbar" =~ "\n" evaluates to 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1088 "foo\nbar" =~ "\\n" evaluates to 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1089
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1090
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1091 expr5 and expr6 *expr5* *expr6*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1092 ---------------
16219
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
1093 expr6 + expr6 Number addition, |List| or |Blob| concatenation *expr-+*
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
1094 expr6 - expr6 Number subtraction *expr--*
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
1095 expr6 . expr6 String concatenation *expr-.*
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
1096 expr6 .. expr6 String concatenation *expr-..*
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
1097
692
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
1098 For |Lists| only "+" is possible and then both expr6 must be a list. The
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1099 result is a new list with the two lists Concatenated.
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
1100
16219
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
1101 For String concatenation ".." is preferred, since "." is ambiguous, it is also
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
1102 used for |Dict| member access and floating point numbers.
16223
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
1103 When |vimscript-version| is 2 or higher, using "." is not allowed.
16219
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
1104
15615
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
1105 expr7 * expr7 Number multiplication *expr-star*
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
1106 expr7 / expr7 Number division *expr-/*
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
1107 expr7 % expr7 Number modulo *expr-%*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1108
16267
b471858040bc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16235
diff changeset
1109 For all, except "." and "..", Strings are converted to Numbers.
3214
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
1110 For bitwise operators see |and()|, |or()| and |xor()|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1111
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1112 Note the difference between "+" and ".":
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1113 "123" + "456" = 579
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1114 "123" . "456" = "123456"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1115
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1116 Since '.' has the same precedence as '+' and '-', you need to read: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1117 1 . 90 + 90.0
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1118 As: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1119 (1 . 90) + 90.0
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1120 That works, since the String "190" is automatically converted to the Number
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1121 190, which can be added to the Float 90.0. However: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1122 1 . 90 * 90.0
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1123 Should be read as: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1124 1 . (90 * 90.0)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1125 Since '.' has lower precedence than '*'. This does NOT work, since this
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1126 attempts to concatenate a Float and a String.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1127
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1128 When dividing a Number by zero the result depends on the value:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1129 0 / 0 = -0x80000000 (like NaN for Float)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1130 >0 / 0 = 0x7fffffff (like positive infinity)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1131 <0 / 0 = -0x7fffffff (like negative infinity)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1132 (before Vim 7.2 it was always 0x7fffffff)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1133
9389
32e34e574716 commit https://github.com/vim/vim/commit/22fcfad29276bd5f317faf516637dcd491b96a12
Christian Brabandt <cb@256bit.org>
parents: 9344
diff changeset
1134 When 64-bit Number support is enabled:
32e34e574716 commit https://github.com/vim/vim/commit/22fcfad29276bd5f317faf516637dcd491b96a12
Christian Brabandt <cb@256bit.org>
parents: 9344
diff changeset
1135 0 / 0 = -0x8000000000000000 (like NaN for Float)
32e34e574716 commit https://github.com/vim/vim/commit/22fcfad29276bd5f317faf516637dcd491b96a12
Christian Brabandt <cb@256bit.org>
parents: 9344
diff changeset
1136 >0 / 0 = 0x7fffffffffffffff (like positive infinity)
32e34e574716 commit https://github.com/vim/vim/commit/22fcfad29276bd5f317faf516637dcd491b96a12
Christian Brabandt <cb@256bit.org>
parents: 9344
diff changeset
1137 <0 / 0 = -0x7fffffffffffffff (like negative infinity)
32e34e574716 commit https://github.com/vim/vim/commit/22fcfad29276bd5f317faf516637dcd491b96a12
Christian Brabandt <cb@256bit.org>
parents: 9344
diff changeset
1138
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1139 When the righthand side of '%' is zero, the result is 0.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1140
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1141 None of these work for |Funcref|s.
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
1142
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1143 . and % do not work for Float. *E804*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1144
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1145
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1146 expr7 *expr7*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1147 -----
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1148 ! expr7 logical NOT *expr-!*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1149 - expr7 unary minus *expr-unary--*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1150 + expr7 unary plus *expr-unary-+*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1151
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
1152 For '!' |TRUE| becomes |FALSE|, |FALSE| becomes |TRUE| (one).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1153 For '-' the sign of the number is changed.
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
1154 For '+' the number is unchanged. Note: "++" has no effect.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1155
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1156 A String will be converted to a Number first.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1157
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1158 These three can be repeated and mixed. Examples:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1159 !-1 == 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1160 !!8 == 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1161 --9 == 9
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1162
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1163
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1164 expr8 *expr8*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1165 -----
14637
0ecb909e3249 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14601
diff changeset
1166 This expression is either |expr9| or a sequence of the alternatives below,
0ecb909e3249 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14601
diff changeset
1167 in any order. E.g., these are all possible:
17620
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
1168 expr8[expr1].name
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
1169 expr8.name[expr1]
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
1170 expr8(expr1, ...)[expr1].name
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
1171 expr8->(expr1, ...)[expr1]
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
1172 Evaluation is always from left to right.
14637
0ecb909e3249 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14601
diff changeset
1173
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1174 expr8[expr1] item of String or |List| *expr-[]* *E111*
8876
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
1175 *E909* *subscript*
21823
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1176 In legacy Vim script:
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
1177 If expr8 is a Number or String this results in a String that contains the
21823
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1178 expr1'th single byte from expr8. expr8 is used as a String (a number is
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1179 automatically converted to a String), expr1 as a Number. This doesn't
21991
bbca88cd13d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21989
diff changeset
1180 recognize multibyte encodings, see `byteidx()` for an alternative, or use
21823
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1181 `split()` to turn the string into a list of characters. Example, to get the
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1182 byte under the cursor: >
823
9ab23f1e137f updated for version 7.0c12
vimboss
parents: 819
diff changeset
1183 :let c = getline(".")[col(".") - 1]
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1184
21823
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1185 In Vim9 script:
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1186 If expr8 is a String this results in a String that contains the expr1'th
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1187 single character from expr8. To use byte indexes use |strpart()|.
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1188
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1189 Index zero gives the first byte or character. Careful: text column numbers
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1190 start with one!
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1191
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1192 If the length of the String is less than the index, the result is an empty
7659
07f11de5efca commit https://github.com/vim/vim/commit/85084ef1e999dcf50e8d466106a33bac24a0febb
Christian Brabandt <cb@256bit.org>
parents: 7653
diff changeset
1193 String. A negative index always results in an empty string (reason: backward
21823
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1194 compatibility). Use [-1:] to get the last byte or character.
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
1195 In Vim9 script a negative index is used like with a list: count from the end.
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1196
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1197 If expr8 is a |List| then it results the item at index expr1. See |list-index|
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1198 for possible index values. If the index is out of range this results in an
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1199 error. Example: >
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1200 :let item = mylist[-1] " get last item
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1201
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1202 Generally, if a |List| index is equal to or higher than the length of the
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1203 |List|, or more negative than the length of the |List|, this results in an
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1204 error.
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1205
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
1206
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
1207 expr8[expr1a : expr1b] substring or sublist *expr-[:]*
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
1208
21991
bbca88cd13d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21989
diff changeset
1209 If expr8 is a String this results in the substring with the bytes or
bbca88cd13d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21989
diff changeset
1210 characters from expr1a to and including expr1b. expr8 is used as a String,
bbca88cd13d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21989
diff changeset
1211 expr1a and expr1b are used as a Number.
21823
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1212
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1213 In legacy Vim script the indexes are byte indexes. This doesn't recognize
21991
bbca88cd13d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21989
diff changeset
1214 multibyte encodings, see |byteidx()| for computing the indexes. If expr8 is
21823
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1215 a Number it is first converted to a String.
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1216
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1217 In Vim9 script the indexes are character indexes. To use byte indexes use
b1f3d8a44ab6 patch 8.2.1461: Vim9: string indexes are counted in bytes
Bram Moolenaar <Bram@vim.org>
parents: 21703
diff changeset
1218 |strpart()|.
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1219
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1220 If expr1a is omitted zero is used. If expr1b is omitted the length of the
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1221 string minus one is used.
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1222
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1223 A negative number can be used to measure from the end of the string. -1 is
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1224 the last character, -2 the last but one, etc.
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1225
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1226 If an index goes out of range for the string characters are omitted. If
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1227 expr1b is smaller than expr1a the result is an empty string.
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1228
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1229 Examples: >
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1230 :let c = name[-1:] " last byte of a string
21991
bbca88cd13d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21989
diff changeset
1231 :let c = name[0:-1] " the whole string
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1232 :let c = name[-2:-2] " last but one byte of a string
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1233 :let s = line(".")[4:] " from the fifth byte to the end
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1234 :let s = s[:-3] " remove last two bytes
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
1235 <
9737
35ce559b8553 commit https://github.com/vim/vim/commit/bc8801c9317eb721a2ee91322669f2dd5d136380
Christian Brabandt <cb@256bit.org>
parents: 9723
diff changeset
1236 *slice*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1237 If expr8 is a |List| this results in a new |List| with the items indicated by
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1238 the indexes expr1a and expr1b. This works like with a String, as explained
9737
35ce559b8553 commit https://github.com/vim/vim/commit/bc8801c9317eb721a2ee91322669f2dd5d136380
Christian Brabandt <cb@256bit.org>
parents: 9723
diff changeset
1239 just above. Also see |sublist| below. Examples: >
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1240 :let l = mylist[:3] " first four items
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1241 :let l = mylist[4:4] " List with one item
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1242 :let l = mylist[:] " shallow copy of a List
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
1243
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
1244 If expr8 is a |Blob| this results in a new |Blob| with the bytes in the
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
1245 indexes expr1a and expr1b, inclusive. Examples: >
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
1246 :let b = 0zDEADBEEF
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
1247 :let bs = b[1:2] " 0zADBE
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
1248 :let bs = b[:] " copy of 0zDEADBEEF
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
1249
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1250 Using expr8[expr1] or expr8[expr1a : expr1b] on a |Funcref| results in an
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1251 error.
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1252
7615
228ff048db20 commit https://github.com/vim/vim/commit/da440d21a6b94d7f525fa7be9b1417c78dd9aa4c
Christian Brabandt <cb@256bit.org>
parents: 7597
diff changeset
1253 Watch out for confusion between a namespace and a variable followed by a colon
228ff048db20 commit https://github.com/vim/vim/commit/da440d21a6b94d7f525fa7be9b1417c78dd9aa4c
Christian Brabandt <cb@256bit.org>
parents: 7597
diff changeset
1254 for a sublist: >
228ff048db20 commit https://github.com/vim/vim/commit/da440d21a6b94d7f525fa7be9b1417c78dd9aa4c
Christian Brabandt <cb@256bit.org>
parents: 7597
diff changeset
1255 mylist[n:] " uses variable n
228ff048db20 commit https://github.com/vim/vim/commit/da440d21a6b94d7f525fa7be9b1417c78dd9aa4c
Christian Brabandt <cb@256bit.org>
parents: 7597
diff changeset
1256 mylist[s:] " uses namespace s:, error!
228ff048db20 commit https://github.com/vim/vim/commit/da440d21a6b94d7f525fa7be9b1417c78dd9aa4c
Christian Brabandt <cb@256bit.org>
parents: 7597
diff changeset
1257
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1258
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1259 expr8.name entry in a |Dictionary| *expr-entry*
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1260
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1261 If expr8 is a |Dictionary| and it is followed by a dot, then the following
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1262 name will be used as a key in the |Dictionary|. This is just like:
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1263 expr8[name].
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
1264
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
1265 The name must consist of alphanumeric characters, just like a variable name,
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
1266 but it may start with a number. Curly braces cannot be used.
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
1267
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
1268 There must not be white space before or after the dot.
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
1269
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
1270 Examples: >
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
1271 :let dict = {"one": 1, 2: "two"}
16808
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16704
diff changeset
1272 :echo dict.one " shows "1"
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16704
diff changeset
1273 :echo dict.2 " shows "two"
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16704
diff changeset
1274 :echo dict .2 " error because of space before the dot
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
1275
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
1276 Note that the dot is also used for String concatenation. To avoid confusion
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
1277 always put spaces around the dot for String concatenation.
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
1278
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
1279
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1280 expr8(expr1, ...) |Funcref| function call
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
1281
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
1282 When expr8 is a |Funcref| type variable, invoke the function it refers to.
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
1283
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
1284
17674
06c3e15ad84d patch 8.1.1834: cannot use a lambda as a method
Bram Moolenaar <Bram@vim.org>
parents: 17667
diff changeset
1285 expr8->name([args]) method call *method* *->*
06c3e15ad84d patch 8.1.1834: cannot use a lambda as a method
Bram Moolenaar <Bram@vim.org>
parents: 17667
diff changeset
1286 expr8->{lambda}([args])
17758
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
1287 *E276*
17620
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
1288 For methods that are also available as global functions this is the same as: >
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
1289 name(expr8 [, args])
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
1290 There can also be methods specifically for the type of "expr8".
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
1291
17661
da7890e3359b patch 8.1.1828: not strict enough checking syntax of method invocation
Bram Moolenaar <Bram@vim.org>
parents: 17624
diff changeset
1292 This allows for chaining, passing the value that one method returns to the
da7890e3359b patch 8.1.1828: not strict enough checking syntax of method invocation
Bram Moolenaar <Bram@vim.org>
parents: 17624
diff changeset
1293 next method: >
17620
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
1294 mylist->filter(filterexpr)->map(mapexpr)->sort()->join()
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
1295 <
17674
06c3e15ad84d patch 8.1.1834: cannot use a lambda as a method
Bram Moolenaar <Bram@vim.org>
parents: 17667
diff changeset
1296 Example of using a lambda: >
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
1297 GetPercentage()->{x -> x * 100}()->printf('%d%%')
17758
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
1298 <
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
1299 When using -> the |expr7| operators will be applied first, thus: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
1300 -1.234->string()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
1301 Is equivalent to: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
1302 (-1.234)->string()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
1303 And NOT: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
1304 -(1.234->string())
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
1305 <
17661
da7890e3359b patch 8.1.1828: not strict enough checking syntax of method invocation
Bram Moolenaar <Bram@vim.org>
parents: 17624
diff changeset
1306 *E274*
da7890e3359b patch 8.1.1828: not strict enough checking syntax of method invocation
Bram Moolenaar <Bram@vim.org>
parents: 17624
diff changeset
1307 "->name(" must not contain white space. There can be white space before the
da7890e3359b patch 8.1.1828: not strict enough checking syntax of method invocation
Bram Moolenaar <Bram@vim.org>
parents: 17624
diff changeset
1308 "->" and after the "(", thus you can split the lines like this: >
da7890e3359b patch 8.1.1828: not strict enough checking syntax of method invocation
Bram Moolenaar <Bram@vim.org>
parents: 17624
diff changeset
1309 mylist
da7890e3359b patch 8.1.1828: not strict enough checking syntax of method invocation
Bram Moolenaar <Bram@vim.org>
parents: 17624
diff changeset
1310 \ ->filter(filterexpr)
da7890e3359b patch 8.1.1828: not strict enough checking syntax of method invocation
Bram Moolenaar <Bram@vim.org>
parents: 17624
diff changeset
1311 \ ->map(mapexpr)
da7890e3359b patch 8.1.1828: not strict enough checking syntax of method invocation
Bram Moolenaar <Bram@vim.org>
parents: 17624
diff changeset
1312 \ ->sort()
da7890e3359b patch 8.1.1828: not strict enough checking syntax of method invocation
Bram Moolenaar <Bram@vim.org>
parents: 17624
diff changeset
1313 \ ->join()
17758
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
1314
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
1315 When using the lambda form there must be no white space between the } and the
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
1316 (.
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
1317
17620
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
1318
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
1319 *expr9*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1320 number
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1321 ------
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
1322 number number constant *expr-number*
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
1323
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
1324 *0x* *hex-number* *0o* *octal-number* *binary-number*
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
1325 Decimal, Hexadecimal (starting with 0x or 0X), Binary (starting with 0b or 0B)
20665
6ff992bf4c82 patch 8.2.0886: cannot use octal numbers in scriptversion 4
Bram Moolenaar <Bram@vim.org>
parents: 20649
diff changeset
1326 and Octal (starting with 0, 0o or 0O).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1327
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1328 *floating-point-format*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1329 Floating point numbers can be written in two forms:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1330
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1331 [-+]{N}.{M}
6530
435956324539 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6447
diff changeset
1332 [-+]{N}.{M}[eE][-+]{exp}
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1333
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1334 {N} and {M} are numbers. Both {N} and {M} must be present and can only
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1335 contain digits.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1336 [-+] means there is an optional plus or minus sign.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1337 {exp} is the exponent, power of 10.
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1338 Only a decimal point is accepted, not a comma. No matter what the current
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1339 locale is.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1340 {only when compiled with the |+float| feature}
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1341
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1342 Examples:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1343 123.456
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1344 +0.0001
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1345 55.0
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1346 -0.123
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1347 1.234e03
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1348 1.0E-6
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1349 -3.1416e+88
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1350
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1351 These are INVALID:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1352 3. empty {M}
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1353 1e40 missing .{M}
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1354
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1355 Rationale:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1356 Before floating point was introduced, the text "123.456" was interpreted as
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1357 the two numbers "123" and "456", both converted to a string and concatenated,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1358 resulting in the string "123456". Since this was considered pointless, and we
1698
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
1359 could not find it intentionally being used in Vim scripts, this backwards
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1360 incompatibility was accepted in favor of being able to use the normal notation
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1361 for floating point numbers.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1362
15131
bc1a8d21c811 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15062
diff changeset
1363 *float-pi* *float-e*
bc1a8d21c811 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15062
diff changeset
1364 A few useful values to copy&paste: >
bc1a8d21c811 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15062
diff changeset
1365 :let pi = 3.14159265359
bc1a8d21c811 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15062
diff changeset
1366 :let e = 2.71828182846
bc1a8d21c811 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15062
diff changeset
1367 Or, if you don't want to write them in as floating-point literals, you can
bc1a8d21c811 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15062
diff changeset
1368 also use functions, like the following: >
bc1a8d21c811 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15062
diff changeset
1369 :let pi = acos(-1.0)
bc1a8d21c811 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15062
diff changeset
1370 :let e = exp(1.0)
15138
9df130fd5e0d patch 8.1.0579: cannot attach properties to text
Bram Moolenaar <Bram@vim.org>
parents: 15131
diff changeset
1371 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1372 *floating-point-precision*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1373 The precision and range of floating points numbers depends on what "double"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1374 means in the library Vim was compiled with. There is no way to change this at
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1375 runtime.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1376
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1377 The default for displaying a |Float| is to use 6 decimal places, like using
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1378 printf("%g", f). You can select something else when using the |printf()|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1379 function. Example: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1380 :echo printf('%.15e', atan(1))
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1381 < 7.853981633974483e-01
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1382
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1383
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1384
6884
29c328f69aaa Update help files.
Bram Moolenaar <bram@vim.org>
parents: 6870
diff changeset
1385 string *string* *String* *expr-string* *E114*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1386 ------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1387 "string" string constant *expr-quote*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1388
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1389 Note that double quotes are used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1390
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1391 A string constant accepts these special characters:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1392 \... three-digit octal number (e.g., "\316")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1393 \.. two-digit octal number (must be followed by non-digit)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1394 \. one-digit octal number (must be followed by non-digit)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1395 \x.. byte specified with two hex numbers (e.g., "\x1f")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1396 \x. byte specified with one hex number (must be followed by non-hex char)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1397 \X.. same as \x..
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1398 \X. same as \x.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1399 \u.... character specified with up to 4 hex numbers, stored according to the
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1400 current value of 'encoding' (e.g., "\u02a4")
6840
37828f7503c7 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6823
diff changeset
1401 \U.... same as \u but allows up to 8 hex numbers.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1402 \b backspace <BS>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1403 \e escape <Esc>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1404 \f formfeed <FF>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1405 \n newline <NL>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1406 \r return <CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1407 \t tab <Tab>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1408 \\ backslash
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1409 \" double quote
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2120
diff changeset
1410 \<xxx> Special key named "xxx". e.g. "\<C-W>" for CTRL-W. This is for use
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1411 in mappings, the 0x80 byte is escaped.
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1412 To use the double quote character it must be escaped: "<M-\">".
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1413 Don't use <Char-xxxx> to get a utf-8 character, use \uxxxx as
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1414 mentioned above.
20627
8bce783af0cb patch 8.2.0867: using {xxx} for encoding a modifier is not nice
Bram Moolenaar <Bram@vim.org>
parents: 20615
diff changeset
1415 \<*xxx> Like \<xxx> but prepends a modifier instead of including it in the
8bce783af0cb patch 8.2.0867: using {xxx} for encoding a modifier is not nice
Bram Moolenaar <Bram@vim.org>
parents: 20615
diff changeset
1416 character. E.g. "\<C-w>" is one character 0x17 while "\<*C-w>" is four
20603
c2570baa2e4c patch 8.2.0855: GUI tests fail because the test doesn't use a modifier
Bram Moolenaar <Bram@vim.org>
parents: 20593
diff changeset
1417 bytes: 3 for the CTRL modifier and then character "W".
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1418
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
1419 Note that "\xff" is stored as the byte 255, which may be invalid in some
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
1420 encodings. Use "\u00ff" to store character 255 according to the current value
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
1421 of 'encoding'.
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
1422
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1423 Note that "\000" and "\x00" force the end of the string.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1424
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1425
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
1426 blob-literal *blob-literal* *E973*
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
1427 ------------
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
1428
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
1429 Hexadecimal starting with 0z or 0Z, with an arbitrary number of bytes.
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
1430 The sequence must be an even number of hex characters. Example: >
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
1431 :let b = 0zFF00ED015DAF
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
1432
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
1433
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1434 literal-string *literal-string* *E115*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1435 ---------------
26
404aac550f35 updated for version 7.0017
vimboss
parents: 24
diff changeset
1436 'string' string constant *expr-'*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1437
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1438 Note that single quotes are used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1439
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1440 This string is taken as it is. No backslashes are removed or have a special
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
1441 meaning. The only exception is that two quotes stand for one quote.
26
404aac550f35 updated for version 7.0017
vimboss
parents: 24
diff changeset
1442
404aac550f35 updated for version 7.0017
vimboss
parents: 24
diff changeset
1443 Single quoted strings are useful for patterns, so that backslashes do not need
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1444 to be doubled. These two commands are equivalent: >
26
404aac550f35 updated for version 7.0017
vimboss
parents: 24
diff changeset
1445 if a =~ "\\s*"
404aac550f35 updated for version 7.0017
vimboss
parents: 24
diff changeset
1446 if a =~ '\s*'
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1447
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1448
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1449 option *expr-option* *E112* *E113*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1450 ------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1451 &option option value, local value if possible
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1452 &g:option global option value
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1453 &l:option local option value
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1454
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1455 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1456 echo "tabstop is " . &tabstop
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1457 if &insertmode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1458
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1459 Any option name can be used here. See |options|. When using the local value
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1460 and there is no buffer-local or window-local value, the global value is used
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1461 anyway.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1462
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1463
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
1464 register *expr-register* *@r*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1465 --------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1466 @r contents of register 'r'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1467
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1468 The result is the contents of the named register, as a single string.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1469 Newlines are inserted where required. To get the contents of the unnamed
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1470 register use @" or @@. See |registers| for an explanation of the available
336
2d8c2622e1fa updated for version 7.0087
vimboss
parents: 327
diff changeset
1471 registers.
2d8c2622e1fa updated for version 7.0087
vimboss
parents: 327
diff changeset
1472
2d8c2622e1fa updated for version 7.0087
vimboss
parents: 327
diff changeset
1473 When using the '=' register you get the expression itself, not what it
2d8c2622e1fa updated for version 7.0087
vimboss
parents: 327
diff changeset
1474 evaluates to. Use |eval()| to evaluate it.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1475
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1476
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1477 nesting *expr-nesting* *E110*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1478 -------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1479 (expr1) nested expression
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1480
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1481
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1482 environment variable *expr-env*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1483 --------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1484 $VAR environment variable
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1485
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1486 The String value of any environment variable. When it is not defined, the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1487 result is an empty string.
16604
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
1488
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
1489 The functions `getenv()` and `setenv()` can also be used and work for
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
1490 environment variables with non-alphanumeric names.
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
1491 The function `environ()` can be used to get a Dict with all environment
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
1492 variables.
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
1493
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
1494
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1495 *expr-env-expand*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1496 Note that there is a difference between using $VAR directly and using
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1497 expand("$VAR"). Using it directly will only expand environment variables that
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1498 are known inside the current Vim session. Using expand() will first try using
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1499 the environment variables known inside the current Vim session. If that
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1500 fails, a shell will be used to expand the variable. This can be slow, but it
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1501 does expand all variables that the shell knows about. Example: >
6180
6921742f396a Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6153
diff changeset
1502 :echo $shell
6921742f396a Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6153
diff changeset
1503 :echo expand("$shell")
6921742f396a Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6153
diff changeset
1504 The first one probably doesn't echo anything, the second echoes the $shell
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1505 variable (if your shell supports it).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1506
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1507
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1508 internal variable *expr-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1509 -----------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1510 variable internal variable
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1511 See below |internal-variables|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1512
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1513
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
1514 function call *expr-function* *E116* *E118* *E119* *E120*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1515 -------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1516 function(expr1, ...) function call
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1517 See below |functions|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1518
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1519
9527
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1520 lambda expression *expr-lambda* *lambda*
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1521 -----------------
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1522 {args -> expr1} lambda expression
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1523
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1524 A lambda expression creates a new unnamed function which returns the result of
9555
9560a5b782ee commit https://github.com/vim/vim/commit/42ebd066422d73cdb7bda6a1dc828a3dd022dec8
Christian Brabandt <cb@256bit.org>
parents: 9536
diff changeset
1525 evaluating |expr1|. Lambda expressions differ from |user-functions| in
9527
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1526 the following ways:
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1527
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1528 1. The body of the lambda expression is an |expr1| and not a sequence of |Ex|
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1529 commands.
9686
8c2553beff0f commit https://github.com/vim/vim/commit/1e96d9bf98f9ab84d5af7f98d6a961d91b17364f
Christian Brabandt <cb@256bit.org>
parents: 9644
diff changeset
1530 2. The prefix "a:" should not be used for arguments. E.g.: >
9527
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1531 :let F = {arg1, arg2 -> arg1 - arg2}
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1532 :echo F(5, 2)
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1533 < 3
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1534
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1535 The arguments are optional. Example: >
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1536 :let F = {-> 'error function'}
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1537 :echo F()
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1538 < error function
9686
8c2553beff0f commit https://github.com/vim/vim/commit/1e96d9bf98f9ab84d5af7f98d6a961d91b17364f
Christian Brabandt <cb@256bit.org>
parents: 9644
diff changeset
1539 *closure*
8c2553beff0f commit https://github.com/vim/vim/commit/1e96d9bf98f9ab84d5af7f98d6a961d91b17364f
Christian Brabandt <cb@256bit.org>
parents: 9644
diff changeset
1540 Lambda expressions can access outer scope variables and arguments. This is
10218
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
1541 often called a closure. Example where "i" and "a:arg" are used in a lambda
13329
424321d6eea7 patch 8.0.1539: no test for the popup menu positioning
Christian Brabandt <cb@256bit.org>
parents: 13298
diff changeset
1542 while they already exist in the function scope. They remain valid even after
424321d6eea7 patch 8.0.1539: no test for the popup menu positioning
Christian Brabandt <cb@256bit.org>
parents: 13298
diff changeset
1543 the function returns: >
9686
8c2553beff0f commit https://github.com/vim/vim/commit/1e96d9bf98f9ab84d5af7f98d6a961d91b17364f
Christian Brabandt <cb@256bit.org>
parents: 9644
diff changeset
1544 :function Foo(arg)
8c2553beff0f commit https://github.com/vim/vim/commit/1e96d9bf98f9ab84d5af7f98d6a961d91b17364f
Christian Brabandt <cb@256bit.org>
parents: 9644
diff changeset
1545 : let i = 3
8c2553beff0f commit https://github.com/vim/vim/commit/1e96d9bf98f9ab84d5af7f98d6a961d91b17364f
Christian Brabandt <cb@256bit.org>
parents: 9644
diff changeset
1546 : return {x -> x + i - a:arg}
8c2553beff0f commit https://github.com/vim/vim/commit/1e96d9bf98f9ab84d5af7f98d6a961d91b17364f
Christian Brabandt <cb@256bit.org>
parents: 9644
diff changeset
1547 :endfunction
8c2553beff0f commit https://github.com/vim/vim/commit/1e96d9bf98f9ab84d5af7f98d6a961d91b17364f
Christian Brabandt <cb@256bit.org>
parents: 9644
diff changeset
1548 :let Bar = Foo(4)
8c2553beff0f commit https://github.com/vim/vim/commit/1e96d9bf98f9ab84d5af7f98d6a961d91b17364f
Christian Brabandt <cb@256bit.org>
parents: 9644
diff changeset
1549 :echo Bar(6)
8c2553beff0f commit https://github.com/vim/vim/commit/1e96d9bf98f9ab84d5af7f98d6a961d91b17364f
Christian Brabandt <cb@256bit.org>
parents: 9644
diff changeset
1550 < 5
9723
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
1551
20552
74e3316c1d5a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20522
diff changeset
1552 Note that the variables must exist in the outer scope before the lambda is
13329
424321d6eea7 patch 8.0.1539: no test for the popup menu positioning
Christian Brabandt <cb@256bit.org>
parents: 13298
diff changeset
1553 defined for this to work. See also |:func-closure|.
424321d6eea7 patch 8.0.1539: no test for the popup menu positioning
Christian Brabandt <cb@256bit.org>
parents: 13298
diff changeset
1554
424321d6eea7 patch 8.0.1539: no test for the popup menu positioning
Christian Brabandt <cb@256bit.org>
parents: 13298
diff changeset
1555 Lambda and closure support can be checked with: >
9723
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
1556 if has('lambda')
9527
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1557
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1558 Examples for using a lambda expression with |sort()|, |map()| and |filter()|: >
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1559 :echo map([1, 2, 3], {idx, val -> val + 1})
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1560 < [2, 3, 4] >
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1561 :echo sort([3,7,2,1,4], {a, b -> a - b})
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1562 < [1, 2, 3, 4, 7]
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1563
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1564 The lambda expression is also useful for Channel, Job and timer: >
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1565 :let timer = timer_start(500,
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1566 \ {-> execute("echo 'Handler called'", "")},
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1567 \ {'repeat': 3})
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1568 < Handler called
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1569 Handler called
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1570 Handler called
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1571
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1572 Note how execute() is used to execute an Ex command. That's ugly though.
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
1573
9686
8c2553beff0f commit https://github.com/vim/vim/commit/1e96d9bf98f9ab84d5af7f98d6a961d91b17364f
Christian Brabandt <cb@256bit.org>
parents: 9644
diff changeset
1574
8c2553beff0f commit https://github.com/vim/vim/commit/1e96d9bf98f9ab84d5af7f98d6a961d91b17364f
Christian Brabandt <cb@256bit.org>
parents: 9644
diff changeset
1575 Lambda expressions have internal names like '<lambda>42'. If you get an error
8c2553beff0f commit https://github.com/vim/vim/commit/1e96d9bf98f9ab84d5af7f98d6a961d91b17364f
Christian Brabandt <cb@256bit.org>
parents: 9644
diff changeset
1576 for a lambda expression, you can find what it is with the following command: >
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
1577 :function <lambda>42
9686
8c2553beff0f commit https://github.com/vim/vim/commit/1e96d9bf98f9ab84d5af7f98d6a961d91b17364f
Christian Brabandt <cb@256bit.org>
parents: 9644
diff changeset
1578 See also: |numbered-function|
8c2553beff0f commit https://github.com/vim/vim/commit/1e96d9bf98f9ab84d5af7f98d6a961d91b17364f
Christian Brabandt <cb@256bit.org>
parents: 9644
diff changeset
1579
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1580 ==============================================================================
2596
fae782ef63dd Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 2581
diff changeset
1581 3. Internal variable *internal-variables* *E461*
fae782ef63dd Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 2581
diff changeset
1582
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1583 An internal variable name can be made up of letters, digits and '_'. But it
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1584 cannot start with a digit. It's also possible to use curly braces, see
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1585 |curly-braces-names|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1586
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1587 An internal variable is created with the ":let" command |:let|.
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
1588 An internal variable is explicitly destroyed with the ":unlet" command
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
1589 |:unlet|.
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
1590 Using a name that is not an internal variable or refers to a variable that has
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
1591 been destroyed results in an error.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1592
20856
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
1593 *variable-scope*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1594 There are several name spaces for variables. Which one is to be used is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1595 specified by what is prepended:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1596
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1597 (nothing) In a function: local to a function; otherwise: global
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1598 |buffer-variable| b: Local to the current buffer.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1599 |window-variable| w: Local to the current window.
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
1600 |tabpage-variable| t: Local to the current tab page.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1601 |global-variable| g: Global.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1602 |local-variable| l: Local to a function.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1603 |script-variable| s: Local to a |:source|'ed Vim script.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1604 |function-argument| a: Function argument (only inside a function).
5815
d735e62f5925 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5814
diff changeset
1605 |vim-variable| v: Global, predefined by Vim.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1606
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1607 The scope name by itself can be used as a |Dictionary|. For example, to
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
1608 delete all script-local variables: >
133
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
1609 :for k in keys(s:)
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
1610 : unlet s:[k]
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
1611 :endfor
20856
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
1612
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
1613 Note: in Vim9 script this is different, see |vim9-scopes|.
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
1614
4358
cf1d93a3914a Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 4354
diff changeset
1615 *buffer-variable* *b:var* *b:*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1616 A variable name that is preceded with "b:" is local to the current buffer.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1617 Thus you can have several "b:foo" variables, one for each buffer.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1618 This kind of variable is deleted when the buffer is wiped out or deleted with
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1619 |:bdelete|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1620
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1621 One local buffer variable is predefined:
4264
2d1383658bb4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 4229
diff changeset
1622 *b:changedtick* *changetick*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1623 b:changedtick The total number of changes to the current buffer. It is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1624 incremented for each change. An undo command is also a change
16996
d5e1e09a829f patch 8.1.1498: ":write" increments b:changedtick even though nothing changed
Bram Moolenaar <Bram@vim.org>
parents: 16971
diff changeset
1625 in this case. Resetting 'modified' when writing the buffer is
d5e1e09a829f patch 8.1.1498: ":write" increments b:changedtick even though nothing changed
Bram Moolenaar <Bram@vim.org>
parents: 16971
diff changeset
1626 also counted.
d5e1e09a829f patch 8.1.1498: ":write" increments b:changedtick even though nothing changed
Bram Moolenaar <Bram@vim.org>
parents: 16971
diff changeset
1627 This can be used to perform an action only when the buffer has
d5e1e09a829f patch 8.1.1498: ":write" increments b:changedtick even though nothing changed
Bram Moolenaar <Bram@vim.org>
parents: 16971
diff changeset
1628 changed. Example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1629 :if my_changedtick != b:changedtick
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1630 : let my_changedtick = b:changedtick
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
1631 : call My_Update()
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1632 :endif
10895
c391bfbdb452 Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10787
diff changeset
1633 < You cannot change or delete the b:changedtick variable.
c391bfbdb452 Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10787
diff changeset
1634
4358
cf1d93a3914a Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 4354
diff changeset
1635 *window-variable* *w:var* *w:*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1636 A variable name that is preceded with "w:" is local to the current window. It
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1637 is deleted when the window is closed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1638
4437
eb6ab7e78925 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 4358
diff changeset
1639 *tabpage-variable* *t:var* *t:*
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
1640 A variable name that is preceded with "t:" is local to the current tab page,
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
1641 It is deleted when the tab page is closed. {not available when compiled
2570
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2569
diff changeset
1642 without the |+windows| feature}
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
1643
4358
cf1d93a3914a Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 4354
diff changeset
1644 *global-variable* *g:var* *g:*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1645 Inside functions global variables are accessed with "g:". Omitting this will
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1646 access a variable local to a function. But "g:" can also be used in any other
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1647 place if you like.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1648
4358
cf1d93a3914a Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 4354
diff changeset
1649 *local-variable* *l:var* *l:*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1650 Inside functions local variables are accessed without prepending anything.
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
1651 But you can also prepend "l:" if you like. However, without prepending "l:"
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
1652 you may run into reserved variable names. For example "count". By itself it
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
1653 refers to "v:count". Using "l:count" you can have a local variable with the
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
1654 same name.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1655
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1656 *script-variable* *s:var*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1657 In a Vim script variables starting with "s:" can be used. They cannot be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1658 accessed from outside of the scripts, thus are local to the script.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1659
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1660 They can be used in:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1661 - commands executed while the script is sourced
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1662 - functions defined in the script
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1663 - autocommands defined in the script
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1664 - functions and autocommands defined in functions and autocommands which were
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1665 defined in the script (recursively)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1666 - user defined commands defined in the script
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1667 Thus not in:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1668 - other scripts sourced from this one
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1669 - mappings
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
1670 - menus
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1671 - etc.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1672
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
1673 Script variables can be used to avoid conflicts with global variable names.
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
1674 Take this example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1675
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1676 let s:counter = 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1677 function MyCounter()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1678 let s:counter = s:counter + 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1679 echo s:counter
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1680 endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1681 command Tick call MyCounter()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1682
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1683 You can now invoke "Tick" from any script, and the "s:counter" variable in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1684 that script will not be changed, only the "s:counter" in the script where
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1685 "Tick" was defined is used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1686
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1687 Another example that does the same: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1688
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1689 let s:counter = 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1690 command Tick let s:counter = s:counter + 1 | echo s:counter
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1691
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1692 When calling a function and invoking a user-defined command, the context for
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
1693 script variables is set to the script where the function or command was
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1694 defined.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1695
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1696 The script variables are also available when a function is defined inside a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1697 function that is defined in a script. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1698
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1699 let s:counter = 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1700 function StartCounting(incr)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1701 if a:incr
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1702 function MyCounter()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1703 let s:counter = s:counter + 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1704 endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1705 else
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1706 function MyCounter()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1707 let s:counter = s:counter - 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1708 endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1709 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1710 endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1711
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1712 This defines the MyCounter() function either for counting up or counting down
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1713 when calling StartCounting(). It doesn't matter from where StartCounting() is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1714 called, the s:counter variable will be accessible in MyCounter().
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1715
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1716 When the same script is sourced again it will use the same script variables.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1717 They will remain valid as long as Vim is running. This can be used to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1718 maintain a counter: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1719
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1720 if !exists("s:counter")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1721 let s:counter = 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1722 echo "script executed for the first time"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1723 else
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1724 let s:counter = s:counter + 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1725 echo "script executed " . s:counter . " times now"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1726 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1727
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1728 Note that this means that filetype plugins don't get a different set of script
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1729 variables for each buffer. Use local buffer variables instead |b:var|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1730
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1731
15131
bc1a8d21c811 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15062
diff changeset
1732 PREDEFINED VIM VARIABLES *vim-variable* *v:var* *v:*
bc1a8d21c811 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15062
diff changeset
1733 *E963*
bc1a8d21c811 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15062
diff changeset
1734 Some variables can be set by the user, but the type cannot be changed.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1735
18477
e93cab5d0f0f patch 8.1.2233: cannot get the Vim command line arguments
Bram Moolenaar <Bram@vim.org>
parents: 18463
diff changeset
1736 *v:argv* *argv-variable*
e93cab5d0f0f patch 8.1.2233: cannot get the Vim command line arguments
Bram Moolenaar <Bram@vim.org>
parents: 18463
diff changeset
1737 v:argv The command line arguments Vim was invoked with. This is a
e93cab5d0f0f patch 8.1.2233: cannot get the Vim command line arguments
Bram Moolenaar <Bram@vim.org>
parents: 18463
diff changeset
1738 list of strings. The first item is the Vim command.
e93cab5d0f0f patch 8.1.2233: cannot get the Vim command line arguments
Bram Moolenaar <Bram@vim.org>
parents: 18463
diff changeset
1739
189
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1740 *v:beval_col* *beval_col-variable*
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1741 v:beval_col The number of the column, over which the mouse pointer is.
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1742 This is the byte index in the |v:beval_lnum| line.
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1743 Only valid while evaluating the 'balloonexpr' option.
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1744
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1745 *v:beval_bufnr* *beval_bufnr-variable*
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1746 v:beval_bufnr The number of the buffer, over which the mouse pointer is. Only
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1747 valid while evaluating the 'balloonexpr' option.
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1748
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1749 *v:beval_lnum* *beval_lnum-variable*
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1750 v:beval_lnum The number of the line, over which the mouse pointer is. Only
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1751 valid while evaluating the 'balloonexpr' option.
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1752
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1753 *v:beval_text* *beval_text-variable*
374
575dacb554d8 updated for version 7.0096
vimboss
parents: 370
diff changeset
1754 v:beval_text The text under or after the mouse pointer. Usually a word as
575dacb554d8 updated for version 7.0096
vimboss
parents: 370
diff changeset
1755 it is useful for debugging a C program. 'iskeyword' applies,
575dacb554d8 updated for version 7.0096
vimboss
parents: 370
diff changeset
1756 but a dot and "->" before the position is included. When on a
575dacb554d8 updated for version 7.0096
vimboss
parents: 370
diff changeset
1757 ']' the text before it is used, including the matching '[' and
189
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1758 word before it. When on a Visual area within one line the
12427
fc3e2d5614dd patch 8.0.1093: various small quickfix issues
Christian Brabandt <cb@256bit.org>
parents: 12389
diff changeset
1759 highlighted text is used. Also see |<cexpr>|.
189
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1760 Only valid while evaluating the 'balloonexpr' option.
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1761
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1762 *v:beval_winnr* *beval_winnr-variable*
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1763 v:beval_winnr The number of the window, over which the mouse pointer is. Only
2709
b01a37ab556b Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 2698
diff changeset
1764 valid while evaluating the 'balloonexpr' option. The first
b01a37ab556b Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 2698
diff changeset
1765 window has number zero (unlike most other places where a
b01a37ab556b Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 2698
diff changeset
1766 window gets a number).
189
504c627f7474 updated for version 7.0057
vimboss
parents: 179
diff changeset
1767
9221
17fa362f10be commit https://github.com/vim/vim/commit/511972d810ea490955161ff5097ec2f57919ceaf
Christian Brabandt <cb@256bit.org>
parents: 9219
diff changeset
1768 *v:beval_winid* *beval_winid-variable*
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
1769 v:beval_winid The |window-ID| of the window, over which the mouse pointer
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
1770 is. Otherwise like v:beval_winnr.
9221
17fa362f10be commit https://github.com/vim/vim/commit/511972d810ea490955161ff5097ec2f57919ceaf
Christian Brabandt <cb@256bit.org>
parents: 9219
diff changeset
1771
844
d3bbb5dd3913 updated for version 7.0f02
vimboss
parents: 843
diff changeset
1772 *v:char* *char-variable*
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
1773 v:char Argument for evaluating 'formatexpr' and used for the typed
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2236
diff changeset
1774 character when using <expr> in an abbreviation |:map-<expr>|.
4502
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4437
diff changeset
1775 It is also used by the |InsertCharPre| and |InsertEnter| events.
844
d3bbb5dd3913 updated for version 7.0f02
vimboss
parents: 843
diff changeset
1776
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1777 *v:charconvert_from* *charconvert_from-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1778 v:charconvert_from
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1779 The name of the character encoding of a file to be converted.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1780 Only valid while evaluating the 'charconvert' option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1781
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1782 *v:charconvert_to* *charconvert_to-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1783 v:charconvert_to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1784 The name of the character encoding of a file after conversion.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1785 Only valid while evaluating the 'charconvert' option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1786
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1787 *v:cmdarg* *cmdarg-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1788 v:cmdarg This variable is used for two purposes:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1789 1. The extra arguments given to a file read/write command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1790 Currently these are "++enc=" and "++ff=". This variable is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1791 set before an autocommand event for a file read/write
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1792 command is triggered. There is a leading space to make it
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1793 possible to append this variable directly after the
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1794 read/write command. Note: The "+cmd" argument isn't
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1795 included here, because it will be executed anyway.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1796 2. When printing a PostScript file with ":hardcopy" this is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1797 the argument for the ":hardcopy" command. This can be used
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1798 in 'printexpr'.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1799
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1800 *v:cmdbang* *cmdbang-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1801 v:cmdbang Set like v:cmdarg for a file read/write command. When a "!"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1802 was used the value is 1, otherwise it is 0. Note that this
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1803 can only be used in autocommands. For user commands |<bang>|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1804 can be used.
20873
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
1805 *v:collate* *collate-variable*
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
1806 v:collate The current locale setting for collation order of the runtime
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
1807 environment. This allows Vim scripts to be aware of the
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
1808 current locale encoding. Technical: it's the value of
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
1809 LC_COLLATE. When not using a locale the value is "C".
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
1810 This variable can not be set directly, use the |:language|
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
1811 command.
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
1812 See |multi-lang|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1813
6909
676906c33768 patch 7.4.774
Bram Moolenaar <bram@vim.org>
parents: 6884
diff changeset
1814 *v:completed_item* *completed_item-variable*
676906c33768 patch 7.4.774
Bram Moolenaar <bram@vim.org>
parents: 6884
diff changeset
1815 v:completed_item
676906c33768 patch 7.4.774
Bram Moolenaar <bram@vim.org>
parents: 6884
diff changeset
1816 |Dictionary| containing the |complete-items| for the most
676906c33768 patch 7.4.774
Bram Moolenaar <bram@vim.org>
parents: 6884
diff changeset
1817 recently completed word after |CompleteDone|. The
676906c33768 patch 7.4.774
Bram Moolenaar <bram@vim.org>
parents: 6884
diff changeset
1818 |Dictionary| is empty if the completion failed.
676906c33768 patch 7.4.774
Bram Moolenaar <bram@vim.org>
parents: 6884
diff changeset
1819
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1820 *v:count* *count-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1821 v:count The count given for the last Normal mode command. Can be used
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1822 to get the count before a mapping. Read-only. Example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1823 :map _x :<C-U>echo "the count is " . v:count<CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1824 < Note: The <C-U> is required to remove the line range that you
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1825 get when typing ':' after a count.
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
1826 When there are two counts, as in "3d2w", they are multiplied,
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
1827 just like what happens in the command, "d6w" for the example.
667
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
1828 Also used for evaluating the 'formatexpr' option.
16366
6ee80f3b5ea9 patch 8.1.1188: not all Vim variables require the v: prefix
Bram Moolenaar <Bram@vim.org>
parents: 16271
diff changeset
1829 "count" also works, for backwards compatibility, unless
6ee80f3b5ea9 patch 8.1.1188: not all Vim variables require the v: prefix
Bram Moolenaar <Bram@vim.org>
parents: 16271
diff changeset
1830 |scriptversion| is 3 or higher.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1831
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1832 *v:count1* *count1-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1833 v:count1 Just like "v:count", but defaults to one when no count is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1834 used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1835
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1836 *v:ctype* *ctype-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1837 v:ctype The current locale setting for characters of the runtime
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1838 environment. This allows Vim scripts to be aware of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1839 current locale encoding. Technical: it's the value of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1840 LC_CTYPE. When not using a locale the value is "C".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1841 This variable can not be set directly, use the |:language|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1842 command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1843 See |multi-lang|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1844
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1845 *v:dying* *dying-variable*
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1846 v:dying Normally zero. When a deadly signal is caught it's set to
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1847 one. When multiple signals are caught the number increases.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1848 Can be used in an autocommand to check if Vim didn't
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1849 terminate normally. {only works on Unix}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1850 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1851 :au VimLeave * if v:dying | echo "\nAAAAaaaarrrggghhhh!!!\n" | endif
2226
36a9ac99e1ca Don't execute some autocommands when v:dying is 2 or more.
Bram Moolenaar <bram@vim.org>
parents: 2214
diff changeset
1852 < Note: if another deadly signal is caught when v:dying is one,
36a9ac99e1ca Don't execute some autocommands when v:dying is 2 or more.
Bram Moolenaar <bram@vim.org>
parents: 2214
diff changeset
1853 VimLeave autocommands will not be executed.
36a9ac99e1ca Don't execute some autocommands when v:dying is 2 or more.
Bram Moolenaar <bram@vim.org>
parents: 2214
diff changeset
1854
23048
ad674a98058a patch 8.2.2070: can't get the exit value in VimLeave(Pre) autocommands
Bram Moolenaar <Bram@vim.org>
parents: 22958
diff changeset
1855 *v:exiting* *exiting-variable*
ad674a98058a patch 8.2.2070: can't get the exit value in VimLeave(Pre) autocommands
Bram Moolenaar <Bram@vim.org>
parents: 22958
diff changeset
1856 v:exiting Vim exit code. Normally zero, non-zero when something went
ad674a98058a patch 8.2.2070: can't get the exit value in VimLeave(Pre) autocommands
Bram Moolenaar <Bram@vim.org>
parents: 22958
diff changeset
1857 wrong. The value is v:null before invoking the |VimLeavePre|
ad674a98058a patch 8.2.2070: can't get the exit value in VimLeave(Pre) autocommands
Bram Moolenaar <Bram@vim.org>
parents: 22958
diff changeset
1858 and |VimLeave| autocmds. See |:q|, |:x| and |:cquit|.
ad674a98058a patch 8.2.2070: can't get the exit value in VimLeave(Pre) autocommands
Bram Moolenaar <Bram@vim.org>
parents: 22958
diff changeset
1859 Example: >
ad674a98058a patch 8.2.2070: can't get the exit value in VimLeave(Pre) autocommands
Bram Moolenaar <Bram@vim.org>
parents: 22958
diff changeset
1860 :au VimLeave * echo "Exit value is " .. v:exiting
ad674a98058a patch 8.2.2070: can't get the exit value in VimLeave(Pre) autocommands
Bram Moolenaar <Bram@vim.org>
parents: 22958
diff changeset
1861 <
17833
8377ec7c5824 patch 8.1.1913: not easy to compute the space on the command line
Bram Moolenaar <Bram@vim.org>
parents: 17829
diff changeset
1862 *v:echospace* *echospace-variable*
8377ec7c5824 patch 8.1.1913: not easy to compute the space on the command line
Bram Moolenaar <Bram@vim.org>
parents: 17829
diff changeset
1863 v:echospace Number of screen cells that can be used for an `:echo` message
8377ec7c5824 patch 8.1.1913: not easy to compute the space on the command line
Bram Moolenaar <Bram@vim.org>
parents: 17829
diff changeset
1864 in the last screen line before causing the |hit-enter-prompt|.
8377ec7c5824 patch 8.1.1913: not easy to compute the space on the command line
Bram Moolenaar <Bram@vim.org>
parents: 17829
diff changeset
1865 Depends on 'showcmd', 'ruler' and 'columns'. You need to
8377ec7c5824 patch 8.1.1913: not easy to compute the space on the command line
Bram Moolenaar <Bram@vim.org>
parents: 17829
diff changeset
1866 check 'cmdheight' for whether there are full-width lines
8377ec7c5824 patch 8.1.1913: not easy to compute the space on the command line
Bram Moolenaar <Bram@vim.org>
parents: 17829
diff changeset
1867 available above the last line.
8377ec7c5824 patch 8.1.1913: not easy to compute the space on the command line
Bram Moolenaar <Bram@vim.org>
parents: 17829
diff changeset
1868
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1869 *v:errmsg* *errmsg-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1870 v:errmsg Last given error message. It's allowed to set this variable.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1871 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1872 :let v:errmsg = ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1873 :silent! next
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1874 :if v:errmsg != ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1875 : ... handle error
16366
6ee80f3b5ea9 patch 8.1.1188: not all Vim variables require the v: prefix
Bram Moolenaar <Bram@vim.org>
parents: 16271
diff changeset
1876 < "errmsg" also works, for backwards compatibility, unless
6ee80f3b5ea9 patch 8.1.1188: not all Vim variables require the v: prefix
Bram Moolenaar <Bram@vim.org>
parents: 16271
diff changeset
1877 |scriptversion| is 3 or higher.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1878
13796
87012d2b17b5 patch 8.0.1770: assert functions don't return anything
Christian Brabandt <cb@256bit.org>
parents: 13740
diff changeset
1879 *v:errors* *errors-variable* *assert-return*
7279
b5e9810b389d commit https://github.com/vim/vim/commit/683fa185a4b4ed7595e5942901548b8239ed5cdb
Christian Brabandt <cb@256bit.org>
parents: 7277
diff changeset
1880 v:errors Errors found by assert functions, such as |assert_true()|.
7277
6600871bb38c commit https://github.com/vim/vim/commit/43345546ae63710441f066648b8485fb545b3801
Christian Brabandt <cb@256bit.org>
parents: 7147
diff changeset
1881 This is a list of strings.
6600871bb38c commit https://github.com/vim/vim/commit/43345546ae63710441f066648b8485fb545b3801
Christian Brabandt <cb@256bit.org>
parents: 7147
diff changeset
1882 The assert functions append an item when an assert fails.
13796
87012d2b17b5 patch 8.0.1770: assert functions don't return anything
Christian Brabandt <cb@256bit.org>
parents: 13740
diff changeset
1883 The return value indicates this: a one is returned if an item
87012d2b17b5 patch 8.0.1770: assert functions don't return anything
Christian Brabandt <cb@256bit.org>
parents: 13740
diff changeset
1884 was added to v:errors, otherwise zero is returned.
7277
6600871bb38c commit https://github.com/vim/vim/commit/43345546ae63710441f066648b8485fb545b3801
Christian Brabandt <cb@256bit.org>
parents: 7147
diff changeset
1885 To remove old results make it empty: >
6600871bb38c commit https://github.com/vim/vim/commit/43345546ae63710441f066648b8485fb545b3801
Christian Brabandt <cb@256bit.org>
parents: 7147
diff changeset
1886 :let v:errors = []
6600871bb38c commit https://github.com/vim/vim/commit/43345546ae63710441f066648b8485fb545b3801
Christian Brabandt <cb@256bit.org>
parents: 7147
diff changeset
1887 < If v:errors is set to anything but a list it is made an empty
6600871bb38c commit https://github.com/vim/vim/commit/43345546ae63710441f066648b8485fb545b3801
Christian Brabandt <cb@256bit.org>
parents: 7147
diff changeset
1888 list by the assert function.
6600871bb38c commit https://github.com/vim/vim/commit/43345546ae63710441f066648b8485fb545b3801
Christian Brabandt <cb@256bit.org>
parents: 7147
diff changeset
1889
13037
6e81a68d63a1 patch 8.0.1394: cannot intercept a yank command
Christian Brabandt <cb@256bit.org>
parents: 13026
diff changeset
1890 *v:event* *event-variable*
6e81a68d63a1 patch 8.0.1394: cannot intercept a yank command
Christian Brabandt <cb@256bit.org>
parents: 13026
diff changeset
1891 v:event Dictionary containing information about the current
19303
51bc26d4a393 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19181
diff changeset
1892 |autocommand|. See the specific event for what it puts in
51bc26d4a393 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19181
diff changeset
1893 this dictionary.
20115
bd021eb62e73 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20037
diff changeset
1894 The dictionary is emptied when the |autocommand| finishes,
bd021eb62e73 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20037
diff changeset
1895 please refer to |dict-identity| for how to get an independent
bd021eb62e73 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20037
diff changeset
1896 copy of it. Use |deepcopy()| if you want to keep the
bd021eb62e73 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20037
diff changeset
1897 information after the event triggers. Example: >
bd021eb62e73 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20037
diff changeset
1898 au TextYankPost * let g:foo = deepcopy(v:event)
bd021eb62e73 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20037
diff changeset
1899 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1900 *v:exception* *exception-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1901 v:exception The value of the exception most recently caught and not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1902 finished. See also |v:throwpoint| and |throw-variables|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1903 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1904 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1905 : throw "oops"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1906 :catch /.*/
17571
2704c4e3e20a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17545
diff changeset
1907 : echo "caught " .. v:exception
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1908 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1909 < Output: "caught oops".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1910
7712
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
1911 *v:false* *false-variable*
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
1912 v:false A Number with value zero. Used to put "false" in JSON. See
8031
ece323e2b57f commit https://github.com/vim/vim/commit/6463ca229cb9412581419497924c85fcbfc854ab
Christian Brabandt <cb@256bit.org>
parents: 8019
diff changeset
1913 |json_encode()|.
9286
64035abb986b commit https://github.com/vim/vim/commit/c95a302a4c42ec8230473cd4a5e0064d0a143aa8
Christian Brabandt <cb@256bit.org>
parents: 9223
diff changeset
1914 When used as a string this evaluates to "v:false". >
7742
5f6f35a3cb12 commit https://github.com/vim/vim/commit/705ada1aff27ecd9c47c690df817d043c2ceb5e2
Christian Brabandt <cb@256bit.org>
parents: 7712
diff changeset
1915 echo v:false
9286
64035abb986b commit https://github.com/vim/vim/commit/c95a302a4c42ec8230473cd4a5e0064d0a143aa8
Christian Brabandt <cb@256bit.org>
parents: 9223
diff changeset
1916 < v:false ~
64035abb986b commit https://github.com/vim/vim/commit/c95a302a4c42ec8230473cd4a5e0064d0a143aa8
Christian Brabandt <cb@256bit.org>
parents: 9223
diff changeset
1917 That is so that eval() can parse the string back to the same
9626
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
1918 value. Read-only.
7712
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
1919
179
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1920 *v:fcs_reason* *fcs_reason-variable*
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1921 v:fcs_reason The reason why the |FileChangedShell| event was triggered.
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1922 Can be used in an autocommand to decide what to do and/or what
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1923 to set v:fcs_choice to. Possible values:
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1924 deleted file no longer exists
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1925 conflict file contents, mode or timestamp was
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1926 changed and buffer is modified
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1927 changed file contents has changed
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1928 mode mode of file changed
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1929 time only file timestamp changed
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1930
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1931 *v:fcs_choice* *fcs_choice-variable*
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1932 v:fcs_choice What should happen after a |FileChangedShell| event was
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1933 triggered. Can be used in an autocommand to tell Vim what to
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1934 do with the affected buffer:
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1935 reload Reload the buffer (does not work if
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1936 the file was deleted).
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1937 ask Ask the user what to do, as if there
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1938 was no autocommand. Except that when
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1939 only the timestamp changed nothing
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1940 will happen.
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1941 <empty> Nothing, the autocommand should do
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1942 everything that needs to be done.
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1943 The default is empty. If another (invalid) value is used then
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1944 Vim behaves like it is empty, there is no warning message.
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 170
diff changeset
1945
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1946 *v:fname_in* *fname_in-variable*
579
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
1947 v:fname_in The name of the input file. Valid while evaluating:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1948 option used for ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1949 'charconvert' file to be converted
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1950 'diffexpr' original file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1951 'patchexpr' original file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1952 'printexpr' file to be printed
593
d220eb88e4e4 updated for version 7.0168
vimboss
parents: 590
diff changeset
1953 And set to the swap file name for |SwapExists|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1954
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1955 *v:fname_out* *fname_out-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1956 v:fname_out The name of the output file. Only valid while
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1957 evaluating:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1958 option used for ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1959 'charconvert' resulting converted file (*)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1960 'diffexpr' output of diff
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1961 'patchexpr' resulting patched file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1962 (*) When doing conversion for a write command (e.g., ":w
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
1963 file") it will be equal to v:fname_in. When doing conversion
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1964 for a read command (e.g., ":e file") it will be a temporary
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1965 file and different from v:fname_in.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1966
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1967 *v:fname_new* *fname_new-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1968 v:fname_new The name of the new version of the file. Only valid while
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1969 evaluating 'diffexpr'.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1970
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1971 *v:fname_diff* *fname_diff-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1972 v:fname_diff The name of the diff (patch) file. Only valid while
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1973 evaluating 'patchexpr'.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1974
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1975 *v:folddashes* *folddashes-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1976 v:folddashes Used for 'foldtext': dashes representing foldlevel of a closed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1977 fold.
29
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
1978 Read-only in the |sandbox|. |fold-foldtext|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1979
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1980 *v:foldlevel* *foldlevel-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1981 v:foldlevel Used for 'foldtext': foldlevel of closed fold.
29
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
1982 Read-only in the |sandbox|. |fold-foldtext|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1983
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1984 *v:foldend* *foldend-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1985 v:foldend Used for 'foldtext': last line of closed fold.
29
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
1986 Read-only in the |sandbox|. |fold-foldtext|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1987
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1988 *v:foldstart* *foldstart-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1989 v:foldstart Used for 'foldtext': first line of closed fold.
29
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
1990 Read-only in the |sandbox|. |fold-foldtext|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1991
5460
c5166fa10464 updated for version 7.4.080
Bram Moolenaar <bram@vim.org>
parents: 5425
diff changeset
1992 *v:hlsearch* *hlsearch-variable*
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
1993 v:hlsearch Variable that indicates whether search highlighting is on.
6413
01c668384bcc updated for version 7.4.537
Bram Moolenaar <bram@vim.org>
parents: 6385
diff changeset
1994 Setting it makes sense only if 'hlsearch' is enabled which
01c668384bcc updated for version 7.4.537
Bram Moolenaar <bram@vim.org>
parents: 6385
diff changeset
1995 requires |+extra_search|. Setting this variable to zero acts
7742
5f6f35a3cb12 commit https://github.com/vim/vim/commit/705ada1aff27ecd9c47c690df817d043c2ceb5e2
Christian Brabandt <cb@256bit.org>
parents: 7712
diff changeset
1996 like the |:nohlsearch| command, setting it to one acts like >
5460
c5166fa10464 updated for version 7.4.080
Bram Moolenaar <bram@vim.org>
parents: 5425
diff changeset
1997 let &hlsearch = &hlsearch
6918
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
1998 < Note that the value is restored when returning from a
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
1999 function. |function-search-undo|.
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
2000
11
4424b47a0797 updated for version 7.0003
vimboss
parents: 10
diff changeset
2001 *v:insertmode* *insertmode-variable*
4424b47a0797 updated for version 7.0003
vimboss
parents: 10
diff changeset
2002 v:insertmode Used for the |InsertEnter| and |InsertChange| autocommand
4424b47a0797 updated for version 7.0003
vimboss
parents: 10
diff changeset
2003 events. Values:
4424b47a0797 updated for version 7.0003
vimboss
parents: 10
diff changeset
2004 i Insert mode
4424b47a0797 updated for version 7.0003
vimboss
parents: 10
diff changeset
2005 r Replace mode
4424b47a0797 updated for version 7.0003
vimboss
parents: 10
diff changeset
2006 v Virtual Replace mode
4424b47a0797 updated for version 7.0003
vimboss
parents: 10
diff changeset
2007
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
2008 *v:key* *key-variable*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
2009 v:key Key of the current item of a |Dictionary|. Only valid while
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
2010 evaluating the expression used with |map()| and |filter()|.
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
2011 Read-only.
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
2012
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2013 *v:lang* *lang-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2014 v:lang The current locale setting for messages of the runtime
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2015 environment. This allows Vim scripts to be aware of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2016 current language. Technical: it's the value of LC_MESSAGES.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2017 The value is system dependent.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2018 This variable can not be set directly, use the |:language|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2019 command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2020 It can be different from |v:ctype| when messages are desired
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2021 in a different language than what is used for character
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2022 encoding. See |multi-lang|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2023
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2024 *v:lc_time* *lc_time-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2025 v:lc_time The current locale setting for time messages of the runtime
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2026 environment. This allows Vim scripts to be aware of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2027 current language. Technical: it's the value of LC_TIME.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2028 This variable can not be set directly, use the |:language|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2029 command. See |multi-lang|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2030
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2031 *v:lnum* *lnum-variable*
2350
06feaf4fe36a Rename some "python3" symbols to "py3", as the command name.
Bram Moolenaar <bram@vim.org>
parents: 2345
diff changeset
2032 v:lnum Line number for the 'foldexpr' |fold-expr|, 'formatexpr' and
06feaf4fe36a Rename some "python3" symbols to "py3", as the command name.
Bram Moolenaar <bram@vim.org>
parents: 2345
diff changeset
2033 'indentexpr' expressions, tab page number for 'guitablabel'
06feaf4fe36a Rename some "python3" symbols to "py3", as the command name.
Bram Moolenaar <bram@vim.org>
parents: 2345
diff changeset
2034 and 'guitabtooltip'. Only valid while one of these
06feaf4fe36a Rename some "python3" symbols to "py3", as the command name.
Bram Moolenaar <bram@vim.org>
parents: 2345
diff changeset
2035 expressions is being evaluated. Read-only when in the
06feaf4fe36a Rename some "python3" symbols to "py3", as the command name.
Bram Moolenaar <bram@vim.org>
parents: 2345
diff changeset
2036 |sandbox|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2037
1029
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
2038 *v:mouse_win* *mouse_win-variable*
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
2039 v:mouse_win Window number for a mouse click obtained with |getchar()|.
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
2040 First window has number 1, like with |winnr()|. The value is
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
2041 zero when there was no mouse button click.
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
2042
9221
17fa362f10be commit https://github.com/vim/vim/commit/511972d810ea490955161ff5097ec2f57919ceaf
Christian Brabandt <cb@256bit.org>
parents: 9219
diff changeset
2043 *v:mouse_winid* *mouse_winid-variable*
17fa362f10be commit https://github.com/vim/vim/commit/511972d810ea490955161ff5097ec2f57919ceaf
Christian Brabandt <cb@256bit.org>
parents: 9219
diff changeset
2044 v:mouse_winid Window ID for a mouse click obtained with |getchar()|.
17fa362f10be commit https://github.com/vim/vim/commit/511972d810ea490955161ff5097ec2f57919ceaf
Christian Brabandt <cb@256bit.org>
parents: 9219
diff changeset
2045 The value is zero when there was no mouse button click.
17fa362f10be commit https://github.com/vim/vim/commit/511972d810ea490955161ff5097ec2f57919ceaf
Christian Brabandt <cb@256bit.org>
parents: 9219
diff changeset
2046
1029
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
2047 *v:mouse_lnum* *mouse_lnum-variable*
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
2048 v:mouse_lnum Line number for a mouse click obtained with |getchar()|.
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
2049 This is the text line number, not the screen line number. The
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
2050 value is zero when there was no mouse button click.
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
2051
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
2052 *v:mouse_col* *mouse_col-variable*
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
2053 v:mouse_col Column number for a mouse click obtained with |getchar()|.
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
2054 This is the screen column number, like with |virtcol()|. The
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
2055 value is zero when there was no mouse button click.
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
2056
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
2057 *v:none* *none-variable* *None*
7712
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
2058 v:none An empty String. Used to put an empty item in JSON. See
8031
ece323e2b57f commit https://github.com/vim/vim/commit/6463ca229cb9412581419497924c85fcbfc854ab
Christian Brabandt <cb@256bit.org>
parents: 8019
diff changeset
2059 |json_encode()|.
21499
3a1ed539ae2a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21409
diff changeset
2060 This can also be used as a function argument to use the
3a1ed539ae2a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21409
diff changeset
2061 default value, see |none-function_argument|.
7742
5f6f35a3cb12 commit https://github.com/vim/vim/commit/705ada1aff27ecd9c47c690df817d043c2ceb5e2
Christian Brabandt <cb@256bit.org>
parents: 7712
diff changeset
2062 When used as a number this evaluates to zero.
9286
64035abb986b commit https://github.com/vim/vim/commit/c95a302a4c42ec8230473cd4a5e0064d0a143aa8
Christian Brabandt <cb@256bit.org>
parents: 9223
diff changeset
2063 When used as a string this evaluates to "v:none". >
7742
5f6f35a3cb12 commit https://github.com/vim/vim/commit/705ada1aff27ecd9c47c690df817d043c2ceb5e2
Christian Brabandt <cb@256bit.org>
parents: 7712
diff changeset
2064 echo v:none
9286
64035abb986b commit https://github.com/vim/vim/commit/c95a302a4c42ec8230473cd4a5e0064d0a143aa8
Christian Brabandt <cb@256bit.org>
parents: 9223
diff changeset
2065 < v:none ~
64035abb986b commit https://github.com/vim/vim/commit/c95a302a4c42ec8230473cd4a5e0064d0a143aa8
Christian Brabandt <cb@256bit.org>
parents: 9223
diff changeset
2066 That is so that eval() can parse the string back to the same
9626
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
2067 value. Read-only.
7712
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
2068
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
2069 *v:null* *null-variable*
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
2070 v:null An empty String. Used to put "null" in JSON. See
8031
ece323e2b57f commit https://github.com/vim/vim/commit/6463ca229cb9412581419497924c85fcbfc854ab
Christian Brabandt <cb@256bit.org>
parents: 8019
diff changeset
2071 |json_encode()|.
7742
5f6f35a3cb12 commit https://github.com/vim/vim/commit/705ada1aff27ecd9c47c690df817d043c2ceb5e2
Christian Brabandt <cb@256bit.org>
parents: 7712
diff changeset
2072 When used as a number this evaluates to zero.
9286
64035abb986b commit https://github.com/vim/vim/commit/c95a302a4c42ec8230473cd4a5e0064d0a143aa8
Christian Brabandt <cb@256bit.org>
parents: 9223
diff changeset
2073 When used as a string this evaluates to "v:null". >
7742
5f6f35a3cb12 commit https://github.com/vim/vim/commit/705ada1aff27ecd9c47c690df817d043c2ceb5e2
Christian Brabandt <cb@256bit.org>
parents: 7712
diff changeset
2074 echo v:null
9286
64035abb986b commit https://github.com/vim/vim/commit/c95a302a4c42ec8230473cd4a5e0064d0a143aa8
Christian Brabandt <cb@256bit.org>
parents: 9223
diff changeset
2075 < v:null ~
64035abb986b commit https://github.com/vim/vim/commit/c95a302a4c42ec8230473cd4a5e0064d0a143aa8
Christian Brabandt <cb@256bit.org>
parents: 9223
diff changeset
2076 That is so that eval() can parse the string back to the same
9626
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
2077 value. Read-only.
7712
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
2078
19477
2bb0e80fcd32 patch 8.2.0296: mixing up "long long" and __int64 may cause problems
Bram Moolenaar <Bram@vim.org>
parents: 19400
diff changeset
2079 *v:numbersize* *numbersize-variable*
2bb0e80fcd32 patch 8.2.0296: mixing up "long long" and __int64 may cause problems
Bram Moolenaar <Bram@vim.org>
parents: 19400
diff changeset
2080 v:numbersize Number of bits in a Number. This is normally 64, but on some
19523
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
2081 systems it may be 32.
19477
2bb0e80fcd32 patch 8.2.0296: mixing up "long long" and __int64 may cause problems
Bram Moolenaar <Bram@vim.org>
parents: 19400
diff changeset
2082
1733
5a7384b9ca66 updated for version 7.2-031
vimboss
parents: 1702
diff changeset
2083 *v:oldfiles* *oldfiles-variable*
5a7384b9ca66 updated for version 7.2-031
vimboss
parents: 1702
diff changeset
2084 v:oldfiles List of file names that is loaded from the |viminfo| file on
5a7384b9ca66 updated for version 7.2-031
vimboss
parents: 1702
diff changeset
2085 startup. These are the files that Vim remembers marks for.
5a7384b9ca66 updated for version 7.2-031
vimboss
parents: 1702
diff changeset
2086 The length of the List is limited by the ' argument of the
5a7384b9ca66 updated for version 7.2-031
vimboss
parents: 1702
diff changeset
2087 'viminfo' option (default is 100).
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5596
diff changeset
2088 When the |viminfo| file is not used the List is empty.
1733
5a7384b9ca66 updated for version 7.2-031
vimboss
parents: 1702
diff changeset
2089 Also see |:oldfiles| and |c_#<|.
5a7384b9ca66 updated for version 7.2-031
vimboss
parents: 1702
diff changeset
2090 The List can be modified, but this has no effect on what is
5a7384b9ca66 updated for version 7.2-031
vimboss
parents: 1702
diff changeset
2091 stored in the |viminfo| file later. If you use values other
5a7384b9ca66 updated for version 7.2-031
vimboss
parents: 1702
diff changeset
2092 than String this will cause trouble.
2570
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2569
diff changeset
2093 {only when compiled with the |+viminfo| feature}
1733
5a7384b9ca66 updated for version 7.2-031
vimboss
parents: 1702
diff changeset
2094
6935
4db70c94226b patch 7.4.786
Bram Moolenaar <bram@vim.org>
parents: 6918
diff changeset
2095 *v:option_new*
4db70c94226b patch 7.4.786
Bram Moolenaar <bram@vim.org>
parents: 6918
diff changeset
2096 v:option_new New value of the option. Valid while executing an |OptionSet|
4db70c94226b patch 7.4.786
Bram Moolenaar <bram@vim.org>
parents: 6918
diff changeset
2097 autocommand.
4db70c94226b patch 7.4.786
Bram Moolenaar <bram@vim.org>
parents: 6918
diff changeset
2098 *v:option_old*
4db70c94226b patch 7.4.786
Bram Moolenaar <bram@vim.org>
parents: 6918
diff changeset
2099 v:option_old Old value of the option. Valid while executing an |OptionSet|
17085
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2100 autocommand. Depending on the command used for setting and the
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2101 kind of option this is either the local old value or the
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2102 global old value.
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2103 *v:option_oldlocal*
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2104 v:option_oldlocal
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2105 Old local value of the option. Valid while executing an
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2106 |OptionSet| autocommand.
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2107 *v:option_oldglobal*
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2108 v:option_oldglobal
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2109 Old global value of the option. Valid while executing an
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2110 |OptionSet| autocommand.
6935
4db70c94226b patch 7.4.786
Bram Moolenaar <bram@vim.org>
parents: 6918
diff changeset
2111 *v:option_type*
4db70c94226b patch 7.4.786
Bram Moolenaar <bram@vim.org>
parents: 6918
diff changeset
2112 v:option_type Scope of the set command. Valid while executing an
4db70c94226b patch 7.4.786
Bram Moolenaar <bram@vim.org>
parents: 6918
diff changeset
2113 |OptionSet| autocommand. Can be either "global" or "local"
17085
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2114 *v:option_command*
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2115 v:option_command
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2116 Command used to set the option. Valid while executing an
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2117 |OptionSet| autocommand.
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2118 value option was set via ~
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2119 "setlocal" |:setlocal| or ":let l:xxx"
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2120 "setglobal" |:setglobal| or ":let g:xxx"
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2121 "set" |:set| or |:let|
620e9011b685 patch 8.1.1542: an OptionSet autocommand does not get enough info
Bram Moolenaar <Bram@vim.org>
parents: 17079
diff changeset
2122 "modeline" |modeline|
1490
0f3f3090491f updated for version 7.1-205
vimboss
parents: 1405
diff changeset
2123 *v:operator* *operator-variable*
0f3f3090491f updated for version 7.1-205
vimboss
parents: 1405
diff changeset
2124 v:operator The last operator given in Normal mode. This is a single
0f3f3090491f updated for version 7.1-205
vimboss
parents: 1405
diff changeset
2125 character except for commands starting with <g> or <z>,
0f3f3090491f updated for version 7.1-205
vimboss
parents: 1405
diff changeset
2126 in which case it is two characters. Best used alongside
0f3f3090491f updated for version 7.1-205
vimboss
parents: 1405
diff changeset
2127 |v:prevcount| and |v:register|. Useful if you want to cancel
0f3f3090491f updated for version 7.1-205
vimboss
parents: 1405
diff changeset
2128 Operator-pending mode and then use the operator, e.g.: >
0f3f3090491f updated for version 7.1-205
vimboss
parents: 1405
diff changeset
2129 :omap O <Esc>:call MyMotion(v:operator)<CR>
0f3f3090491f updated for version 7.1-205
vimboss
parents: 1405
diff changeset
2130 < The value remains set until another operator is entered, thus
0f3f3090491f updated for version 7.1-205
vimboss
parents: 1405
diff changeset
2131 don't expect it to be empty.
0f3f3090491f updated for version 7.1-205
vimboss
parents: 1405
diff changeset
2132 v:operator is not set for |:delete|, |:yank| or other Ex
0f3f3090491f updated for version 7.1-205
vimboss
parents: 1405
diff changeset
2133 commands.
0f3f3090491f updated for version 7.1-205
vimboss
parents: 1405
diff changeset
2134 Read-only.
0f3f3090491f updated for version 7.1-205
vimboss
parents: 1405
diff changeset
2135
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2136 *v:prevcount* *prevcount-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2137 v:prevcount The count given for the last but one Normal mode command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2138 This is the v:count value of the previous command. Useful if
1490
0f3f3090491f updated for version 7.1-205
vimboss
parents: 1405
diff changeset
2139 you want to cancel Visual or Operator-pending mode and then
0f3f3090491f updated for version 7.1-205
vimboss
parents: 1405
diff changeset
2140 use the count, e.g.: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2141 :vmap % <Esc>:call MyFilter(v:prevcount)<CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2142 < Read-only.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2143
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
2144 *v:profiling* *profiling-variable*
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
2145 v:profiling Normally zero. Set to one after using ":profile start".
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
2146 See |profiling|.
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
2147
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2148 *v:progname* *progname-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2149 v:progname Contains the name (with path removed) with which Vim was
3492
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
2150 invoked. Allows you to do special initialisations for |view|,
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
2151 |evim| etc., or any other name you might symlink to Vim.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2152 Read-only.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2153
5780
d2286df8719d updated for version 7.4.234
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
2154 *v:progpath* *progpath-variable*
17758
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
2155 v:progpath Contains the command with which Vim was invoked, in a form
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
2156 that when passed to the shell will run the same Vim executable
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
2157 as the current one (if $PATH remains unchanged).
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
2158 Useful if you want to message a Vim server using a
5780
d2286df8719d updated for version 7.4.234
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
2159 |--remote-expr|.
5782
5ab2946f7ce5 updated for version 7.4.235
Bram Moolenaar <bram@vim.org>
parents: 5780
diff changeset
2160 To get the full path use: >
5ab2946f7ce5 updated for version 7.4.235
Bram Moolenaar <bram@vim.org>
parents: 5780
diff changeset
2161 echo exepath(v:progpath)
17758
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
2162 < If the command has a relative path it will be expanded to the
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
2163 full path, so that it still works after `:cd`. Thus starting
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
2164 "./vim" results in "/home/user/path/to/vim/src/vim".
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
2165 On Linux and other systems it will always be the full path.
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
2166 On Mac it may just be "vim" and using exepath() as mentioned
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
2167 above should be used to get the full path.
11032
516391d8865f patch 8.0.0405: v:progpath may become invalid after :cd
Christian Brabandt <cb@256bit.org>
parents: 11014
diff changeset
2168 On MS-Windows the executable may be called "vim.exe", but the
516391d8865f patch 8.0.0405: v:progpath may become invalid after :cd
Christian Brabandt <cb@256bit.org>
parents: 11014
diff changeset
2169 ".exe" is not added to v:progpath.
5780
d2286df8719d updated for version 7.4.234
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
2170 Read-only.
d2286df8719d updated for version 7.4.234
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
2171
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2172 *v:register* *register-variable*
2698
b6471224d2af Updated runtime files and translations.
Bram Moolenaar <bram@vim.org>
parents: 2681
diff changeset
2173 v:register The name of the register in effect for the current normal mode
3492
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
2174 command (regardless of whether that command actually used a
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
2175 register). Or for the currently executing normal mode mapping
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
2176 (use this in custom commands that take a register).
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
2177 If none is supplied it is the default register '"', unless
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
2178 'clipboard' contains "unnamed" or "unnamedplus", then it is
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
2179 '*' or '+'.
2698
b6471224d2af Updated runtime files and translations.
Bram Moolenaar <bram@vim.org>
parents: 2681
diff changeset
2180 Also see |getreg()| and |setreg()|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2181
540
2df7f3a5eb96 updated for version 7.0153
vimboss
parents: 537
diff changeset
2182 *v:scrollstart* *scrollstart-variable*
2df7f3a5eb96 updated for version 7.0153
vimboss
parents: 537
diff changeset
2183 v:scrollstart String describing the script or function that caused the
2df7f3a5eb96 updated for version 7.0153
vimboss
parents: 537
diff changeset
2184 screen to scroll up. It's only set when it is empty, thus the
2df7f3a5eb96 updated for version 7.0153
vimboss
parents: 537
diff changeset
2185 first reason is remembered. It is set to "Unknown" for a
2df7f3a5eb96 updated for version 7.0153
vimboss
parents: 537
diff changeset
2186 typed command.
2df7f3a5eb96 updated for version 7.0153
vimboss
parents: 537
diff changeset
2187 This can be used to find out why your script causes the
2df7f3a5eb96 updated for version 7.0153
vimboss
parents: 537
diff changeset
2188 hit-enter prompt.
2df7f3a5eb96 updated for version 7.0153
vimboss
parents: 537
diff changeset
2189
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2190 *v:servername* *servername-variable*
11904
40322e8f07e7 patch 8.0.0832: terminal function arguments are not consistent
Christian Brabandt <cb@256bit.org>
parents: 11882
diff changeset
2191 v:servername The resulting registered |client-server-name| if any.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2192 Read-only.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2193
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2194
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
2195 v:searchforward *v:searchforward* *searchforward-variable*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
2196 Search direction: 1 after a forward search, 0 after a
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
2197 backward search. It is reset to forward when directly setting
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
2198 the last search pattern, see |quote/|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
2199 Note that the value is restored when returning from a
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
2200 function. |function-search-undo|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
2201 Read-write.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
2202
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2203 *v:shell_error* *shell_error-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2204 v:shell_error Result of the last shell command. When non-zero, the last
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2205 shell command had an error. When zero, there was no problem.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2206 This only works when the shell returns the error code to Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2207 The value -1 is often used when the command could not be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2208 executed. Read-only.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2209 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2210 :!mv foo bar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2211 :if v:shell_error
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2212 : echo 'could not rename "foo" to "bar"!'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2213 :endif
16366
6ee80f3b5ea9 patch 8.1.1188: not all Vim variables require the v: prefix
Bram Moolenaar <Bram@vim.org>
parents: 16271
diff changeset
2214 < "shell_error" also works, for backwards compatibility, unless
6ee80f3b5ea9 patch 8.1.1188: not all Vim variables require the v: prefix
Bram Moolenaar <Bram@vim.org>
parents: 16271
diff changeset
2215 |scriptversion| is 3 or higher.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2216
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2217 *v:statusmsg* *statusmsg-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2218 v:statusmsg Last given status message. It's allowed to set this variable.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2219
579
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2220 *v:swapname* *swapname-variable*
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2221 v:swapname Only valid when executing |SwapExists| autocommands: Name of
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2222 the swap file found. Read-only.
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2223
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2224 *v:swapchoice* *swapchoice-variable*
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2225 v:swapchoice |SwapExists| autocommands can set this to the selected choice
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2226 for handling an existing swap file:
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2227 'o' Open read-only
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2228 'e' Edit anyway
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2229 'r' Recover
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2230 'd' Delete swapfile
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2231 'q' Quit
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2232 'a' Abort
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
2233 The value should be a single-character string. An empty value
579
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2234 results in the user being asked, as would happen when there is
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2235 no SwapExists autocommand. The default is empty.
1ef373b13126 updated for version 7.0164
vimboss
parents: 574
diff changeset
2236
590
de152391f6f9 updated for version 7.0167
vimboss
parents: 579
diff changeset
2237 *v:swapcommand* *swapcommand-variable*
625
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 620
diff changeset
2238 v:swapcommand Normal mode command to be executed after a file has been
590
de152391f6f9 updated for version 7.0167
vimboss
parents: 579
diff changeset
2239 opened. Can be used for a |SwapExists| autocommand to have
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
2240 another Vim open the file and jump to the right place. For
590
de152391f6f9 updated for version 7.0167
vimboss
parents: 579
diff changeset
2241 example, when jumping to a tag the value is ":tag tagname\r".
716
8ae24f338cab updated for version 7.0217
vimboss
parents: 714
diff changeset
2242 For ":edit +cmd file" the value is ":cmd\r".
590
de152391f6f9 updated for version 7.0167
vimboss
parents: 579
diff changeset
2243
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
2244 *v:t_TYPE* *v:t_bool* *t_bool-variable*
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
2245 v:t_bool Value of |Boolean| type. Read-only. See: |type()|
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
2246 *v:t_channel* *t_channel-variable*
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
2247 v:t_channel Value of |Channel| type. Read-only. See: |type()|
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
2248 *v:t_dict* *t_dict-variable*
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
2249 v:t_dict Value of |Dictionary| type. Read-only. See: |type()|
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
2250 *v:t_float* *t_float-variable*
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
2251 v:t_float Value of |Float| type. Read-only. See: |type()|
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
2252 *v:t_func* *t_func-variable*
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
2253 v:t_func Value of |Funcref| type. Read-only. See: |type()|
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
2254 *v:t_job* *t_job-variable*
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
2255 v:t_job Value of |Job| type. Read-only. See: |type()|
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
2256 *v:t_list* *t_list-variable*
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
2257 v:t_list Value of |List| type. Read-only. See: |type()|
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
2258 *v:t_none* *t_none-variable*
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
2259 v:t_none Value of |None| type. Read-only. See: |type()|
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
2260 *v:t_number* *t_number-variable*
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
2261 v:t_number Value of |Number| type. Read-only. See: |type()|
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
2262 *v:t_string* *t_string-variable*
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
2263 v:t_string Value of |String| type. Read-only. See: |type()|
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
2264 *v:t_blob* *t_blob-variable*
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
2265 v:t_blob Value of |Blob| type. Read-only. See: |type()|
9587
05a56bbe34a1 commit https://github.com/vim/vim/commit/f562e72df726c6191fa305e1c0a113f1cfb87f76
Christian Brabandt <cb@256bit.org>
parents: 9555
diff changeset
2266
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2267 *v:termresponse* *termresponse-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2268 v:termresponse The escape sequence returned by the terminal for the |t_RV|
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
2269 termcap entry. It is set when Vim receives an escape sequence
16849
629f3d3b6886 patch 8.1.1426: no test for syntax highlight in popup window
Bram Moolenaar <Bram@vim.org>
parents: 16833
diff changeset
2270 that starts with ESC [ or CSI, then '>' or '?' and ends in a
629f3d3b6886 patch 8.1.1426: no test for syntax highlight in popup window
Bram Moolenaar <Bram@vim.org>
parents: 16833
diff changeset
2271 'c', with only digits and ';' in between.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2272 When this option is set, the TermResponse autocommand event is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2273 fired, so that you can react to the response from the
20836
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
2274 terminal. You can use |terminalprops()| to see what Vim
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
2275 figured out about the terminal.
16849
629f3d3b6886 patch 8.1.1426: no test for syntax highlight in popup window
Bram Moolenaar <Bram@vim.org>
parents: 16833
diff changeset
2276 The response from a new xterm is: "<Esc>[> Pp ; Pv ; Pc c". Pp
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2277 is the terminal type: 0 for vt100 and 1 for vt220. Pv is the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2278 patch level (since this was introduced in patch 95, it's
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2279 always 95 or bigger). Pc is always zero.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2280 {only when compiled with |+termresponse| feature}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2281
12273
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2282 *v:termblinkresp*
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2283 v:termblinkresp The escape sequence returned by the terminal for the |t_RC|
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2284 termcap entry. This is used to find out whether the terminal
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2285 cursor is blinking. This is used by |term_getcursor()|.
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2286
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2287 *v:termstyleresp*
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2288 v:termstyleresp The escape sequence returned by the terminal for the |t_RS|
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2289 termcap entry. This is used to find out what the shape of the
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2290 cursor is. This is used by |term_getcursor()|.
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2291
12632
b1a7e3968a31 patch 8.0.1194: actual fg and bg colors of terminal are unknown
Christian Brabandt <cb@256bit.org>
parents: 12499
diff changeset
2292 *v:termrbgresp*
b1a7e3968a31 patch 8.0.1194: actual fg and bg colors of terminal are unknown
Christian Brabandt <cb@256bit.org>
parents: 12499
diff changeset
2293 v:termrbgresp The escape sequence returned by the terminal for the |t_RB|
12273
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2294 termcap entry. This is used to find out what the terminal
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2295 background color is, see 'background'.
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2296
12632
b1a7e3968a31 patch 8.0.1194: actual fg and bg colors of terminal are unknown
Christian Brabandt <cb@256bit.org>
parents: 12499
diff changeset
2297 *v:termrfgresp*
b1a7e3968a31 patch 8.0.1194: actual fg and bg colors of terminal are unknown
Christian Brabandt <cb@256bit.org>
parents: 12499
diff changeset
2298 v:termrfgresp The escape sequence returned by the terminal for the |t_RF|
b1a7e3968a31 patch 8.0.1194: actual fg and bg colors of terminal are unknown
Christian Brabandt <cb@256bit.org>
parents: 12499
diff changeset
2299 termcap entry. This is used to find out what the terminal
b1a7e3968a31 patch 8.0.1194: actual fg and bg colors of terminal are unknown
Christian Brabandt <cb@256bit.org>
parents: 12499
diff changeset
2300 foreground color is.
b1a7e3968a31 patch 8.0.1194: actual fg and bg colors of terminal are unknown
Christian Brabandt <cb@256bit.org>
parents: 12499
diff changeset
2301
12273
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2302 *v:termu7resp*
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2303 v:termu7resp The escape sequence returned by the terminal for the |t_u7|
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2304 termcap entry. This is used to find out what the terminal
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2305 does with ambiguous width characters, see 'ambiwidth'.
c952a6af25e0 patch 8.0.1016: gnome terminal echoes t_RC
Christian Brabandt <cb@256bit.org>
parents: 12254
diff changeset
2306
8881
ed0b39dd7fd6 commit https://github.com/vim/vim/commit/ebf7dfa6f121c82f97d2adca3d45fbaba9ad8f7e
Christian Brabandt <cb@256bit.org>
parents: 8876
diff changeset
2307 *v:testing* *testing-variable*
9121
7350959e53c3 commit https://github.com/vim/vim/commit/8e8df251bf2505e5decf258397c6069fbe5e2e01
Christian Brabandt <cb@256bit.org>
parents: 9117
diff changeset
2308 v:testing Must be set before using `test_garbagecollect_now()`.
11160
d0a20101ecb2 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11105
diff changeset
2309 Also, when set certain error messages won't be shown for 2
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2310 seconds. (e.g. "'dictionary' option is empty")
8881
ed0b39dd7fd6 commit https://github.com/vim/vim/commit/ebf7dfa6f121c82f97d2adca3d45fbaba9ad8f7e
Christian Brabandt <cb@256bit.org>
parents: 8876
diff changeset
2311
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2312 *v:this_session* *this_session-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2313 v:this_session Full filename of the last loaded or saved session file. See
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2314 |:mksession|. It is allowed to set this variable. When no
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2315 session file has been saved, this variable is empty.
16366
6ee80f3b5ea9 patch 8.1.1188: not all Vim variables require the v: prefix
Bram Moolenaar <Bram@vim.org>
parents: 16271
diff changeset
2316 "this_session" also works, for backwards compatibility, unless
6ee80f3b5ea9 patch 8.1.1188: not all Vim variables require the v: prefix
Bram Moolenaar <Bram@vim.org>
parents: 16271
diff changeset
2317 |scriptversion| is 3 or higher
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2318
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2319 *v:throwpoint* *throwpoint-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2320 v:throwpoint The point where the exception most recently caught and not
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
2321 finished was thrown. Not set when commands are typed. See
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2322 also |v:exception| and |throw-variables|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2323 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2324 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2325 : throw "oops"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2326 :catch /.*/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2327 : echo "Exception from" v:throwpoint
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2328 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2329 < Output: "Exception from test.vim, line 2"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2330
7712
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
2331 *v:true* *true-variable*
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
2332 v:true A Number with value one. Used to put "true" in JSON. See
8031
ece323e2b57f commit https://github.com/vim/vim/commit/6463ca229cb9412581419497924c85fcbfc854ab
Christian Brabandt <cb@256bit.org>
parents: 8019
diff changeset
2333 |json_encode()|.
9286
64035abb986b commit https://github.com/vim/vim/commit/c95a302a4c42ec8230473cd4a5e0064d0a143aa8
Christian Brabandt <cb@256bit.org>
parents: 9223
diff changeset
2334 When used as a string this evaluates to "v:true". >
7742
5f6f35a3cb12 commit https://github.com/vim/vim/commit/705ada1aff27ecd9c47c690df817d043c2ceb5e2
Christian Brabandt <cb@256bit.org>
parents: 7712
diff changeset
2335 echo v:true
9286
64035abb986b commit https://github.com/vim/vim/commit/c95a302a4c42ec8230473cd4a5e0064d0a143aa8
Christian Brabandt <cb@256bit.org>
parents: 9223
diff changeset
2336 < v:true ~
64035abb986b commit https://github.com/vim/vim/commit/c95a302a4c42ec8230473cd4a5e0064d0a143aa8
Christian Brabandt <cb@256bit.org>
parents: 9223
diff changeset
2337 That is so that eval() can parse the string back to the same
9626
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
2338 value. Read-only.
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
2339 *v:val* *val-variable*
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
2340 v:val Value of the current item of a |List| or |Dictionary|. Only
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
2341 valid while evaluating the expression used with |map()| and
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
2342 |filter()|. Read-only.
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
2343
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2344 *v:version* *version-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2345 v:version Version number of Vim: Major version number times 100 plus
17131
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
2346 minor version number. Version 5.0 is 500. Version 5.1
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2347 is 501. Read-only. "version" also works, for backwards
16366
6ee80f3b5ea9 patch 8.1.1188: not all Vim variables require the v: prefix
Bram Moolenaar <Bram@vim.org>
parents: 16271
diff changeset
2348 compatibility, unless |scriptversion| is 3 or higher.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2349 Use |has()| to check if a certain patch was included, e.g.: >
5786
71b165a378ad updated for version 7.4.237
Bram Moolenaar <bram@vim.org>
parents: 5782
diff changeset
2350 if has("patch-7.4.123")
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2351 < Note that patch numbers are specific to the version, thus both
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2352 version 5.0 and 5.1 may have a patch 123, but these are
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2353 completely different.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2354
17053
d5fa04016df0 patch 8.1.1526: no numerical value for the patchlevel
Bram Moolenaar <Bram@vim.org>
parents: 17036
diff changeset
2355 *v:versionlong* *versionlong-variable*
17131
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
2356 v:versionlong Like v:version, but also including the patchlevel in the last
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
2357 four digits. Version 8.1 with patch 123 has value 8010123.
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
2358 This can be used like this: >
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
2359 if v:versionlong >= 8010123
17053
d5fa04016df0 patch 8.1.1526: no numerical value for the patchlevel
Bram Moolenaar <Bram@vim.org>
parents: 17036
diff changeset
2360 < However, if there are gaps in the list of patches included
d5fa04016df0 patch 8.1.1526: no numerical value for the patchlevel
Bram Moolenaar <Bram@vim.org>
parents: 17036
diff changeset
2361 this will not work well. This can happen if a recent patch
d5fa04016df0 patch 8.1.1526: no numerical value for the patchlevel
Bram Moolenaar <Bram@vim.org>
parents: 17036
diff changeset
2362 was included into an older version, e.g. for a security fix.
d5fa04016df0 patch 8.1.1526: no numerical value for the patchlevel
Bram Moolenaar <Bram@vim.org>
parents: 17036
diff changeset
2363 Use the has() function to make sure the patch is actually
d5fa04016df0 patch 8.1.1526: no numerical value for the patchlevel
Bram Moolenaar <Bram@vim.org>
parents: 17036
diff changeset
2364 included.
d5fa04016df0 patch 8.1.1526: no numerical value for the patchlevel
Bram Moolenaar <Bram@vim.org>
parents: 17036
diff changeset
2365
8738
e770986c855a commit https://github.com/vim/vim/commit/1473551a4457d4920b235eeeb9f279e196ee7225
Christian Brabandt <cb@256bit.org>
parents: 8669
diff changeset
2366 *v:vim_did_enter* *vim_did_enter-variable*
e770986c855a commit https://github.com/vim/vim/commit/1473551a4457d4920b235eeeb9f279e196ee7225
Christian Brabandt <cb@256bit.org>
parents: 8669
diff changeset
2367 v:vim_did_enter Zero until most of startup is done. It is set to one just
e770986c855a commit https://github.com/vim/vim/commit/1473551a4457d4920b235eeeb9f279e196ee7225
Christian Brabandt <cb@256bit.org>
parents: 8669
diff changeset
2368 before |VimEnter| autocommands are triggered.
e770986c855a commit https://github.com/vim/vim/commit/1473551a4457d4920b235eeeb9f279e196ee7225
Christian Brabandt <cb@256bit.org>
parents: 8669
diff changeset
2369
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2370 *v:warningmsg* *warningmsg-variable*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2371 v:warningmsg Last given warning message. It's allowed to set this variable.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2372
2609
758822790b43 updated for version 7.3.031
Bram Moolenaar <bram@vim.org>
parents: 2608
diff changeset
2373 *v:windowid* *windowid-variable*
758822790b43 updated for version 7.3.031
Bram Moolenaar <bram@vim.org>
parents: 2608
diff changeset
2374 v:windowid When any X11 based GUI is running or when running in a
758822790b43 updated for version 7.3.031
Bram Moolenaar <bram@vim.org>
parents: 2608
diff changeset
2375 terminal and Vim connects to the X server (|-X|) this will be
2616
73d947c20291 updated for version 7.3.038
Bram Moolenaar <bram@vim.org>
parents: 2610
diff changeset
2376 set to the window ID.
73d947c20291 updated for version 7.3.038
Bram Moolenaar <bram@vim.org>
parents: 2610
diff changeset
2377 When an MS-Windows GUI is running this will be set to the
73d947c20291 updated for version 7.3.038
Bram Moolenaar <bram@vim.org>
parents: 2610
diff changeset
2378 window handle.
73d947c20291 updated for version 7.3.038
Bram Moolenaar <bram@vim.org>
parents: 2610
diff changeset
2379 Otherwise the value is zero.
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
2380 Note: for windows inside Vim use |winnr()| or |win_getid()|,
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
2381 see |window-ID|.
2609
758822790b43 updated for version 7.3.031
Bram Moolenaar <bram@vim.org>
parents: 2608
diff changeset
2382
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2383 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2384 4. Builtin Functions *functions*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2385
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2386 See |function-list| for a list grouped by what the function is used for.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2387
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 233
diff changeset
2388 (Use CTRL-] on the function name to jump to the full explanation.)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2389
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2390 USAGE RESULT DESCRIPTION ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2391
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2392 abs({expr}) Float or Number absolute value of {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2393 acos({expr}) Float arc cosine of {expr}
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
2394 add({object}, {item}) List/Blob append {item} to {object}
9536
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
2395 and({expr}, {expr}) Number bitwise AND
14864
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
2396 append({lnum}, {text}) Number append {text} below line {lnum}
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
2397 appendbufline({expr}, {lnum}, {text})
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
2398 Number append {text} below line {lnum}
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
2399 in buffer {expr}
15033
f8b0f1e42f2c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15016
diff changeset
2400 argc([{winid}]) Number number of files in the argument list
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
2401 argidx() Number current index in the argument list
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2402 arglistid([{winnr} [, {tabnr}]]) Number argument list id
14964
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
2403 argv({nr} [, {winid}]) String {nr} entry of the argument list
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
2404 argv([-1, {winid}]) List the argument list
20679
1af1d8ff2aa8 patch 8.2.0893: assert_equalfile() does not take a third argument
Bram Moolenaar <Bram@vim.org>
parents: 20665
diff changeset
2405 asin({expr}) Float arc sine of {expr}
13796
87012d2b17b5 patch 8.0.1770: assert functions don't return anything
Christian Brabandt <cb@256bit.org>
parents: 13740
diff changeset
2406 assert_beeps({cmd}) Number assert {cmd} causes a beep
11181
13544aa85dc0 patch 8.0.0477: the client-server test may hang when failing
Christian Brabandt <cb@256bit.org>
parents: 11177
diff changeset
2407 assert_equal({exp}, {act} [, {msg}])
13796
87012d2b17b5 patch 8.0.1770: assert functions don't return anything
Christian Brabandt <cb@256bit.org>
parents: 13740
diff changeset
2408 Number assert {exp} is equal to {act}
20679
1af1d8ff2aa8 patch 8.2.0893: assert_equalfile() does not take a third argument
Bram Moolenaar <Bram@vim.org>
parents: 20665
diff changeset
2409 assert_equalfile({fname-one}, {fname-two} [, {msg}])
1af1d8ff2aa8 patch 8.2.0893: assert_equalfile() does not take a third argument
Bram Moolenaar <Bram@vim.org>
parents: 20665
diff changeset
2410 Number assert file contents are equal
11181
13544aa85dc0 patch 8.0.0477: the client-server test may hang when failing
Christian Brabandt <cb@256bit.org>
parents: 11177
diff changeset
2411 assert_exception({error} [, {msg}])
13796
87012d2b17b5 patch 8.0.1770: assert functions don't return anything
Christian Brabandt <cb@256bit.org>
parents: 13740
diff changeset
2412 Number assert {error} is in v:exception
22171
d4c7b3e9cd17 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22077
diff changeset
2413 assert_fails({cmd} [, {error} [, {msg} [, {lnum} [, {context}]]]])
14945
4ee65b4150fd Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 14864
diff changeset
2414 Number assert {cmd} fails
11181
13544aa85dc0 patch 8.0.0477: the client-server test may hang when failing
Christian Brabandt <cb@256bit.org>
parents: 11177
diff changeset
2415 assert_false({actual} [, {msg}])
13796
87012d2b17b5 patch 8.0.1770: assert functions don't return anything
Christian Brabandt <cb@256bit.org>
parents: 13740
diff changeset
2416 Number assert {actual} is false
9636
ccbb8e393d80 commit https://github.com/vim/vim/commit/61c04493b00f85d0b97436260a9ef9ab82143b78
Christian Brabandt <cb@256bit.org>
parents: 9626
diff changeset
2417 assert_inrange({lower}, {upper}, {actual} [, {msg}])
13796
87012d2b17b5 patch 8.0.1770: assert functions don't return anything
Christian Brabandt <cb@256bit.org>
parents: 13740
diff changeset
2418 Number assert {actual} is inside the range
11181
13544aa85dc0 patch 8.0.0477: the client-server test may hang when failing
Christian Brabandt <cb@256bit.org>
parents: 11177
diff changeset
2419 assert_match({pat}, {text} [, {msg}])
13796
87012d2b17b5 patch 8.0.1770: assert functions don't return anything
Christian Brabandt <cb@256bit.org>
parents: 13740
diff changeset
2420 Number assert {pat} matches {text}
11181
13544aa85dc0 patch 8.0.0477: the client-server test may hang when failing
Christian Brabandt <cb@256bit.org>
parents: 11177
diff changeset
2421 assert_notequal({exp}, {act} [, {msg}])
13796
87012d2b17b5 patch 8.0.1770: assert functions don't return anything
Christian Brabandt <cb@256bit.org>
parents: 13740
diff changeset
2422 Number assert {exp} is not equal {act}
11181
13544aa85dc0 patch 8.0.0477: the client-server test may hang when failing
Christian Brabandt <cb@256bit.org>
parents: 11177
diff changeset
2423 assert_notmatch({pat}, {text} [, {msg}])
13796
87012d2b17b5 patch 8.0.1770: assert functions don't return anything
Christian Brabandt <cb@256bit.org>
parents: 13740
diff changeset
2424 Number assert {pat} not matches {text}
87012d2b17b5 patch 8.0.1770: assert functions don't return anything
Christian Brabandt <cb@256bit.org>
parents: 13740
diff changeset
2425 assert_report({msg}) Number report a test failure
87012d2b17b5 patch 8.0.1770: assert functions don't return anything
Christian Brabandt <cb@256bit.org>
parents: 13740
diff changeset
2426 assert_true({actual} [, {msg}]) Number assert {actual} is true
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2427 atan({expr}) Float arc tangent of {expr}
10038
7cf4e210cf3c commit https://github.com/vim/vim/commit/04186095346daa60e82e981dad114de2b641d672
Christian Brabandt <cb@256bit.org>
parents: 10027
diff changeset
2428 atan2({expr1}, {expr2}) Float arc tangent of {expr1} / {expr2}
16600
ff3c99bd1038 patch 8.1.1303: not possible to hide a balloon
Bram Moolenaar <Bram@vim.org>
parents: 16576
diff changeset
2429 balloon_gettext() String current text in the balloon
13016
e47e70300f30 patch 8.0.1384: not enough quickfix help; confusing winid
Christian Brabandt <cb@256bit.org>
parents: 12977
diff changeset
2430 balloon_show({expr}) none show {expr} inside the balloon
12883
058e93aee621 patch 8.0.1318: terminal balloon only shows one line
Christian Brabandt <cb@256bit.org>
parents: 12857
diff changeset
2431 balloon_split({msg}) List split {msg} as used for a balloon
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2432 browse({save}, {title}, {initdir}, {default})
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2433 String put up a file requester
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2434 browsedir({title}, {initdir}) String put up a directory requester
17221
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
2435 bufadd({name}) Number add a buffer to the buffer list
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
2436 bufexists({expr}) Number |TRUE| if buffer {expr} exists
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
2437 buflisted({expr}) Number |TRUE| if buffer {expr} is listed
17221
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
2438 bufload({expr}) Number load buffer {expr} if not loaded yet
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
2439 bufloaded({expr}) Number |TRUE| if buffer {expr} is loaded
17855
285f7a700185 patch 8.1.1924: using empty string for current buffer is unexpected
Bram Moolenaar <Bram@vim.org>
parents: 17849
diff changeset
2440 bufname([{expr}]) String Name of the buffer {expr}
285f7a700185 patch 8.1.1924: using empty string for current buffer is unexpected
Bram Moolenaar <Bram@vim.org>
parents: 17849
diff changeset
2441 bufnr([{expr} [, {create}]]) Number Number of the buffer {expr}
9219
7363f5cc4cb8 commit https://github.com/vim/vim/commit/b3619a90eae2702553ff9494ecc4c9b20c13c224
Christian Brabandt <cb@256bit.org>
parents: 9121
diff changeset
2442 bufwinid({expr}) Number window ID of buffer {expr}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2443 bufwinnr({expr}) Number window number of buffer {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2444 byte2line({byte}) Number line number at byte count {byte}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2445 byteidx({expr}, {nr}) Number byte index of {nr}'th char in {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2446 byteidxcomp({expr}, {nr}) Number byte index of {nr}'th char in {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2447 call({func}, {arglist} [, {dict}])
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
2448 any call {func} with arguments {arglist}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2449 ceil({expr}) Float round {expr} up
10422
e664ee056a84 commit https://github.com/vim/vim/commit/4b785f69c0616dba5d3f38e8ce4b5398cec89407
Christian Brabandt <cb@256bit.org>
parents: 10404
diff changeset
2450 ch_canread({handle}) Number check if there is something to read
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2451 ch_close({handle}) none close {handle}
10054
d4b7232fc63a commit https://github.com/vim/vim/commit/0874a83e9be1b39fdb217f02b427bf1d6133a4d8
Christian Brabandt <cb@256bit.org>
parents: 10051
diff changeset
2452 ch_close_in({handle}) none close in part of {handle}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2453 ch_evalexpr({handle}, {expr} [, {options}])
8440
4c6ad81d41fe commit https://github.com/vim/vim/commit/5f148ec0b5a6cedd9129b3abac351034b83cc4f7
Christian Brabandt <cb@256bit.org>
parents: 8392
diff changeset
2454 any evaluate {expr} on JSON {handle}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2455 ch_evalraw({handle}, {string} [, {options}])
8440
4c6ad81d41fe commit https://github.com/vim/vim/commit/5f148ec0b5a6cedd9129b3abac351034b83cc4f7
Christian Brabandt <cb@256bit.org>
parents: 8392
diff changeset
2456 any evaluate {string} on raw {handle}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2457 ch_getbufnr({handle}, {what}) Number get buffer number for {handle}/{what}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2458 ch_getjob({channel}) Job get the Job of {channel}
9536
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
2459 ch_info({handle}) String info about channel {handle}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2460 ch_log({msg} [, {handle}]) none write {msg} in the channel log file
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2461 ch_logfile({fname} [, {mode}]) none start logging channel activity
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2462 ch_open({address} [, {options}])
9536
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
2463 Channel open a channel to {address}
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
2464 ch_read({handle} [, {options}]) String read from {handle}
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
2465 ch_readblob({handle} [, {options}])
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
2466 Blob read Blob from {handle}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2467 ch_readraw({handle} [, {options}])
9536
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
2468 String read raw from {handle}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2469 ch_sendexpr({handle}, {expr} [, {options}])
8440
4c6ad81d41fe commit https://github.com/vim/vim/commit/5f148ec0b5a6cedd9129b3abac351034b83cc4f7
Christian Brabandt <cb@256bit.org>
parents: 8392
diff changeset
2470 any send {expr} over JSON {handle}
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
2471 ch_sendraw({handle}, {expr} [, {options}])
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
2472 any send {expr} over raw {handle}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2473 ch_setoptions({handle}, {options})
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2474 none set options for {handle}
10233
d709622a18c9 commit https://github.com/vim/vim/commit/7ef3810d28b7ab2edbfcafab3fe8ad8bc2c2f138
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2475 ch_status({handle} [, {options}])
d709622a18c9 commit https://github.com/vim/vim/commit/7ef3810d28b7ab2edbfcafab3fe8ad8bc2c2f138
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2476 String status of channel {handle}
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
2477 changenr() Number current change number
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2478 char2nr({expr} [, {utf8}]) Number ASCII/UTF8 value of first char in {expr}
21973
85add08e6a2d patch 8.2.1536: cannot get the class of a character; emoji widths are wrong
Bram Moolenaar <Bram@vim.org>
parents: 21971
diff changeset
2479 charclass({string}) Number character class of {string}
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
2480 charcol({expr}) Number column number of cursor or mark
23380
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
2481 charidx({string}, {idx} [, {countcc}])
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
2482 Number char index of byte {idx} in {string}
16576
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
2483 chdir({dir}) String change current working directory
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2484 cindent({lnum}) Number C indent for line {lnum}
16158
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
2485 clearmatches([{win}]) none clear all matches
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
2486 col({expr}) Number column byte index of cursor or mark
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2487 complete({startcol}, {matches}) none set Insert mode completion
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2488 complete_add({expr}) Number add completion match
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
2489 complete_check() Number check for key typed during completion
16127
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
2490 complete_info([{what}]) Dict get current completion information
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2491 confirm({msg} [, {choices} [, {default} [, {type}]]])
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2492 Number number of choice picked by user
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2493 copy({expr}) any make a shallow copy of {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2494 cos({expr}) Float cosine of {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2495 cosh({expr}) Float hyperbolic cosine of {expr}
14864
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
2496 count({comp}, {expr} [, {ic} [, {start}]])
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
2497 Number count how many {expr} are in {comp}
9887
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 9881
diff changeset
2498 cscope_connection([{num}, {dbpath} [, {prepend}]])
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2499 Number checks existence of cscope connection
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2500 cursor({lnum}, {col} [, {off}])
6385
f654ad95fd4e Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6369
diff changeset
2501 Number move cursor to {lnum}, {col}, {off}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2502 cursor({list}) Number move cursor to position in {list}
14147
de75c249723d patch 8.1.0091: MS-Windows: Cannot interrupt gdb when program is running
Christian Brabandt <cb@256bit.org>
parents: 14123
diff changeset
2503 debugbreak({pid}) Number interrupt process being debugged
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2504 deepcopy({expr} [, {noref}]) any make a full copy of {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2505 delete({fname} [, {flags}]) Number delete the file or directory {fname}
14519
5c5908e81e93 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14422
diff changeset
2506 deletebufline({expr}, {first} [, {last}])
14043
cbad3b3f46b2 patch 8.1.0039: cannot easily delete lines in another buffer
Christian Brabandt <cb@256bit.org>
parents: 14039
diff changeset
2507 Number delete lines from buffer {expr}
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
2508 did_filetype() Number |TRUE| if FileType autocmd event used
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2509 diff_filler({lnum}) Number diff filler lines about {lnum}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2510 diff_hlID({lnum}, {col}) Number diff highlighting at {lnum}/{col}
19400
bd9069d21c5d patch 8.2.0258: modifyOtherKeys cannot be temporarily disabled
Bram Moolenaar <Bram@vim.org>
parents: 19398
diff changeset
2511 echoraw({expr}) none output {expr} as-is
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
2512 empty({expr}) Number |TRUE| if {expr} is empty
16604
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
2513 environ() Dict return environment variables
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2514 escape({string}, {chars}) String escape {chars} in {string} with '\'
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2515 eval({string}) any evaluate {string} into its value
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
2516 eventhandler() Number |TRUE| if inside an event handler
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2517 executable({expr}) Number 1 if executable {expr} exists
9454
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
2518 execute({command}) String execute {command} and get the output
9536
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
2519 exepath({expr}) String full path of the command {expr}
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
2520 exists({expr}) Number |TRUE| if {expr} exists
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2521 exp({expr}) Float exponential of {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2522 expand({expr} [, {nosuf} [, {list}]])
3398
d1096a4e96bd updated for version 7.3.465
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
2523 any expand special keywords in {expr}
17020
1841c03a9b5e patch 8.1.1510: a plugin cannot easily expand a command like done internally
Bram Moolenaar <Bram@vim.org>
parents: 17004
diff changeset
2524 expandcmd({expr}) String expand {expr} like with `:edit`
20687
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
2525 extend({expr1}, {expr2} [, {expr3}])
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
2526 List/Dict insert items of {expr2} into {expr1}
23588
510088f8c66f patch 8.2.2336: Vim9: not possible to extend dictionary with different type
Bram Moolenaar <Bram@vim.org>
parents: 23563
diff changeset
2527 extendnew({expr1}, {expr2} [, {expr3}])
510088f8c66f patch 8.2.2336: Vim9: not possible to extend dictionary with different type
Bram Moolenaar <Bram@vim.org>
parents: 23563
diff changeset
2528 List/Dict like |extend()| but creates a new
510088f8c66f patch 8.2.2336: Vim9: not possible to extend dictionary with different type
Bram Moolenaar <Bram@vim.org>
parents: 23563
diff changeset
2529 List or Dictionary
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2530 feedkeys({string} [, {mode}]) Number add key sequence to typeahead buffer
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
2531 filereadable({file}) Number |TRUE| if {file} is a readable file
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
2532 filewritable({file}) Number |TRUE| if {file} is a writable file
10218
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
2533 filter({expr1}, {expr2}) List/Dict remove items from {expr1} where
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
2534 {expr2} is 0
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2535 finddir({name} [, {path} [, {count}]])
824
8dd456c1e283 updated for version 7.0c13
vimboss
parents: 823
diff changeset
2536 String find directory {name} in {path}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2537 findfile({name} [, {path} [, {count}]])
824
8dd456c1e283 updated for version 7.0c13
vimboss
parents: 823
diff changeset
2538 String find file {name} in {path}
20766
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
2539 flatten({list} [, {maxdepth}]) List flatten {list} up to {maxdepth} levels
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2540 float2nr({expr}) Number convert Float {expr} to a Number
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2541 floor({expr}) Float round {expr} down
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2542 fmod({expr1}, {expr2}) Float remainder of {expr1} / {expr2}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2543 fnameescape({fname}) String escape special characters in {fname}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2544 fnamemodify({fname}, {mods}) String modify file name
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2545 foldclosed({lnum}) Number first line of fold at {lnum} if closed
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2546 foldclosedend({lnum}) Number last line of fold at {lnum} if closed
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2547 foldlevel({lnum}) Number fold level at {lnum}
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 8094
diff changeset
2548 foldtext() String line displayed for closed fold
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2549 foldtextresult({lnum}) String text for closed fold at {lnum}
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 8094
diff changeset
2550 foreground() Number bring the Vim window to the foreground
9723
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
2551 funcref({name} [, {arglist}] [, {dict}])
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
2552 Funcref reference to function {name}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2553 function({name} [, {arglist}] [, {dict}])
9723
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
2554 Funcref named reference to function {name}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2555 garbagecollect([{atexit}]) none free memory, breaking cyclic references
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2556 get({list}, {idx} [, {def}]) any get item {idx} from {list} or {def}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2557 get({dict}, {key} [, {def}]) any get item {key} from {dict} or {def}
9117
0cc48b3cd884 commit https://github.com/vim/vim/commit/03e19a04ac2ca55643663b97b6ab94043233dcbd
Christian Brabandt <cb@256bit.org>
parents: 9110
diff changeset
2558 get({func}, {what}) any get property of funcref/partial {func}
10218
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
2559 getbufinfo([{expr}]) List information about buffers
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2560 getbufline({expr}, {lnum} [, {end}])
435
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
2561 List lines {lnum} to {end} of buffer {expr}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2562 getbufvar({expr}, {varname} [, {def}])
4157
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
2563 any variable {varname} in buffer {expr}
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
2564 getchangelist([{expr}]) List list of change list items
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2565 getchar([expr]) Number get one character from the user
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 8094
diff changeset
2566 getcharmod() Number modifiers for the last typed character
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
2567 getcharpos({expr}) List position of cursor, mark, etc.
7013
349e6c01f35d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6991
diff changeset
2568 getcharsearch() Dict last character search
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2569 getcmdline() String return the current command-line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2570 getcmdpos() Number return cursor position in command-line
6153
1e8ebf870720 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6110
diff changeset
2571 getcmdtype() String return current command-line type
1e8ebf870720 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6110
diff changeset
2572 getcmdwintype() String return current command-line window type
9861
74f67cb4f7e1 commit https://github.com/vim/vim/commit/e9d58a6459687a1228b5aa85bd7b31f8f1e528a8
Christian Brabandt <cb@256bit.org>
parents: 9858
diff changeset
2573 getcompletion({pat}, {type} [, {filtered}])
74f67cb4f7e1 commit https://github.com/vim/vim/commit/e9d58a6459687a1228b5aa85bd7b31f8f1e528a8
Christian Brabandt <cb@256bit.org>
parents: 9858
diff changeset
2574 List list of cmdline completion matches
22357
0e231e8e70f8 patch 8.2.1727: a popup created with "cursorline" will ignore "firstline"
Bram Moolenaar <Bram@vim.org>
parents: 22355
diff changeset
2575 getcurpos([{winnr}]) List position of the cursor
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
2576 getcursorcharpos([{winnr}]) List character position of the cursor
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2577 getcwd([{winnr} [, {tabnr}]]) String get the current working directory
16604
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
2578 getenv({name}) String return environment variable
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2579 getfontname([{name}]) String name of font being used
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2580 getfperm({fname}) String file permissions of file {fname}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2581 getfsize({fname}) Number size in bytes of file {fname}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2582 getftime({fname}) Number last modification time of file
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2583 getftype({fname}) String description of type of file {fname}
18008
8ae333756614 patch 8.1.2000: plugin cannot get the current IME status
Bram Moolenaar <Bram@vim.org>
parents: 18000
diff changeset
2584 getimstatus() Number |TRUE| if the IME status is active
13246
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
2585 getjumplist([{winnr} [, {tabnr}]])
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
2586 List list of jump list items
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2587 getline({lnum}) String line {lnum} of current buffer
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2588 getline({lnum}, {end}) List lines {lnum} to {end} of current buffer
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
2589 getloclist({nr}) List list of location list items
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
2590 getloclist({nr}, {what}) Dict get specific location list properties
20615
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
2591 getmarklist([{expr}]) List list of global/local marks
16158
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
2592 getmatches([{win}]) List list of current matches
18623
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
2593 getmousepos() Dict last known mouse position
1548
8d74df00f7da updated for version 7.1-262
vimboss
parents: 1533
diff changeset
2594 getpid() Number process ID of Vim
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2595 getpos({expr}) List position of cursor, mark, etc.
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
2596 getqflist() List list of quickfix items
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
2597 getqflist({what}) Dict get specific quickfix list properties
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2598 getreg([{regname} [, 1 [, {list}]]])
20743
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
2599 String or List contents of a register
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
2600 getreginfo([{regname}]) Dict information about a register
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
2601 getregtype([{regname}]) String type of a register
10218
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
2602 gettabinfo([{expr}]) List list of tab pages
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2603 gettabvar({nr}, {varname} [, {def}])
4157
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
2604 any variable {varname} in tab {nr} or {def}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2605 gettabwinvar({tabnr}, {winnr}, {name} [, {def}])
831
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
2606 any {name} in {winnr} in tab page {tabnr}
15016
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
2607 gettagstack([{nr}]) Dict get the tag stack of window {nr}
21989
52e970719f4b patch 8.2.1544: cannot translate messages in a Vim script
Bram Moolenaar <Bram@vim.org>
parents: 21973
diff changeset
2608 gettext({text}) String lookup translation of {text}
14343
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
2609 getwininfo([{winid}]) List list of info about each window
13482
9eebe457eb3c Update runtime files. Convert a couple of help files to utf-8.
Christian Brabandt <cb@256bit.org>
parents: 13438
diff changeset
2610 getwinpos([{timeout}]) List X and Y coord in pixels of the Vim window
13379
0f9dd1b43244 patch 8.0.1563: timeout of getwinposx() can be too short
Christian Brabandt <cb@256bit.org>
parents: 13341
diff changeset
2611 getwinposx() Number X coord in pixels of the Vim window
0f9dd1b43244 patch 8.0.1563: timeout of getwinposx() can be too short
Christian Brabandt <cb@256bit.org>
parents: 13341
diff changeset
2612 getwinposy() Number Y coord in pixels of the Vim window
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2613 getwinvar({nr}, {varname} [, {def}])
4157
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
2614 any variable {varname} in window {nr}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2615 glob({expr} [, {nosuf} [, {list} [, {alllinks}]]])
3398
d1096a4e96bd updated for version 7.3.465
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
2616 any expand file wildcards in {expr}
9536
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
2617 glob2regpat({expr}) String convert a glob pat into a search pat
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2618 globpath({path}, {expr} [, {nosuf} [, {list} [, {alllinks}]]])
1754
28d0c20ad8a0 updated for version 7.2-051
vimboss
parents: 1733
diff changeset
2619 String do glob({expr}) for all dirs in {path}
19742
810eee1b42e3 patch 8.2.0427: it is not possible to check for a typo in a feature name
Bram Moolenaar <Bram@vim.org>
parents: 19721
diff changeset
2620 has({feature} [, {check}]) Number |TRUE| if feature {feature} supported
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
2621 has_key({dict}, {key}) Number |TRUE| if {dict} has entry {key}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2622 haslocaldir([{winnr} [, {tabnr}]])
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
2623 Number |TRUE| if the window executed |:lcd|
16427
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
2624 or |:tcd|
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2625 hasmapto({what} [, {mode} [, {abbr}]])
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
2626 Number |TRUE| if mapping to {what} exists
19181
94eda51ba9ba patch 8.2.0149: maintaining a Vim9 branch separately is more work
Bram Moolenaar <Bram@vim.org>
parents: 19163
diff changeset
2627 histadd({history}, {item}) Number add an item to a history
94eda51ba9ba patch 8.2.0149: maintaining a Vim9 branch separately is more work
Bram Moolenaar <Bram@vim.org>
parents: 19163
diff changeset
2628 histdel({history} [, {item}]) Number remove an item from a history
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2629 histget({history} [, {index}]) String get the item {index} from a history
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2630 histnr({history}) Number highest index of a history
20687
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
2631 hlID({name}) Number syntax ID of highlight group {name}
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
2632 hlexists({name}) Number |TRUE| if highlight group {name} exists
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2633 hostname() String name of the machine Vim is running on
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2634 iconv({expr}, {from}, {to}) String convert encoding of {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2635 indent({lnum}) Number indent of line {lnum}
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
2636 index({object}, {expr} [, {start} [, {ic}]])
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
2637 Number index in {object} where {expr} appears
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2638 input({prompt} [, {text} [, {completion}]])
531
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
2639 String get input from the user
11763
21f3930dfe6e Documentation updates.
Christian Brabandt <cb@256bit.org>
parents: 11659
diff changeset
2640 inputdialog({prompt} [, {text} [, {completion}]])
9536
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
2641 String like input() but in a GUI dialog
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2642 inputlist({textlist}) Number let the user pick from a choice list
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
2643 inputrestore() Number restore typeahead
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
2644 inputsave() Number save and clear typeahead
9536
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
2645 inputsecret({prompt} [, {text}]) String like input() but hiding the text
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
2646 insert({object}, {item} [, {idx}]) List insert {item} in {object} [before {idx}]
18699
1febd1aa9930 patch 8.1.2341: not so easy to interrupt a script programatically
Bram Moolenaar <Bram@vim.org>
parents: 18669
diff changeset
2647 interrupt() none interrupt script execution
9536
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
2648 invert({expr}) Number bitwise invert
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
2649 isdirectory({directory}) Number |TRUE| if {directory} is a directory
16213
2c33b119ba92 patch 8.1.1111: it is not easy to check for infinity
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
2650 isinf({expr}) Number determine if {expr} is infinity value
2c33b119ba92 patch 8.1.1111: it is not easy to check for infinity
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
2651 (positive or negative)
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
2652 islocked({expr}) Number |TRUE| if {expr} is locked
9536
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
2653 isnan({expr}) Number |TRUE| if {expr} is NaN
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2654 items({dict}) List key-value pairs in {dict}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2655 job_getchannel({job}) Channel get the channel handle for {job}
13740
f309afff6f25 patch 8.0.1742: cannot get a list of all the jobs
Christian Brabandt <cb@256bit.org>
parents: 13735
diff changeset
2656 job_info([{job}]) Dict get information about {job}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2657 job_setoptions({job}, {options}) none set options for {job}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2658 job_start({command} [, {options}])
9536
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
2659 Job start a job
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2660 job_status({job}) String get the status of {job}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2661 job_stop({job} [, {how}]) Number stop {job}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2662 join({list} [, {sep}]) String join {list} items into one String
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2663 js_decode({string}) any decode JS style JSON
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2664 js_encode({expr}) String encode JS style JSON
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2665 json_decode({string}) any decode JSON
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2666 json_encode({expr}) String encode JSON
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2667 keys({dict}) List keys in {dict}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2668 len({expr}) Number the length of {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2669 libcall({lib}, {func}, {arg}) String call {func} in library {lib} with {arg}
9536
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
2670 libcallnr({lib}, {func}, {arg}) Number idem, but return a Number
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
2671 line({expr} [, {winid}]) Number line nr of cursor, last line or mark
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2672 line2byte({lnum}) Number byte count of line {lnum}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2673 lispindent({lnum}) Number Lisp indent for line {lnum}
16235
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
2674 list2str({list} [, {utf8}]) String turn numbers in {list} into a String
16638
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
2675 listener_add({callback} [, {buf}])
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
2676 Number add a callback to listen to changes
16660
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
2677 listener_flush([{buf}]) none invoke listener callbacks
16638
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
2678 listener_remove({id}) none remove a listener callback
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2679 localtime() Number current time
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2680 log({expr}) Float natural logarithm (base e) of {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2681 log10({expr}) Float logarithm of Float {expr} to base 10
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2682 luaeval({expr} [, {expr}]) any evaluate |Lua| expression
10218
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
2683 map({expr1}, {expr2}) List/Dict change each item in {expr1} to {expr}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2684 maparg({name} [, {mode} [, {abbr} [, {dict}]]])
3224
8b8ef1fed009 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3214
diff changeset
2685 String or Dict
8b8ef1fed009 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3214
diff changeset
2686 rhs of mapping {name} in mode {mode}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2687 mapcheck({name} [, {mode} [, {abbr}]])
782
d20041a02ee5 updated for version 7.0228
vimboss
parents: 777
diff changeset
2688 String check for mappings matching {name}
22844
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
2689 mapnew({expr1}, {expr2}) List/Dict like |map()| but creates a new List
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
2690 or Dictionary
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
2691 mapset({mode}, {abbr}, {dict}) none restore mapping from |maparg()| result
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2692 match({expr}, {pat} [, {start} [, {count}]])
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2693 Number position where {pat} matches in {expr}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2694 matchadd({group}, {pattern} [, {priority} [, {id} [, {dict}]]])
1326
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
2695 Number highlight {pattern} with {group}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2696 matchaddpos({group}, {pos} [, {priority} [, {id} [, {dict}]]])
5979
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
2697 Number highlight positions with {group}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2698 matcharg({nr}) List arguments of |:match|
16158
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
2699 matchdelete({id} [, {win}]) Number delete match identified by {id}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2700 matchend({expr}, {pat} [, {start} [, {count}]])
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2701 Number position where {pat} ends in {expr}
22355
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
2702 matchfuzzy({list}, {str} [, {dict}])
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
2703 List fuzzy match {str} in {list}
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
2704 matchfuzzypos({list}, {str} [, {dict}])
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
2705 List fuzzy match {str} in {list}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2706 matchlist({expr}, {pat} [, {start} [, {count}]])
158
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
2707 List match and submatches of {pat} in {expr}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2708 matchstr({expr}, {pat} [, {start} [, {count}]])
19
a81bc802c17c updated for version 7.0011
vimboss
parents: 18
diff changeset
2709 String {count}'th match of {pat} in {expr}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2710 matchstrpos({expr}, {pat} [, {start} [, {count}]])
8793
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
2711 List {count}'th match of {pat} in {expr}
10734
523cd59d6db0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10730
diff changeset
2712 max({expr}) Number maximum value of items in {expr}
19657
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
2713 menu_info({name} [, {mode}]) Dict get menu item information
10734
523cd59d6db0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10730
diff changeset
2714 min({expr}) Number minimum value of items in {expr}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2715 mkdir({name} [, {path} [, {prot}]])
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
2716 Number create directory {name}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2717 mode([expr]) String current editing mode
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2718 mzeval({expr}) any evaluate |MzScheme| expression
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2719 nextnonblank({lnum}) Number line nr of non-blank line >= {lnum}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2720 nr2char({expr} [, {utf8}]) String single char with ASCII/UTF8 value {expr}
9536
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
2721 or({expr}, {expr}) Number bitwise OR
22385
770fe121ca64 patch 8.2.1741: pathshorten() only supports using one character
Bram Moolenaar <Bram@vim.org>
parents: 22357
diff changeset
2722 pathshorten({expr} [, {len}]) String shorten directory names in a path
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2723 perleval({expr}) any evaluate |Perl| expression
17257
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2724 popup_atcursor({what}, {options}) Number create popup window near the cursor
18130
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
2725 popup_beval({what}, {options}) Number create popup window for 'ballooneval'
17257
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2726 popup_clear() none close all popup windows
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2727 popup_close({id} [, {result}]) none close popup window {id}
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2728 popup_create({what}, {options}) Number create a popup window
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2729 popup_dialog({what}, {options}) Number create a popup window used as a dialog
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2730 popup_filter_menu({id}, {key}) Number filter for a menu popup window
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2731 popup_filter_yesno({id}, {key}) Number filter for a dialog popup window
17825
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
2732 popup_findinfo() Number get window ID of info popup window
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
2733 popup_findpreview() Number get window ID of preview popup window
17257
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2734 popup_getoptions({id}) Dict get options of popup window {id}
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2735 popup_getpos({id}) Dict get position of popup window {id}
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2736 popup_hide({id}) none hide popup menu {id}
20687
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
2737 popup_list() List get a list of window IDs of all popups
20386
3b3589275ab9 patch 8.2.0748: cannot get a list of all popups
Bram Moolenaar <Bram@vim.org>
parents: 20241
diff changeset
2738 popup_locate({row}, {col}) Number get window ID of popup at position
17257
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2739 popup_menu({what}, {options}) Number create a popup window used as a menu
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2740 popup_move({id}, {options}) none set position of popup window {id}
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2741 popup_notification({what}, {options})
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2742 Number create a notification popup window
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2743 popup_setoptions({id}, {options})
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2744 none set options for popup window {id}
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
2745 popup_settext({id}, {text}) none set the text of popup window {id}
20687
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
2746 popup_show({id}) none unhide popup window {id}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2747 pow({x}, {y}) Float {x} to the power of {y}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2748 prevnonblank({lnum}) Number line nr of non-blank line <= {lnum}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2749 printf({fmt}, {expr1}...) String format text
22077
335365fcbb60 patch 8.2.1588: cannot read back the prompt of a prompt buffer
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
2750 prompt_getprompt({buf}) String get prompt text
14103
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
2751 prompt_setcallback({buf}, {expr}) none set prompt callback function
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
2752 prompt_setinterrupt({buf}, {text}) none set prompt interrupt function
14019
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
2753 prompt_setprompt({buf}, {text}) none set prompt text
15138
9df130fd5e0d patch 8.1.0579: cannot attach properties to text
Bram Moolenaar <Bram@vim.org>
parents: 15131
diff changeset
2754 prop_add({lnum}, {col}, {props}) none add a text property
15251
17525ca95e1e patch 8.1.0634: text properties cannot cross line boundaries
Bram Moolenaar <Bram@vim.org>
parents: 15219
diff changeset
2755 prop_clear({lnum} [, {lnum-end} [, {props}]])
15138
9df130fd5e0d patch 8.1.0579: cannot attach properties to text
Bram Moolenaar <Bram@vim.org>
parents: 15131
diff changeset
2756 none remove all text properties
9df130fd5e0d patch 8.1.0579: cannot attach properties to text
Bram Moolenaar <Bram@vim.org>
parents: 15131
diff changeset
2757 prop_find({props} [, {direction}])
9df130fd5e0d patch 8.1.0579: cannot attach properties to text
Bram Moolenaar <Bram@vim.org>
parents: 15131
diff changeset
2758 Dict search for a text property
20241
56265f711890 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20178
diff changeset
2759 prop_list({lnum} [, {props}]) List text properties in {lnum}
15281
97b40b4c6911 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15279
diff changeset
2760 prop_remove({props} [, {lnum} [, {lnum-end}]])
15138
9df130fd5e0d patch 8.1.0579: cannot attach properties to text
Bram Moolenaar <Bram@vim.org>
parents: 15131
diff changeset
2761 Number remove a text property
9df130fd5e0d patch 8.1.0579: cannot attach properties to text
Bram Moolenaar <Bram@vim.org>
parents: 15131
diff changeset
2762 prop_type_add({name}, {props}) none define a new property type
9df130fd5e0d patch 8.1.0579: cannot attach properties to text
Bram Moolenaar <Bram@vim.org>
parents: 15131
diff changeset
2763 prop_type_change({name}, {props})
9df130fd5e0d patch 8.1.0579: cannot attach properties to text
Bram Moolenaar <Bram@vim.org>
parents: 15131
diff changeset
2764 none change an existing property type
9df130fd5e0d patch 8.1.0579: cannot attach properties to text
Bram Moolenaar <Bram@vim.org>
parents: 15131
diff changeset
2765 prop_type_delete({name} [, {props}])
9df130fd5e0d patch 8.1.0579: cannot attach properties to text
Bram Moolenaar <Bram@vim.org>
parents: 15131
diff changeset
2766 none delete a property type
22723
5b7ea82bc18f Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22689
diff changeset
2767 prop_type_get({name} [, {props}])
15138
9df130fd5e0d patch 8.1.0579: cannot attach properties to text
Bram Moolenaar <Bram@vim.org>
parents: 15131
diff changeset
2768 Dict get property type values
9df130fd5e0d patch 8.1.0579: cannot attach properties to text
Bram Moolenaar <Bram@vim.org>
parents: 15131
diff changeset
2769 prop_type_list([{props}]) List get list of property types
17756
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
2770 pum_getpos() Dict position and size of pum if visible
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
2771 pumvisible() Number whether popup menu is visible
20687
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
2772 py3eval({expr}) any evaluate |python3| expression
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2773 pyeval({expr}) any evaluate |Python| expression
10722
7598ce51bf2a patch 8.0.0251: not easy to select Python 2 or 3
Christian Brabandt <cb@256bit.org>
parents: 10617
diff changeset
2774 pyxeval({expr}) any evaluate |python_x| expression
18701
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
2775 rand([{expr}]) Number get pseudo-random number
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2776 range({expr} [, {max} [, {stride}]])
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
2777 List items from {expr} to {max}
23602
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
2778 readblob({fname}) Blob read a |Blob| from {fname}
20873
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
2779 readdir({dir} [, {expr} [, {dict}]])
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
2780 List file names in {dir} selected by {expr}
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
2781 readdirex({dir} [, {expr} [, {dict}]])
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
2782 List file info in {dir} selected by {expr}
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
2783 readfile({fname} [, {type} [, {max}]])
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
2784 List get list of lines from file {fname}
20649
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
2785 reduce({object}, {func} [, {initial}])
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
2786 any reduce {object} using {func}
14019
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
2787 reg_executing() String get the executing register name
14004
e124262d435e patch 8.1.0020: cannot tell whether a register is executing or recording
Christian Brabandt <cb@256bit.org>
parents: 13967
diff changeset
2788 reg_recording() String get the recording register name
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2789 reltime([{start} [, {end}]]) List get time value
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2790 reltimefloat({time}) Float turn the time value into a Float
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2791 reltimestr({time}) String turn time value into a String
11229
146a1e213b60 Update runtime files. Add Rust support.
Christian Brabandt <cb@256bit.org>
parents: 11225
diff changeset
2792 remote_expr({server}, {string} [, {idvar} [, {timeout}]])
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2793 String send expression
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2794 remote_foreground({server}) Number bring Vim server to the foreground
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2795 remote_peek({serverid} [, {retvar}])
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2796 Number check for reply string
11229
146a1e213b60 Update runtime files. Add Rust support.
Christian Brabandt <cb@256bit.org>
parents: 11225
diff changeset
2797 remote_read({serverid} [, {timeout}])
146a1e213b60 Update runtime files. Add Rust support.
Christian Brabandt <cb@256bit.org>
parents: 11225
diff changeset
2798 String read reply string
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2799 remote_send({server}, {string} [, {idvar}])
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2800 String send key sequence
11177
76fb679a310e patch 8.0.0475: not enough testing for the client-server feature
Christian Brabandt <cb@256bit.org>
parents: 11160
diff changeset
2801 remote_startserver({name}) none become server {name}
18669
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
2802 remove({list}, {idx} [, {end}]) any/List
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
2803 remove items {idx}-{end} from {list}
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
2804 remove({blob}, {idx} [, {end}]) Number/Blob
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
2805 remove bytes {idx}-{end} from {blob}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2806 remove({dict}, {key}) any remove entry {key} from {dict}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2807 rename({from}, {to}) Number rename (move) file from {from} to {to}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2808 repeat({expr}, {count}) String repeat {expr} {count} times
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2809 resolve({filename}) String get filename a shortcut points to
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2810 reverse({list}) List reverse {list} in-place
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2811 round({expr}) Float round off {expr}
16103
518f44125207 patch 8.1.1056: no eval function for Ruby
Bram Moolenaar <Bram@vim.org>
parents: 16086
diff changeset
2812 rubyeval({expr}) any evaluate |Ruby| expression
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2813 screenattr({row}, {col}) Number attribute at screen position
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2814 screenchar({row}, {col}) Number character at screen position
16133
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
2815 screenchars({row}, {col}) List List of characters at screen position
3986
56bb88c68f98 updated for version 7.3.748
Bram Moolenaar <bram@vim.org>
parents: 3967
diff changeset
2816 screencol() Number current cursor column
17292
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
2817 screenpos({winid}, {lnum}, {col}) Dict screen row and col of a text character
3986
56bb88c68f98 updated for version 7.3.748
Bram Moolenaar <bram@vim.org>
parents: 3967
diff changeset
2818 screenrow() Number current cursor row
16133
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
2819 screenstring({row}, {col}) String characters at screen position
20725
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
2820 search({pattern} [, {flags} [, {stopline} [, {timeout} [, {skip}]]]])
1496
29c09fa57168 updated for version 7.1-211
vimboss
parents: 1490
diff changeset
2821 Number search for {pattern}
20647
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
2822 searchcount([{options}]) Dict get or update search stats
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2823 searchdecl({name} [, {global} [, {thisblock}]])
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
2824 Number search for variable declaration
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2825 searchpair({start}, {middle}, {end} [, {flags} [, {skip} [...]]])
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
2826 Number search for other end of start/end pair
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2827 searchpairpos({start}, {middle}, {end} [, {flags} [, {skip} [...]]])
667
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
2828 List search for other end of start/end pair
20725
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
2829 searchpos({pattern} [, {flags} [, {stopline} [, {timeout} [, {skip}]]]])
667
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
2830 List search for {pattern}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2831 server2client({clientid}, {string})
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2832 Number send reply string
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2833 serverlist() String get a list of available servers
14864
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
2834 setbufline({expr}, {lnum}, {text})
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
2835 Number set line {lnum} to {text} in buffer
12319
c7e95667d14b patch 8.0.1039: cannot change a line in not current buffer
Christian Brabandt <cb@256bit.org>
parents: 12317
diff changeset
2836 {expr}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2837 setbufvar({expr}, {varname}, {val})
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2838 none set {varname} in buffer {expr} to {val}
21971
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
2839 setcellwidths({list}) none set character cell width overrides
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
2840 setcharpos({expr}, {list}) Number set the {expr} position to {list}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2841 setcharsearch({dict}) Dict set character search from {dict}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2842 setcmdpos({pos}) Number set cursor position in command-line
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
2843 setcursorcharpos({list}) Number move cursor to position in {list}
16604
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
2844 setenv({name}, {val}) none set environment variable
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2845 setfperm({fname}, {mode}) Number set {fname} file permissions to {mode}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2846 setline({lnum}, {line}) Number set line {lnum} to {line}
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
2847 setloclist({nr}, {list} [, {action}])
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
2848 Number modify location list using {list}
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
2849 setloclist({nr}, {list}, {action}, {what})
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
2850 Number modify specific location list props
16158
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
2851 setmatches({list} [, {win}]) Number restore a list of matches
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2852 setpos({expr}, {list}) Number set the {expr} position to {list}
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
2853 setqflist({list} [, {action}]) Number modify quickfix list using {list}
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
2854 setqflist({list}, {action}, {what})
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
2855 Number modify specific quickfix list props
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2856 setreg({n}, {v} [, {opt}]) Number set register to value and type
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2857 settabvar({nr}, {varname}, {val}) none set {varname} in tab page {nr} to {val}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2858 settabwinvar({tabnr}, {winnr}, {varname}, {val})
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2859 none set {varname} in window {winnr} in tab
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2860 page {tabnr} to {val}
15016
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
2861 settagstack({nr}, {dict} [, {action}])
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
2862 Number modify tag stack using {dict}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2863 setwinvar({nr}, {varname}, {val}) none set {varname} in window {nr} to {val}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2864 sha256({string}) String SHA256 checksum of {string}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2865 shellescape({string} [, {special}])
1661
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
2866 String escape {string} for use as shell
985
656853d9c014 updated for version 7.0-111
vimboss
parents: 874
diff changeset
2867 command argument
15062
3a94f7918980 patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents: 15033
diff changeset
2868 shiftwidth([{col}]) Number effective value of 'shiftwidth'
15209
3a99b2e6d136 patch 8.1.0614: placing signs can be complicated
Bram Moolenaar <Bram@vim.org>
parents: 15194
diff changeset
2869 sign_define({name} [, {dict}]) Number define or update a sign
17366
9843fbfa0ee5 patch 8.1.1682: placing a larger number of signs is slow
Bram Moolenaar <Bram@vim.org>
parents: 17292
diff changeset
2870 sign_define({list}) List define or update a list of signs
15209
3a99b2e6d136 patch 8.1.0614: placing signs can be complicated
Bram Moolenaar <Bram@vim.org>
parents: 15194
diff changeset
2871 sign_getdefined([{name}]) List get a list of defined signs
3a99b2e6d136 patch 8.1.0614: placing signs can be complicated
Bram Moolenaar <Bram@vim.org>
parents: 15194
diff changeset
2872 sign_getplaced([{expr} [, {dict}]])
3a99b2e6d136 patch 8.1.0614: placing signs can be complicated
Bram Moolenaar <Bram@vim.org>
parents: 15194
diff changeset
2873 List get a list of placed signs
15418
51b3c36b0523 patch 8.1.0717: there is no function for the ":sign jump" command
Bram Moolenaar <Bram@vim.org>
parents: 15388
diff changeset
2874 sign_jump({id}, {group}, {expr})
51b3c36b0523 patch 8.1.0717: there is no function for the ":sign jump" command
Bram Moolenaar <Bram@vim.org>
parents: 15388
diff changeset
2875 Number jump to a sign
15209
3a99b2e6d136 patch 8.1.0614: placing signs can be complicated
Bram Moolenaar <Bram@vim.org>
parents: 15194
diff changeset
2876 sign_place({id}, {group}, {name}, {expr} [, {dict}])
3a99b2e6d136 patch 8.1.0614: placing signs can be complicated
Bram Moolenaar <Bram@vim.org>
parents: 15194
diff changeset
2877 Number place a sign
17366
9843fbfa0ee5 patch 8.1.1682: placing a larger number of signs is slow
Bram Moolenaar <Bram@vim.org>
parents: 17292
diff changeset
2878 sign_placelist({list}) List place a list of signs
15209
3a99b2e6d136 patch 8.1.0614: placing signs can be complicated
Bram Moolenaar <Bram@vim.org>
parents: 15194
diff changeset
2879 sign_undefine([{name}]) Number undefine a sign
17366
9843fbfa0ee5 patch 8.1.1682: placing a larger number of signs is slow
Bram Moolenaar <Bram@vim.org>
parents: 17292
diff changeset
2880 sign_undefine({list}) List undefine a list of signs
15209
3a99b2e6d136 patch 8.1.0614: placing signs can be complicated
Bram Moolenaar <Bram@vim.org>
parents: 15194
diff changeset
2881 sign_unplace({group} [, {dict}])
3a99b2e6d136 patch 8.1.0614: placing signs can be complicated
Bram Moolenaar <Bram@vim.org>
parents: 15194
diff changeset
2882 Number unplace a sign
17366
9843fbfa0ee5 patch 8.1.1682: placing a larger number of signs is slow
Bram Moolenaar <Bram@vim.org>
parents: 17292
diff changeset
2883 sign_unplacelist({list}) List unplace a list of signs
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2884 simplify({filename}) String simplify filename as much as possible
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2885 sin({expr}) Float sine of {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2886 sinh({expr}) Float hyperbolic sine of {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2887 sort({list} [, {func} [, {dict}]])
2902
69e0783ed0ef updated for version 7.3.224
Bram Moolenaar <bram@vim.org>
parents: 2845
diff changeset
2888 List sort {list}, using {func} to compare
17026
905e1b154058 patch 8.1.1513: all popup functionality is in functions, except :popupclear
Bram Moolenaar <Bram@vim.org>
parents: 17020
diff changeset
2889 sound_clear() none stop playing all sounds
17004
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
2890 sound_playevent({name} [, {callback}])
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
2891 Number play an event sound
17026
905e1b154058 patch 8.1.1513: all popup functionality is in functions, except :popupclear
Bram Moolenaar <Bram@vim.org>
parents: 17020
diff changeset
2892 sound_playfile({path} [, {callback}])
905e1b154058 patch 8.1.1513: all popup functionality is in functions, except :popupclear
Bram Moolenaar <Bram@vim.org>
parents: 17020
diff changeset
2893 Number play sound file {path}
17004
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
2894 sound_stop({id}) none stop playing sound {id}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2895 soundfold({word}) String sound-fold {word}
344
7033303ea0c0 updated for version 7.0089
vimboss
parents: 336
diff changeset
2896 spellbadword() String badly spelled word at cursor
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2897 spellsuggest({word} [, {max} [, {capital}]])
537
e321639cfa3e updated for version 7.0152
vimboss
parents: 532
diff changeset
2898 List spelling suggestions
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2899 split({expr} [, {pat} [, {keepempty}]])
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
2900 List make |List| from {pat} separated {expr}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2901 sqrt({expr}) Float square root of {expr}
18701
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
2902 srand([{expr}]) List get seed for |rand()|
18104
e59ff7b5d7a7 patch 8.1.2047: cannot check the current state
Bram Moolenaar <Bram@vim.org>
parents: 18080
diff changeset
2903 state([{what}]) String current state of Vim
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2904 str2float({expr}) Float convert String to Float
16235
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
2905 str2list({expr} [, {utf8}]) List convert each character of {expr} to
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
2906 ASCII/UTF8 value
18080
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
2907 str2nr({expr} [, {base} [, {quoted}]])
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
2908 Number convert String to Number
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2909 strcharpart({str}, {start} [, {len}])
21935
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
2910 String {len} characters of {str} at
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
2911 character {start}
20687
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
2912 strchars({expr} [, {skipcc}]) Number character length of the String {expr}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2913 strdisplaywidth({expr} [, {col}]) Number display length of the String {expr}
18669
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
2914 strftime({format} [, {time}]) String format time with a specified format
8951
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
2915 strgetchar({str}, {index}) Number get char {index} from {str}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2916 stridx({haystack}, {needle} [, {start}])
133
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
2917 Number index of {needle} in {haystack}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2918 string({expr}) String String representation of {expr} value
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2919 strlen({expr}) Number length of the String {expr}
21935
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
2920 strpart({str}, {start} [, {len} [, {chars}]])
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
2921 String {len} bytes/chars of {str} at
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
2922 byte {start}
18669
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
2923 strptime({format}, {timestring})
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
2924 Number Convert {timestring} to unix timestamp
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2925 strridx({haystack}, {needle} [, {start}])
140
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
2926 Number last index of {needle} in {haystack}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2927 strtrans({expr}) String translate string to make it printable
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2928 strwidth({expr}) Number display cell length of the String {expr}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2929 submatch({nr} [, {list}]) String or List
5794
a63d0cd691dc updated for version 7.4.241
Bram Moolenaar <bram@vim.org>
parents: 5786
diff changeset
2930 specific match in ":s" or substitute()
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2931 substitute({expr}, {pat}, {sub}, {flags})
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2932 String all {pat} in {expr} replaced with {sub}
14599
72d6f6f7ead7 patch 8.1.0313: information about a swap file is unavailable
Christian Brabandt <cb@256bit.org>
parents: 14587
diff changeset
2933 swapinfo({fname}) Dict information about swap file {fname}
14778
20653d6f3d95 patch 8.1.0401: can't get swap name of another buffer
Christian Brabandt <cb@256bit.org>
parents: 14756
diff changeset
2934 swapname({expr}) String swap file of buffer {expr}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2935 synID({lnum}, {col}, {trans}) Number syntax ID at {lnum} and {col}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2936 synIDattr({synID}, {what} [, {mode}])
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2937 String attribute {what} of syntax ID {synID}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2938 synIDtrans({synID}) Number translated syntax ID of {synID}
9536
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
2939 synconcealed({lnum}, {col}) List info about concealing
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2940 synstack({lnum}, {col}) List stack of syntax IDs at {lnum} and {col}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2941 system({expr} [, {input}]) String output of shell command/filter {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2942 systemlist({expr} [, {input}]) List output of shell command/filter {expr}
9344
33c1b85d408c commit https://github.com/vim/vim/commit/802a0d902fca423acb15f835d7b09183883d79a0
Christian Brabandt <cb@256bit.org>
parents: 9286
diff changeset
2943 tabpagebuflist([{arg}]) List list of buffer numbers in tab page
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2944 tabpagenr([{arg}]) Number number of current or last tab page
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2945 tabpagewinnr({tabarg} [, {arg}]) Number number of current window in tab page
20687
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
2946 tagfiles() List tags files used
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2947 taglist({expr} [, {filename}]) List list of tags matching {expr}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2948 tan({expr}) Float tangent of {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
2949 tanh({expr}) Float hyperbolic tangent of {expr}
8577
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
2950 tempname() String name for a temporary file
13298
a88c5e12b860 patch 8.0.1523: cannot write and read terminal screendumps
Christian Brabandt <cb@256bit.org>
parents: 13280
diff changeset
2951 term_dumpdiff({filename}, {filename} [, {options}])
a88c5e12b860 patch 8.0.1523: cannot write and read terminal screendumps
Christian Brabandt <cb@256bit.org>
parents: 13280
diff changeset
2952 Number display difference between two dumps
a88c5e12b860 patch 8.0.1523: cannot write and read terminal screendumps
Christian Brabandt <cb@256bit.org>
parents: 13280
diff changeset
2953 term_dumpload({filename} [, {options}])
a88c5e12b860 patch 8.0.1523: cannot write and read terminal screendumps
Christian Brabandt <cb@256bit.org>
parents: 13280
diff changeset
2954 Number displaying a screen dump
13329
424321d6eea7 patch 8.0.1539: no test for the popup menu positioning
Christian Brabandt <cb@256bit.org>
parents: 13298
diff changeset
2955 term_dumpwrite({buf}, {filename} [, {options}])
13298
a88c5e12b860 patch 8.0.1523: cannot write and read terminal screendumps
Christian Brabandt <cb@256bit.org>
parents: 13280
diff changeset
2956 none dump terminal window contents
12035
a3ed3d236839 patch 8.0.0898: can't use the alternate screen in a terminal window
Christian Brabandt <cb@256bit.org>
parents: 12031
diff changeset
2957 term_getaltscreen({buf}) Number get the alternate screen flag
13626
ab89131d30e0 patch 8.0.1685: can't set ANSI colors of a terminal window
Christian Brabandt <cb@256bit.org>
parents: 13563
diff changeset
2958 term_getansicolors({buf}) List get ANSI palette in GUI color mode
12003
6889f1f25d6b patch 8.0.0882: term_scrape() and term_getline() require two arguments
Christian Brabandt <cb@256bit.org>
parents: 11995
diff changeset
2959 term_getattr({attr}, {what}) Number get the value of attribute {what}
11876
3704ca24c9a2 patch 8.0.0818: cannot get the cursor position of a terminal
Christian Brabandt <cb@256bit.org>
parents: 11874
diff changeset
2960 term_getcursor({buf}) List get the cursor position of a terminal
11846
1c65cad8b967 patch 8.0.0804: terminal window functions not yet implemented
Christian Brabandt <cb@256bit.org>
parents: 11828
diff changeset
2961 term_getjob({buf}) Job get the job associated with a terminal
11904
40322e8f07e7 patch 8.0.0832: terminal function arguments are not consistent
Christian Brabandt <cb@256bit.org>
parents: 11882
diff changeset
2962 term_getline({buf}, {row}) String get a line of text from a terminal
12025
c0ee48f48a2b patch 8.0.0893: cannot get the scroll count of a terminal window
Christian Brabandt <cb@256bit.org>
parents: 12007
diff changeset
2963 term_getscrolled({buf}) Number get the scroll count of a terminal
11846
1c65cad8b967 patch 8.0.0804: terminal window functions not yet implemented
Christian Brabandt <cb@256bit.org>
parents: 11828
diff changeset
2964 term_getsize({buf}) List get the size of a terminal
11882
69e7379f46db patch 8.0.0821: cannot get the title and status of a terminal window
Christian Brabandt <cb@256bit.org>
parents: 11876
diff changeset
2965 term_getstatus({buf}) String get the status of a terminal
69e7379f46db patch 8.0.0821: cannot get the title and status of a terminal window
Christian Brabandt <cb@256bit.org>
parents: 11876
diff changeset
2966 term_gettitle({buf}) String get the title of a terminal
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
2967 term_gettty({buf}, [{input}]) String get the tty name of a terminal
11846
1c65cad8b967 patch 8.0.0804: terminal window functions not yet implemented
Christian Brabandt <cb@256bit.org>
parents: 11828
diff changeset
2968 term_list() List get the list of terminal buffers
11904
40322e8f07e7 patch 8.0.0832: terminal function arguments are not consistent
Christian Brabandt <cb@256bit.org>
parents: 11882
diff changeset
2969 term_scrape({buf}, {row}) List get row of a terminal screen
11846
1c65cad8b967 patch 8.0.0804: terminal window functions not yet implemented
Christian Brabandt <cb@256bit.org>
parents: 11828
diff changeset
2970 term_sendkeys({buf}, {keys}) none send keystrokes to a terminal
13626
ab89131d30e0 patch 8.0.1685: can't set ANSI colors of a terminal window
Christian Brabandt <cb@256bit.org>
parents: 13563
diff changeset
2971 term_setansicolors({buf}, {colors})
ab89131d30e0 patch 8.0.1685: can't set ANSI colors of a terminal window
Christian Brabandt <cb@256bit.org>
parents: 13563
diff changeset
2972 none set ANSI palette in GUI color mode
20687
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
2973 term_setapi({buf}, {expr}) none set |terminal-api| function name prefix
13735
a62eeee5f116 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13678
diff changeset
2974 term_setkill({buf}, {how}) none set signal to stop job in terminal
13437
02b3f719eacb Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13379
diff changeset
2975 term_setrestore({buf}, {command}) none set command to restore terminal
13735
a62eeee5f116 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13678
diff changeset
2976 term_setsize({buf}, {rows}, {cols})
a62eeee5f116 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13678
diff changeset
2977 none set the size of a terminal
16380
5ad204d8a2f2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16366
diff changeset
2978 term_start({cmd} [, {options}]) Number open a terminal window and run a job
12007
64b822c4f7ae patch 8.0.0884: can't specify the wait time for term_wait()
Christian Brabandt <cb@256bit.org>
parents: 12003
diff changeset
2979 term_wait({buf} [, {time}]) Number wait for screen to be updated
20836
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
2980 terminalprops() Dict properties of the terminal
9121
7350959e53c3 commit https://github.com/vim/vim/commit/8e8df251bf2505e5decf258397c6069fbe5e2e01
Christian Brabandt <cb@256bit.org>
parents: 9117
diff changeset
2981 test_alloc_fail({id}, {countdown}, {repeat})
7350959e53c3 commit https://github.com/vim/vim/commit/8e8df251bf2505e5decf258397c6069fbe5e2e01
Christian Brabandt <cb@256bit.org>
parents: 9117
diff changeset
2982 none make memory allocation fail
9644
9f7bcc2c3b97 commit https://github.com/vim/vim/commit/6f1d9a096bf22d50c727dca73abbfb8e3ff55176
Christian Brabandt <cb@256bit.org>
parents: 9636
diff changeset
2983 test_autochdir() none enable 'autochdir' during startup
14864
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
2984 test_feedinput({string}) none add key sequence to input buffer
9108
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
2985 test_garbagecollect_now() none free memory right now for testing
17159
3fd0765f454f patch 8.1.1579: dict and list could be GC'ed while displaying error
Bram Moolenaar <Bram@vim.org>
parents: 17131
diff changeset
2986 test_garbagecollect_soon() none free memory soon for testing
16664
ca1814eeecf5 patch 8.1.1334: when buffer is hidden "F" in 'shortmess' is not used
Bram Moolenaar <Bram@vim.org>
parents: 16660
diff changeset
2987 test_getvalue({string}) any get value of an internal variable
11006
b3601a8eb679 patch 8.0.0392: GUI test fails with Athena and Motif
Christian Brabandt <cb@256bit.org>
parents: 10908
diff changeset
2988 test_ignore_error({expr}) none ignore a specific error
15456
f01eb1aed348 patch 8.1.0736: code for Blob not sufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 15454
diff changeset
2989 test_null_blob() Blob null value for testing
9108
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
2990 test_null_channel() Channel null value for testing
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
2991 test_null_dict() Dict null value for testing
19874
f92435f0f449 patch 8.2.0493: Vim9: some error messages not tested
Bram Moolenaar <Bram@vim.org>
parents: 19870
diff changeset
2992 test_null_function() Funcref null value for testing
9108
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
2993 test_null_job() Job null value for testing
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
2994 test_null_list() List null value for testing
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
2995 test_null_partial() Funcref null value for testing
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
2996 test_null_string() String null value for testing
14945
4ee65b4150fd Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 14864
diff changeset
2997 test_option_not_set({name}) none reset flag indicating option was set
4ee65b4150fd Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 14864
diff changeset
2998 test_override({expr}, {val}) none test with Vim internal overrides
16078
d13aa9c5a1d1 patch 8.1.1044: no way to check the reference count of objects
Bram Moolenaar <Bram@vim.org>
parents: 16019
diff changeset
2999 test_refcount({expr}) Number get the reference count of {expr}
14756
a179e5cfcab7 patch 8.1.0390: scrollbars are not tested
Christian Brabandt <cb@256bit.org>
parents: 14748
diff changeset
3000 test_scrollbar({which}, {value}, {dragging})
a179e5cfcab7 patch 8.1.0390: scrollbars are not tested
Christian Brabandt <cb@256bit.org>
parents: 14748
diff changeset
3001 none scroll in the GUI for testing
16517
9484fc00ac6b patch 8.1.1262: cannot simulate a mouse click in a test
Bram Moolenaar <Bram@vim.org>
parents: 16489
diff changeset
3002 test_setmouse({row}, {col}) none set the mouse position for testing
20687
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
3003 test_settime({expr}) none set current time for testing
19350
76cb39bf1871 patch 8.2.0233: crash when using garbagecollect() in between rand()
Bram Moolenaar <Bram@vim.org>
parents: 19308
diff changeset
3004 test_srand_seed([seed]) none set seed for testing srand()
20687
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
3005 test_unknown() any unknown value for testing
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
3006 test_void() any void value for testing
9790
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
3007 timer_info([{id}]) List information about timers
9810
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
3008 timer_pause({id}, {pause}) none pause or unpause a timer
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3009 timer_start({time}, {callback} [, {options}])
8577
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
3010 Number create a timer
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3011 timer_stop({timer}) none stop a timer
9810
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
3012 timer_stopall() none stop all timers
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3013 tolower({expr}) String the String {expr} switched to lowercase
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3014 toupper({expr}) String the String {expr} switched to uppercase
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3015 tr({src}, {fromstr}, {tostr}) String translate chars of {src} in {fromstr}
15
631143ac4a01 updated for version 7.0007
vimboss
parents: 14
diff changeset
3016 to chars in {tostr}
20629
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
3017 trim({text} [, {mask} [, {dir}]])
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
3018 String trim characters in {mask} from {text}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3019 trunc({expr}) Float truncate Float {expr}
23594
d3e064f54890 patch 8.2.2339: cannot get the type of a value as a string
Bram Moolenaar <Bram@vim.org>
parents: 23588
diff changeset
3020 type({expr}) Number type of value {expr}
d3e064f54890 patch 8.2.2339: cannot get the type of a value as a string
Bram Moolenaar <Bram@vim.org>
parents: 23588
diff changeset
3021 typename({expr}) String representation of the type of {expr}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3022 undofile({name}) String undo file name for {name}
2280
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
3023 undotree() List undo file tree
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3024 uniq({list} [, {func} [, {dict}]])
5747
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
3025 List remove adjacent duplicates from a list
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3026 values({dict}) List values in {dict}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3027 virtcol({expr}) Number screen column of cursor or mark
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3028 visualmode([expr]) String last visual mode used
4151
13170a796134 updated for version 7.3.828
Bram Moolenaar <bram@vim.org>
parents: 4126
diff changeset
3029 wildmenumode() Number whether 'wildmenu' mode is active
16833
6699c03347d2 patch 8.1.1418: win_execute() is not implemented yet
Bram Moolenaar <Bram@vim.org>
parents: 16808
diff changeset
3030 win_execute({id}, {command} [, {silent}])
6699c03347d2 patch 8.1.1418: win_execute() is not implemented yet
Bram Moolenaar <Bram@vim.org>
parents: 16808
diff changeset
3031 String execute {command} in window {id}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3032 win_findbuf({bufnr}) List find windows containing {bufnr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3033 win_getid([{win} [, {tab}]]) Number get window ID for {win} in {tab}
20115
bd021eb62e73 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20037
diff changeset
3034 win_gettype([{nr}]) String type of window {nr}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3035 win_gotoid({expr}) Number go to window with ID {expr}
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3036 win_id2tabwin({expr}) List get tab and window nr from window ID
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3037 win_id2win({expr}) Number get window nr from window ID
12977
2d817fd289ba patch 8.0.1364: there is no easy way to get the window position
Christian Brabandt <cb@256bit.org>
parents: 12968
diff changeset
3038 win_screenpos({nr}) List get screen position of window {nr}
18049
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
3039 win_splitmove({nr}, {target} [, {options}])
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
3040 Number move window {nr} to split of {target}
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3041 winbufnr({nr}) Number buffer number of window {nr}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3042 wincol() Number window column of the cursor
20552
74e3316c1d5a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20522
diff changeset
3043 windowsversion() String MS-Windows OS version
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3044 winheight({nr}) Number height of window {nr}
14587
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
3045 winlayout([{tabnr}]) List layout of windows in tab {tabnr}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3046 winline() Number window line of the cursor
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3047 winnr([{expr}]) Number number of current window
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
3048 winrestcmd() String returns command to restore window sizes
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3049 winrestview({dict}) none restore view of current window
712
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
3050 winsaveview() Dict save view of current window
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
3051 winwidth({nr}) Number width of window {nr}
7480
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
3052 wordcount() Dict get byte/char/word statistics
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
3053 writefile({object}, {fname} [, {flags}])
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
3054 Number write |Blob| or |List| of lines to file
9536
b2aada04d84e commit https://github.com/vim/vim/commit/a06ecab7a5159e744448ace731036f0dc5f87dd4
Christian Brabandt <cb@256bit.org>
parents: 9527
diff changeset
3055 xor({expr}, {expr}) Number bitwise XOR
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3056
8876
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
3057
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3058 abs({expr}) *abs()*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3059 Return the absolute value of {expr}. When {expr} evaluates to
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3060 a |Float| abs() returns a |Float|. When {expr} can be
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3061 converted to a |Number| abs() returns a |Number|. Otherwise
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3062 abs() gives an error message and returns -1.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3063 Examples: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3064 echo abs(1.456)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3065 < 1.456 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3066 echo abs(-5.456)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3067 < 5.456 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3068 echo abs(-4)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3069 < 4
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3070
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3071 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3072 Compute()->abs()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3073
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3074 < {only available when compiled with the |+float| feature}
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3075
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3076
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3077 acos({expr}) *acos()*
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3078 Return the arc cosine of {expr} measured in radians, as a
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
3079 |Float| in the range of [0, pi].
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
3080 {expr} must evaluate to a |Float| or a |Number| in the range
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3081 [-1, 1].
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3082 Examples: >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3083 :echo acos(0)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3084 < 1.570796 >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3085 :echo acos(-0.5)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3086 < 2.094395
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3087
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3088 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3089 Compute()->acos()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3090
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3091 < {only available when compiled with the |+float| feature}
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3092
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3093
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
3094 add({object}, {expr}) *add()*
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
3095 Append the item {expr} to |List| or |Blob| {object}. Returns
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
3096 the resulting |List| or |Blob|. Examples: >
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
3097 :let alist = add([1, 2, 3], item)
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
3098 :call add(mylist, "woodstock")
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
3099 < Note that when {expr} is a |List| it is appended as a single
692
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
3100 item. Use |extend()| to concatenate |Lists|.
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
3101 When {object} is a |Blob| then {expr} must be a number.
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
3102 Use |insert()| to add an item at another position.
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3103
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
3104 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
3105 mylist->add(val1)->add(val2)
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
3106
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
3107
3214
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
3108 and({expr}, {expr}) *and()*
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
3109 Bitwise AND on the two arguments. The arguments are converted
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
3110 to a number. A List, Dict or Float argument causes an error.
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
3111 Example: >
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
3112 :let flag = and(bits, 0x80)
17783
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3113 < Can also be used as a |method|: >
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3114 :let flag = bits->and(0x80)
3214
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
3115
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
3116
14864
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
3117 append({lnum}, {text}) *append()*
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
3118 When {text} is a |List|: Append each item of the |List| as a
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
3119 text line below line {lnum} in the current buffer.
14864
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
3120 Otherwise append {text} as one text line below line {lnum} in
153
19670b05ee32 updated for version 7.0047
vimboss
parents: 148
diff changeset
3121 the current buffer.
19670b05ee32 updated for version 7.0047
vimboss
parents: 148
diff changeset
3122 {lnum} can be zero to insert a line before the first one.
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
3123 Returns 1 for failure ({lnum} out of range or out of memory),
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
3124 0 for success. Example: >
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
3125 :let failed = append(line('$'), "# THE END")
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
3126 :let failed = append(0, ["Chapter 1", "the beginning"])
14039
acb2dc112b06 patch 8.1.0037: cannot easily append lines to another buffer
Christian Brabandt <cb@256bit.org>
parents: 14019
diff changeset
3127
21250
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
3128 < Can also be used as a |method| after a List, the base is
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
3129 passed as the second argument: >
17620
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
3130 mylist->append(lnum)
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
3131
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
3132
14039
acb2dc112b06 patch 8.1.0037: cannot easily append lines to another buffer
Christian Brabandt <cb@256bit.org>
parents: 14019
diff changeset
3133 appendbufline({expr}, {lnum}, {text}) *appendbufline()*
acb2dc112b06 patch 8.1.0037: cannot easily append lines to another buffer
Christian Brabandt <cb@256bit.org>
parents: 14019
diff changeset
3134 Like |append()| but append the text in buffer {expr}.
acb2dc112b06 patch 8.1.0037: cannot easily append lines to another buffer
Christian Brabandt <cb@256bit.org>
parents: 14019
diff changeset
3135
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
3136 This function works only for loaded buffers. First call
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
3137 |bufload()| if needed.
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
3138
14039
acb2dc112b06 patch 8.1.0037: cannot easily append lines to another buffer
Christian Brabandt <cb@256bit.org>
parents: 14019
diff changeset
3139 For the use of {expr}, see |bufname()|.
acb2dc112b06 patch 8.1.0037: cannot easily append lines to another buffer
Christian Brabandt <cb@256bit.org>
parents: 14019
diff changeset
3140
acb2dc112b06 patch 8.1.0037: cannot easily append lines to another buffer
Christian Brabandt <cb@256bit.org>
parents: 14019
diff changeset
3141 {lnum} is used like with |append()|. Note that using |line()|
acb2dc112b06 patch 8.1.0037: cannot easily append lines to another buffer
Christian Brabandt <cb@256bit.org>
parents: 14019
diff changeset
3142 would use the current buffer, not the one appending to.
acb2dc112b06 patch 8.1.0037: cannot easily append lines to another buffer
Christian Brabandt <cb@256bit.org>
parents: 14019
diff changeset
3143 Use "$" to append at the end of the buffer.
acb2dc112b06 patch 8.1.0037: cannot easily append lines to another buffer
Christian Brabandt <cb@256bit.org>
parents: 14019
diff changeset
3144
acb2dc112b06 patch 8.1.0037: cannot easily append lines to another buffer
Christian Brabandt <cb@256bit.org>
parents: 14019
diff changeset
3145 On success 0 is returned, on failure 1 is returned.
acb2dc112b06 patch 8.1.0037: cannot easily append lines to another buffer
Christian Brabandt <cb@256bit.org>
parents: 14019
diff changeset
3146
acb2dc112b06 patch 8.1.0037: cannot easily append lines to another buffer
Christian Brabandt <cb@256bit.org>
parents: 14019
diff changeset
3147 If {expr} is not a valid buffer or {lnum} is not valid, an
acb2dc112b06 patch 8.1.0037: cannot easily append lines to another buffer
Christian Brabandt <cb@256bit.org>
parents: 14019
diff changeset
3148 error message is given. Example: >
acb2dc112b06 patch 8.1.0037: cannot easily append lines to another buffer
Christian Brabandt <cb@256bit.org>
parents: 14019
diff changeset
3149 :let failed = appendbufline(13, 0, "# THE START")
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
3150 <
22723
5b7ea82bc18f Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22689
diff changeset
3151 Can also be used as a |method| after a List, the base is
21250
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
3152 passed as the second argument: >
17620
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
3153 mylist->appendbufline(buf, lnum)
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
3154
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
3155
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
3156 argc([{winid}]) *argc()*
14964
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
3157 The result is the number of files in the argument list. See
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
3158 |arglist|.
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
3159 If {winid} is not supplied, the argument list of the current
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
3160 window is used.
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
3161 If {winid} is -1, the global argument list is used.
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
3162 Otherwise {winid} specifies the window of which the argument
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
3163 list is used: either the window number or the window ID.
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
3164 Returns -1 if the {winid} argument is invalid.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3165
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3166 *argidx()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3167 argidx() The result is the current index in the argument list. 0 is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3168 the first file. argc() - 1 is the last one. See |arglist|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3169
5942
66eead134d68 updated for version 7.4.312
Bram Moolenaar <bram@vim.org>
parents: 5940
diff changeset
3170 *arglistid()*
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 8094
diff changeset
3171 arglistid([{winnr} [, {tabnr}]])
5942
66eead134d68 updated for version 7.4.312
Bram Moolenaar <bram@vim.org>
parents: 5940
diff changeset
3172 Return the argument list ID. This is a number which
66eead134d68 updated for version 7.4.312
Bram Moolenaar <bram@vim.org>
parents: 5940
diff changeset
3173 identifies the argument list being used. Zero is used for the
6153
1e8ebf870720 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6110
diff changeset
3174 global argument list. See |arglist|.
14964
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
3175 Returns -1 if the arguments are invalid.
5942
66eead134d68 updated for version 7.4.312
Bram Moolenaar <bram@vim.org>
parents: 5940
diff changeset
3176
66eead134d68 updated for version 7.4.312
Bram Moolenaar <bram@vim.org>
parents: 5940
diff changeset
3177 Without arguments use the current window.
66eead134d68 updated for version 7.4.312
Bram Moolenaar <bram@vim.org>
parents: 5940
diff changeset
3178 With {winnr} only use this window in the current tab page.
66eead134d68 updated for version 7.4.312
Bram Moolenaar <bram@vim.org>
parents: 5940
diff changeset
3179 With {winnr} and {tabnr} use the window in the specified tab
66eead134d68 updated for version 7.4.312
Bram Moolenaar <bram@vim.org>
parents: 5940
diff changeset
3180 page.
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
3181 {winnr} can be the window number or the |window-ID|.
5942
66eead134d68 updated for version 7.4.312
Bram Moolenaar <bram@vim.org>
parents: 5940
diff changeset
3182
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3183 *argv()*
20241
56265f711890 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20178
diff changeset
3184 argv([{nr} [, {winid}]])
14964
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
3185 The result is the {nr}th file in the argument list. See
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
3186 |arglist|. "argv(0)" is the first one. Example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3187 :let i = 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3188 :while i < argc()
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3189 : let f = escape(fnameescape(argv(i)), '.')
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3190 : exe 'amenu Arg.' . f . ' :e ' . f . '<CR>'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3191 : let i = i + 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3192 :endwhile
14964
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
3193 < Without the {nr} argument, or when {nr} is -1, a |List| with
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
3194 the whole |arglist| is returned.
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
3195
2c0bfa167468 patch 8.1.0493: argv() and argc() only work on the current argument list
Bram Moolenaar <Bram@vim.org>
parents: 14945
diff changeset
3196 The {winid} argument specifies the window ID, see |argc()|.
18477
e93cab5d0f0f patch 8.1.2233: cannot get the Vim command line arguments
Bram Moolenaar <Bram@vim.org>
parents: 18463
diff changeset
3197 For the Vim command line arguments see |v:argv|.
818
1f929f3ca806 updated for version 7.0c03
vimboss
parents: 810
diff changeset
3198
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3199 asin({expr}) *asin()*
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
3200 Return the arc sine of {expr} measured in radians, as a |Float|
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3201 in the range of [-pi/2, pi/2].
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
3202 {expr} must evaluate to a |Float| or a |Number| in the range
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3203 [-1, 1].
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3204 Examples: >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3205 :echo asin(0.8)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3206 < 0.927295 >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3207 :echo asin(-0.5)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3208 < -0.523599
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3209
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3210 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3211 Compute()->asin()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3212 <
2570
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2569
diff changeset
3213 {only available when compiled with the |+float| feature}
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3214
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3215
19099
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
3216 assert_ functions are documented here: |assert-functions-details|
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
3217
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
3218
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
3219
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3220 atan({expr}) *atan()*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3221 Return the principal value of the arc tangent of {expr}, in
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3222 the range [-pi/2, +pi/2] radians, as a |Float|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3223 {expr} must evaluate to a |Float| or a |Number|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3224 Examples: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3225 :echo atan(100)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3226 < 1.560797 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3227 :echo atan(-4.01)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3228 < -1.326405
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3229
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3230 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3231 Compute()->atan()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3232 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3233 {only available when compiled with the |+float| feature}
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3234
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3235
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3236 atan2({expr1}, {expr2}) *atan2()*
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3237 Return the arc tangent of {expr1} / {expr2}, measured in
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
3238 radians, as a |Float| in the range [-pi, pi].
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
3239 {expr1} and {expr2} must evaluate to a |Float| or a |Number|.
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3240 Examples: >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3241 :echo atan2(-1, 1)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3242 < -0.785398 >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3243 :echo atan2(1, -1)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3244 < 2.356194
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3245
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3246 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3247 Compute()->atan(1)
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3248 <
2570
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2569
diff changeset
3249 {only available when compiled with the |+float| feature}
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3250
16600
ff3c99bd1038 patch 8.1.1303: not possible to hide a balloon
Bram Moolenaar <Bram@vim.org>
parents: 16576
diff changeset
3251 balloon_gettext() *balloon_gettext()*
ff3c99bd1038 patch 8.1.1303: not possible to hide a balloon
Bram Moolenaar <Bram@vim.org>
parents: 16576
diff changeset
3252 Return the current text in the balloon. Only for the string,
ff3c99bd1038 patch 8.1.1303: not possible to hide a balloon
Bram Moolenaar <Bram@vim.org>
parents: 16576
diff changeset
3253 not used for the List.
ff3c99bd1038 patch 8.1.1303: not possible to hide a balloon
Bram Moolenaar <Bram@vim.org>
parents: 16576
diff changeset
3254
12883
058e93aee621 patch 8.0.1318: terminal balloon only shows one line
Christian Brabandt <cb@256bit.org>
parents: 12857
diff changeset
3255 balloon_show({expr}) *balloon_show()*
058e93aee621 patch 8.0.1318: terminal balloon only shows one line
Christian Brabandt <cb@256bit.org>
parents: 12857
diff changeset
3256 Show {expr} inside the balloon. For the GUI {expr} is used as
058e93aee621 patch 8.0.1318: terminal balloon only shows one line
Christian Brabandt <cb@256bit.org>
parents: 12857
diff changeset
3257 a string. For a terminal {expr} can be a list, which contains
058e93aee621 patch 8.0.1318: terminal balloon only shows one line
Christian Brabandt <cb@256bit.org>
parents: 12857
diff changeset
3258 the lines of the balloon. If {expr} is not a list it will be
058e93aee621 patch 8.0.1318: terminal balloon only shows one line
Christian Brabandt <cb@256bit.org>
parents: 12857
diff changeset
3259 split with |balloon_split()|.
16600
ff3c99bd1038 patch 8.1.1303: not possible to hide a balloon
Bram Moolenaar <Bram@vim.org>
parents: 16576
diff changeset
3260 If {expr} is an empty string any existing balloon is removed.
12883
058e93aee621 patch 8.0.1318: terminal balloon only shows one line
Christian Brabandt <cb@256bit.org>
parents: 12857
diff changeset
3261
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3262 Example: >
11014
fb2bcfa6a8de patch 8.0.0396: 'balloonexpr' only works synchronously
Christian Brabandt <cb@256bit.org>
parents: 11006
diff changeset
3263 func GetBalloonContent()
16600
ff3c99bd1038 patch 8.1.1303: not possible to hide a balloon
Bram Moolenaar <Bram@vim.org>
parents: 16576
diff changeset
3264 " ... initiate getting the content
11014
fb2bcfa6a8de patch 8.0.0396: 'balloonexpr' only works synchronously
Christian Brabandt <cb@256bit.org>
parents: 11006
diff changeset
3265 return ''
fb2bcfa6a8de patch 8.0.0396: 'balloonexpr' only works synchronously
Christian Brabandt <cb@256bit.org>
parents: 11006
diff changeset
3266 endfunc
fb2bcfa6a8de patch 8.0.0396: 'balloonexpr' only works synchronously
Christian Brabandt <cb@256bit.org>
parents: 11006
diff changeset
3267 set balloonexpr=GetBalloonContent()
fb2bcfa6a8de patch 8.0.0396: 'balloonexpr' only works synchronously
Christian Brabandt <cb@256bit.org>
parents: 11006
diff changeset
3268
fb2bcfa6a8de patch 8.0.0396: 'balloonexpr' only works synchronously
Christian Brabandt <cb@256bit.org>
parents: 11006
diff changeset
3269 func BalloonCallback(result)
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3270 call balloon_show(a:result)
11014
fb2bcfa6a8de patch 8.0.0396: 'balloonexpr' only works synchronously
Christian Brabandt <cb@256bit.org>
parents: 11006
diff changeset
3271 endfunc
17783
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3272 < Can also be used as a |method|: >
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3273 GetText()->balloon_show()
11014
fb2bcfa6a8de patch 8.0.0396: 'balloonexpr' only works synchronously
Christian Brabandt <cb@256bit.org>
parents: 11006
diff changeset
3274 <
fb2bcfa6a8de patch 8.0.0396: 'balloonexpr' only works synchronously
Christian Brabandt <cb@256bit.org>
parents: 11006
diff changeset
3275 The intended use is that fetching the content of the balloon
fb2bcfa6a8de patch 8.0.0396: 'balloonexpr' only works synchronously
Christian Brabandt <cb@256bit.org>
parents: 11006
diff changeset
3276 is initiated from 'balloonexpr'. It will invoke an
fb2bcfa6a8de patch 8.0.0396: 'balloonexpr' only works synchronously
Christian Brabandt <cb@256bit.org>
parents: 11006
diff changeset
3277 asynchronous method, in which a callback invokes
fb2bcfa6a8de patch 8.0.0396: 'balloonexpr' only works synchronously
Christian Brabandt <cb@256bit.org>
parents: 11006
diff changeset
3278 balloon_show(). The 'balloonexpr' itself can return an
fb2bcfa6a8de patch 8.0.0396: 'balloonexpr' only works synchronously
Christian Brabandt <cb@256bit.org>
parents: 11006
diff changeset
3279 empty string or a placeholder.
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3280
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3281 When showing a balloon is not possible nothing happens, no
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3282 error message.
14864
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
3283 {only available when compiled with the |+balloon_eval| or
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
3284 |+balloon_eval_term| feature}
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3285
12883
058e93aee621 patch 8.0.1318: terminal balloon only shows one line
Christian Brabandt <cb@256bit.org>
parents: 12857
diff changeset
3286 balloon_split({msg}) *balloon_split()*
058e93aee621 patch 8.0.1318: terminal balloon only shows one line
Christian Brabandt <cb@256bit.org>
parents: 12857
diff changeset
3287 Split {msg} into lines to be displayed in a balloon. The
058e93aee621 patch 8.0.1318: terminal balloon only shows one line
Christian Brabandt <cb@256bit.org>
parents: 12857
diff changeset
3288 splits are made for the current window size and optimize to
058e93aee621 patch 8.0.1318: terminal balloon only shows one line
Christian Brabandt <cb@256bit.org>
parents: 12857
diff changeset
3289 show debugger output.
058e93aee621 patch 8.0.1318: terminal balloon only shows one line
Christian Brabandt <cb@256bit.org>
parents: 12857
diff changeset
3290 Returns a |List| with the split lines.
17783
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3291 Can also be used as a |method|: >
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3292 GetText()->balloon_split()->balloon_show()
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3293
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3294 < {only available when compiled with the |+balloon_eval_term|
12885
10cb5c3df3f5 patch 8.0.1319: can't build GUI on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 12883
diff changeset
3295 feature}
12883
058e93aee621 patch 8.0.1318: terminal balloon only shows one line
Christian Brabandt <cb@256bit.org>
parents: 12857
diff changeset
3296
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3297 *browse()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3298 browse({save}, {title}, {initdir}, {default})
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3299 Put up a file requester. This only works when "has("browse")"
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
3300 returns |TRUE| (only in some GUI versions).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3301 The input fields are:
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
3302 {save} when |TRUE|, select file to write
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3303 {title} title for the requester
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3304 {initdir} directory to start browsing in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3305 {default} default file name
17783
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3306 An empty string is returned when the "Cancel" button is hit,
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3307 something went wrong, or browsing is not possible.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3308
29
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
3309 *browsedir()*
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
3310 browsedir({title}, {initdir})
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
3311 Put up a directory requester. This only works when
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
3312 "has("browse")" returns |TRUE| (only in some GUI versions).
29
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
3313 On systems where a directory browser is not supported a file
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
3314 browser is used. In that case: select a file in the directory
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
3315 to be used.
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
3316 The input fields are:
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
3317 {title} title for the requester
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
3318 {initdir} directory to start browsing in
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
3319 When the "Cancel" button is hit, something went wrong, or
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
3320 browsing is not possible, an empty string is returned.
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
3321
17221
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3322 bufadd({name}) *bufadd()*
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3323 Add a buffer to the buffer list with {name}.
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3324 If a buffer for file {name} already exists, return that buffer
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3325 number. Otherwise return the buffer number of the newly
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3326 created buffer. When {name} is an empty string then a new
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3327 buffer is always created.
18000
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
3328 The buffer will not have 'buflisted' set and not be loaded
17253
26e0352613ec patch 8.1.1626: no test for closing a popup window with a modified buffer
Bram Moolenaar <Bram@vim.org>
parents: 17221
diff changeset
3329 yet. To add some text to the buffer use this: >
26e0352613ec patch 8.1.1626: no test for closing a popup window with a modified buffer
Bram Moolenaar <Bram@vim.org>
parents: 17221
diff changeset
3330 let bufnr = bufadd('someName')
26e0352613ec patch 8.1.1626: no test for closing a popup window with a modified buffer
Bram Moolenaar <Bram@vim.org>
parents: 17221
diff changeset
3331 call bufload(bufnr)
26e0352613ec patch 8.1.1626: no test for closing a popup window with a modified buffer
Bram Moolenaar <Bram@vim.org>
parents: 17221
diff changeset
3332 call setbufline(bufnr, 1, ['some', 'text'])
17783
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3333 < Can also be used as a |method|: >
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3334 let bufnr = 'somename'->bufadd()
17221
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3335
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3336 bufexists({expr}) *bufexists()*
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
3337 The result is a Number, which is |TRUE| if a buffer called
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3338 {expr} exists.
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
3339 If the {expr} argument is a number, buffer numbers are used.
12909
1578c0ba0dd1 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12885
diff changeset
3340 Number zero is the alternate buffer for the current window.
1578c0ba0dd1 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12885
diff changeset
3341
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3342 If the {expr} argument is a string it must match a buffer name
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
3343 exactly. The name can be:
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
3344 - Relative to the current directory.
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
3345 - A full path.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3346 - The name of a buffer with 'buftype' set to "nofile".
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
3347 - A URL name.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3348 Unlisted buffers will be found.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3349 Note that help files are listed by their short name in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3350 output of |:buffers|, but bufexists() requires using their
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3351 long name to be able to find them.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3352 bufexists() may report a buffer exists, but to use the name
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3353 with a |:buffer| command you may need to use |expand()|. Esp
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3354 for MS-Windows 8.3 names in the form "c:\DOCUME~1"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3355 Use "bufexists(0)" to test for the existence of an alternate
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3356 file name.
17783
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3357
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3358 Can also be used as a |method|: >
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3359 let exists = 'somename'->bufexists()
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3360 <
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3361 Obsolete name: buffer_exists(). *buffer_exists()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3362
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3363 buflisted({expr}) *buflisted()*
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
3364 The result is a Number, which is |TRUE| if a buffer called
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3365 {expr} exists and is listed (has the 'buflisted' option set).
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
3366 The {expr} argument is used like with |bufexists()|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3367
17783
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3368 Can also be used as a |method|: >
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3369 let listed = 'somename'->buflisted()
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3370
17221
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3371 bufload({expr}) *bufload()*
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3372 Ensure the buffer {expr} is loaded. When the buffer name
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3373 refers to an existing file then the file is read. Otherwise
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3374 the buffer will be empty. If the buffer was already loaded
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3375 then there is no change.
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3376 If there is an existing swap file for the file of the buffer,
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3377 there will be no dialog, the buffer will be loaded anyway.
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3378 The {expr} argument is used like with |bufexists()|.
a8fc7d97b54d patch 8.1.1610: there is no way to add or load a buffer without side effects
Bram Moolenaar <Bram@vim.org>
parents: 17172
diff changeset
3379
17783
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3380 Can also be used as a |method|: >
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3381 eval 'somename'->bufload()
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3382
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3383 bufloaded({expr}) *bufloaded()*
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
3384 The result is a Number, which is |TRUE| if a buffer called
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3385 {expr} exists and is loaded (shown in a window or hidden).
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
3386 The {expr} argument is used like with |bufexists()|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3387
17783
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3388 Can also be used as a |method|: >
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3389 let loaded = 'somename'->bufloaded()
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3390
17855
285f7a700185 patch 8.1.1924: using empty string for current buffer is unexpected
Bram Moolenaar <Bram@vim.org>
parents: 17849
diff changeset
3391 bufname([{expr}]) *bufname()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3392 The result is the name of a buffer, as it is displayed by the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3393 ":ls" command.
17855
285f7a700185 patch 8.1.1924: using empty string for current buffer is unexpected
Bram Moolenaar <Bram@vim.org>
parents: 17849
diff changeset
3394 If {expr} is omitted the current buffer is used.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3395 If {expr} is a Number, that buffer number's name is given.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3396 Number zero is the alternate buffer for the current window.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3397 If {expr} is a String, it is used as a |file-pattern| to match
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
3398 with the buffer names. This is always done like 'magic' is
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3399 set and 'cpoptions' is empty. When there is more than one
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3400 match an empty string is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3401 "" or "%" can be used for the current buffer, "#" for the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3402 alternate buffer.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3403 A full match is preferred, otherwise a match at the start, end
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
3404 or middle of the buffer name is accepted. If you only want a
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
3405 full match then put "^" at the start and "$" at the end of the
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
3406 pattern.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3407 Listed buffers are found first. If there is a single match
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3408 with a listed buffer, that one is returned. Next unlisted
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3409 buffers are searched for.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3410 If the {expr} is a String, but you want to use it as a buffer
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3411 number, force it to be a Number by adding zero to it: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3412 :echo bufname("3" + 0)
17783
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3413 < Can also be used as a |method|: >
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3414 echo bufnr->bufname()
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3415
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3416 < If the buffer doesn't exist, or doesn't have a name, an empty
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3417 string is returned. >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3418 bufname("#") alternate buffer name
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3419 bufname(3) name of buffer 3
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3420 bufname("%") name of current buffer
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3421 bufname("file2") name of buffer where "file2" matches.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3422 < *buffer_name()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3423 Obsolete name: buffer_name().
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3424
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3425 *bufnr()*
17855
285f7a700185 patch 8.1.1924: using empty string for current buffer is unexpected
Bram Moolenaar <Bram@vim.org>
parents: 17849
diff changeset
3426 bufnr([{expr} [, {create}]])
707
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
3427 The result is the number of a buffer, as it is displayed by
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3428 the ":ls" command. For the use of {expr}, see |bufname()|
707
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
3429 above.
18170
4ac8161e92e0 patch 8.1.2080: the terminal API is limited and can't be disabled
Bram Moolenaar <Bram@vim.org>
parents: 18130
diff changeset
3430
707
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
3431 If the buffer doesn't exist, -1 is returned. Or, if the
22171
d4c7b3e9cd17 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22077
diff changeset
3432 {create} argument is present and TRUE, a new, unlisted,
18170
4ac8161e92e0 patch 8.1.2080: the terminal API is limited and can't be disabled
Bram Moolenaar <Bram@vim.org>
parents: 18130
diff changeset
3433 buffer is created and its number is returned. Example: >
4ac8161e92e0 patch 8.1.2080: the terminal API is limited and can't be disabled
Bram Moolenaar <Bram@vim.org>
parents: 18130
diff changeset
3434 let newbuf = bufnr('Scratch001', 1)
4ac8161e92e0 patch 8.1.2080: the terminal API is limited and can't be disabled
Bram Moolenaar <Bram@vim.org>
parents: 18130
diff changeset
3435 < Using an empty name uses the current buffer. To create a new
4ac8161e92e0 patch 8.1.2080: the terminal API is limited and can't be disabled
Bram Moolenaar <Bram@vim.org>
parents: 18130
diff changeset
3436 buffer with an empty name use |bufadd()|.
4ac8161e92e0 patch 8.1.2080: the terminal API is limited and can't be disabled
Bram Moolenaar <Bram@vim.org>
parents: 18130
diff changeset
3437
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3438 bufnr("$") is the last buffer: >
17855
285f7a700185 patch 8.1.1924: using empty string for current buffer is unexpected
Bram Moolenaar <Bram@vim.org>
parents: 17849
diff changeset
3439 :let last_buffer = bufnr("$")
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3440 < The result is a Number, which is the highest buffer number
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3441 of existing buffers. Note that not all buffers with a smaller
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3442 number necessarily exist, because ":bwipeout" may have removed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3443 them. Use bufexists() to test for the existence of a buffer.
17783
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3444
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3445 Can also be used as a |method|: >
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3446 echo bufref->bufnr()
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3447 <
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
3448 Obsolete name: buffer_number(). *buffer_number()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3449 *last_buffer_nr()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3450 Obsolete name for bufnr("$"): last_buffer_nr().
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3451
9219
7363f5cc4cb8 commit https://github.com/vim/vim/commit/b3619a90eae2702553ff9494ecc4c9b20c13c224
Christian Brabandt <cb@256bit.org>
parents: 9121
diff changeset
3452 bufwinid({expr}) *bufwinid()*
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
3453 The result is a Number, which is the |window-ID| of the first
9219
7363f5cc4cb8 commit https://github.com/vim/vim/commit/b3619a90eae2702553ff9494ecc4c9b20c13c224
Christian Brabandt <cb@256bit.org>
parents: 9121
diff changeset
3454 window associated with buffer {expr}. For the use of {expr},
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
3455 see |bufname()| above. If buffer {expr} doesn't exist or
9219
7363f5cc4cb8 commit https://github.com/vim/vim/commit/b3619a90eae2702553ff9494ecc4c9b20c13c224
Christian Brabandt <cb@256bit.org>
parents: 9121
diff changeset
3456 there is no such window, -1 is returned. Example: >
7363f5cc4cb8 commit https://github.com/vim/vim/commit/b3619a90eae2702553ff9494ecc4c9b20c13c224
Christian Brabandt <cb@256bit.org>
parents: 9121
diff changeset
3457
7363f5cc4cb8 commit https://github.com/vim/vim/commit/b3619a90eae2702553ff9494ecc4c9b20c13c224
Christian Brabandt <cb@256bit.org>
parents: 9121
diff changeset
3458 echo "A window containing buffer 1 is " . (bufwinid(1))
7363f5cc4cb8 commit https://github.com/vim/vim/commit/b3619a90eae2702553ff9494ecc4c9b20c13c224
Christian Brabandt <cb@256bit.org>
parents: 9121
diff changeset
3459 <
7363f5cc4cb8 commit https://github.com/vim/vim/commit/b3619a90eae2702553ff9494ecc4c9b20c13c224
Christian Brabandt <cb@256bit.org>
parents: 9121
diff changeset
3460 Only deals with the current tab page.
7363f5cc4cb8 commit https://github.com/vim/vim/commit/b3619a90eae2702553ff9494ecc4c9b20c13c224
Christian Brabandt <cb@256bit.org>
parents: 9121
diff changeset
3461
17825
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
3462 Can also be used as a |method|: >
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
3463 FindBuffer()->bufwinid()
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
3464
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3465 bufwinnr({expr}) *bufwinnr()*
17825
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
3466 Like |bufwinid()| but return the window number instead of the
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
3467 |window-ID|.
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
3468 If buffer {expr} doesn't exist or there is no such window, -1
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
3469 is returned. Example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3470
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3471 echo "A window containing buffer 1 is " . (bufwinnr(1))
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3472
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3473 < The number can be used with |CTRL-W_w| and ":wincmd w"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3474 |:wincmd|.
17825
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
3475
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
3476 Can also be used as a |method|: >
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
3477 FindBuffer()->bufwinnr()
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3478
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3479 byte2line({byte}) *byte2line()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3480 Return the line number that contains the character at byte
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3481 count {byte} in the current buffer. This includes the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3482 end-of-line character, depending on the 'fileformat' option
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3483 for the current buffer. The first character has byte count
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3484 one.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3485 Also see |line2byte()|, |go| and |:goto|.
17829
1090d6637cfd patch 8.1.1911: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17825
diff changeset
3486
1090d6637cfd patch 8.1.1911: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17825
diff changeset
3487 Can also be used as a |method|: >
1090d6637cfd patch 8.1.1911: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17825
diff changeset
3488 GetOffset()->byte2line()
1090d6637cfd patch 8.1.1911: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17825
diff changeset
3489
1090d6637cfd patch 8.1.1911: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17825
diff changeset
3490 < {not available when compiled without the |+byte_offset|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3491 feature}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3492
18
293621502c4d updated for version 7.0010
vimboss
parents: 15
diff changeset
3493 byteidx({expr}, {nr}) *byteidx()*
293621502c4d updated for version 7.0010
vimboss
parents: 15
diff changeset
3494 Return byte index of the {nr}'th character in the string
21935
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
3495 {expr}. Use zero for the first character, it then returns
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
3496 zero.
22958
e7c125224b1a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22862
diff changeset
3497 If there are no multibyte characters the returned value is
e7c125224b1a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22862
diff changeset
3498 equal to {nr}.
5413
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3499 Composing characters are not counted separately, their byte
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3500 length is added to the preceding base character. See
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3501 |byteidxcomp()| below for counting composing characters
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3502 separately.
18
293621502c4d updated for version 7.0010
vimboss
parents: 15
diff changeset
3503 Example : >
293621502c4d updated for version 7.0010
vimboss
parents: 15
diff changeset
3504 echo matchstr(str, ".", byteidx(str, 3))
293621502c4d updated for version 7.0010
vimboss
parents: 15
diff changeset
3505 < will display the fourth character. Another way to do the
293621502c4d updated for version 7.0010
vimboss
parents: 15
diff changeset
3506 same: >
293621502c4d updated for version 7.0010
vimboss
parents: 15
diff changeset
3507 let s = strpart(str, byteidx(str, 3))
293621502c4d updated for version 7.0010
vimboss
parents: 15
diff changeset
3508 echo strpart(s, 0, byteidx(s, 1))
8951
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
3509 < Also see |strgetchar()| and |strcharpart()|.
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
3510
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
3511 If there are less than {nr} characters -1 is returned.
18
293621502c4d updated for version 7.0010
vimboss
parents: 15
diff changeset
3512 If there are exactly {nr} characters the length of the string
5413
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3513 in bytes is returned.
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3514
17829
1090d6637cfd patch 8.1.1911: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17825
diff changeset
3515 Can also be used as a |method|: >
1090d6637cfd patch 8.1.1911: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17825
diff changeset
3516 GetName()->byteidx(idx)
1090d6637cfd patch 8.1.1911: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17825
diff changeset
3517
5413
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3518 byteidxcomp({expr}, {nr}) *byteidxcomp()*
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3519 Like byteidx(), except that a composing character is counted
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3520 as a separate character. Example: >
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3521 let s = 'e' . nr2char(0x301)
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3522 echo byteidx(s, 1)
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3523 echo byteidxcomp(s, 1)
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3524 echo byteidxcomp(s, 2)
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3525 < The first and third echo result in 3 ('e' plus composing
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3526 character is 3 bytes), the second echo results in 1 ('e' is
3109053ce4e3 updated for version 7.4.057
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
3527 one byte).
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3528 Only works differently from byteidx() when 'encoding' is set
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3529 to a Unicode encoding.
18
293621502c4d updated for version 7.0010
vimboss
parents: 15
diff changeset
3530
17829
1090d6637cfd patch 8.1.1911: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17825
diff changeset
3531 Can also be used as a |method|: >
1090d6637cfd patch 8.1.1911: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17825
diff changeset
3532 GetName()->byteidxcomp(idx)
1090d6637cfd patch 8.1.1911: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17825
diff changeset
3533
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
3534 call({func}, {arglist} [, {dict}]) *call()* *E699*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
3535 Call function {func} with the items in |List| {arglist} as
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
3536 arguments.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
3537 {func} can either be a |Funcref| or the name of a function.
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
3538 a:firstline and a:lastline are set to the cursor line.
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
3539 Returns the return value of the called function.
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
3540 {dict} is for functions with the "dict" attribute. It will be
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
3541 used to set the local variable "self". |Dictionary-function|
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
3542
17829
1090d6637cfd patch 8.1.1911: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17825
diff changeset
3543 Can also be used as a |method|: >
1090d6637cfd patch 8.1.1911: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17825
diff changeset
3544 GetFunc()->call([arg, arg], dict)
1090d6637cfd patch 8.1.1911: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17825
diff changeset
3545
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3546 ceil({expr}) *ceil()*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3547 Return the smallest integral value greater than or equal to
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3548 {expr} as a |Float| (round up).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3549 {expr} must evaluate to a |Float| or a |Number|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3550 Examples: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3551 echo ceil(1.456)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3552 < 2.0 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3553 echo ceil(-5.456)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3554 < -5.0 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3555 echo ceil(4.0)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3556 < 4.0
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3557
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3558 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3559 Compute()->ceil()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3560 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3561 {only available when compiled with the |+float| feature}
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3562
17456
e414281d8bb4 patch 8.1.1726: the eval.txt help file is too big
Bram Moolenaar <Bram@vim.org>
parents: 17450
diff changeset
3563
e414281d8bb4 patch 8.1.1726: the eval.txt help file is too big
Bram Moolenaar <Bram@vim.org>
parents: 17450
diff changeset
3564 ch_ functions are documented here: |channel-functions-details|
e414281d8bb4 patch 8.1.1726: the eval.txt help file is too big
Bram Moolenaar <Bram@vim.org>
parents: 17450
diff changeset
3565
e414281d8bb4 patch 8.1.1726: the eval.txt help file is too big
Bram Moolenaar <Bram@vim.org>
parents: 17450
diff changeset
3566
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3567 changenr() *changenr()*
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3568 Return the number of the most recent change. This is the same
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3569 number as what is displayed with |:undolist| and can be used
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3570 with the |:undo| command.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3571 When a change was made it is the number of that change. After
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3572 redo it is the number of the redone change. After undo it is
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3573 one less than the number of the undone change.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3574
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
3575 char2nr({expr} [, {utf8}]) *char2nr()*
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3576 Return number value of the first char in {expr}. Examples: >
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3577 char2nr(" ") returns 32
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3578 char2nr("ABC") returns 65
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3579 < When {utf8} is omitted or zero, the current 'encoding' is used.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3580 Example for "utf-8": >
13482
9eebe457eb3c Update runtime files. Convert a couple of help files to utf-8.
Christian Brabandt <cb@256bit.org>
parents: 13438
diff changeset
3581 char2nr("á") returns 225
9eebe457eb3c Update runtime files. Convert a couple of help files to utf-8.
Christian Brabandt <cb@256bit.org>
parents: 13438
diff changeset
3582 char2nr("á"[0]) returns 195
22171
d4c7b3e9cd17 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22077
diff changeset
3583 < With {utf8} set to TRUE, always treat as utf-8 characters.
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3584 A combining character is a separate character.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3585 |nr2char()| does the opposite.
16158
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
3586 To turn a string into a list of character numbers: >
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
3587 let str = "ABC"
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
3588 let list = map(split(str, '\zs'), {_, val -> char2nr(val)})
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
3589 < Result: [65, 66, 67]
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3590
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3591 Can also be used as a |method|: >
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3592 GetChar()->char2nr()
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3593
21973
85add08e6a2d patch 8.2.1536: cannot get the class of a character; emoji widths are wrong
Bram Moolenaar <Bram@vim.org>
parents: 21971
diff changeset
3594
85add08e6a2d patch 8.2.1536: cannot get the class of a character; emoji widths are wrong
Bram Moolenaar <Bram@vim.org>
parents: 21971
diff changeset
3595 charclass({string}) *charclass()*
85add08e6a2d patch 8.2.1536: cannot get the class of a character; emoji widths are wrong
Bram Moolenaar <Bram@vim.org>
parents: 21971
diff changeset
3596 Return the character class of the first character in {string}.
85add08e6a2d patch 8.2.1536: cannot get the class of a character; emoji widths are wrong
Bram Moolenaar <Bram@vim.org>
parents: 21971
diff changeset
3597 The character class is one of:
85add08e6a2d patch 8.2.1536: cannot get the class of a character; emoji widths are wrong
Bram Moolenaar <Bram@vim.org>
parents: 21971
diff changeset
3598 0 blank
85add08e6a2d patch 8.2.1536: cannot get the class of a character; emoji widths are wrong
Bram Moolenaar <Bram@vim.org>
parents: 21971
diff changeset
3599 1 punctuation
85add08e6a2d patch 8.2.1536: cannot get the class of a character; emoji widths are wrong
Bram Moolenaar <Bram@vim.org>
parents: 21971
diff changeset
3600 2 word character
85add08e6a2d patch 8.2.1536: cannot get the class of a character; emoji widths are wrong
Bram Moolenaar <Bram@vim.org>
parents: 21971
diff changeset
3601 3 emoji
85add08e6a2d patch 8.2.1536: cannot get the class of a character; emoji widths are wrong
Bram Moolenaar <Bram@vim.org>
parents: 21971
diff changeset
3602 other specific Unicode class
85add08e6a2d patch 8.2.1536: cannot get the class of a character; emoji widths are wrong
Bram Moolenaar <Bram@vim.org>
parents: 21971
diff changeset
3603 The class is used in patterns and word motions.
85add08e6a2d patch 8.2.1536: cannot get the class of a character; emoji widths are wrong
Bram Moolenaar <Bram@vim.org>
parents: 21971
diff changeset
3604
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3605 *charcol()*
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3606 charcol({expr}) Same as |col()| but returns the character index of the column
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3607 position given with {expr} instead of the byte position.
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3608
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3609 Example:
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3610 With the cursor on '세' in line 5 with text "여보세요": >
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3611 charcol('.') returns 3
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3612 col('.') returns 7
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3613
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3614 < Can also be used as a |method|: >
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3615 GetPos()->col()
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3616 <
23380
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3617 *charidx()*
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3618 charidx({string}, {idx} [, {countcc}])
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3619 Return the character index of the byte at {idx} in {string}.
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3620 The index of the first character is zero.
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3621 If there are no multibyte characters the returned value is
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3622 equal to {idx}.
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3623 When {countcc} is omitted or zero, then composing characters
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3624 are not counted separately, their byte length is added to the
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3625 preceding base character.
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3626 When {countcc} is set to 1, then composing characters are
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3627 counted as separate characters.
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3628 Returns -1 if the arguments are invalid or if {idx} is greater
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3629 than the index of the last byte in {string}. An error is
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3630 given if the first argument is not a string, the second
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3631 argument is not a number or when the third argument is present
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3632 and is not zero or one.
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3633 See |byteidx()| and |byteidxcomp()| for getting the byte index
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3634 from the character index.
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3635 Examples: >
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3636 echo charidx('áb́ć', 3) returns 1
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3637 echo charidx('áb́ć', 6, 1) returns 4
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3638 echo charidx('áb́ć', 16) returns -1
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3639 <
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3640 Can also be used as a |method|: >
2351b40af967 patch 8.2.2233: cannot convert a byte index into a character index
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
3641 GetName()->charidx(idx)
21973
85add08e6a2d patch 8.2.1536: cannot get the class of a character; emoji widths are wrong
Bram Moolenaar <Bram@vim.org>
parents: 21971
diff changeset
3642
16576
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3643 chdir({dir}) *chdir()*
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3644 Change the current working directory to {dir}. The scope of
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3645 the directory change depends on the directory of the current
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3646 window:
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3647 - If the current window has a window-local directory
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3648 (|:lcd|), then changes the window local directory.
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3649 - Otherwise, if the current tabpage has a local
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3650 directory (|:tcd|) then changes the tabpage local
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3651 directory.
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3652 - Otherwise, changes the global directory.
19303
51bc26d4a393 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19181
diff changeset
3653 {dir} must be a String.
16576
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3654 If successful, returns the previous working directory. Pass
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3655 this to another chdir() to restore the directory.
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3656 On failure, returns an empty string.
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3657
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3658 Example: >
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3659 let save_dir = chdir(newdir)
16808
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16704
diff changeset
3660 if save_dir != ""
16576
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3661 " ... do some work
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3662 call chdir(save_dir)
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3663 endif
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3664
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3665 < Can also be used as a |method|: >
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3666 GetDir()->chdir()
16576
bcc343175103 patch 8.1.1291: not easy to change directory and restore
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3667 <
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3668 cindent({lnum}) *cindent()*
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3669 Get the amount of indent for line {lnum} according the C
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3670 indenting rules, as with 'cindent'.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3671 The indent is counted in spaces, the value of 'tabstop' is
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3672 relevant. {lnum} is used just like in |getline()|.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3673 When {lnum} is invalid or Vim was not compiled the |+cindent|
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3674 feature, -1 is returned.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3675 See |C-indenting|.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3676
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3677 Can also be used as a |method|: >
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3678 GetLnum()->cindent()
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3679
16158
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
3680 clearmatches([{win}]) *clearmatches()*
16127
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3681 Clears all matches previously defined for the current window
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3682 by |matchadd()| and the |:match| commands.
16158
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
3683 If {win} is specified, use the window with this number or
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
3684 window ID instead of the current window.
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3685
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3686 Can also be used as a |method|: >
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3687 GetWin()->clearmatches()
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3688 <
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3689 *col()*
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3690 col({expr}) The result is a Number, which is the byte index of the column
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3691 position given with {expr}. The accepted positions are:
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3692 . the cursor position
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3693 $ the end of the cursor line (the result is the
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3694 number of bytes in the cursor line plus one)
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3695 'x position of mark x (if the mark is not set, 0 is
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3696 returned)
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3697 v In Visual mode: the start of the Visual area (the
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3698 cursor is the end). When not in Visual mode
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3699 returns the cursor position. Differs from |'<| in
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3700 that it's updated right away.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3701 Additionally {expr} can be [lnum, col]: a |List| with the line
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3702 and column number. Most useful when the column is "$", to get
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3703 the last column of a specific line. When "lnum" or "col" is
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3704 out of range then col() returns zero.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3705 To get the line number use |line()|. To get both use
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3706 |getpos()|.
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3707 For the screen column position use |virtcol()|. For the
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
3708 character position use |charcol()|.
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3709 Note that only marks in the current file can be used.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3710 Examples: >
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3711 col(".") column of cursor
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3712 col("$") length of cursor line plus one
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3713 col("'t") column of mark t
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3714 col("'" . markname) column of mark markname
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3715 < The first column is 1. 0 is returned for an error.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3716 For an uppercase mark the column may actually be in another
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3717 buffer.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3718 For the cursor position, when 'virtualedit' is active, the
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3719 column is one higher if the cursor is after the end of the
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3720 line. This can be used to obtain the column in Insert mode: >
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3721 :imap <F2> <C-O>:let save_ve = &ve<CR>
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3722 \<C-O>:set ve=all<CR>
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3723 \<C-O>:echo col(".") . "\n" <Bar>
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3724 \let &ve = save_ve<CR>
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3725
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3726 < Can also be used as a |method|: >
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3727 GetPos()->col()
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3728 <
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3729
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3730 complete({startcol}, {matches}) *complete()* *E785*
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3731 Set the matches for Insert mode completion.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3732 Can only be used in Insert mode. You need to use a mapping
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3733 with CTRL-R = (see |i_CTRL-R|). It does not work after CTRL-O
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3734 or with an expression mapping.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3735 {startcol} is the byte offset in the line where the completed
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3736 text start. The text up to the cursor is the original text
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3737 that will be replaced by the matches. Use col('.') for an
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3738 empty string. "col('.') - 1" will replace one character by a
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3739 match.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3740 {matches} must be a |List|. Each |List| item is one match.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3741 See |complete-items| for the kind of items that are possible.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3742 Note that the after calling this function you need to avoid
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3743 inserting anything that would cause completion to stop.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3744 The match can be selected with CTRL-N and CTRL-P as usual with
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3745 Insert mode completion. The popup menu will appear if
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3746 specified, see |ins-completion-menu|.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3747 Example: >
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3748 inoremap <F5> <C-R>=ListMonths()<CR>
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3749
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3750 func! ListMonths()
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3751 call complete(col('.'), ['January', 'February', 'March',
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3752 \ 'April', 'May', 'June', 'July', 'August', 'September',
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3753 \ 'October', 'November', 'December'])
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3754 return ''
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3755 endfunc
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3756 < This isn't very useful, but it shows how it works. Note that
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3757 an empty string is returned to avoid a zero being inserted.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3758
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
3759 Can also be used as a |method|, the base is passed as the
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
3760 second argument: >
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3761 GetMatches()->complete(col('.'))
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3762
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3763 complete_add({expr}) *complete_add()*
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3764 Add {expr} to the list of matches. Only to be used by the
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3765 function specified with the 'completefunc' option.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3766 Returns 0 for failure (empty string or out of memory),
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3767 1 when the match was added, 2 when the match was already in
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3768 the list.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3769 See |complete-functions| for an explanation of {expr}. It is
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3770 the same as one item in the list that 'omnifunc' would return.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3771
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3772 Can also be used as a |method|: >
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3773 GetMoreMatches()->complete_add()
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3774
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3775 complete_check() *complete_check()*
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3776 Check for a key typed while looking for completion matches.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3777 This is to be used when looking for matches takes some time.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3778 Returns |TRUE| when searching for matches is to be aborted,
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3779 zero otherwise.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3780 Only to be used by the function specified with the
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3781 'completefunc' option.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3782
16127
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3783 *complete_info()*
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3784 complete_info([{what}])
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
3785 Returns a |Dictionary| with information about Insert mode
16127
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3786 completion. See |ins-completion|.
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3787 The items are:
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3788 mode Current completion mode name string.
16208
a23c883685cb Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16158
diff changeset
3789 See |complete_info_mode| for the values.
16127
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3790 pum_visible |TRUE| if popup menu is visible.
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3791 See |pumvisible()|.
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3792 items List of completion matches. Each item is a
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3793 dictionary containing the entries "word",
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3794 "abbr", "menu", "kind", "info" and "user_data".
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3795 See |complete-items|.
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3796 selected Selected item index. First index is zero.
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3797 Index is -1 if no item is selected (showing
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3798 typed text only)
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3799 inserted Inserted string. [NOT IMPLEMENT YET]
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3800
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3801 *complete_info_mode*
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3802 mode values are:
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3803 "" Not in completion mode
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3804 "keyword" Keyword completion |i_CTRL-X_CTRL-N|
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3805 "ctrl_x" Just pressed CTRL-X |i_CTRL-X|
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3806 "whole_line" Whole lines |i_CTRL-X_CTRL-L|
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3807 "files" File names |i_CTRL-X_CTRL-F|
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3808 "tags" Tags |i_CTRL-X_CTRL-]|
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3809 "path_defines" Definition completion |i_CTRL-X_CTRL-D|
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3810 "path_patterns" Include completion |i_CTRL-X_CTRL-I|
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3811 "dictionary" Dictionary |i_CTRL-X_CTRL-K|
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3812 "thesaurus" Thesaurus |i_CTRL-X_CTRL-T|
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3813 "cmdline" Vim Command line |i_CTRL-X_CTRL-V|
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3814 "function" User defined completion |i_CTRL-X_CTRL-U|
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3815 "omni" Omni completion |i_CTRL-X_CTRL-O|
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3816 "spell" Spelling suggestions |i_CTRL-X_s|
20965
59f93c2d2551 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20889
diff changeset
3817 "eval" |complete()| completion
16127
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3818 "unknown" Other internal modes
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3819
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3820 If the optional {what} list argument is supplied, then only
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3821 the items listed in {what} are returned. Unsupported items in
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3822 {what} are silently ignored.
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3823
17756
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
3824 To get the position and size of the popup menu, see
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
3825 |pum_getpos()|. It's also available in |v:event| during the
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
3826 |CompleteChanged| event.
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
3827
16127
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3828 Examples: >
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3829 " Get all items
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3830 call complete_info()
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3831 " Get only 'mode'
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3832 call complete_info(['mode'])
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3833 " Get only 'mode' and 'pum_visible'
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3834 call complete_info(['mode', 'pum_visible'])
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3835
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3836 < Can also be used as a |method|: >
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3837 GetItems()->complete_info()
16127
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
3838 <
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3839 *confirm()*
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3840 confirm({msg} [, {choices} [, {default} [, {type}]]])
16019
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
3841 confirm() offers the user a dialog, from which a choice can be
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3842 made. It returns the number of the choice. For the first
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3843 choice this is 1.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3844 Note: confirm() is only supported when compiled with dialog
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3845 support, see |+dialog_con| and |+dialog_gui|.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3846
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3847 {msg} is displayed in a |dialog| with {choices} as the
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3848 alternatives. When {choices} is missing or empty, "&OK" is
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3849 used (and translated).
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3850 {msg} is a String, use '\n' to include a newline. Only on
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3851 some systems the string is wrapped when it doesn't fit.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3852
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3853 {choices} is a String, with the individual choices separated
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3854 by '\n', e.g. >
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3855 confirm("Save changes?", "&Yes\n&No\n&Cancel")
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3856 < The letter after the '&' is the shortcut key for that choice.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3857 Thus you can type 'c' to select "Cancel". The shortcut does
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3858 not need to be the first letter: >
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3859 confirm("file has been modified", "&Save\nSave &All")
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3860 < For the console, the first letter of each choice is used as
22824
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
3861 the default shortcut key. Case is ignored.
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3862
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3863 The optional {default} argument is the number of the choice
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3864 that is made if the user hits <CR>. Use 1 to make the first
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3865 choice the default one. Use 0 to not set a default. If
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3866 {default} is omitted, 1 is used.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3867
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3868 The optional {type} argument gives the type of dialog. This
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3869 is only used for the icon of the GTK, Mac, Motif and Win32
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3870 GUI. It can be one of these values: "Error", "Question",
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3871 "Info", "Warning" or "Generic". Only the first character is
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3872 relevant. When {type} is omitted, "Generic" is used.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3873
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3874 If the user aborts the dialog by pressing <Esc>, CTRL-C,
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3875 or another valid interrupt key, confirm() returns 0.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3876
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3877 An example: >
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3878 :let choice = confirm("What do you want?", "&Apples\n&Oranges\n&Bananas", 2)
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3879 :if choice == 0
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3880 : echo "make up your mind!"
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3881 :elseif choice == 3
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3882 : echo "tasteful"
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3883 :else
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3884 : echo "I prefer bananas myself."
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3885 :endif
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3886 < In a GUI dialog, buttons are used. The layout of the buttons
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3887 depends on the 'v' flag in 'guioptions'. If it is included,
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3888 the buttons are always put vertically. Otherwise, confirm()
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3889 tries to put the buttons in one horizontal line. If they
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3890 don't fit, a vertical layout is used anyway. For some systems
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3891 the horizontal layout is always used.
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
3892
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3893 Can also be used as a |method|in: >
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
3894 BuildMessage()->confirm("&Yes\n&No")
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
3895 <
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
3896 *copy()*
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
3897 copy({expr}) Make a copy of {expr}. For Numbers and Strings this isn't
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
3898 different from using {expr} directly.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
3899 When {expr} is a |List| a shallow copy is created. This means
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
3900 that the original |List| can be changed without changing the
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3901 copy, and vice versa. But the items are identical, thus
8019
d685893d852e commit https://github.com/vim/vim/commit/7823a3bd2eed6ff9e544d201de96710bd5344aaf
Christian Brabandt <cb@256bit.org>
parents: 7992
diff changeset
3902 changing an item changes the contents of both |Lists|.
d685893d852e commit https://github.com/vim/vim/commit/7823a3bd2eed6ff9e544d201de96710bd5344aaf
Christian Brabandt <cb@256bit.org>
parents: 7992
diff changeset
3903 A |Dictionary| is copied in a similar way as a |List|.
d685893d852e commit https://github.com/vim/vim/commit/7823a3bd2eed6ff9e544d201de96710bd5344aaf
Christian Brabandt <cb@256bit.org>
parents: 7992
diff changeset
3904 Also see |deepcopy()|.
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
3905 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
3906 mylist->copy()
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
3907
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3908 cos({expr}) *cos()*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3909 Return the cosine of {expr}, measured in radians, as a |Float|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3910 {expr} must evaluate to a |Float| or a |Number|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3911 Examples: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3912 :echo cos(100)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3913 < 0.862319 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3914 :echo cos(-4.01)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3915 < -0.646043
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3916
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3917 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3918 Compute()->cos()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3919 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3920 {only available when compiled with the |+float| feature}
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
3921
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3922
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3923 cosh({expr}) *cosh()*
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
3924 Return the hyperbolic cosine of {expr} as a |Float| in the range
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3925 [1, inf].
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
3926 {expr} must evaluate to a |Float| or a |Number|.
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3927 Examples: >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3928 :echo cosh(0.5)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3929 < 1.127626 >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3930 :echo cosh(-0.5)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3931 < -1.127626
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3932
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3933 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3934 Compute()->cosh()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
3935 <
2570
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2569
diff changeset
3936 {only available when compiled with the |+float| feature}
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
3937
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
3938
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
3939 count({comp}, {expr} [, {ic} [, {start}]]) *count()*
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
3940 Return the number of times an item with value {expr} appears
11828
5a07a3ff56c1 patch 8.0.0794: checking translations fails with multiple NL
Christian Brabandt <cb@256bit.org>
parents: 11763
diff changeset
3941 in |String|, |List| or |Dictionary| {comp}.
5a07a3ff56c1 patch 8.0.0794: checking translations fails with multiple NL
Christian Brabandt <cb@256bit.org>
parents: 11763
diff changeset
3942
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
3943 If {start} is given then start with the item with this index.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
3944 {start} can only be used with a |List|.
11828
5a07a3ff56c1 patch 8.0.0794: checking translations fails with multiple NL
Christian Brabandt <cb@256bit.org>
parents: 11763
diff changeset
3945
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
3946 When {ic} is given and it's |TRUE| then case is ignored.
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
3947
11828
5a07a3ff56c1 patch 8.0.0794: checking translations fails with multiple NL
Christian Brabandt <cb@256bit.org>
parents: 11763
diff changeset
3948 When {comp} is a string then the number of not overlapping
13070
17720967656c patch 8.0.1410: hang when using count() with an empty string
Christian Brabandt <cb@256bit.org>
parents: 13062
diff changeset
3949 occurrences of {expr} is returned. Zero is returned when
17720967656c patch 8.0.1410: hang when using count() with an empty string
Christian Brabandt <cb@256bit.org>
parents: 13062
diff changeset
3950 {expr} is an empty string.
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
3951
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
3952 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
3953 mylist->count(val)
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
3954 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3955 *cscope_connection()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3956 cscope_connection([{num} , {dbpath} [, {prepend}]])
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3957 Checks for the existence of a |cscope| connection. If no
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3958 parameters are specified, then the function returns:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3959 0, if cscope was not available (not compiled in), or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3960 if there are no cscope connections;
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3961 1, if there is at least one cscope connection.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3962
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3963 If parameters are specified, then the value of {num}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3964 determines how existence of a cscope connection is checked:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3965
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3966 {num} Description of existence check
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3967 ----- ------------------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3968 0 Same as no parameters (e.g., "cscope_connection()").
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3969 1 Ignore {prepend}, and use partial string matches for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3970 {dbpath}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3971 2 Ignore {prepend}, and use exact string matches for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3972 {dbpath}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3973 3 Use {prepend}, use partial string matches for both
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3974 {dbpath} and {prepend}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3975 4 Use {prepend}, use exact string matches for both
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3976 {dbpath} and {prepend}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3977
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3978 Note: All string comparisons are case sensitive!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3979
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3980 Examples. Suppose we had the following (from ":cs show"): >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3981
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3982 # pid database name prepend path
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3983 0 27664 cscope.out /usr/local
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3984 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3985 Invocation Return Val ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3986 ---------- ---------- >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3987 cscope_connection() 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3988 cscope_connection(1, "out") 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3989 cscope_connection(2, "out") 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3990 cscope_connection(3, "out") 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3991 cscope_connection(3, "out", "local") 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3992 cscope_connection(4, "out") 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3993 cscope_connection(4, "out", "local") 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3994 cscope_connection(4, "cscope.out", "/usr/local") 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3995 <
703
2fae45239fb3 updated for version 7.0212
vimboss
parents: 697
diff changeset
3996 cursor({lnum}, {col} [, {off}]) *cursor()*
2fae45239fb3 updated for version 7.0212
vimboss
parents: 697
diff changeset
3997 cursor({list})
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
3998 Positions the cursor at the column (byte count) {col} in the
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
3999 line {lnum}. The first column is one.
5938
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
4000
703
2fae45239fb3 updated for version 7.0212
vimboss
parents: 697
diff changeset
4001 When there is one argument {list} this is used as a |List|
5938
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
4002 with two, three or four item:
8876
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
4003 [{lnum}, {col}]
5938
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
4004 [{lnum}, {col}, {off}]
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
4005 [{lnum}, {col}, {off}, {curswant}]
6009
7b83c190d370 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6007
diff changeset
4006 This is like the return value of |getpos()| or |getcurpos()|,
5944
332a5c2b2956 updated for version 7.4.313
Bram Moolenaar <bram@vim.org>
parents: 5942
diff changeset
4007 but without the first item.
5938
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
4008
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
4009 To position the cursor using the character count, use
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
4010 |setcursorcharpos()|.
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
4011
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4012 Does not change the jumplist.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4013 If {lnum} is greater than the number of lines in the buffer,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4014 the cursor will be positioned at the last line in the buffer.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4015 If {lnum} is zero, the cursor will stay in the current line.
493
06364aa0d597 updated for version 7.0135
vimboss
parents: 484
diff changeset
4016 If {col} is greater than the number of bytes in the line,
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4017 the cursor will be positioned at the last character in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4018 line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4019 If {col} is zero, the cursor will stay in the current column.
5944
332a5c2b2956 updated for version 7.4.313
Bram Moolenaar <bram@vim.org>
parents: 5942
diff changeset
4020 If {curswant} is given it is used to set the preferred column
6180
6921742f396a Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6153
diff changeset
4021 for vertical movement. Otherwise {col} is used.
6385
f654ad95fd4e Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6369
diff changeset
4022
703
2fae45239fb3 updated for version 7.0212
vimboss
parents: 697
diff changeset
4023 When 'virtualedit' is used {off} specifies the offset in
2fae45239fb3 updated for version 7.0212
vimboss
parents: 697
diff changeset
4024 screen columns from the start of the character. E.g., a
1266
54588e2e8041 updated for version 7.1
vimboss
parents: 1215
diff changeset
4025 position within a <Tab> or after the last character.
1851
e7f6ca5594cf updated for version 7.2-149
vimboss
parents: 1768
diff changeset
4026 Returns 0 when the position could be set, -1 otherwise.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4027
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4028 Can also be used as a |method|: >
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4029 GetCursorPos()->cursor()
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4030
14147
de75c249723d patch 8.1.0091: MS-Windows: Cannot interrupt gdb when program is running
Christian Brabandt <cb@256bit.org>
parents: 14123
diff changeset
4031 debugbreak({pid}) *debugbreak()*
de75c249723d patch 8.1.0091: MS-Windows: Cannot interrupt gdb when program is running
Christian Brabandt <cb@256bit.org>
parents: 14123
diff changeset
4032 Specifically used to interrupt a program being debugged. It
de75c249723d patch 8.1.0091: MS-Windows: Cannot interrupt gdb when program is running
Christian Brabandt <cb@256bit.org>
parents: 14123
diff changeset
4033 will cause process {pid} to get a SIGTRAP. Behavior for other
de75c249723d patch 8.1.0091: MS-Windows: Cannot interrupt gdb when program is running
Christian Brabandt <cb@256bit.org>
parents: 14123
diff changeset
4034 processes is undefined. See |terminal-debugger|.
de75c249723d patch 8.1.0091: MS-Windows: Cannot interrupt gdb when program is running
Christian Brabandt <cb@256bit.org>
parents: 14123
diff changeset
4035 {only available on MS-Windows}
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
4036
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4037 Can also be used as a |method|: >
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4038 GetPid()->debugbreak()
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4039
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
4040 deepcopy({expr} [, {noref}]) *deepcopy()* *E698*
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
4041 Make a copy of {expr}. For Numbers and Strings this isn't
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
4042 different from using {expr} directly.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4043 When {expr} is a |List| a full copy is created. This means
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4044 that the original |List| can be changed without changing the
8031
ece323e2b57f commit https://github.com/vim/vim/commit/6463ca229cb9412581419497924c85fcbfc854ab
Christian Brabandt <cb@256bit.org>
parents: 8019
diff changeset
4045 copy, and vice versa. When an item is a |List| or
ece323e2b57f commit https://github.com/vim/vim/commit/6463ca229cb9412581419497924c85fcbfc854ab
Christian Brabandt <cb@256bit.org>
parents: 8019
diff changeset
4046 |Dictionary|, a copy for it is made, recursively. Thus
ece323e2b57f commit https://github.com/vim/vim/commit/6463ca229cb9412581419497924c85fcbfc854ab
Christian Brabandt <cb@256bit.org>
parents: 8019
diff changeset
4047 changing an item in the copy does not change the contents of
ece323e2b57f commit https://github.com/vim/vim/commit/6463ca229cb9412581419497924c85fcbfc854ab
Christian Brabandt <cb@256bit.org>
parents: 8019
diff changeset
4048 the original |List|.
ece323e2b57f commit https://github.com/vim/vim/commit/6463ca229cb9412581419497924c85fcbfc854ab
Christian Brabandt <cb@256bit.org>
parents: 8019
diff changeset
4049 A |Dictionary| is copied in a similar way as a |List|.
21250
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
4050
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4051 When {noref} is omitted or zero a contained |List| or
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4052 |Dictionary| is only copied once. All references point to
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4053 this single copy. With {noref} set to 1 every occurrence of a
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4054 |List| or |Dictionary| results in a new copy. This also means
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4055 that a cyclic reference causes deepcopy() to fail.
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
4056 *E724*
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
4057 Nesting is possible up to 100 levels. When there is an item
164
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 161
diff changeset
4058 that refers back to a higher level making a deep copy with
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 161
diff changeset
4059 {noref} set to 1 will fail.
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
4060 Also see |copy()|.
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
4061
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4062 Can also be used as a |method|: >
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4063 GetObject()->deepcopy()
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4064
7615
228ff048db20 commit https://github.com/vim/vim/commit/da440d21a6b94d7f525fa7be9b1417c78dd9aa4c
Christian Brabandt <cb@256bit.org>
parents: 7597
diff changeset
4065 delete({fname} [, {flags}]) *delete()*
228ff048db20 commit https://github.com/vim/vim/commit/da440d21a6b94d7f525fa7be9b1417c78dd9aa4c
Christian Brabandt <cb@256bit.org>
parents: 7597
diff changeset
4066 Without {flags} or with {flags} empty: Deletes the file by the
7629
befbed72da87 commit https://github.com/vim/vim/commit/43a34f9f74fdce462fa250baab620264c28b6165
Christian Brabandt <cb@256bit.org>
parents: 7615
diff changeset
4067 name {fname}. This also works when {fname} is a symbolic link.
7615
228ff048db20 commit https://github.com/vim/vim/commit/da440d21a6b94d7f525fa7be9b1417c78dd9aa4c
Christian Brabandt <cb@256bit.org>
parents: 7597
diff changeset
4068
228ff048db20 commit https://github.com/vim/vim/commit/da440d21a6b94d7f525fa7be9b1417c78dd9aa4c
Christian Brabandt <cb@256bit.org>
parents: 7597
diff changeset
4069 When {flags} is "d": Deletes the directory by the name
7629
befbed72da87 commit https://github.com/vim/vim/commit/43a34f9f74fdce462fa250baab620264c28b6165
Christian Brabandt <cb@256bit.org>
parents: 7615
diff changeset
4070 {fname}. This fails when directory {fname} is not empty.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
4071
7615
228ff048db20 commit https://github.com/vim/vim/commit/da440d21a6b94d7f525fa7be9b1417c78dd9aa4c
Christian Brabandt <cb@256bit.org>
parents: 7597
diff changeset
4072 When {flags} is "rf": Deletes the directory by the name
7629
befbed72da87 commit https://github.com/vim/vim/commit/43a34f9f74fdce462fa250baab620264c28b6165
Christian Brabandt <cb@256bit.org>
parents: 7615
diff changeset
4073 {fname} and everything in it, recursively. BE CAREFUL!
10027
018fead968c1 commit https://github.com/vim/vim/commit/36f44c21da2e912c008683a0c4447fca2a071e9a
Christian Brabandt <cb@256bit.org>
parents: 10004
diff changeset
4074 Note: on MS-Windows it is not possible to delete a directory
018fead968c1 commit https://github.com/vim/vim/commit/36f44c21da2e912c008683a0c4447fca2a071e9a
Christian Brabandt <cb@256bit.org>
parents: 10004
diff changeset
4075 that is being used.
10004
8061455d9179 commit https://github.com/vim/vim/commit/818078ddfbb8cc2546f697c5675a251d095722ec
Christian Brabandt <cb@256bit.org>
parents: 10000
diff changeset
4076
7629
befbed72da87 commit https://github.com/vim/vim/commit/43a34f9f74fdce462fa250baab620264c28b6165
Christian Brabandt <cb@256bit.org>
parents: 7615
diff changeset
4077 A symbolic link itself is deleted, not what it points to.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
4078
7615
228ff048db20 commit https://github.com/vim/vim/commit/da440d21a6b94d7f525fa7be9b1417c78dd9aa4c
Christian Brabandt <cb@256bit.org>
parents: 7597
diff changeset
4079 The result is a Number, which is 0 if the delete operation was
228ff048db20 commit https://github.com/vim/vim/commit/da440d21a6b94d7f525fa7be9b1417c78dd9aa4c
Christian Brabandt <cb@256bit.org>
parents: 7597
diff changeset
4080 successful and -1 when the deletion failed or partly failed.
228ff048db20 commit https://github.com/vim/vim/commit/da440d21a6b94d7f525fa7be9b1417c78dd9aa4c
Christian Brabandt <cb@256bit.org>
parents: 7597
diff changeset
4081
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4082 Use |remove()| to delete an item from a |List|.
14043
cbad3b3f46b2 patch 8.1.0039: cannot easily delete lines in another buffer
Christian Brabandt <cb@256bit.org>
parents: 14039
diff changeset
4083 To delete a line from the buffer use |:delete| or
cbad3b3f46b2 patch 8.1.0039: cannot easily delete lines in another buffer
Christian Brabandt <cb@256bit.org>
parents: 14039
diff changeset
4084 |deletebufline()|.
cbad3b3f46b2 patch 8.1.0039: cannot easily delete lines in another buffer
Christian Brabandt <cb@256bit.org>
parents: 14039
diff changeset
4085
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4086 Can also be used as a |method|: >
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4087 GetName()->delete()
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4088
14519
5c5908e81e93 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14422
diff changeset
4089 deletebufline({expr}, {first} [, {last}]) *deletebufline()*
14043
cbad3b3f46b2 patch 8.1.0039: cannot easily delete lines in another buffer
Christian Brabandt <cb@256bit.org>
parents: 14039
diff changeset
4090 Delete lines {first} to {last} (inclusive) from buffer {expr}.
cbad3b3f46b2 patch 8.1.0039: cannot easily delete lines in another buffer
Christian Brabandt <cb@256bit.org>
parents: 14039
diff changeset
4091 If {last} is omitted then delete line {first} only.
cbad3b3f46b2 patch 8.1.0039: cannot easily delete lines in another buffer
Christian Brabandt <cb@256bit.org>
parents: 14039
diff changeset
4092 On success 0 is returned, on failure 1 is returned.
cbad3b3f46b2 patch 8.1.0039: cannot easily delete lines in another buffer
Christian Brabandt <cb@256bit.org>
parents: 14039
diff changeset
4093
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
4094 This function works only for loaded buffers. First call
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
4095 |bufload()| if needed.
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
4096
14043
cbad3b3f46b2 patch 8.1.0039: cannot easily delete lines in another buffer
Christian Brabandt <cb@256bit.org>
parents: 14039
diff changeset
4097 For the use of {expr}, see |bufname()| above.
cbad3b3f46b2 patch 8.1.0039: cannot easily delete lines in another buffer
Christian Brabandt <cb@256bit.org>
parents: 14039
diff changeset
4098
14864
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
4099 {first} and {last} are used like with |getline()|. Note that
14043
cbad3b3f46b2 patch 8.1.0039: cannot easily delete lines in another buffer
Christian Brabandt <cb@256bit.org>
parents: 14039
diff changeset
4100 when using |line()| this refers to the current buffer. Use "$"
cbad3b3f46b2 patch 8.1.0039: cannot easily delete lines in another buffer
Christian Brabandt <cb@256bit.org>
parents: 14039
diff changeset
4101 to refer to the last line in buffer {expr}.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4102
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4103 Can also be used as a |method|: >
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4104 GetBuffer()->deletebufline(1)
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
4105 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4106 *did_filetype()*
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
4107 did_filetype() Returns |TRUE| when autocommands are being executed and the
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4108 FileType event has been triggered at least once. Can be used
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4109 to avoid triggering the FileType event again in the scripts
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4110 that detect the file type. |FileType|
11473
bd6ff5246c71 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11442
diff changeset
4111 Returns |FALSE| when `:setf FALLBACK` was used.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4112 When editing another file, the counter is reset, thus this
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4113 really checks if the FileType event has been triggered for the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4114 current buffer. This allows an autocommand that starts
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4115 editing another buffer to set 'filetype' and load a syntax
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4116 file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4117
32
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4118 diff_filler({lnum}) *diff_filler()*
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4119 Returns the number of filler lines above line {lnum}.
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4120 These are the lines that were inserted at this point in
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4121 another diff'ed window. These filler lines are shown in the
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4122 display but don't exist in the buffer.
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4123 {lnum} is used like with |getline()|. Thus "." is the current
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4124 line, "'m" mark m, etc.
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4125 Returns 0 if the current window is not in diff mode.
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4126
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4127 Can also be used as a |method|: >
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4128 GetLnum()->diff_filler()
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4129
32
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4130 diff_hlID({lnum}, {col}) *diff_hlID()*
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4131 Returns the highlight ID for diff mode at line {lnum} column
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4132 {col} (byte index). When the current line does not have a
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4133 diff change zero is returned.
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4134 {lnum} is used like with |getline()|. Thus "." is the current
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4135 line, "'m" mark m, etc.
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4136 {col} is 1 for the leftmost column, {lnum} is 1 for the first
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4137 line.
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4138 The highlight ID can be used with |synIDattr()| to obtain
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4139 syntax information about the highlighting.
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
4140
17837
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4141 Can also be used as a |method|: >
f71ee7b04f0b patch 8.1.1915: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17833
diff changeset
4142 GetLnum()->diff_hlID(col)
16604
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
4143
19400
bd9069d21c5d patch 8.2.0258: modifyOtherKeys cannot be temporarily disabled
Bram Moolenaar <Bram@vim.org>
parents: 19398
diff changeset
4144
bd9069d21c5d patch 8.2.0258: modifyOtherKeys cannot be temporarily disabled
Bram Moolenaar <Bram@vim.org>
parents: 19398
diff changeset
4145 echoraw({expr}) *echoraw()*
bd9069d21c5d patch 8.2.0258: modifyOtherKeys cannot be temporarily disabled
Bram Moolenaar <Bram@vim.org>
parents: 19398
diff changeset
4146 Output {expr} as-is, including unprintable characters. This
bd9069d21c5d patch 8.2.0258: modifyOtherKeys cannot be temporarily disabled
Bram Moolenaar <Bram@vim.org>
parents: 19398
diff changeset
4147 can be used to output a terminal code. For example, to disable
bd9069d21c5d patch 8.2.0258: modifyOtherKeys cannot be temporarily disabled
Bram Moolenaar <Bram@vim.org>
parents: 19398
diff changeset
4148 modifyOtherKeys: >
bd9069d21c5d patch 8.2.0258: modifyOtherKeys cannot be temporarily disabled
Bram Moolenaar <Bram@vim.org>
parents: 19398
diff changeset
4149 call echoraw(&t_TE)
bd9069d21c5d patch 8.2.0258: modifyOtherKeys cannot be temporarily disabled
Bram Moolenaar <Bram@vim.org>
parents: 19398
diff changeset
4150 < and to enable it again: >
bd9069d21c5d patch 8.2.0258: modifyOtherKeys cannot be temporarily disabled
Bram Moolenaar <Bram@vim.org>
parents: 19398
diff changeset
4151 call echoraw(&t_TI)
bd9069d21c5d patch 8.2.0258: modifyOtherKeys cannot be temporarily disabled
Bram Moolenaar <Bram@vim.org>
parents: 19398
diff changeset
4152 < Use with care, you can mess up the terminal this way.
bd9069d21c5d patch 8.2.0258: modifyOtherKeys cannot be temporarily disabled
Bram Moolenaar <Bram@vim.org>
parents: 19398
diff changeset
4153
bd9069d21c5d patch 8.2.0258: modifyOtherKeys cannot be temporarily disabled
Bram Moolenaar <Bram@vim.org>
parents: 19398
diff changeset
4154
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
4155 empty({expr}) *empty()*
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
4156 Return the Number 1 if {expr} is empty, zero otherwise.
7957
b74549818500 commit https://github.com/vim/vim/commit/835dc636a5350f610b62f110227d2363b5b2880a
Christian Brabandt <cb@256bit.org>
parents: 7935
diff changeset
4157 - A |List| or |Dictionary| is empty when it does not have any
b74549818500 commit https://github.com/vim/vim/commit/835dc636a5350f610b62f110227d2363b5b2880a
Christian Brabandt <cb@256bit.org>
parents: 7935
diff changeset
4158 items.
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
4159 - A |String| is empty when its length is zero.
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
4160 - A |Number| and |Float| are empty when their value is zero.
7957
b74549818500 commit https://github.com/vim/vim/commit/835dc636a5350f610b62f110227d2363b5b2880a
Christian Brabandt <cb@256bit.org>
parents: 7935
diff changeset
4161 - |v:false|, |v:none| and |v:null| are empty, |v:true| is not.
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
4162 - A |Job| is empty when it failed to start.
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
4163 - A |Channel| is empty when it is closed.
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
4164 - A |Blob| is empty when its length is zero.
7957
b74549818500 commit https://github.com/vim/vim/commit/835dc636a5350f610b62f110227d2363b5b2880a
Christian Brabandt <cb@256bit.org>
parents: 7935
diff changeset
4165
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
4166 For a long |List| this is much faster than comparing the
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4167 length with zero.
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4168
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
4169 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
4170 mylist->empty()
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
4171
19099
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
4172 environ() *environ()*
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
4173 Return all of environment variables as dictionary. You can
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
4174 check if an environment variable exists like this: >
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
4175 :echo has_key(environ(), 'HOME')
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
4176 < Note that the variable name may be CamelCase; to ignore case
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
4177 use this: >
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
4178 :echo index(keys(environ()), 'HOME', 0, 1) != -1
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
4179
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4180 escape({string}, {chars}) *escape()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4181 Escape the characters in {chars} that occur in {string} with a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4182 backslash. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4183 :echo escape('c:\program files\vim', ' \')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4184 < results in: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4185 c:\\program\ files\\vim
12427
fc3e2d5614dd patch 8.0.1093: various small quickfix issues
Christian Brabandt <cb@256bit.org>
parents: 12389
diff changeset
4186 < Also see |shellescape()| and |fnameescape()|.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4187
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4188 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4189 GetText()->escape(' \')
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4190 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4191 *eval()*
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
4192 eval({string}) Evaluate {string} and return the result. Especially useful to
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
4193 turn the result of |string()| back into the original value.
15571
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
4194 This works for Numbers, Floats, Strings, Blobs and composites
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
4195 of them. Also works for |Funcref|s that refer to existing
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4196 functions.
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
4197
17620
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
4198 Can also be used as a |method|: >
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
4199 argv->join()->eval()
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
4200
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4201 eventhandler() *eventhandler()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4202 Returns 1 when inside an event handler. That is that Vim got
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4203 interrupted while waiting for the user to type a character,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4204 e.g., when dropping a file on Vim. This means interactive
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4205 commands cannot be used. Otherwise zero is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4206
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4207 executable({expr}) *executable()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4208 This function checks if an executable with the name {expr}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4209 exists. {expr} must be the name of the program without any
10
4e2284e71352 updated for version 7.0002
vimboss
parents: 9
diff changeset
4210 arguments.
4e2284e71352 updated for version 7.0002
vimboss
parents: 9
diff changeset
4211 executable() uses the value of $PATH and/or the normal
4e2284e71352 updated for version 7.0002
vimboss
parents: 9
diff changeset
4212 searchpath for programs. *PATHEXT*
18972
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18928
diff changeset
4213 On MS-Windows the ".exe", ".bat", etc. can optionally be
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18928
diff changeset
4214 included. Then the extensions in $PATHEXT are tried. Thus if
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18928
diff changeset
4215 "foo.exe" does not exist, "foo.exe.bat" can be found. If
20593
89b0f161e6a6 patch 8.2.0850: MS-Windows: exepath() works different from cmd.exe
Bram Moolenaar <Bram@vim.org>
parents: 20552
diff changeset
4216 $PATHEXT is not set then ".com;.exe;.bat;.cmd" is used. A dot
18972
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18928
diff changeset
4217 by itself can be used in $PATHEXT to try using the name
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18928
diff changeset
4218 without an extension. When 'shell' looks like a Unix shell,
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18928
diff changeset
4219 then the name is also tried without adding an extension.
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18928
diff changeset
4220 On MS-Windows it only checks if the file exists and is not a
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18928
diff changeset
4221 directory, not if it's really executable.
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
4222 On MS-Windows an executable in the same directory as Vim is
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
4223 always found. Since this directory is added to $PATH it
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
4224 should also work to execute it |win32-PATH|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4225 The result is a Number:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4226 1 exists
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4227 0 does not exist
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4228 -1 not implemented on this system
14249
4543777545a3 Updated runtime and language files.
Christian Brabandt <cb@256bit.org>
parents: 14193
diff changeset
4229 |exepath()| can be used to get the full path of an executable.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4230
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4231 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4232 GetCommand()->executable()
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4233
9454
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4234 execute({command} [, {silent}]) *execute()*
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4235 Execute an Ex command or commands and return the output as a
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4236 string.
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4237 {command} can be a string or a List. In case of a List the
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4238 lines are executed one by one.
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4239 This is equivalent to: >
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4240 redir => var
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4241 {command}
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4242 redir END
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4243 <
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4244 The optional {silent} argument can have these values:
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4245 "" no `:silent` used
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4246 "silent" `:silent` used
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4247 "silent!" `:silent!` used
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
4248 The default is "silent". Note that with "silent!", unlike
9527
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
4249 `:redir`, error messages are dropped. When using an external
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
4250 command the screen may be messed up, use `system()` instead.
9454
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4251 *E930*
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4252 It is not possible to use `:redir` anywhere in {command}.
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4253
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4254 To get a list of lines use |split()| on the result: >
9464
be72f4201a1d commit https://github.com/vim/vim/commit/063b9d15abea041a5bfff3ffc4e219e26fd1d4fa
Christian Brabandt <cb@256bit.org>
parents: 9460
diff changeset
4255 split(execute('args'), "\n")
9454
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4256
16833
6699c03347d2 patch 8.1.1418: win_execute() is not implemented yet
Bram Moolenaar <Bram@vim.org>
parents: 16808
diff changeset
4257 < To execute a command in another window than the current one
6699c03347d2 patch 8.1.1418: win_execute() is not implemented yet
Bram Moolenaar <Bram@vim.org>
parents: 16808
diff changeset
4258 use `win_execute()`.
6699c03347d2 patch 8.1.1418: win_execute() is not implemented yet
Bram Moolenaar <Bram@vim.org>
parents: 16808
diff changeset
4259
6699c03347d2 patch 8.1.1418: win_execute() is not implemented yet
Bram Moolenaar <Bram@vim.org>
parents: 16808
diff changeset
4260 When used recursively the output of the recursive call is not
9454
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4261 included in the output of the higher level call.
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
4262
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4263 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4264 GetCommand()->execute()
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4265
5782
5ab2946f7ce5 updated for version 7.4.235
Bram Moolenaar <bram@vim.org>
parents: 5780
diff changeset
4266 exepath({expr}) *exepath()*
5ab2946f7ce5 updated for version 7.4.235
Bram Moolenaar <bram@vim.org>
parents: 5780
diff changeset
4267 If {expr} is an executable and is either an absolute path, a
5ab2946f7ce5 updated for version 7.4.235
Bram Moolenaar <bram@vim.org>
parents: 5780
diff changeset
4268 relative path or found in $PATH, return the full path.
5ab2946f7ce5 updated for version 7.4.235
Bram Moolenaar <bram@vim.org>
parents: 5780
diff changeset
4269 Note that the current directory is used when {expr} starts
5ab2946f7ce5 updated for version 7.4.235
Bram Moolenaar <bram@vim.org>
parents: 5780
diff changeset
4270 with "./", which may be a problem for Vim: >
5ab2946f7ce5 updated for version 7.4.235
Bram Moolenaar <bram@vim.org>
parents: 5780
diff changeset
4271 echo exepath(v:progpath)
5814
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5808
diff changeset
4272 < If {expr} cannot be found in $PATH or is not executable then
5782
5ab2946f7ce5 updated for version 7.4.235
Bram Moolenaar <bram@vim.org>
parents: 5780
diff changeset
4273 an empty string is returned.
5ab2946f7ce5 updated for version 7.4.235
Bram Moolenaar <bram@vim.org>
parents: 5780
diff changeset
4274
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4275 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4276 GetCommand()->exepath()
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
4277 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4278 *exists()*
9790
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
4279 exists({expr}) The result is a Number, which is |TRUE| if {expr} is defined,
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
4280 zero otherwise.
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
4281
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
4282 For checking for a supported feature use |has()|.
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
4283 For checking if a file exists use |filereadable()|.
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
4284
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
4285 The {expr} argument is a string, which contains one of these:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4286 &option-name Vim option (only checks if it exists,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4287 not if it really works)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4288 +option-name Vim option that works.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4289 $ENVNAME environment variable (could also be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4290 done by comparing with an empty
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4291 string)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4292 *funcname built-in function (see |functions|)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4293 or user defined function (see
19805
2dc5e6ddeb4c patch 8.2.0459: cannot check if a function name is correct
Bram Moolenaar <Bram@vim.org>
parents: 19783
diff changeset
4294 |user-functions|) that is implemented.
2dc5e6ddeb4c patch 8.2.0459: cannot check if a function name is correct
Bram Moolenaar <Bram@vim.org>
parents: 19783
diff changeset
4295 Also works for a variable that is a
2dc5e6ddeb4c patch 8.2.0459: cannot check if a function name is correct
Bram Moolenaar <Bram@vim.org>
parents: 19783
diff changeset
4296 Funcref.
2dc5e6ddeb4c patch 8.2.0459: cannot check if a function name is correct
Bram Moolenaar <Bram@vim.org>
parents: 19783
diff changeset
4297 ?funcname built-in function that could be
2dc5e6ddeb4c patch 8.2.0459: cannot check if a function name is correct
Bram Moolenaar <Bram@vim.org>
parents: 19783
diff changeset
4298 implemented; to be used to check if
2dc5e6ddeb4c patch 8.2.0459: cannot check if a function name is correct
Bram Moolenaar <Bram@vim.org>
parents: 19783
diff changeset
4299 "funcname" is valid
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4300 varname internal variable (see
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
4301 |internal-variables|). Also works
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4302 for |curly-braces-names|, |Dictionary|
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4303 entries, |List| items, etc. Beware
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
4304 that evaluating an index may cause an
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
4305 error message for an invalid
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
4306 expression. E.g.: >
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
4307 :let l = [1, 2, 3]
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
4308 :echo exists("l[5]")
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
4309 < 0 >
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
4310 :echo exists("l[xx]")
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
4311 < E121: Undefined variable: xx
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
4312 0
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4313 :cmdname Ex command: built-in command, user
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4314 command or command modifier |:command|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4315 Returns:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4316 1 for match with start of a command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4317 2 full match with a command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4318 3 matches several user commands
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4319 To check for a supported command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4320 always check the return value to be 2.
864
bc620d6bdf06 updated for version 7.0g03
vimboss
parents: 859
diff changeset
4321 :2match The |:2match| command.
bc620d6bdf06 updated for version 7.0g03
vimboss
parents: 859
diff changeset
4322 :3match The |:3match| command.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4323 #event autocommand defined for this event
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4324 #event#pattern autocommand defined for this event and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4325 pattern (the pattern is taken
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4326 literally and compared to the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4327 autocommand patterns character by
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4328 character)
613
53114ef7778f updated for version 7.0174
vimboss
parents: 593
diff changeset
4329 #group autocommand group exists
53114ef7778f updated for version 7.0174
vimboss
parents: 593
diff changeset
4330 #group#event autocommand defined for this group and
53114ef7778f updated for version 7.0174
vimboss
parents: 593
diff changeset
4331 event.
53114ef7778f updated for version 7.0174
vimboss
parents: 593
diff changeset
4332 #group#event#pattern
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
4333 autocommand defined for this group,
613
53114ef7778f updated for version 7.0174
vimboss
parents: 593
diff changeset
4334 event and pattern.
615
7fe13e0f5dce updated for version 7.0175
vimboss
parents: 613
diff changeset
4335 ##event autocommand for this event is
7fe13e0f5dce updated for version 7.0175
vimboss
parents: 613
diff changeset
4336 supported.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4337
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4338 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4339 exists("&shortname")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4340 exists("$HOSTNAME")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4341 exists("*strftime")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4342 exists("*s:MyFunc")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4343 exists("bufcount")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4344 exists(":Make")
613
53114ef7778f updated for version 7.0174
vimboss
parents: 593
diff changeset
4345 exists("#CursorHold")
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4346 exists("#BufReadPre#*.gz")
613
53114ef7778f updated for version 7.0174
vimboss
parents: 593
diff changeset
4347 exists("#filetypeindent")
53114ef7778f updated for version 7.0174
vimboss
parents: 593
diff changeset
4348 exists("#filetypeindent#FileType")
53114ef7778f updated for version 7.0174
vimboss
parents: 593
diff changeset
4349 exists("#filetypeindent#FileType#*")
615
7fe13e0f5dce updated for version 7.0175
vimboss
parents: 613
diff changeset
4350 exists("##ColorScheme")
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4351 < There must be no space between the symbol (&/$/*/#) and the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4352 name.
867
a5677b7ce858 updated for version 7.0g04
vimboss
parents: 864
diff changeset
4353 There must be no extra characters after the name, although in
a5677b7ce858 updated for version 7.0g04
vimboss
parents: 864
diff changeset
4354 a few cases this is ignored. That may become more strict in
a5677b7ce858 updated for version 7.0g04
vimboss
parents: 864
diff changeset
4355 the future, thus don't count on it!
a5677b7ce858 updated for version 7.0g04
vimboss
parents: 864
diff changeset
4356 Working example: >
a5677b7ce858 updated for version 7.0g04
vimboss
parents: 864
diff changeset
4357 exists(":make")
a5677b7ce858 updated for version 7.0g04
vimboss
parents: 864
diff changeset
4358 < NOT working example: >
a5677b7ce858 updated for version 7.0g04
vimboss
parents: 864
diff changeset
4359 exists(":make install")
859
99305c4c42d4 updated for version 7.0g02
vimboss
parents: 857
diff changeset
4360
99305c4c42d4 updated for version 7.0g02
vimboss
parents: 857
diff changeset
4361 < Note that the argument must be a string, not the name of the
99305c4c42d4 updated for version 7.0g02
vimboss
parents: 857
diff changeset
4362 variable itself. For example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4363 exists(bufcount)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4364 < This doesn't check for existence of the "bufcount" variable,
853
d10fbefd3bc1 updated for version 7.0f05
vimboss
parents: 844
diff changeset
4365 but gets the value of "bufcount", and checks if that exists.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4366
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4367 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4368 Varname()->exists()
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4369
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4370 exp({expr}) *exp()*
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
4371 Return the exponential of {expr} as a |Float| in the range
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4372 [0, inf].
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
4373 {expr} must evaluate to a |Float| or a |Number|.
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4374 Examples: >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4375 :echo exp(2)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4376 < 7.389056 >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4377 :echo exp(-1)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4378 < 0.367879
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4379
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4380 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4381 Compute()->exp()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4382 <
2570
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2569
diff changeset
4383 {only available when compiled with the |+float| feature}
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4384
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4385
3410
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
4386 expand({expr} [, {nosuf} [, {list}]]) *expand()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4387 Expand wildcards and the following special keywords in {expr}.
3410
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
4388 'wildignorecase' applies.
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
4389
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
4390 If {list} is given and it is |TRUE|, a List will be returned.
3410
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
4391 Otherwise the result is a String and when there are several
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
4392 matches, they are separated by <NL> characters. [Note: in
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
4393 version 5.0 a space was used, which caused problems when a
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
4394 file name contains a space]
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4395
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
4396 If the expansion fails, the result is an empty string. A name
4869
a5352e73dc00 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 4835
diff changeset
4397 for a non-existing file is not included, unless {expr} does
a5352e73dc00 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 4835
diff changeset
4398 not start with '%', '#' or '<', see below.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4399
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4400 When {expr} starts with '%', '#' or '<', the expansion is done
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4401 like for the |cmdline-special| variables with their associated
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4402 modifiers. Here is a short overview:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4403
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4404 % current file name
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4405 # alternate file name
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4406 #n alternate file name n
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4407 <cfile> file name under the cursor
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4408 <afile> autocmd file name
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4409 <abuf> autocmd buffer number (as a String!)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4410 <amatch> autocmd matched name
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22298
diff changeset
4411 <cexpr> C expression under the cursor
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5692
diff changeset
4412 <sfile> sourced script file or function name
14700
0a3b9ecf7cb8 patch 8.1.0362: cannot get the script line number when executing a function
Christian Brabandt <cb@256bit.org>
parents: 14695
diff changeset
4413 <slnum> sourced script line number or function
0a3b9ecf7cb8 patch 8.1.0362: cannot get the script line number when executing a function
Christian Brabandt <cb@256bit.org>
parents: 14695
diff changeset
4414 line number
0a3b9ecf7cb8 patch 8.1.0362: cannot get the script line number when executing a function
Christian Brabandt <cb@256bit.org>
parents: 14695
diff changeset
4415 <sflnum> script file line number, also when in
0a3b9ecf7cb8 patch 8.1.0362: cannot get the script line number when executing a function
Christian Brabandt <cb@256bit.org>
parents: 14695
diff changeset
4416 a function
21608
24cb89db078d patch 8.2.1354: test 59 is old style
Bram Moolenaar <Bram@vim.org>
parents: 21499
diff changeset
4417 <SID> "<SNR>123_" where "123" is the
24cb89db078d patch 8.2.1354: test 59 is old style
Bram Moolenaar <Bram@vim.org>
parents: 21499
diff changeset
4418 current script ID |<SID>|
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22298
diff changeset
4419 <stack> call stack
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4420 <cword> word under the cursor
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4421 <cWORD> WORD under the cursor
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4422 <client> the {clientid} of the last received
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4423 message |server2client()|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4424 Modifiers:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4425 :p expand to full path
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4426 :h head (last path component removed)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4427 :t tail (last path component only)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4428 :r root (one extension removed)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4429 :e extension only
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4430
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4431 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4432 :let &tags = expand("%:p:h") . "/tags"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4433 < Note that when expanding a string that starts with '%', '#' or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4434 '<', any following text is ignored. This does NOT work: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4435 :let doesntwork = expand("%:h.bak")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4436 < Use this: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4437 :let doeswork = expand("%:h") . ".bak"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4438 < Also note that expanding "<cfile>" and others only returns the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4439 referenced file name without further expansion. If "<cfile>"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4440 is "~/.cshrc", you need to do another expand() to have the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4441 "~/" expanded into the path of the home directory: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4442 :echo expand(expand("<cfile>"))
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4443 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4444 There cannot be white space between the variables and the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4445 following modifier. The |fnamemodify()| function can be used
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4446 to modify normal file names.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4447
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4448 When using '%' or '#', and the current or alternate file name
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4449 is not defined, an empty string is used. Using "%:p" in a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4450 buffer with no name, results in the current directory, with a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4451 '/' added.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4452
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4453 When {expr} does not start with '%', '#' or '<', it is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4454 expanded like a file name is expanded on the command line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4455 'suffixes' and 'wildignore' are used, unless the optional
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
4456 {nosuf} argument is given and it is |TRUE|.
3398
d1096a4e96bd updated for version 7.3.465
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
4457 Names for non-existing files are included. The "**" item can
d1096a4e96bd updated for version 7.3.465
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
4458 be used to search in a directory tree. For example, to find
d1096a4e96bd updated for version 7.3.465
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
4459 all "README" files in the current directory and below: >
444
d0d15b184c56 updated for version 7.0116
vimboss
parents: 438
diff changeset
4460 :echo expand("**/README")
d0d15b184c56 updated for version 7.0116
vimboss
parents: 438
diff changeset
4461 <
16019
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
4462 expand() can also be used to expand variables and environment
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4463 variables that are only known in a shell. But this can be
6180
6921742f396a Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6153
diff changeset
4464 slow, because a shell may be used to do the expansion. See
6921742f396a Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6153
diff changeset
4465 |expr-env-expand|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4466 The expanded variable is still handled like a list of file
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
4467 names. When an environment variable cannot be expanded, it is
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4468 left unchanged. Thus ":echo expand('$FOOBAR')" results in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4469 "$FOOBAR".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4470
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4471 See |glob()| for finding existing files. See |system()| for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4472 getting the raw output of an external command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4473
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4474 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4475 Getpattern()->expand()
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4476
17020
1841c03a9b5e patch 8.1.1510: a plugin cannot easily expand a command like done internally
Bram Moolenaar <Bram@vim.org>
parents: 17004
diff changeset
4477 expandcmd({expr}) *expandcmd()*
1841c03a9b5e patch 8.1.1510: a plugin cannot easily expand a command like done internally
Bram Moolenaar <Bram@vim.org>
parents: 17004
diff changeset
4478 Expand special items in {expr} like what is done for an Ex
1841c03a9b5e patch 8.1.1510: a plugin cannot easily expand a command like done internally
Bram Moolenaar <Bram@vim.org>
parents: 17004
diff changeset
4479 command such as `:edit`. This expands special keywords, like
1841c03a9b5e patch 8.1.1510: a plugin cannot easily expand a command like done internally
Bram Moolenaar <Bram@vim.org>
parents: 17004
diff changeset
4480 with |expand()|, and environment variables, anywhere in
18456
6d11fc4aa683 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18343
diff changeset
4481 {expr}. "~user" and "~/path" are only expanded at the start.
6d11fc4aa683 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18343
diff changeset
4482 Returns the expanded string. Example: >
17020
1841c03a9b5e patch 8.1.1510: a plugin cannot easily expand a command like done internally
Bram Moolenaar <Bram@vim.org>
parents: 17004
diff changeset
4483 :echo expandcmd('make %<.o')
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4484
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4485 < Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4486 GetCommand()->expandcmd()
17020
1841c03a9b5e patch 8.1.1510: a plugin cannot easily expand a command like done internally
Bram Moolenaar <Bram@vim.org>
parents: 17004
diff changeset
4487 <
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4488 extend({expr1}, {expr2} [, {expr3}]) *extend()*
692
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
4489 {expr1} and {expr2} must be both |Lists| or both
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
4490 |Dictionaries|.
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
4491
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
4492 If they are |Lists|: Append {expr2} to {expr1}.
22824
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
4493 If {expr3} is given insert the items of {expr2} before the
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
4494 item with index {expr3} in {expr1}. When {expr3} is zero
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
4495 insert before the first item. When {expr3} is equal to
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
4496 len({expr1}) then {expr2} is appended.
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
4497 Examples: >
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
4498 :echo sort(extend(mylist, [7, 5]))
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
4499 :call extend(mylist, [2, 3], 1)
1699
9d74e2f433c0 updated for version 7.2c-001
vimboss
parents: 1698
diff changeset
4500 < When {expr1} is the same List as {expr2} then the number of
9d74e2f433c0 updated for version 7.2c-001
vimboss
parents: 1698
diff changeset
4501 items copied is equal to the original length of the List.
9d74e2f433c0 updated for version 7.2c-001
vimboss
parents: 1698
diff changeset
4502 E.g., when {expr3} is 1 you get N new copies of the first item
9d74e2f433c0 updated for version 7.2c-001
vimboss
parents: 1698
diff changeset
4503 (where N is the original length of the List).
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
4504 Use |add()| to concatenate one item to a list. To concatenate
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
4505 two lists into a new list use the + operator: >
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
4506 :let newlist = [1, 2, 3] + [4, 5]
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4507 <
692
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
4508 If they are |Dictionaries|:
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4509 Add all entries from {expr2} to {expr1}.
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4510 If a key exists in both {expr1} and {expr2} then {expr3} is
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4511 used to decide what to do:
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4512 {expr3} = "keep": keep the value of {expr1}
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4513 {expr3} = "force": use the value of {expr2}
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
4514 {expr3} = "error": give an error message *E737*
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4515 When {expr3} is omitted then "force" is assumed.
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4516
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4517 {expr1} is changed when {expr2} is not empty. If necessary
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4518 make a copy of {expr1} first.
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4519 {expr2} remains unchanged.
6823
0303182665d5 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6741
diff changeset
4520 When {expr1} is locked and {expr2} is not empty the operation
0303182665d5 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6741
diff changeset
4521 fails.
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4522 Returns {expr1}.
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4523
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
4524 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
4525 mylist->extend(otherlist)
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
4526
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
4527
23588
510088f8c66f patch 8.2.2336: Vim9: not possible to extend dictionary with different type
Bram Moolenaar <Bram@vim.org>
parents: 23563
diff changeset
4528 extendnew({expr1}, {expr2} [, {expr3}]) *extendnew()*
510088f8c66f patch 8.2.2336: Vim9: not possible to extend dictionary with different type
Bram Moolenaar <Bram@vim.org>
parents: 23563
diff changeset
4529 Like |extend()| but instead of adding items to {expr1} a new
510088f8c66f patch 8.2.2336: Vim9: not possible to extend dictionary with different type
Bram Moolenaar <Bram@vim.org>
parents: 23563
diff changeset
4530 List or Dictionary is created and returned. {expr1} remains
510088f8c66f patch 8.2.2336: Vim9: not possible to extend dictionary with different type
Bram Moolenaar <Bram@vim.org>
parents: 23563
diff changeset
4531 unchanged. Items can still be changed by {expr2}, if you
510088f8c66f patch 8.2.2336: Vim9: not possible to extend dictionary with different type
Bram Moolenaar <Bram@vim.org>
parents: 23563
diff changeset
4532 don't want that use |deepcopy()| first.
510088f8c66f patch 8.2.2336: Vim9: not possible to extend dictionary with different type
Bram Moolenaar <Bram@vim.org>
parents: 23563
diff changeset
4533
510088f8c66f patch 8.2.2336: Vim9: not possible to extend dictionary with different type
Bram Moolenaar <Bram@vim.org>
parents: 23563
diff changeset
4534
842
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
4535 feedkeys({string} [, {mode}]) *feedkeys()*
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
4536 Characters in {string} are queued for processing as if they
6549
2561531decf1 updated for version 7.4.601
Bram Moolenaar <bram@vim.org>
parents: 6530
diff changeset
4537 come from a mapping or were typed by the user.
15378
0d76dd701e49 patch 8.1.0697: ":sign place" requires the buffer argument
Bram Moolenaar <Bram@vim.org>
parents: 15335
diff changeset
4538
6549
2561531decf1 updated for version 7.4.601
Bram Moolenaar <bram@vim.org>
parents: 6530
diff changeset
4539 By default the string is added to the end of the typeahead
2561531decf1 updated for version 7.4.601
Bram Moolenaar <bram@vim.org>
parents: 6530
diff changeset
4540 buffer, thus if a mapping is still being executed the
2561531decf1 updated for version 7.4.601
Bram Moolenaar <bram@vim.org>
parents: 6530
diff changeset
4541 characters come after them. Use the 'i' flag to insert before
2561531decf1 updated for version 7.4.601
Bram Moolenaar <bram@vim.org>
parents: 6530
diff changeset
4542 other characters, they will be executed next, before any
2561531decf1 updated for version 7.4.601
Bram Moolenaar <bram@vim.org>
parents: 6530
diff changeset
4543 characters from a mapping.
15378
0d76dd701e49 patch 8.1.0697: ":sign place" requires the buffer argument
Bram Moolenaar <Bram@vim.org>
parents: 15335
diff changeset
4544
842
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
4545 The function does not wait for processing of keys contained in
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
4546 {string}.
15378
0d76dd701e49 patch 8.1.0697: ":sign place" requires the buffer argument
Bram Moolenaar <Bram@vim.org>
parents: 15335
diff changeset
4547
842
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
4548 To include special keys into {string}, use double-quotes
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
4549 and "\..." notation |expr-quote|. For example,
1215
1d08aac0aea9 updated for version 7.1b
vimboss
parents: 1156
diff changeset
4550 feedkeys("\<CR>") simulates pressing of the <Enter> key. But
842
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
4551 feedkeys('\<CR>') pushes 5 characters.
16600
ff3c99bd1038 patch 8.1.1303: not possible to hide a balloon
Bram Moolenaar <Bram@vim.org>
parents: 16576
diff changeset
4552 A special code that might be useful is <Ignore>, it exits the
ff3c99bd1038 patch 8.1.1303: not possible to hide a balloon
Bram Moolenaar <Bram@vim.org>
parents: 16576
diff changeset
4553 wait for a character without doing anything. *<Ignore>*
15378
0d76dd701e49 patch 8.1.0697: ":sign place" requires the buffer argument
Bram Moolenaar <Bram@vim.org>
parents: 15335
diff changeset
4554
842
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
4555 {mode} is a String, which can contain these character flags:
15378
0d76dd701e49 patch 8.1.0697: ":sign place" requires the buffer argument
Bram Moolenaar <Bram@vim.org>
parents: 15335
diff changeset
4556 'm' Remap keys. This is default. If {mode} is absent,
0d76dd701e49 patch 8.1.0697: ":sign place" requires the buffer argument
Bram Moolenaar <Bram@vim.org>
parents: 15335
diff changeset
4557 keys are remapped.
843
9f279ebda751 updated for version 7.0f01
vimboss
parents: 842
diff changeset
4558 'n' Do not remap keys.
9f279ebda751 updated for version 7.0f01
vimboss
parents: 842
diff changeset
4559 't' Handle keys as if typed; otherwise they are handled as
9f279ebda751 updated for version 7.0f01
vimboss
parents: 842
diff changeset
4560 if coming from a mapping. This matters for undo,
9f279ebda751 updated for version 7.0f01
vimboss
parents: 842
diff changeset
4561 opening folds, etc.
15615
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
4562 'L' Lowlevel input. Only works for Unix or when using the
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
4563 GUI. Keys are used as if they were coming from the
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
4564 terminal. Other flags are not used. *E980*
19742
810eee1b42e3 patch 8.2.0427: it is not possible to check for a typo in a feature name
Bram Moolenaar <Bram@vim.org>
parents: 19721
diff changeset
4565 When a CTRL-C interrupts and 't' is included it sets
810eee1b42e3 patch 8.2.0427: it is not possible to check for a typo in a feature name
Bram Moolenaar <Bram@vim.org>
parents: 19721
diff changeset
4566 the internal "got_int" flag.
6549
2561531decf1 updated for version 7.4.601
Bram Moolenaar <bram@vim.org>
parents: 6530
diff changeset
4567 'i' Insert the string instead of appending (see above).
7703
39251e981d1f commit https://github.com/vim/vim/commit/25281634cda03ce302aaf9f906a9520b5f81f91e
Christian Brabandt <cb@256bit.org>
parents: 7659
diff changeset
4568 'x' Execute commands until typeahead is empty. This is
39251e981d1f commit https://github.com/vim/vim/commit/25281634cda03ce302aaf9f906a9520b5f81f91e
Christian Brabandt <cb@256bit.org>
parents: 7659
diff changeset
4569 similar to using ":normal!". You can call feedkeys()
39251e981d1f commit https://github.com/vim/vim/commit/25281634cda03ce302aaf9f906a9520b5f81f91e
Christian Brabandt <cb@256bit.org>
parents: 7659
diff changeset
4570 several times without 'x' and then one time with 'x'
39251e981d1f commit https://github.com/vim/vim/commit/25281634cda03ce302aaf9f906a9520b5f81f91e
Christian Brabandt <cb@256bit.org>
parents: 7659
diff changeset
4571 (possibly with an empty {string}) to execute all the
8876
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
4572 typeahead. Note that when Vim ends in Insert mode it
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
4573 will behave as if <Esc> is typed, to avoid getting
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
4574 stuck, waiting for a character to be typed before the
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
4575 script continues.
15378
0d76dd701e49 patch 8.1.0697: ":sign place" requires the buffer argument
Bram Moolenaar <Bram@vim.org>
parents: 15335
diff changeset
4576 Note that if you manage to call feedkeys() while
15424
90c8ff9c19ee patch 8.1.0720: cannot easily change the current quickfx list index
Bram Moolenaar <Bram@vim.org>
parents: 15418
diff changeset
4577 executing commands, thus calling it recursively, then
20687
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
4578 all typeahead will be consumed by the last call.
8951
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
4579 '!' When used with 'x' will not end Insert mode. Can be
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
4580 used in a test when a timer is set to exit Insert mode
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
4581 a little later. Useful for testing CursorHoldI.
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
4582
842
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
4583 Return value is always 0.
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
4584
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4585 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4586 GetInput()->feedkeys()
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4587
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4588 filereadable({file}) *filereadable()*
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
4589 The result is a Number, which is |TRUE| when a file with the
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4590 name {file} exists, and can be read. If {file} doesn't exist,
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
4591 or is a directory, the result is |FALSE|. {file} is any
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4592 expression, which is used as a String.
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
4593 If you don't care about the file being readable you can use
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
4594 |glob()|.
17620
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
4595 {file} is used as-is, you may want to expand wildcards first: >
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
4596 echo filereadable('~/.vimrc')
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
4597 0
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
4598 echo filereadable(expand('~/.vimrc'))
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
4599 1
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4600
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4601 < Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4602 GetName()->filereadable()
17620
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
4603 < *file_readable()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4604 Obsolete name: file_readable().
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4605
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
4606
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
4607 filewritable({file}) *filewritable()*
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
4608 The result is a Number, which is 1 when a file with the
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
4609 name {file} exists, and can be written. If {file} doesn't
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4610 exist, or is not writable, the result is 0. If {file} is a
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
4611 directory, and we can write to it, the result is 2.
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
4612
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4613 Can also be used as a |method|: >
20687
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
4614 GetName()->filewritable()
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4615
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
4616
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4617 filter({expr1}, {expr2}) *filter()*
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4618 {expr1} must be a |List| or a |Dictionary|.
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4619 For each item in {expr1} evaluate {expr2} and when the result
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4620 is zero remove the item from the |List| or |Dictionary|.
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4621 {expr2} must be a |string| or |Funcref|.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
4622
10218
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
4623 If {expr2} is a |string|, inside {expr2} |v:val| has the value
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4624 of the current item. For a |Dictionary| |v:key| has the key
10218
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
4625 of the current item and for a |List| |v:key| has the index of
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
4626 the current item.
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4627 Examples: >
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4628 call filter(mylist, 'v:val !~ "OLD"')
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4629 < Removes the items where "OLD" appears. >
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4630 call filter(mydict, 'v:key >= 8')
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4631 < Removes the items with a key below 8. >
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4632 call filter(var, 0)
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4633 < Removes all the items, thus clears the |List| or |Dictionary|.
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
4634
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4635 Note that {expr2} is the result of expression and is then
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4636 used as an expression again. Often it is good to use a
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4637 |literal-string| to avoid having to double backslashes.
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4638
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4639 If {expr2} is a |Funcref| it must take two arguments:
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4640 1. the key or the index of the current item.
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4641 2. the value of the current item.
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
4642 The function must return |TRUE| if the item should be kept.
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4643 Example that keeps the odd items of a list: >
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4644 func Odd(idx, val)
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4645 return a:idx % 2 == 1
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4646 endfunc
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4647 call filter(mylist, function('Odd'))
10218
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
4648 < It is shorter when using a |lambda|: >
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
4649 call filter(myList, {idx, val -> idx * val <= 42})
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
4650 < If you do not use "val" you can leave it out: >
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
4651 call filter(myList, {idx -> idx % 2 == 1})
10244
876fbdd84e52 commit https://github.com/vim/vim/commit/2ec618c9feac4573b154510236ad8121c77d0eca
Christian Brabandt <cb@256bit.org>
parents: 10237
diff changeset
4652 <
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4653 The operation is done in-place. If you want a |List| or
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4654 |Dictionary| to remain unmodified make a copy first: >
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 648
diff changeset
4655 :let l = filter(copy(mylist), 'v:val =~ "KEEP"')
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
4656
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4657 < Returns {expr1}, the |List| or |Dictionary| that was filtered.
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4658 When an error is encountered while evaluating {expr2} no
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4659 further items in {expr1} are processed. When {expr2} is a
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4660 Funcref errors inside a function are ignored, unless it was
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
4661 defined with the "abort" flag.
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
4662
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
4663 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
4664 mylist->filter(expr2)
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
4665
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
4666 finddir({name} [, {path} [, {count}]]) *finddir()*
1095
4c8b90b7a94a updated for version 7.0-221
vimboss
parents: 1065
diff changeset
4667 Find directory {name} in {path}. Supports both downwards and
4c8b90b7a94a updated for version 7.0-221
vimboss
parents: 1065
diff changeset
4668 upwards recursive directory searches. See |file-searching|
4c8b90b7a94a updated for version 7.0-221
vimboss
parents: 1065
diff changeset
4669 for the syntax of {path}.
4c8b90b7a94a updated for version 7.0-221
vimboss
parents: 1065
diff changeset
4670 Returns the path of the first found match. When the found
4c8b90b7a94a updated for version 7.0-221
vimboss
parents: 1065
diff changeset
4671 directory is below the current directory a relative path is
4c8b90b7a94a updated for version 7.0-221
vimboss
parents: 1065
diff changeset
4672 returned. Otherwise a full path is returned.
19
a81bc802c17c updated for version 7.0011
vimboss
parents: 18
diff changeset
4673 If {path} is omitted or empty then 'path' is used.
a81bc802c17c updated for version 7.0011
vimboss
parents: 18
diff changeset
4674 If the optional {count} is given, find {count}'s occurrence of
794
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
4675 {name} in {path} instead of the first one.
809
4f1b94b51e99 updated for version 7.0b02
vimboss
parents: 805
diff changeset
4676 When {count} is negative return all the matches in a |List|.
19
a81bc802c17c updated for version 7.0011
vimboss
parents: 18
diff changeset
4677 This is quite similar to the ex-command |:find|.
2570
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2569
diff changeset
4678 {only available when compiled with the |+file_in_path|
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2569
diff changeset
4679 feature}
794
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
4680
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4681 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4682 GetName()->finddir()
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4683
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
4684 findfile({name} [, {path} [, {count}]]) *findfile()*
794
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
4685 Just like |finddir()|, but find a file instead of a directory.
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
4686 Uses 'suffixesadd'.
19
a81bc802c17c updated for version 7.0011
vimboss
parents: 18
diff changeset
4687 Example: >
a81bc802c17c updated for version 7.0011
vimboss
parents: 18
diff changeset
4688 :echo findfile("tags.vim", ".;")
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
4689 < Searches from the directory of the current file upwards until
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
4690 it finds the file "tags.vim".
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4691
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4692 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4693 GetName()->findfile()
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4694
20766
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4695 flatten({list} [, {maxdepth}]) *flatten()*
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4696 Flatten {list} up to {maxdepth} levels. Without {maxdepth}
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4697 the result is a |List| without nesting, as if {maxdepth} is
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4698 a very large number.
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4699 The {list} is changed in place, make a copy first if you do
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4700 not want that.
20965
59f93c2d2551 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20889
diff changeset
4701 *E900*
20766
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4702 {maxdepth} means how deep in nested lists changes are made.
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4703 {list} is not modified when {maxdepth} is 0.
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4704 {maxdepth} must be positive number.
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4705
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4706 If there is an error the number zero is returned.
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4707
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4708 Example: >
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4709 :echo flatten([1, [2, [3, 4]], 5])
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4710 < [1, 2, 3, 4, 5] >
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4711 :echo flatten([1, [2, [3, 4]], 5], 1)
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4712 < [1, 2, [3, 4], 5]
821925509d8c patch 8.2.0935: flattening a list with existing code is slow
Bram Moolenaar <Bram@vim.org>
parents: 20753
diff changeset
4713
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4714 float2nr({expr}) *float2nr()*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4715 Convert {expr} to a Number by omitting the part after the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4716 decimal point.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4717 {expr} must evaluate to a |Float| or a Number.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4718 When the value of {expr} is out of range for a |Number| the
9389
32e34e574716 commit https://github.com/vim/vim/commit/22fcfad29276bd5f317faf516637dcd491b96a12
Christian Brabandt <cb@256bit.org>
parents: 9344
diff changeset
4719 result is truncated to 0x7fffffff or -0x7fffffff (or when
32e34e574716 commit https://github.com/vim/vim/commit/22fcfad29276bd5f317faf516637dcd491b96a12
Christian Brabandt <cb@256bit.org>
parents: 9344
diff changeset
4720 64-bit Number support is enabled, 0x7fffffffffffffff or
12427
fc3e2d5614dd patch 8.0.1093: various small quickfix issues
Christian Brabandt <cb@256bit.org>
parents: 12389
diff changeset
4721 -0x7fffffffffffffff). NaN results in -0x80000000 (or when
9389
32e34e574716 commit https://github.com/vim/vim/commit/22fcfad29276bd5f317faf516637dcd491b96a12
Christian Brabandt <cb@256bit.org>
parents: 9344
diff changeset
4722 64-bit Number support is enabled, -0x8000000000000000).
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4723 Examples: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4724 echo float2nr(3.95)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4725 < 3 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4726 echo float2nr(-23.45)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4727 < -23 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4728 echo float2nr(1.0e100)
9389
32e34e574716 commit https://github.com/vim/vim/commit/22fcfad29276bd5f317faf516637dcd491b96a12
Christian Brabandt <cb@256bit.org>
parents: 9344
diff changeset
4729 < 2147483647 (or 9223372036854775807) >
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4730 echo float2nr(-1.0e150)
9389
32e34e574716 commit https://github.com/vim/vim/commit/22fcfad29276bd5f317faf516637dcd491b96a12
Christian Brabandt <cb@256bit.org>
parents: 9344
diff changeset
4731 < -2147483647 (or -9223372036854775807) >
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4732 echo float2nr(1.0e-100)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4733 < 0
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4734
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4735 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4736 Compute()->float2nr()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4737 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4738 {only available when compiled with the |+float| feature}
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4739
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4740
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4741 floor({expr}) *floor()*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4742 Return the largest integral value less than or equal to
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4743 {expr} as a |Float| (round down).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4744 {expr} must evaluate to a |Float| or a |Number|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4745 Examples: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4746 echo floor(1.856)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4747 < 1.0 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4748 echo floor(-5.456)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4749 < -6.0 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4750 echo floor(4.0)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4751 < 4.0
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4752
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4753 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4754 Compute()->floor()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4755 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4756 {only available when compiled with the |+float| feature}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
4757
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4758
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4759 fmod({expr1}, {expr2}) *fmod()*
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4760 Return the remainder of {expr1} / {expr2}, even if the
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4761 division is not representable. Returns {expr1} - i * {expr2}
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4762 for some integer i such that if {expr2} is non-zero, the
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4763 result has the same sign as {expr1} and magnitude less than
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4764 the magnitude of {expr2}. If {expr2} is zero, the value
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
4765 returned is zero. The value returned is a |Float|.
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
4766 {expr1} and {expr2} must evaluate to a |Float| or a |Number|.
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4767 Examples: >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4768 :echo fmod(12.33, 1.22)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4769 < 0.13 >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4770 :echo fmod(-12.33, 1.22)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4771 < -0.13
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4772
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4773 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4774 Compute()->fmod(1.22)
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
4775 <
2570
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2569
diff changeset
4776 {only available when compiled with |+float| feature}
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4777
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
4778
1586
fe7db192c7cc updated for version 7.1-299
vimboss
parents: 1548
diff changeset
4779 fnameescape({string}) *fnameescape()*
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
4780 Escape {string} for use as file name command argument. All
1586
fe7db192c7cc updated for version 7.1-299
vimboss
parents: 1548
diff changeset
4781 characters that have a special meaning, such as '%' and '|'
fe7db192c7cc updated for version 7.1-299
vimboss
parents: 1548
diff changeset
4782 are escaped with a backslash.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4783 For most systems the characters escaped are
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4784 " \t\n*?[{`$\\%#'\"|!<". For systems where a backslash
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
4785 appears in a filename, it depends on the value of 'isfname'.
1700
9e1cefec84dd updated for version 7.2c-002
vimboss
parents: 1699
diff changeset
4786 A leading '+' and '>' is also escaped (special after |:edit|
9e1cefec84dd updated for version 7.2c-002
vimboss
parents: 1699
diff changeset
4787 and |:write|). And a "-" by itself (special after |:cd|).
1586
fe7db192c7cc updated for version 7.1-299
vimboss
parents: 1548
diff changeset
4788 Example: >
1700
9e1cefec84dd updated for version 7.2c-002
vimboss
parents: 1699
diff changeset
4789 :let fname = '+some str%nge|name'
1586
fe7db192c7cc updated for version 7.1-299
vimboss
parents: 1548
diff changeset
4790 :exe "edit " . fnameescape(fname)
fe7db192c7cc updated for version 7.1-299
vimboss
parents: 1548
diff changeset
4791 < results in executing: >
1700
9e1cefec84dd updated for version 7.2c-002
vimboss
parents: 1699
diff changeset
4792 edit \+some\ str\%nge\|name
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4793 <
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4794 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4795 GetName()->fnameescape()
1586
fe7db192c7cc updated for version 7.1-299
vimboss
parents: 1548
diff changeset
4796
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4797 fnamemodify({fname}, {mods}) *fnamemodify()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4798 Modify file name {fname} according to {mods}. {mods} is a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4799 string of characters like it is used for file names on the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4800 command line. See |filename-modifiers|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4801 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4802 :echo fnamemodify("main.c", ":p:h")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4803 < results in: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4804 /home/mool/vim/vim/src
23305
fab58304f77d Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23164
diff changeset
4805 < If {mods} is empty then {fname} is returned.
fab58304f77d Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23164
diff changeset
4806 Note: Environment variables don't work in {fname}, use
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4807 |expand()| first then.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4808
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4809 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4810 GetName()->fnamemodify(':p:h')
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4811
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4812 foldclosed({lnum}) *foldclosed()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4813 The result is a Number. If the line {lnum} is in a closed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4814 fold, the result is the number of the first line in that fold.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4815 If the line {lnum} is not in a closed fold, -1 is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4816
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4817 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4818 GetLnum()->foldclosed()
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4819
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4820 foldclosedend({lnum}) *foldclosedend()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4821 The result is a Number. If the line {lnum} is in a closed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4822 fold, the result is the number of the last line in that fold.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4823 If the line {lnum} is not in a closed fold, -1 is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4824
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4825 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4826 GetLnum()->foldclosedend()
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4827
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4828 foldlevel({lnum}) *foldlevel()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4829 The result is a Number, which is the foldlevel of line {lnum}
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
4830 in the current buffer. For nested folds the deepest level is
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4831 returned. If there is no fold at line {lnum}, zero is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4832 returned. It doesn't matter if the folds are open or closed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4833 When used while updating folds (from 'foldexpr') -1 is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4834 returned for lines where folds are still to be updated and the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4835 foldlevel is unknown. As a special case the level of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4836 previous line is usually available.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4837
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4838 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4839 GetLnum()->foldlevel()
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
4840 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4841 *foldtext()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4842 foldtext() Returns a String, to be displayed for a closed fold. This is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4843 the default function used for the 'foldtext' option and should
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4844 only be called from evaluating 'foldtext'. It uses the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4845 |v:foldstart|, |v:foldend| and |v:folddashes| variables.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4846 The returned string looks like this: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4847 +-- 45 lines: abcdef
11181
13544aa85dc0 patch 8.0.0477: the client-server test may hang when failing
Christian Brabandt <cb@256bit.org>
parents: 11177
diff changeset
4848 < The number of leading dashes depends on the foldlevel. The
13544aa85dc0 patch 8.0.0477: the client-server test may hang when failing
Christian Brabandt <cb@256bit.org>
parents: 11177
diff changeset
4849 "45" is the number of lines in the fold. "abcdef" is the text
13544aa85dc0 patch 8.0.0477: the client-server test may hang when failing
Christian Brabandt <cb@256bit.org>
parents: 11177
diff changeset
4850 in the first non-blank line of the fold. Leading white space,
13544aa85dc0 patch 8.0.0477: the client-server test may hang when failing
Christian Brabandt <cb@256bit.org>
parents: 11177
diff changeset
4851 "//" or "/*" and the text from the 'foldmarker' and
13544aa85dc0 patch 8.0.0477: the client-server test may hang when failing
Christian Brabandt <cb@256bit.org>
parents: 11177
diff changeset
4852 'commentstring' options is removed.
13544aa85dc0 patch 8.0.0477: the client-server test may hang when failing
Christian Brabandt <cb@256bit.org>
parents: 11177
diff changeset
4853 When used to draw the actual foldtext, the rest of the line
13544aa85dc0 patch 8.0.0477: the client-server test may hang when failing
Christian Brabandt <cb@256bit.org>
parents: 11177
diff changeset
4854 will be filled with the fold char from the 'fillchars'
13544aa85dc0 patch 8.0.0477: the client-server test may hang when failing
Christian Brabandt <cb@256bit.org>
parents: 11177
diff changeset
4855 setting.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4856 {not available when compiled without the |+folding| feature}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4857
29
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
4858 foldtextresult({lnum}) *foldtextresult()*
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
4859 Returns the text that is displayed for the closed fold at line
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
4860 {lnum}. Evaluates 'foldtext' in the appropriate context.
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
4861 When there is no closed fold at {lnum} an empty string is
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
4862 returned.
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
4863 {lnum} is used like with |getline()|. Thus "." is the current
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
4864 line, "'m" mark m, etc.
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
4865 Useful when exporting folded text, e.g., to HTML.
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
4866 {not available when compiled without the |+folding| feature}
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
4867
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4868
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4869 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4870 GetLnum()->foldtextresult()
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4871 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4872 *foreground()*
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
4873 foreground() Move the Vim window to the foreground. Useful when sent from
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4874 a client to a Vim server. |remote_send()|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4875 On Win32 systems this might not work, the OS does not always
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4876 allow a window to bring itself to the foreground. Use
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4877 |remote_foreground()| instead.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4878 {only in the Win32, Athena, Motif and GTK GUI versions and the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4879 Win32 console version}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4880
9723
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
4881 *funcref()*
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
4882 funcref({name} [, {arglist}] [, {dict}])
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
4883 Just like |function()|, but the returned Funcref will lookup
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
4884 the function by reference, not by name. This matters when the
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
4885 function {name} is redefined later.
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
4886
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
4887 Unlike |function()|, {name} must be an existing user function.
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
4888 Also for autoloaded functions. {name} cannot be a builtin
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
4889 function.
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
4890
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4891 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4892 GetFuncname()->funcref([arg])
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4893 <
8538
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4894 *function()* *E700* *E922* *E923*
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4895 function({name} [, {arglist}] [, {dict}])
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4896 Return a |Funcref| variable that refers to function {name}.
8577
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
4897 {name} can be the name of a user defined function or an
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
4898 internal function.
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
4899
9723
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
4900 {name} can also be a Funcref or a partial. When it is a
8577
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
4901 partial the dict stored in it will be used and the {dict}
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
4902 argument is not allowed. E.g.: >
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
4903 let FuncWithArg = function(dict.Func, [arg])
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
4904 let Broken = function(dict.Func, [arg], dict)
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
4905 <
9723
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
4906 When using the Funcref the function will be found by {name},
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
4907 also when it was redefined later. Use |funcref()| to keep the
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
4908 same function.
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
4909
8538
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4910 When {arglist} or {dict} is present this creates a partial.
9097
071f9da012fb commit https://github.com/vim/vim/commit/06d2d38ab7564e1f784b1058a4ef4580cd6d1810
Christian Brabandt <cb@256bit.org>
parents: 9076
diff changeset
4911 That means the argument list and/or the dictionary is stored in
8538
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4912 the Funcref and will be used when the Funcref is called.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
4913
8538
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4914 The arguments are passed to the function in front of other
17667
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
4915 arguments, but after any argument from |method|. Example: >
8538
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4916 func Callback(arg1, arg2, name)
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4917 ...
17667
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
4918 let Partial = function('Callback', ['one', 'two'])
8538
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4919 ...
17667
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
4920 call Partial('name')
8538
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4921 < Invokes the function as with: >
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4922 call Callback('one', 'two', 'name')
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4923
17667
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
4924 < With a |method|: >
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
4925 func Callback(one, two, three)
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
4926 ...
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
4927 let Partial = function('Callback', ['two'])
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
4928 ...
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
4929 eval 'one'->Partial('three')
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
4930 < Invokes the function as with: >
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
4931 call Callback('one', 'two', 'three')
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
4932
8669
06848fe9c816 commit https://github.com/vim/vim/commit/03602ec28ed25739e88b2c835adb0662d3720bb2
Christian Brabandt <cb@256bit.org>
parents: 8577
diff changeset
4933 < The function() call can be nested to add more arguments to the
06848fe9c816 commit https://github.com/vim/vim/commit/03602ec28ed25739e88b2c835adb0662d3720bb2
Christian Brabandt <cb@256bit.org>
parents: 8577
diff changeset
4934 Funcref. The extra arguments are appended to the list of
06848fe9c816 commit https://github.com/vim/vim/commit/03602ec28ed25739e88b2c835adb0662d3720bb2
Christian Brabandt <cb@256bit.org>
parents: 8577
diff changeset
4935 arguments. Example: >
06848fe9c816 commit https://github.com/vim/vim/commit/03602ec28ed25739e88b2c835adb0662d3720bb2
Christian Brabandt <cb@256bit.org>
parents: 8577
diff changeset
4936 func Callback(arg1, arg2, name)
06848fe9c816 commit https://github.com/vim/vim/commit/03602ec28ed25739e88b2c835adb0662d3720bb2
Christian Brabandt <cb@256bit.org>
parents: 8577
diff changeset
4937 ...
06848fe9c816 commit https://github.com/vim/vim/commit/03602ec28ed25739e88b2c835adb0662d3720bb2
Christian Brabandt <cb@256bit.org>
parents: 8577
diff changeset
4938 let Func = function('Callback', ['one'])
06848fe9c816 commit https://github.com/vim/vim/commit/03602ec28ed25739e88b2c835adb0662d3720bb2
Christian Brabandt <cb@256bit.org>
parents: 8577
diff changeset
4939 let Func2 = function(Func, ['two'])
06848fe9c816 commit https://github.com/vim/vim/commit/03602ec28ed25739e88b2c835adb0662d3720bb2
Christian Brabandt <cb@256bit.org>
parents: 8577
diff changeset
4940 ...
06848fe9c816 commit https://github.com/vim/vim/commit/03602ec28ed25739e88b2c835adb0662d3720bb2
Christian Brabandt <cb@256bit.org>
parents: 8577
diff changeset
4941 call Func2('name')
06848fe9c816 commit https://github.com/vim/vim/commit/03602ec28ed25739e88b2c835adb0662d3720bb2
Christian Brabandt <cb@256bit.org>
parents: 8577
diff changeset
4942 < Invokes the function as with: >
06848fe9c816 commit https://github.com/vim/vim/commit/03602ec28ed25739e88b2c835adb0662d3720bb2
Christian Brabandt <cb@256bit.org>
parents: 8577
diff changeset
4943 call Callback('one', 'two', 'name')
06848fe9c816 commit https://github.com/vim/vim/commit/03602ec28ed25739e88b2c835adb0662d3720bb2
Christian Brabandt <cb@256bit.org>
parents: 8577
diff changeset
4944
8538
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4945 < The Dictionary is only useful when calling a "dict" function.
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4946 In that case the {dict} is passed in as "self". Example: >
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4947 function Callback() dict
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4948 echo "called for " . self.name
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4949 endfunction
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4950 ...
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4951 let context = {"name": "example"}
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4952 let Func = function('Callback', context)
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4953 ...
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4954 call Func() " will echo: called for example
8577
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
4955 < The use of function() is not needed when there are no extra
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
4956 arguments, these two are equivalent: >
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
4957 let Func = function('Callback', context)
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
4958 let Func = context.Callback
8538
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4959
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4960 < The argument list and the Dictionary can be combined: >
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4961 function Callback(arg1, count) dict
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4962 ...
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4963 let context = {"name": "example"}
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4964 let Func = function('Callback', ['one'], context)
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4965 ...
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4966 call Func(500)
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4967 < Invokes the function as with: >
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4968 call context.Callback('one', 500)
17849
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4969 <
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4970 Can also be used as a |method|: >
73ddc462979d patch 8.1.1921: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17837
diff changeset
4971 GetFuncname()->function([arg])
8538
c337c813c64d commit https://github.com/vim/vim/commit/1735bc988c546cc962c5f94792815b4d7cb79710
Christian Brabandt <cb@256bit.org>
parents: 8536
diff changeset
4972
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
4973
3224
8b8ef1fed009 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3214
diff changeset
4974 garbagecollect([{atexit}]) *garbagecollect()*
8881
ed0b39dd7fd6 commit https://github.com/vim/vim/commit/ebf7dfa6f121c82f97d2adca3d45fbaba9ad8f7e
Christian Brabandt <cb@256bit.org>
parents: 8876
diff changeset
4975 Cleanup unused |Lists|, |Dictionaries|, |Channels| and |Jobs|
ed0b39dd7fd6 commit https://github.com/vim/vim/commit/ebf7dfa6f121c82f97d2adca3d45fbaba9ad8f7e
Christian Brabandt <cb@256bit.org>
parents: 8876
diff changeset
4976 that have circular references.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
4977
8881
ed0b39dd7fd6 commit https://github.com/vim/vim/commit/ebf7dfa6f121c82f97d2adca3d45fbaba9ad8f7e
Christian Brabandt <cb@256bit.org>
parents: 8876
diff changeset
4978 There is hardly ever a need to invoke this function, as it is
ed0b39dd7fd6 commit https://github.com/vim/vim/commit/ebf7dfa6f121c82f97d2adca3d45fbaba9ad8f7e
Christian Brabandt <cb@256bit.org>
parents: 8876
diff changeset
4979 automatically done when Vim runs out of memory or is waiting
ed0b39dd7fd6 commit https://github.com/vim/vim/commit/ebf7dfa6f121c82f97d2adca3d45fbaba9ad8f7e
Christian Brabandt <cb@256bit.org>
parents: 8876
diff changeset
4980 for the user to press a key after 'updatetime'. Items without
ed0b39dd7fd6 commit https://github.com/vim/vim/commit/ebf7dfa6f121c82f97d2adca3d45fbaba9ad8f7e
Christian Brabandt <cb@256bit.org>
parents: 8876
diff changeset
4981 circular references are always freed when they become unused.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4982 This is useful if you have deleted a very big |List| and/or
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4983 |Dictionary| with circular references in a script that runs
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4984 for a long time.
8881
ed0b39dd7fd6 commit https://github.com/vim/vim/commit/ebf7dfa6f121c82f97d2adca3d45fbaba9ad8f7e
Christian Brabandt <cb@256bit.org>
parents: 8876
diff changeset
4985
3224
8b8ef1fed009 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3214
diff changeset
4986 When the optional {atexit} argument is one, garbage
1405
b63792dadc23 updated for version 7.1-120
vimboss
parents: 1326
diff changeset
4987 collection will also be done when exiting Vim, if it wasn't
b63792dadc23 updated for version 7.1-120
vimboss
parents: 1326
diff changeset
4988 done before. This is useful when checking for memory leaks.
370
3a21825ad207 updated for version 7.0095
vimboss
parents: 359
diff changeset
4989
9108
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
4990 The garbage collection is not done immediately but only when
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
4991 it's safe to perform. This is when waiting for the user to
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
4992 type a character. To force garbage collection immediately use
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
4993 |test_garbagecollect_now()|.
8881
ed0b39dd7fd6 commit https://github.com/vim/vim/commit/ebf7dfa6f121c82f97d2adca3d45fbaba9ad8f7e
Christian Brabandt <cb@256bit.org>
parents: 8876
diff changeset
4994
140
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
4995 get({list}, {idx} [, {default}]) *get()*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
4996 Get item {idx} from |List| {list}. When this item is not
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
4997 available return {default}. Return zero when {default} is
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
4998 omitted.
21250
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
4999 Preferably used as a |method|: >
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
5000 mylist->get(idx)
15498
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
5001 get({blob}, {idx} [, {default}])
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
5002 Get byte {idx} from |Blob| {blob}. When this byte is not
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
5003 available return {default}. Return -1 when {default} is
e1de20a47fa9 patch 8.1.0757: not enough documentation for Blobs
Bram Moolenaar <Bram@vim.org>
parents: 15456
diff changeset
5004 omitted.
21250
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
5005 Preferably used as a |method|: >
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
5006 myblob->get(idx)
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
5007 get({dict}, {key} [, {default}])
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
5008 Get item with key {key} from |Dictionary| {dict}. When this
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
5009 item is not available return {default}. Return zero when
17571
2704c4e3e20a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17545
diff changeset
5010 {default} is omitted. Useful example: >
2704c4e3e20a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17545
diff changeset
5011 let val = get(g:, 'var_name', 'default')
2704c4e3e20a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17545
diff changeset
5012 < This gets the value of g:var_name if it exists, and uses
2704c4e3e20a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17545
diff changeset
5013 'default' when it does not exist.
21250
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
5014 Preferably used as a |method|: >
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
5015 mydict->get(key)
9117
0cc48b3cd884 commit https://github.com/vim/vim/commit/03e19a04ac2ca55643663b97b6ab94043233dcbd
Christian Brabandt <cb@256bit.org>
parents: 9110
diff changeset
5016 get({func}, {what})
0cc48b3cd884 commit https://github.com/vim/vim/commit/03e19a04ac2ca55643663b97b6ab94043233dcbd
Christian Brabandt <cb@256bit.org>
parents: 9110
diff changeset
5017 Get an item with from Funcref {func}. Possible values for
9110
6d3888e2232c commit https://github.com/vim/vim/commit/2bbf8eff6fab16d86e7bcfc0da1962d31bec7891
Christian Brabandt <cb@256bit.org>
parents: 9108
diff changeset
5018 {what} are:
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
5019 "name" The function name
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
5020 "func" The function
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
5021 "dict" The dictionary
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
5022 "args" The list with arguments
21250
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
5023 Preferably used as a |method|: >
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
5024 myfunc->get(what)
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
5025 <
9858
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5026 *getbufinfo()*
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5027 getbufinfo([{expr}])
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5028 getbufinfo([{dict}])
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
5029 Get information about buffers as a List of Dictionaries.
9858
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5030
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5031 Without an argument information about all the buffers is
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5032 returned.
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5033
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
5034 When the argument is a |Dictionary| only the buffers matching
9858
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5035 the specified criteria are returned. The following keys can
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5036 be specified in {dict}:
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5037 buflisted include only listed buffers.
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5038 bufloaded include only loaded buffers.
13020
58cce40c965b patch 8.0.1386: cannot select modified buffers with getbufinfo()
Christian Brabandt <cb@256bit.org>
parents: 13016
diff changeset
5039 bufmodified include only modified buffers.
9858
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5040
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5041 Otherwise, {expr} specifies a particular buffer to return
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5042 information for. For the use of {expr}, see |bufname()|
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5043 above. If the buffer is found the returned List has one item.
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5044 Otherwise the result is an empty list.
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5045
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5046 Each returned List item is a dictionary with the following
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5047 entries:
21676
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
5048 bufnr Buffer number.
9858
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5049 changed TRUE if the buffer is modified.
21676
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
5050 changedtick Number of changes made to the buffer.
9858
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5051 hidden TRUE if the buffer is hidden.
21676
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
5052 lastused Timestamp in seconds, like
18463
18d7337b6837 patch 8.1.2225: the "last used" info of a buffer is under used
Bram Moolenaar <Bram@vim.org>
parents: 18456
diff changeset
5053 |localtime()|, when the buffer was
18d7337b6837 patch 8.1.2225: the "last used" info of a buffer is under used
Bram Moolenaar <Bram@vim.org>
parents: 18456
diff changeset
5054 last used.
18d7337b6837 patch 8.1.2225: the "last used" info of a buffer is under used
Bram Moolenaar <Bram@vim.org>
parents: 18456
diff changeset
5055 {only with the |+viminfo| feature}
9858
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5056 listed TRUE if the buffer is listed.
21676
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
5057 lnum Line number used for the buffer when
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
5058 opened in the current window.
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
5059 linecount Number of lines in the buffer (only
18916
cf051bdefb3f patch 8.2.0019: cannot number of lines of another buffer
Bram Moolenaar <Bram@vim.org>
parents: 18912
diff changeset
5060 valid when loaded)
9858
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5061 loaded TRUE if the buffer is loaded.
21676
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
5062 name Full path to the file in the buffer.
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
5063 signs List of signs placed in the buffer.
9858
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5064 Each list item is a dictionary with
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5065 the following fields:
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5066 id sign identifier
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5067 lnum line number
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5068 name sign name
21676
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
5069 variables A reference to the dictionary with
10000
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
5070 buffer-local variables.
21676
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
5071 windows List of |window-ID|s that display this
10000
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
5072 buffer
21676
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
5073 popups List of popup |window-ID|s that
17253
26e0352613ec patch 8.1.1626: no test for closing a popup window with a modified buffer
Bram Moolenaar <Bram@vim.org>
parents: 17221
diff changeset
5074 display this buffer
9858
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5075
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5076 Examples: >
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5077 for buf in getbufinfo()
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5078 echo buf.name
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5079 endfor
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5080 for buf in getbufinfo({'buflisted':1})
10000
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
5081 if buf.changed
9858
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5082 ....
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5083 endif
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5084 endfor
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5085 <
10000
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
5086 To get buffer-local options use: >
14519
5c5908e81e93 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14422
diff changeset
5087 getbufvar({bufnr}, '&option_name')
21381
95e6fb6a5c86 patch 8.2.1241: cannot use getbufinfo() as a method
Bram Moolenaar <Bram@vim.org>
parents: 21250
diff changeset
5088 <
95e6fb6a5c86 patch 8.2.1241: cannot use getbufinfo() as a method
Bram Moolenaar <Bram@vim.org>
parents: 21250
diff changeset
5089 Can also be used as a |method|: >
95e6fb6a5c86 patch 8.2.1241: cannot use getbufinfo() as a method
Bram Moolenaar <Bram@vim.org>
parents: 21250
diff changeset
5090 GetBufnr()->getbufinfo()
95e6fb6a5c86 patch 8.2.1241: cannot use getbufinfo() as a method
Bram Moolenaar <Bram@vim.org>
parents: 21250
diff changeset
5091 <
95e6fb6a5c86 patch 8.2.1241: cannot use getbufinfo() as a method
Bram Moolenaar <Bram@vim.org>
parents: 21250
diff changeset
5092
435
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
5093 *getbufline()*
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
5094 getbufline({expr}, {lnum} [, {end}])
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
5095 Return a |List| with the lines starting from {lnum} to {end}
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
5096 (inclusive) in the buffer {expr}. If {end} is omitted, a
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
5097 |List| with only the line {lnum} is returned.
435
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
5098
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
5099 For the use of {expr}, see |bufname()| above.
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
5100
448
dd9db57ee7ce updated for version 7.0118
vimboss
parents: 444
diff changeset
5101 For {lnum} and {end} "$" can be used for the last line of the
dd9db57ee7ce updated for version 7.0118
vimboss
parents: 444
diff changeset
5102 buffer. Otherwise a number must be used.
435
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
5103
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
5104 When {lnum} is smaller than 1 or bigger than the number of
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
5105 lines in the buffer, an empty |List| is returned.
435
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
5106
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
5107 When {end} is greater than the number of lines in the buffer,
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
5108 it is treated as {end} is set to the number of lines in the
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
5109 buffer. When {end} is before {lnum} an empty |List| is
435
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
5110 returned.
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
5111
448
dd9db57ee7ce updated for version 7.0118
vimboss
parents: 444
diff changeset
5112 This function works only for loaded buffers. For unloaded and
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
5113 non-existing buffers, an empty |List| is returned.
435
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
5114
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
5115 Example: >
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
5116 :let lines = getbufline(bufnr("myfile"), 1, "$")
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5117
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5118 < Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5119 GetBufnr()->getbufline(lnum)
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5120
4157
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
5121 getbufvar({expr}, {varname} [, {def}]) *getbufvar()*
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5122 The result is the value of option or local buffer variable
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5123 {varname} in buffer {expr}. Note that the name without "b:"
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5124 must be used.
23164
99ef85ff1af4 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23048
diff changeset
5125 When {varname} is empty returns a |Dictionary| with all the
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
5126 buffer-local variables.
23164
99ef85ff1af4 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23048
diff changeset
5127 When {varname} is equal to "&" returns a |Dictionary| with all
10000
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
5128 the buffer-local options.
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
5129 Otherwise, when {varname} starts with "&" returns the value of
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
5130 a buffer-local option.
216
da182deebec7 updated for version 7.0061
vimboss
parents: 205
diff changeset
5131 This also works for a global or buffer-local option, but it
da182deebec7 updated for version 7.0061
vimboss
parents: 205
diff changeset
5132 doesn't work for a global variable, window-local variable or
da182deebec7 updated for version 7.0061
vimboss
parents: 205
diff changeset
5133 window-local option.
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5134 For the use of {expr}, see |bufname()| above.
4157
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
5135 When the buffer or variable doesn't exist {def} or an empty
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
5136 string is returned, there is no error message.
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5137 Examples: >
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5138 :let bufmodified = getbufvar(1, "&mod")
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5139 :echo "todo myvar = " . getbufvar("todo", "myvar")
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5140
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5141 < Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5142 GetBufnr()->getbufvar(varname)
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5143 <
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5144 getchangelist([{expr}]) *getchangelist()*
13280
fbda23eb0996 patch 8.0.1514: getting the list of changes is not easy
Christian Brabandt <cb@256bit.org>
parents: 13272
diff changeset
5145 Returns the |changelist| for the buffer {expr}. For the use
fbda23eb0996 patch 8.0.1514: getting the list of changes is not easy
Christian Brabandt <cb@256bit.org>
parents: 13272
diff changeset
5146 of {expr}, see |bufname()| above. If buffer {expr} doesn't
fbda23eb0996 patch 8.0.1514: getting the list of changes is not easy
Christian Brabandt <cb@256bit.org>
parents: 13272
diff changeset
5147 exist, an empty list is returned.
fbda23eb0996 patch 8.0.1514: getting the list of changes is not easy
Christian Brabandt <cb@256bit.org>
parents: 13272
diff changeset
5148
fbda23eb0996 patch 8.0.1514: getting the list of changes is not easy
Christian Brabandt <cb@256bit.org>
parents: 13272
diff changeset
5149 The returned list contains two entries: a list with the change
fbda23eb0996 patch 8.0.1514: getting the list of changes is not easy
Christian Brabandt <cb@256bit.org>
parents: 13272
diff changeset
5150 locations and the current position in the list. Each
fbda23eb0996 patch 8.0.1514: getting the list of changes is not easy
Christian Brabandt <cb@256bit.org>
parents: 13272
diff changeset
5151 entry in the change list is a dictionary with the following
fbda23eb0996 patch 8.0.1514: getting the list of changes is not easy
Christian Brabandt <cb@256bit.org>
parents: 13272
diff changeset
5152 entries:
fbda23eb0996 patch 8.0.1514: getting the list of changes is not easy
Christian Brabandt <cb@256bit.org>
parents: 13272
diff changeset
5153 col column number
fbda23eb0996 patch 8.0.1514: getting the list of changes is not easy
Christian Brabandt <cb@256bit.org>
parents: 13272
diff changeset
5154 coladd column offset for 'virtualedit'
fbda23eb0996 patch 8.0.1514: getting the list of changes is not easy
Christian Brabandt <cb@256bit.org>
parents: 13272
diff changeset
5155 lnum line number
fbda23eb0996 patch 8.0.1514: getting the list of changes is not easy
Christian Brabandt <cb@256bit.org>
parents: 13272
diff changeset
5156 If buffer {expr} is the current buffer, then the current
fbda23eb0996 patch 8.0.1514: getting the list of changes is not easy
Christian Brabandt <cb@256bit.org>
parents: 13272
diff changeset
5157 position refers to the position in the list. For other
fbda23eb0996 patch 8.0.1514: getting the list of changes is not easy
Christian Brabandt <cb@256bit.org>
parents: 13272
diff changeset
5158 buffers, it is set to the length of the list.
fbda23eb0996 patch 8.0.1514: getting the list of changes is not easy
Christian Brabandt <cb@256bit.org>
parents: 13272
diff changeset
5159
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5160 Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5161 GetBufnr()->getchangelist()
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5162
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5163 getchar([expr]) *getchar()*
867
a5677b7ce858 updated for version 7.0g04
vimboss
parents: 864
diff changeset
5164 Get a single character from the user or input stream.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5165 If [expr] is omitted, wait until a character is available.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5166 If [expr] is 0, only get a character when one is available.
867
a5677b7ce858 updated for version 7.0g04
vimboss
parents: 864
diff changeset
5167 Return zero otherwise.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5168 If [expr] is 1, only check if a character is available, it is
867
a5677b7ce858 updated for version 7.0g04
vimboss
parents: 864
diff changeset
5169 not consumed. Return zero if no character available.
a5677b7ce858 updated for version 7.0g04
vimboss
parents: 864
diff changeset
5170
5555
7818ca6de3d0 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5466
diff changeset
5171 Without [expr] and when [expr] is 0 a whole character or
11639
71d7b5ed08a0 patch 8.0.0702: an error in a timer can make Vim unusable
Christian Brabandt <cb@256bit.org>
parents: 11609
diff changeset
5172 special key is returned. If it is a single character, the
867
a5677b7ce858 updated for version 7.0g04
vimboss
parents: 864
diff changeset
5173 result is a number. Use nr2char() to convert it to a String.
a5677b7ce858 updated for version 7.0g04
vimboss
parents: 864
diff changeset
5174 Otherwise a String is returned with the encoded character.
11639
71d7b5ed08a0 patch 8.0.0702: an error in a timer can make Vim unusable
Christian Brabandt <cb@256bit.org>
parents: 11609
diff changeset
5175 For a special key it's a String with a sequence of bytes
71d7b5ed08a0 patch 8.0.0702: an error in a timer can make Vim unusable
Christian Brabandt <cb@256bit.org>
parents: 11609
diff changeset
5176 starting with 0x80 (decimal: 128). This is the same value as
71d7b5ed08a0 patch 8.0.0702: an error in a timer can make Vim unusable
Christian Brabandt <cb@256bit.org>
parents: 11609
diff changeset
5177 the String "\<Key>", e.g., "\<Left>". The returned value is
71d7b5ed08a0 patch 8.0.0702: an error in a timer can make Vim unusable
Christian Brabandt <cb@256bit.org>
parents: 11609
diff changeset
5178 also a String when a modifier (shift, control, alt) was used
71d7b5ed08a0 patch 8.0.0702: an error in a timer can make Vim unusable
Christian Brabandt <cb@256bit.org>
parents: 11609
diff changeset
5179 that is not included in the character.
867
a5677b7ce858 updated for version 7.0g04
vimboss
parents: 864
diff changeset
5180
5968
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5181 When [expr] is 0 and Esc is typed, there will be a short delay
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5182 while Vim waits to see if this is the start of an escape
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5183 sequence.
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5184
5555
7818ca6de3d0 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5466
diff changeset
5185 When [expr] is 1 only the first byte is returned. For a
872
e6c3e7c34232 updated for version 7.0g05
vimboss
parents: 867
diff changeset
5186 one-byte character it is the character itself as a number.
e6c3e7c34232 updated for version 7.0g05
vimboss
parents: 867
diff changeset
5187 Use nr2char() to convert it to a String.
867
a5677b7ce858 updated for version 7.0g04
vimboss
parents: 864
diff changeset
5188
3224
8b8ef1fed009 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3214
diff changeset
5189 Use getcharmod() to obtain any additional modifiers.
8b8ef1fed009 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3214
diff changeset
5190
1029
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
5191 When the user clicks a mouse button, the mouse event will be
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
5192 returned. The position can then be found in |v:mouse_col|,
18623
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5193 |v:mouse_lnum|, |v:mouse_winid| and |v:mouse_win|.
21230
e67123c115d2 patch 8.2.1166: once mouse move events are enabled getchar() returns them
Bram Moolenaar <Bram@vim.org>
parents: 21093
diff changeset
5194 |getmousepos()| can also be used. Mouse move events will be
e67123c115d2 patch 8.2.1166: once mouse move events are enabled getchar() returns them
Bram Moolenaar <Bram@vim.org>
parents: 21093
diff changeset
5195 ignored.
e67123c115d2 patch 8.2.1166: once mouse move events are enabled getchar() returns them
Bram Moolenaar <Bram@vim.org>
parents: 21093
diff changeset
5196 This example positions the mouse as it would normally happen: >
1029
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
5197 let c = getchar()
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
5198 if c == "\<LeftMouse>" && v:mouse_win > 0
1029
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
5199 exe v:mouse_win . "wincmd w"
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
5200 exe v:mouse_lnum
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
5201 exe "normal " . v:mouse_col . "|"
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
5202 endif
82b2594be408 updated for version 7.0-155
vimboss
parents: 985
diff changeset
5203 <
10734
523cd59d6db0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10730
diff changeset
5204 When using bracketed paste only the first character is
523cd59d6db0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10730
diff changeset
5205 returned, the rest of the pasted text is dropped.
523cd59d6db0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10730
diff changeset
5206 |xterm-bracketed-paste|.
523cd59d6db0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10730
diff changeset
5207
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5208 There is no prompt, you will somehow have to make clear to the
23305
fab58304f77d Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23164
diff changeset
5209 user that a character has to be typed. The screen is not
fab58304f77d Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23164
diff changeset
5210 redrawn, e.g. when resizing the window. When using a popup
fab58304f77d Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23164
diff changeset
5211 window it should work better with a |popup-filter|.
fab58304f77d Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23164
diff changeset
5212
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5213 There is no mapping for the character.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5214 Key codes are replaced, thus when the user presses the <Del>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5215 key you get the code for the <Del> key, not the raw character
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5216 sequence. Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5217 getchar() == "\<Del>"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5218 getchar() == "\<S-Left>"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5219 < This example redefines "f" to ignore case: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5220 :nmap f :call FindChar()<CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5221 :function FindChar()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5222 : let c = nr2char(getchar())
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5223 : while col('.') < col('$') - 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5224 : normal l
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5225 : if getline('.')[col('.') - 1] ==? c
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5226 : break
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5227 : endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5228 : endwhile
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5229 :endfunction
6421
5d89d9b40499 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6413
diff changeset
5230 <
6647
3af822eb4da5 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6583
diff changeset
5231 You may also receive synthetic characters, such as
6421
5d89d9b40499 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6413
diff changeset
5232 |<CursorHold>|. Often you will want to ignore this and get
5d89d9b40499 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6413
diff changeset
5233 another character: >
5d89d9b40499 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6413
diff changeset
5234 :function GetKey()
5d89d9b40499 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6413
diff changeset
5235 : let c = getchar()
5d89d9b40499 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6413
diff changeset
5236 : while c == "\<CursorHold>"
5d89d9b40499 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6413
diff changeset
5237 : let c = getchar()
5d89d9b40499 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6413
diff changeset
5238 : endwhile
5d89d9b40499 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6413
diff changeset
5239 : return c
5d89d9b40499 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6413
diff changeset
5240 :endfunction
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5241
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5242 getcharmod() *getcharmod()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5243 The result is a Number which is the state of the modifiers for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5244 the last obtained character with getchar() or in another way.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5245 These values are added together:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5246 2 shift
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5247 4 control
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5248 8 alt (meta)
3224
8b8ef1fed009 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3214
diff changeset
5249 16 meta (when it's different from ALT)
8b8ef1fed009 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3214
diff changeset
5250 32 mouse double click
8b8ef1fed009 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3214
diff changeset
5251 64 mouse triple click
8b8ef1fed009 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3214
diff changeset
5252 96 mouse quadruple click (== 32 + 64)
8b8ef1fed009 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3214
diff changeset
5253 128 command (Macintosh only)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5254 Only the modifiers that have not been included in the
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
5255 character itself are obtained. Thus Shift-a results in "A"
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
5256 without a modifier.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5257
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5258 *getcharpos()*
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5259 getcharpos({expr})
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5260 Get the position for {expr}. Same as |getpos()| but the column
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5261 number in the returned List is a character index instead of
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5262 a byte index.
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5263
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5264 Example:
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5265 With the cursor on '세' in line 5 with text "여보세요": >
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5266 getcharpos('.') returns [0, 5, 3, 0]
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5267 getpos('.') returns [0, 5, 7, 0]
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5268 <
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5269 Can also be used as a |method|: >
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5270 GetMark()->getcharpos()
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5271
6991
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5272 getcharsearch() *getcharsearch()*
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5273 Return the current character search information as a {dict}
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5274 with the following entries:
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5275
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5276 char character previously used for a character
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5277 search (|t|, |f|, |T|, or |F|); empty string
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5278 if no character search has been performed
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5279 forward direction of character search; 1 for forward,
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5280 0 for backward
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5281 until type of character search; 1 for a |t| or |T|
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5282 character search, 0 for an |f| or |F|
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5283 character search
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5284
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5285 This can be useful to always have |;| and |,| search
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5286 forward/backward regardless of the direction of the previous
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5287 character search: >
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5288 :nnoremap <expr> ; getcharsearch().forward ? ';' : ','
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5289 :nnoremap <expr> , getcharsearch().forward ? ',' : ';'
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5290 < Also see |setcharsearch()|.
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
5291
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5292 getcmdline() *getcmdline()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5293 Return the current command-line. Only works when the command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5294 line is being edited, thus requires use of |c_CTRL-\_e| or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5295 |c_CTRL-R_=|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5296 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5297 :cmap <F7> <C-\>eescape(getcmdline(), ' \')<CR>
531
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
5298 < Also see |getcmdtype()|, |getcmdpos()| and |setcmdpos()|.
14864
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
5299 Returns an empty string when entering a password or using
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
5300 |inputsecret()|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5301
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
5302 getcmdpos() *getcmdpos()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5303 Return the position of the cursor in the command line as a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5304 byte count. The first column is 1.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5305 Only works when editing the command line, thus requires use of
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3445
diff changeset
5306 |c_CTRL-\_e| or |c_CTRL-R_=| or an expression mapping.
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3445
diff changeset
5307 Returns 0 otherwise.
531
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
5308 Also see |getcmdtype()|, |setcmdpos()| and |getcmdline()|.
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
5309
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
5310 getcmdtype() *getcmdtype()*
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
5311 Return the current command-line type. Possible return values
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
5312 are:
532
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
5313 : normal Ex command
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
5314 > debug mode command |debug-mode|
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
5315 / forward search command
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
5316 ? backward search command
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
5317 @ |input()| command
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
5318 - |:insert| or |:append| command
6213
37c24033b260 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6197
diff changeset
5319 = |i_CTRL-R_=|
531
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
5320 Only works when editing the command line, thus requires use of
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3445
diff changeset
5321 |c_CTRL-\_e| or |c_CTRL-R_=| or an expression mapping.
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3445
diff changeset
5322 Returns an empty string otherwise.
531
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
5323 Also see |getcmdpos()|, |setcmdpos()| and |getcmdline()|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5324
6153
1e8ebf870720 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6110
diff changeset
5325 getcmdwintype() *getcmdwintype()*
1e8ebf870720 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6110
diff changeset
5326 Return the current |command-line-window| type. Possible return
1e8ebf870720 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6110
diff changeset
5327 values are the same as |getcmdtype()|. Returns an empty string
1e8ebf870720 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6110
diff changeset
5328 when not in the command-line window.
1e8ebf870720 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6110
diff changeset
5329
9861
74f67cb4f7e1 commit https://github.com/vim/vim/commit/e9d58a6459687a1228b5aa85bd7b31f8f1e528a8
Christian Brabandt <cb@256bit.org>
parents: 9858
diff changeset
5330 getcompletion({pat}, {type} [, {filtered}]) *getcompletion()*
9460
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5331 Return a list of command-line completion matches. {type}
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5332 specifies what for. The following completion types are
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5333 supported:
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5334
13551
1fd0f8392946 patch 8.0.1649: no completion for argument list commands
Christian Brabandt <cb@256bit.org>
parents: 13513
diff changeset
5335 arglist file names in argument list
9460
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5336 augroup autocmd groups
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5337 buffer buffer names
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5338 behave :behave suboptions
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5339 color color schemes
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5340 command Ex command (and arguments)
20745
49673325ca13 patch 8.2.0925: getcompletion() does not return command line arguments
Bram Moolenaar <Bram@vim.org>
parents: 20743
diff changeset
5341 cmdline |cmdline-completion| result
9460
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5342 compiler compilers
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5343 cscope |:cscope| suboptions
18987
e378907d79bf patch 8.2.0054: :diffget and :diffput don't have good completion
Bram Moolenaar <Bram@vim.org>
parents: 18973
diff changeset
5344 diff_buffer |:diffget| and |:diffput| completion
9460
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5345 dir directory names
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5346 environment environment variable names
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5347 event autocommand events
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5348 expression Vim expression
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5349 file file and directory names
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5350 file_in_path file and directory names in |'path'|
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5351 filetype filetype names |'filetype'|
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5352 function function name
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5353 help help subjects
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5354 highlight highlight groups
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5355 history :history suboptions
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5356 locale locale names (as output of locale -a)
20965
59f93c2d2551 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20889
diff changeset
5357 mapclear buffer argument
9460
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5358 mapping mapping name
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5359 menu menus
10275
6d8b2da002e9 commit https://github.com/vim/vim/commit/9e507ca8a3e1535e62de4bd86374b0fcd18ef5b8
Christian Brabandt <cb@256bit.org>
parents: 10245
diff changeset
5360 messages |:messages| suboptions
9460
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5361 option options
10275
6d8b2da002e9 commit https://github.com/vim/vim/commit/9e507ca8a3e1535e62de4bd86374b0fcd18ef5b8
Christian Brabandt <cb@256bit.org>
parents: 10245
diff changeset
5362 packadd optional package |pack-add| names
9460
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5363 shellcmd Shell command
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5364 sign |:sign| suboptions
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5365 syntax syntax file names |'syntax'|
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5366 syntime |:syntime| suboptions
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5367 tag tags
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5368 tag_listfiles tags, file names
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5369 user user names
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5370 var user variables
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5371
20745
49673325ca13 patch 8.2.0925: getcompletion() does not return command line arguments
Bram Moolenaar <Bram@vim.org>
parents: 20743
diff changeset
5372 If {pat} is an empty string, then all the matches are
49673325ca13 patch 8.2.0925: getcompletion() does not return command line arguments
Bram Moolenaar <Bram@vim.org>
parents: 20743
diff changeset
5373 returned. Otherwise only items matching {pat} are returned.
49673325ca13 patch 8.2.0925: getcompletion() does not return command line arguments
Bram Moolenaar <Bram@vim.org>
parents: 20743
diff changeset
5374 See |wildcards| for the use of special characters in {pat}.
9460
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5375
9861
74f67cb4f7e1 commit https://github.com/vim/vim/commit/e9d58a6459687a1228b5aa85bd7b31f8f1e528a8
Christian Brabandt <cb@256bit.org>
parents: 9858
diff changeset
5376 If the optional {filtered} flag is set to 1, then 'wildignore'
74f67cb4f7e1 commit https://github.com/vim/vim/commit/e9d58a6459687a1228b5aa85bd7b31f8f1e528a8
Christian Brabandt <cb@256bit.org>
parents: 9858
diff changeset
5377 is applied to filter the results. Otherwise all the matches
74f67cb4f7e1 commit https://github.com/vim/vim/commit/e9d58a6459687a1228b5aa85bd7b31f8f1e528a8
Christian Brabandt <cb@256bit.org>
parents: 9858
diff changeset
5378 are returned. The 'wildignorecase' option always applies.
74f67cb4f7e1 commit https://github.com/vim/vim/commit/e9d58a6459687a1228b5aa85bd7b31f8f1e528a8
Christian Brabandt <cb@256bit.org>
parents: 9858
diff changeset
5379
20745
49673325ca13 patch 8.2.0925: getcompletion() does not return command line arguments
Bram Moolenaar <Bram@vim.org>
parents: 20743
diff changeset
5380 If {type} is "cmdline", then the |cmdline-completion| result is
49673325ca13 patch 8.2.0925: getcompletion() does not return command line arguments
Bram Moolenaar <Bram@vim.org>
parents: 20743
diff changeset
5381 returned. For example, to complete the possible values after
49673325ca13 patch 8.2.0925: getcompletion() does not return command line arguments
Bram Moolenaar <Bram@vim.org>
parents: 20743
diff changeset
5382 a ":call" command: >
20965
59f93c2d2551 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20889
diff changeset
5383 echo getcompletion('call ', 'cmdline')
20745
49673325ca13 patch 8.2.0925: getcompletion() does not return command line arguments
Bram Moolenaar <Bram@vim.org>
parents: 20743
diff changeset
5384 <
9460
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5385 If there are no matches, an empty list is returned. An
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5386 invalid value for {type} produces an error.
cdffa812f9d1 commit https://github.com/vim/vim/commit/aa4d73235bf4deee167aa5314b89ae3d3db334b7
Christian Brabandt <cb@256bit.org>
parents: 9454
diff changeset
5387
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5388 Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5389 GetPattern()->getcompletion('color')
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5390 <
5944
332a5c2b2956 updated for version 7.4.313
Bram Moolenaar <bram@vim.org>
parents: 5942
diff changeset
5391 *getcurpos()*
22357
0e231e8e70f8 patch 8.2.1727: a popup created with "cursorline" will ignore "firstline"
Bram Moolenaar <Bram@vim.org>
parents: 22355
diff changeset
5392 getcurpos([{winid}])
0e231e8e70f8 patch 8.2.1727: a popup created with "cursorline" will ignore "firstline"
Bram Moolenaar <Bram@vim.org>
parents: 22355
diff changeset
5393 Get the position of the cursor. This is like getpos('.'), but
19968
1908e92b02fd Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19952
diff changeset
5394 includes an extra "curswant" item in the list:
1908e92b02fd Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19952
diff changeset
5395 [0, lnum, col, off, curswant] ~
5944
332a5c2b2956 updated for version 7.4.313
Bram Moolenaar <bram@vim.org>
parents: 5942
diff changeset
5396 The "curswant" number is the preferred column when moving the
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5397 cursor vertically. Also see |getcursorcharpos()| and
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5398 |getpos()|.
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5399 The first "bufnum" item is always zero. The byte position of
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5400 the cursor is returned in 'col'. To get the character
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5401 position, use |getcursorcharpos()|.
11347
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
5402
22357
0e231e8e70f8 patch 8.2.1727: a popup created with "cursorline" will ignore "firstline"
Bram Moolenaar <Bram@vim.org>
parents: 22355
diff changeset
5403 The optional {winid} argument can specify the window. It can
0e231e8e70f8 patch 8.2.1727: a popup created with "cursorline" will ignore "firstline"
Bram Moolenaar <Bram@vim.org>
parents: 22355
diff changeset
5404 be the window number or the |window-ID|. The last known
0e231e8e70f8 patch 8.2.1727: a popup created with "cursorline" will ignore "firstline"
Bram Moolenaar <Bram@vim.org>
parents: 22355
diff changeset
5405 cursor position is returned, this may be invalid for the
0e231e8e70f8 patch 8.2.1727: a popup created with "cursorline" will ignore "firstline"
Bram Moolenaar <Bram@vim.org>
parents: 22355
diff changeset
5406 current value of the buffer if it is not the current window.
0e231e8e70f8 patch 8.2.1727: a popup created with "cursorline" will ignore "firstline"
Bram Moolenaar <Bram@vim.org>
parents: 22355
diff changeset
5407 If {winid} is invalid a list with zeroes is returned.
0e231e8e70f8 patch 8.2.1727: a popup created with "cursorline" will ignore "firstline"
Bram Moolenaar <Bram@vim.org>
parents: 22355
diff changeset
5408
5944
332a5c2b2956 updated for version 7.4.313
Bram Moolenaar <bram@vim.org>
parents: 5942
diff changeset
5409 This can be used to save and restore the cursor position: >
332a5c2b2956 updated for version 7.4.313
Bram Moolenaar <bram@vim.org>
parents: 5942
diff changeset
5410 let save_cursor = getcurpos()
332a5c2b2956 updated for version 7.4.313
Bram Moolenaar <bram@vim.org>
parents: 5942
diff changeset
5411 MoveTheCursorAround
332a5c2b2956 updated for version 7.4.313
Bram Moolenaar <bram@vim.org>
parents: 5942
diff changeset
5412 call setpos('.', save_cursor)
11347
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
5413 < Note that this only works within the window. See
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
5414 |winrestview()| for restoring more state.
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5415
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5416 Can also be used as a |method|: >
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5417 GetWinid()->getcurpos()
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5418
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5419 < *getcursorcharpos()*
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5420 getcursorcharpos([{winid}])
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5421 Same as |getcurpos()| but the column number in the returned
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5422 List is a character index instead of a byte index.
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5423
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5424 Example:
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5425 With the cursor on '보' in line 3 with text "여보세요": >
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5426 getcursorcharpos() returns [0, 3, 2, 0, 3]
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5427 getcurpos() returns [0, 3, 4, 0, 3]
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5428
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5429 < Can also be used as a |method|: >
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5430 GetWinid()->getcursorcharpos()
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5431
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5432 < *getcwd()*
7653
d4370fef0175 commit https://github.com/vim/vim/commit/c970330676eaae7ba7cd05cfa46df5a413853ef9
Christian Brabandt <cb@256bit.org>
parents: 7651
diff changeset
5433 getcwd([{winnr} [, {tabnr}]])
d4370fef0175 commit https://github.com/vim/vim/commit/c970330676eaae7ba7cd05cfa46df5a413853ef9
Christian Brabandt <cb@256bit.org>
parents: 7651
diff changeset
5434 The result is a String, which is the name of the current
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5435 working directory.
7653
d4370fef0175 commit https://github.com/vim/vim/commit/c970330676eaae7ba7cd05cfa46df5a413853ef9
Christian Brabandt <cb@256bit.org>
parents: 7651
diff changeset
5436
d4370fef0175 commit https://github.com/vim/vim/commit/c970330676eaae7ba7cd05cfa46df5a413853ef9
Christian Brabandt <cb@256bit.org>
parents: 7651
diff changeset
5437 With {winnr} return the local current directory of this window
13229
93efa1de7abb patch 8.0.1489: there is no easy way to get the global directory
Christian Brabandt <cb@256bit.org>
parents: 13125
diff changeset
5438 in the current tab page. {winnr} can be the window number or
93efa1de7abb patch 8.0.1489: there is no easy way to get the global directory
Christian Brabandt <cb@256bit.org>
parents: 13125
diff changeset
5439 the |window-ID|.
93efa1de7abb patch 8.0.1489: there is no easy way to get the global directory
Christian Brabandt <cb@256bit.org>
parents: 13125
diff changeset
5440 If {winnr} is -1 return the name of the global working
93efa1de7abb patch 8.0.1489: there is no easy way to get the global directory
Christian Brabandt <cb@256bit.org>
parents: 13125
diff changeset
5441 directory. See also |haslocaldir()|.
93efa1de7abb patch 8.0.1489: there is no easy way to get the global directory
Christian Brabandt <cb@256bit.org>
parents: 13125
diff changeset
5442
7653
d4370fef0175 commit https://github.com/vim/vim/commit/c970330676eaae7ba7cd05cfa46df5a413853ef9
Christian Brabandt <cb@256bit.org>
parents: 7651
diff changeset
5443 With {winnr} and {tabnr} return the local current directory of
16427
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5444 the window in the specified tab page. If {winnr} is -1 return
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5445 the working directory of the tabpage.
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5446 If {winnr} is zero use the current window, if {tabnr} is zero
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5447 use the current tabpage.
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5448 Without any arguments, return the working directory of the
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5449 current window.
7653
d4370fef0175 commit https://github.com/vim/vim/commit/c970330676eaae7ba7cd05cfa46df5a413853ef9
Christian Brabandt <cb@256bit.org>
parents: 7651
diff changeset
5450 Return an empty string if the arguments are invalid.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5451
16427
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5452 Examples: >
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5453 " Get the working directory of the current window
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5454 :echo getcwd()
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5455 :echo getcwd(0)
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5456 :echo getcwd(0, 0)
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5457 " Get the working directory of window 3 in tabpage 2
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5458 :echo getcwd(3, 2)
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5459 " Get the global working directory
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5460 :echo getcwd(-1)
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5461 " Get the working directory of tabpage 3
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5462 :echo getcwd(-1, 3)
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5463 " Get the working directory of current tabpage
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5464 :echo getcwd(-1, 0)
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5465
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5466 < Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5467 GetWinnr()->getcwd()
16427
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
5468 <
16604
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
5469 getenv({name}) *getenv()*
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
5470 Return the value of environment variable {name}.
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
5471 When the variable does not exist |v:null| is returned. That
17571
2704c4e3e20a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17545
diff changeset
5472 is different from a variable set to an empty string, although
2704c4e3e20a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17545
diff changeset
5473 some systems interpret the empty value as the variable being
2704c4e3e20a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17545
diff changeset
5474 deleted. See also |expr-env|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5475
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5476 Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5477 GetVarname()->getenv()
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5478
37
fdf55076c53f updated for version 7.0022
vimboss
parents: 33
diff changeset
5479 getfontname([{name}]) *getfontname()*
fdf55076c53f updated for version 7.0022
vimboss
parents: 33
diff changeset
5480 Without an argument returns the name of the normal font being
fdf55076c53f updated for version 7.0022
vimboss
parents: 33
diff changeset
5481 used. Like what is used for the Normal highlight group
fdf55076c53f updated for version 7.0022
vimboss
parents: 33
diff changeset
5482 |hl-Normal|.
fdf55076c53f updated for version 7.0022
vimboss
parents: 33
diff changeset
5483 With an argument a check is done whether {name} is a valid
fdf55076c53f updated for version 7.0022
vimboss
parents: 33
diff changeset
5484 font name. If not then an empty string is returned.
fdf55076c53f updated for version 7.0022
vimboss
parents: 33
diff changeset
5485 Otherwise the actual font name is returned, or {name} if the
fdf55076c53f updated for version 7.0022
vimboss
parents: 33
diff changeset
5486 GUI does not support obtaining the real name.
824
8dd456c1e283 updated for version 7.0c13
vimboss
parents: 823
diff changeset
5487 Only works when the GUI is running, thus not in your vimrc or
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
5488 gvimrc file. Use the |GUIEnter| autocommand to use this
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
5489 function just after the GUI has started.
10895
c391bfbdb452 Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10787
diff changeset
5490 Note that the GTK GUI accepts any font name, thus checking for
c391bfbdb452 Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10787
diff changeset
5491 a valid name does not work.
37
fdf55076c53f updated for version 7.0022
vimboss
parents: 33
diff changeset
5492
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5493 getfperm({fname}) *getfperm()*
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5494 The result is a String, which is the read, write, and execute
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5495 permissions of the given file {fname}.
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5496 If {fname} does not exist or its directory cannot be read, an
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5497 empty string is returned.
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5498 The result is of the form "rwxrwxrwx", where each group of
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5499 "rwx" flags represent, in turn, the permissions of the owner
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5500 of the file, the group the file belongs to, and other users.
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5501 If a user does not have a given permission the flag for this
3750
536aa8b0c934 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3682
diff changeset
5502 is replaced with the string "-". Examples: >
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5503 :echo getfperm("/etc/passwd")
3750
536aa8b0c934 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3682
diff changeset
5504 :echo getfperm(expand("~/.vimrc"))
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5505 < This will hopefully (from a security point of view) display
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5506 the string "rw-r--r--" or even "rw-------".
205
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
5507
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5508 Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5509 GetFilename()->getfperm()
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5510 <
10244
876fbdd84e52 commit https://github.com/vim/vim/commit/2ec618c9feac4573b154510236ad8121c77d0eca
Christian Brabandt <cb@256bit.org>
parents: 10237
diff changeset
5511 For setting permissions use |setfperm()|.
8451
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
5512
16604
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
5513 getfsize({fname}) *getfsize()*
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
5514 The result is a Number, which is the size in bytes of the
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
5515 given file {fname}.
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
5516 If {fname} is a directory, 0 is returned.
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
5517 If the file {fname} can't be found, -1 is returned.
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
5518 If the size of {fname} is too big to fit in a Number then -2
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
5519 is returned.
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
5520
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5521 Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5522 GetFilename()->getfsize()
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5523
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5524 getftime({fname}) *getftime()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5525 The result is a Number, which is the last modification time of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5526 the given file {fname}. The value is measured as seconds
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5527 since 1st Jan 1970, and may be passed to strftime(). See also
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5528 |localtime()| and |strftime()|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5529 If the file {fname} can't be found -1 is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5530
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5531 Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5532 GetFilename()->getftime()
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5533
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5534 getftype({fname}) *getftype()*
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5535 The result is a String, which is a description of the kind of
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5536 file of the given file {fname}.
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5537 If {fname} does not exist an empty string is returned.
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5538 Here is a table over different kinds of files and their
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5539 results:
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5540 Normal file "file"
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5541 Directory "dir"
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5542 Symbolic link "link"
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5543 Block device "bdev"
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5544 Character device "cdev"
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5545 Socket "socket"
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5546 FIFO "fifo"
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5547 All other "other"
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5548 Example: >
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5549 getftype("/home")
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5550 < Note that a type such as "link" will only be returned on
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5551 systems that support it. On some systems only "dir" and
7707
41768bcebc9b commit https://github.com/vim/vim/commit/13d5aeef56e3140a8eb8f40c7062aa1c5700f76e
Christian Brabandt <cb@256bit.org>
parents: 7703
diff changeset
5552 "file" are returned. On MS-Windows a symbolic link to a
41768bcebc9b commit https://github.com/vim/vim/commit/13d5aeef56e3140a8eb8f40c7062aa1c5700f76e
Christian Brabandt <cb@256bit.org>
parents: 7703
diff changeset
5553 directory returns "dir" instead of "link".
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
5554
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5555 Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5556 GetFilename()->getftype()
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5557
18008
8ae333756614 patch 8.1.2000: plugin cannot get the current IME status
Bram Moolenaar <Bram@vim.org>
parents: 18000
diff changeset
5558 getimstatus() *getimstatus()*
8ae333756614 patch 8.1.2000: plugin cannot get the current IME status
Bram Moolenaar <Bram@vim.org>
parents: 18000
diff changeset
5559 The result is a Number, which is |TRUE| when the IME status is
8ae333756614 patch 8.1.2000: plugin cannot get the current IME status
Bram Moolenaar <Bram@vim.org>
parents: 18000
diff changeset
5560 active.
8ae333756614 patch 8.1.2000: plugin cannot get the current IME status
Bram Moolenaar <Bram@vim.org>
parents: 18000
diff changeset
5561 See 'imstatusfunc'.
8ae333756614 patch 8.1.2000: plugin cannot get the current IME status
Bram Moolenaar <Bram@vim.org>
parents: 18000
diff changeset
5562
13298
a88c5e12b860 patch 8.0.1523: cannot write and read terminal screendumps
Christian Brabandt <cb@256bit.org>
parents: 13280
diff changeset
5563 getjumplist([{winnr} [, {tabnr}]]) *getjumplist()*
13246
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5564 Returns the |jumplist| for the specified window.
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5565
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5566 Without arguments use the current window.
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5567 With {winnr} only use this window in the current tab page.
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5568 {winnr} can also be a |window-ID|.
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5569 With {winnr} and {tabnr} use the window in the specified tab
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5570 page.
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5571
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5572 The returned list contains two entries: a list with the jump
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5573 locations and the last used jump position number in the list.
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5574 Each entry in the jump location list is a dictionary with
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5575 the following entries:
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5576 bufnr buffer number
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5577 col column number
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5578 coladd column offset for 'virtualedit'
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5579 filename filename if available
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5580 lnum line number
dd3b2ecf91f6 patch 8.0.1497: getting the jump list requires parsing the output of :jumps
Christian Brabandt <cb@256bit.org>
parents: 13231
diff changeset
5581
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5582 Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5583 GetWinnr()->getjumplist()
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5584
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5585 < *getline()*
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5586 getline({lnum} [, {end}])
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5587 Without {end} the result is a String, which is line {lnum}
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5588 from the current buffer. Example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5589 getline(1)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5590 < When {lnum} is a String that doesn't start with a
14019
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
5591 digit, |line()| is called to translate the String into a Number.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5592 To get the line under the cursor: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5593 getline(".")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5594 < When {lnum} is smaller than 1 or bigger than the number of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5595 lines in the buffer, an empty string is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5596
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
5597 When {end} is given the result is a |List| where each item is
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
5598 a line from the current buffer in the range {lnum} to {end},
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5599 including line {end}.
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5600 {end} is used in the same way as {lnum}.
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5601 Non-existing lines are silently omitted.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
5602 When {end} is before {lnum} an empty |List| is returned.
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5603 Example: >
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5604 :let start = line('.')
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5605 :let end = search("^$") - 1
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5606 :let lines = getline(start, end)
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5607
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5608 < Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5609 ComputeLnum()->getline()
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5610
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
5611 < To get lines from another buffer see |getbufline()|
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
5612
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
5613 getloclist({nr} [, {what}]) *getloclist()*
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
5614 Returns a |List| with all the entries in the location list for
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
5615 window {nr}. {nr} can be the window number or the |window-ID|.
9223
6c4d610fce0a commit https://github.com/vim/vim/commit/888ccac8902cee186fbd47e971881f6d9b19c068
Christian Brabandt <cb@256bit.org>
parents: 9221
diff changeset
5616 When {nr} is zero the current window is used.
6c4d610fce0a commit https://github.com/vim/vim/commit/888ccac8902cee186fbd47e971881f6d9b19c068
Christian Brabandt <cb@256bit.org>
parents: 9221
diff changeset
5617
647
19106f131c87 updated for version 7.0188
vimboss
parents: 644
diff changeset
5618 For a location list window, the displayed location list is
648
9032e4668296 updated for version 7.0189
vimboss
parents: 647
diff changeset
5619 returned. For an invalid window number {nr}, an empty list is
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
5620 returned. Otherwise, same as |getqflist()|.
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5621
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5622 If the optional {what} dictionary argument is supplied, then
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5623 returns the items listed in {what} as a dictionary. Refer to
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5624 |getqflist()| for the supported items in {what}.
16019
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
5625
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
5626 In addition to the items supported by |getqflist()| in {what},
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
5627 the following item is supported by |getloclist()|:
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
5628
16808
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16704
diff changeset
5629 filewinid id of the window used to display files
16019
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
5630 from the location list. This field is
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
5631 applicable only when called from a
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
5632 location list window. See
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
5633 |location-list-file-window| for more
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
5634 details.
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5635
23164
99ef85ff1af4 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23048
diff changeset
5636 Returns a |Dictionary| with default values if there is no
99ef85ff1af4 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23048
diff changeset
5637 location list for the window {nr}.
22357
0e231e8e70f8 patch 8.2.1727: a popup created with "cursorline" will ignore "firstline"
Bram Moolenaar <Bram@vim.org>
parents: 22355
diff changeset
5638 Returns an empty Dictionary if window {nr} does not exist.
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
5639
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
5640 Examples (See also |getqflist-examples|): >
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
5641 :echo getloclist(3, {'all': 0})
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
5642 :echo getloclist(5, {'filewinid': 0})
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
5643
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
5644
21676
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
5645 getmarklist([{expr}]) *getmarklist()*
20615
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5646 Without the {expr} argument returns a |List| with information
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5647 about all the global marks. |mark|
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5648
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5649 If the optional {expr} argument is specified, returns the
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5650 local marks defined in buffer {expr}. For the use of {expr},
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5651 see |bufname()|.
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5652
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22298
diff changeset
5653 Each item in the returned List is a |Dict| with the following:
20615
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5654 name - name of the mark prefixed by "'"
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5655 pos - a |List| with the position of the mark:
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5656 [bufnum, lnum, col, off]
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5657 Refer to |getpos()| for more information.
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5658 file - file name
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5659
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5660 Refer to |getpos()| for getting information about a specific
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5661 mark.
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5662
20635
3e36a51ff152 patch 8.2.0871: cannot use getmarklist() as a method
Bram Moolenaar <Bram@vim.org>
parents: 20631
diff changeset
5663 Can also be used as a |method|: >
3e36a51ff152 patch 8.2.0871: cannot use getmarklist() as a method
Bram Moolenaar <Bram@vim.org>
parents: 20631
diff changeset
5664 GetBufnr()->getmarklist()
20615
8eed1e9389bb patch 8.2.0861: cannot easily get all the current marks
Bram Moolenaar <Bram@vim.org>
parents: 20603
diff changeset
5665
16158
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
5666 getmatches([{win}]) *getmatches()*
16127
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
5667 Returns a |List| with all matches previously defined for the
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
5668 current window by |matchadd()| and the |:match| commands.
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
5669 |getmatches()| is useful in combination with |setmatches()|,
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
5670 as |setmatches()| can restore a list of matches saved by
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
5671 |getmatches()|.
1326
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5672 Example: >
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5673 :echo getmatches()
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5674 < [{'group': 'MyGroup1', 'pattern': 'TODO',
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5675 'priority': 10, 'id': 1}, {'group': 'MyGroup2',
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5676 'pattern': 'FIXME', 'priority': 10, 'id': 2}] >
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5677 :let m = getmatches()
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5678 :call clearmatches()
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5679 :echo getmatches()
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5680 < [] >
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5681 :call setmatches(m)
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5682 :echo getmatches()
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5683 < [{'group': 'MyGroup1', 'pattern': 'TODO',
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5684 'priority': 10, 'id': 1}, {'group': 'MyGroup2',
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5685 'pattern': 'FIXME', 'priority': 10, 'id': 2}] >
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5686 :unlet m
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
5687 <
18623
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5688 getmousepos() *getmousepos()*
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
5689 Returns a |Dictionary| with the last known position of the
18623
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5690 mouse. This can be used in a mapping for a mouse click or in
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5691 a filter of a popup window. The items are:
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5692 screenrow screen row
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5693 screencol screen column
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5694 winid Window ID of the click
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5695 winrow row inside "winid"
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5696 wincol column inside "winid"
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5697 line text line inside "winid"
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5698 column text column inside "winid"
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5699 All numbers are 1-based.
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5700
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5701 If not over a window, e.g. when in the command line, then only
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5702 "screenrow" and "screencol" are valid, the others are zero.
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5703
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5704 When on the status line below a window or the vertical
20687
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
5705 separator right of a window, the "line" and "column" values
18623
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5706 are zero.
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5707
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5708 When the position is after the text then "column" is the
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5709 length of the text in bytes.
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5710
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5711 If the mouse is over a popup window then that window is used.
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5712
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5713
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5714 When using |getchar()| the Vim variables |v:mouse_lnum|,
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5715 |v:mouse_col| and |v:mouse_winid| also provide these values.
3089b422b9dc patch 8.1.2304: cannot get the mouse position when getting a mouse click
Bram Moolenaar <Bram@vim.org>
parents: 18594
diff changeset
5716
5968
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5717 *getpid()*
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5718 getpid() Return a Number which is the process ID of the Vim process.
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5719 On Unix and MS-Windows this is a unique number, until Vim
18972
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18928
diff changeset
5720 exits.
5968
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5721
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5722 *getpos()*
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5723 getpos({expr}) Get the position for {expr}. For possible values of {expr}
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5724 see |line()|. For getting the cursor position see
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5725 |getcurpos()|.
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5726 The result is a |List| with four numbers:
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5727 [bufnum, lnum, col, off]
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5728 "bufnum" is zero, unless a mark like '0 or 'A is used, then it
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5729 is the buffer number of the mark.
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5730 "lnum" and "col" are the position in the buffer. The first
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5731 column is 1.
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5732 The "off" number is zero, unless 'virtualedit' is used. Then
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5733 it is the offset in screen columns from the start of the
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5734 character. E.g., a position within a <Tab> or after the last
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5735 character.
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5736 Note that for '< and '> Visual mode matters: when it is "V"
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5737 (visual line mode) the column of '< is zero and the column of
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5738 '> is a large number.
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5739 The column number in the returned List is the byte position
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5740 within the line. To get the character position in the line,
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5741 use |getcharpos()|
5968
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5742 This can be used to save and restore the position of a mark: >
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5743 let save_a_mark = getpos("'a")
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5744 ...
6421
5d89d9b40499 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6413
diff changeset
5745 call setpos("'a", save_a_mark)
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
5746 < Also see |getcharpos()|, |getcurpos()| and |setpos()|.
5968
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
5747
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5748 Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5749 GetMark()->getpos()
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5750
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5751 getqflist([{what}]) *getqflist()*
23164
99ef85ff1af4 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23048
diff changeset
5752 Returns a |List| with all the current quickfix errors. Each
230
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
5753 list item is a dictionary with these entries:
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
5754 bufnr number of buffer that has the file name, use
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
5755 bufname() to get the name
13821
98274127d675 patch 8.0.1782: no simple way to label quickfix entries
Christian Brabandt <cb@256bit.org>
parents: 13818
diff changeset
5756 module module name
230
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
5757 lnum line number in the buffer (first line is 1)
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
5758 col column number (first column is 1)
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
5759 vcol |TRUE|: "col" is visual column
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
5760 |FALSE|: "col" is byte index
230
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
5761 nr error number
1065
caa550fe4457 updated for version 7.0-191
vimboss
parents: 1029
diff changeset
5762 pattern search pattern used to locate the error
230
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
5763 text description of the error
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
5764 type type of the error, 'E', '1', etc.
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
5765 valid |TRUE|: recognized error message
230
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
5766
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
5767 When there is no error list or it's empty, an empty list is
1065
caa550fe4457 updated for version 7.0-191
vimboss
parents: 1029
diff changeset
5768 returned. Quickfix list entries with non-existing buffer
caa550fe4457 updated for version 7.0-191
vimboss
parents: 1029
diff changeset
5769 number are returned with "bufnr" set to zero.
515
04dcb5a1f2f9 updated for version 7.0144
vimboss
parents: 504
diff changeset
5770
230
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
5771 Useful application: Find pattern matches in multiple files and
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
5772 do something with them: >
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
5773 :vimgrep /theword/jg *.c
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
5774 :for d in getqflist()
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
5775 : echo bufname(d.bufnr) ':' d.lnum '=' d.text
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
5776 :endfor
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5777 <
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5778 If the optional {what} dictionary argument is supplied, then
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5779 returns only the items listed in {what} as a dictionary. The
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5780 following string items are supported in {what}:
13062
6479dadcf214 patch 8.0.1406: difficult to track changes to a quickfix list
Christian Brabandt <cb@256bit.org>
parents: 13051
diff changeset
5781 changedtick get the total number of changes made
13818
28ac7914b2b6 Update runtime files and translations
Christian Brabandt <cb@256bit.org>
parents: 13796
diff changeset
5782 to the list |quickfix-changedtick|
28ac7914b2b6 Update runtime files and translations
Christian Brabandt <cb@256bit.org>
parents: 13796
diff changeset
5783 context get the |quickfix-context|
12321
2779d593a706 patch 8.0.1040: cannot use another error format in getqflist()
Christian Brabandt <cb@256bit.org>
parents: 12319
diff changeset
5784 efm errorformat to use when parsing "lines". If
12968
45987b1b77dc Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 12909
diff changeset
5785 not present, then the 'errorformat' option
12321
2779d593a706 patch 8.0.1040: cannot use another error format in getqflist()
Christian Brabandt <cb@256bit.org>
parents: 12319
diff changeset
5786 value is used.
12287
20641a7e1fc9 patch 8.0.1023: it is not easy to identify a quickfix list
Christian Brabandt <cb@256bit.org>
parents: 12273
diff changeset
5787 id get information for the quickfix list with
20641a7e1fc9 patch 8.0.1023: it is not easy to identify a quickfix list
Christian Brabandt <cb@256bit.org>
parents: 12273
diff changeset
5788 |quickfix-ID|; zero means the id for the
12968
45987b1b77dc Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 12909
diff changeset
5789 current list or the list specified by "nr"
20631
d6827bd31d1d patch 8.2.0869: it is not possible to customize the quickfix window contents
Bram Moolenaar <Bram@vim.org>
parents: 20629
diff changeset
5790 idx get information for the quickfix entry at this
d6827bd31d1d patch 8.2.0869: it is not possible to customize the quickfix window contents
Bram Moolenaar <Bram@vim.org>
parents: 20629
diff changeset
5791 index in the list specified by 'id' or 'nr'.
d6827bd31d1d patch 8.2.0869: it is not possible to customize the quickfix window contents
Bram Moolenaar <Bram@vim.org>
parents: 20629
diff changeset
5792 If set to zero, then uses the current entry.
15424
90c8ff9c19ee patch 8.1.0720: cannot easily change the current quickfx list index
Bram Moolenaar <Bram@vim.org>
parents: 15418
diff changeset
5793 See |quickfix-index|
11549
f5add45f9848 patch 8.0.0657: cannot get and set quickfix list items
Christian Brabandt <cb@256bit.org>
parents: 11543
diff changeset
5794 items quickfix list entries
13818
28ac7914b2b6 Update runtime files and translations
Christian Brabandt <cb@256bit.org>
parents: 13796
diff changeset
5795 lines parse a list of lines using 'efm' and return
28ac7914b2b6 Update runtime files and translations
Christian Brabandt <cb@256bit.org>
parents: 13796
diff changeset
5796 the resulting entries. Only a |List| type is
28ac7914b2b6 Update runtime files and translations
Christian Brabandt <cb@256bit.org>
parents: 13796
diff changeset
5797 accepted. The current quickfix list is not
28ac7914b2b6 Update runtime files and translations
Christian Brabandt <cb@256bit.org>
parents: 13796
diff changeset
5798 modified. See |quickfix-parse|.
10237
197795e3530d commit https://github.com/vim/vim/commit/890680ca6364386fabb271c85e0755bcaa6a33c1
Christian Brabandt <cb@256bit.org>
parents: 10233
diff changeset
5799 nr get information for this quickfix list; zero
12321
2779d593a706 patch 8.0.1040: cannot use another error format in getqflist()
Christian Brabandt <cb@256bit.org>
parents: 12319
diff changeset
5800 means the current quickfix list and "$" means
11502
46bbef0ee9a6 patch 8.0.0634: cannot easily get to the last quickfix list
Christian Brabandt <cb@256bit.org>
parents: 11473
diff changeset
5801 the last quickfix list
16019
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
5802 qfbufnr number of the buffer displayed in the quickfix
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
5803 window. Returns 0 if the quickfix buffer is
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
5804 not present. See |quickfix-buffer|.
12465
805f7fd40e0d patch 8.0.1112: can't get size or current index from quickfix list
Christian Brabandt <cb@256bit.org>
parents: 12427
diff changeset
5805 size number of entries in the quickfix list
13818
28ac7914b2b6 Update runtime files and translations
Christian Brabandt <cb@256bit.org>
parents: 13796
diff changeset
5806 title get the list title |quickfix-title|
13016
e47e70300f30 patch 8.0.1384: not enough quickfix help; confusing winid
Christian Brabandt <cb@256bit.org>
parents: 12977
diff changeset
5807 winid get the quickfix |window-ID|
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5808 all all of the above quickfix properties
13016
e47e70300f30 patch 8.0.1384: not enough quickfix help; confusing winid
Christian Brabandt <cb@256bit.org>
parents: 12977
diff changeset
5809 Non-string items in {what} are ignored. To get the value of a
13026
7c0e0e923537 patch 8.0.1389: getqflist() items are missing if not set
Christian Brabandt <cb@256bit.org>
parents: 13020
diff changeset
5810 particular item, set it to zero.
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5811 If "nr" is not present then the current quickfix list is used.
12287
20641a7e1fc9 patch 8.0.1023: it is not easy to identify a quickfix list
Christian Brabandt <cb@256bit.org>
parents: 12273
diff changeset
5812 If both "nr" and a non-zero "id" are specified, then the list
20641a7e1fc9 patch 8.0.1023: it is not easy to identify a quickfix list
Christian Brabandt <cb@256bit.org>
parents: 12273
diff changeset
5813 specified by "id" is used.
12427
fc3e2d5614dd patch 8.0.1093: various small quickfix issues
Christian Brabandt <cb@256bit.org>
parents: 12389
diff changeset
5814 To get the number of lists in the quickfix stack, set "nr" to
fc3e2d5614dd patch 8.0.1093: various small quickfix issues
Christian Brabandt <cb@256bit.org>
parents: 12389
diff changeset
5815 "$" in {what}. The "nr" value in the returned dictionary
11502
46bbef0ee9a6 patch 8.0.0634: cannot easily get to the last quickfix list
Christian Brabandt <cb@256bit.org>
parents: 11473
diff changeset
5816 contains the quickfix stack size.
12427
fc3e2d5614dd patch 8.0.1093: various small quickfix issues
Christian Brabandt <cb@256bit.org>
parents: 12389
diff changeset
5817 When "lines" is specified, all the other items except "efm"
fc3e2d5614dd patch 8.0.1093: various small quickfix issues
Christian Brabandt <cb@256bit.org>
parents: 12389
diff changeset
5818 are ignored. The returned dictionary contains the entry
fc3e2d5614dd patch 8.0.1093: various small quickfix issues
Christian Brabandt <cb@256bit.org>
parents: 12389
diff changeset
5819 "items" with the list of entries.
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5820
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5821 The returned dictionary contains the following entries:
13062
6479dadcf214 patch 8.0.1406: difficult to track changes to a quickfix list
Christian Brabandt <cb@256bit.org>
parents: 13051
diff changeset
5822 changedtick total number of changes made to the
6479dadcf214 patch 8.0.1406: difficult to track changes to a quickfix list
Christian Brabandt <cb@256bit.org>
parents: 13051
diff changeset
5823 list |quickfix-changedtick|
13818
28ac7914b2b6 Update runtime files and translations
Christian Brabandt <cb@256bit.org>
parents: 13796
diff changeset
5824 context quickfix list context. See |quickfix-context|
13026
7c0e0e923537 patch 8.0.1389: getqflist() items are missing if not set
Christian Brabandt <cb@256bit.org>
parents: 13020
diff changeset
5825 If not present, set to "".
7c0e0e923537 patch 8.0.1389: getqflist() items are missing if not set
Christian Brabandt <cb@256bit.org>
parents: 13020
diff changeset
5826 id quickfix list ID |quickfix-ID|. If not
7c0e0e923537 patch 8.0.1389: getqflist() items are missing if not set
Christian Brabandt <cb@256bit.org>
parents: 13020
diff changeset
5827 present, set to 0.
20631
d6827bd31d1d patch 8.2.0869: it is not possible to customize the quickfix window contents
Bram Moolenaar <Bram@vim.org>
parents: 20629
diff changeset
5828 idx index of the quickfix entry in the list. If not
13026
7c0e0e923537 patch 8.0.1389: getqflist() items are missing if not set
Christian Brabandt <cb@256bit.org>
parents: 13020
diff changeset
5829 present, set to 0.
7c0e0e923537 patch 8.0.1389: getqflist() items are missing if not set
Christian Brabandt <cb@256bit.org>
parents: 13020
diff changeset
5830 items quickfix list entries. If not present, set to
7c0e0e923537 patch 8.0.1389: getqflist() items are missing if not set
Christian Brabandt <cb@256bit.org>
parents: 13020
diff changeset
5831 an empty list.
7c0e0e923537 patch 8.0.1389: getqflist() items are missing if not set
Christian Brabandt <cb@256bit.org>
parents: 13020
diff changeset
5832 nr quickfix list number. If not present, set to 0
16019
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
5833 qfbufnr number of the buffer displayed in the quickfix
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
5834 window. If not present, set to 0.
13026
7c0e0e923537 patch 8.0.1389: getqflist() items are missing if not set
Christian Brabandt <cb@256bit.org>
parents: 13020
diff changeset
5835 size number of entries in the quickfix list. If not
7c0e0e923537 patch 8.0.1389: getqflist() items are missing if not set
Christian Brabandt <cb@256bit.org>
parents: 13020
diff changeset
5836 present, set to 0.
7c0e0e923537 patch 8.0.1389: getqflist() items are missing if not set
Christian Brabandt <cb@256bit.org>
parents: 13020
diff changeset
5837 title quickfix list title text. If not present, set
7c0e0e923537 patch 8.0.1389: getqflist() items are missing if not set
Christian Brabandt <cb@256bit.org>
parents: 13020
diff changeset
5838 to "".
13016
e47e70300f30 patch 8.0.1384: not enough quickfix help; confusing winid
Christian Brabandt <cb@256bit.org>
parents: 12977
diff changeset
5839 winid quickfix |window-ID|. If not present, set to 0
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5840
13818
28ac7914b2b6 Update runtime files and translations
Christian Brabandt <cb@256bit.org>
parents: 13796
diff changeset
5841 Examples (See also |getqflist-examples|): >
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5842 :echo getqflist({'all': 1})
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5843 :echo getqflist({'nr': 2, 'title': 1})
12303
ec7a4fd21dd5 patch 8.0.1031: "text" argument for getqflist() is confusing
Christian Brabandt <cb@256bit.org>
parents: 12287
diff changeset
5844 :echo getqflist({'lines' : ["F1:10:L10"]})
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
5845 <
5796
f084024c0ddb updated for version 7.4.242
Bram Moolenaar <bram@vim.org>
parents: 5794
diff changeset
5846 getreg([{regname} [, 1 [, {list}]]]) *getreg()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5847 The result is a String, which is the contents of register
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 233
diff changeset
5848 {regname}. Example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5849 :let cliptext = getreg('*')
9887
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 9881
diff changeset
5850 < When {regname} was not set the result is an empty string.
8951
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
5851
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
5852 getreg('=') returns the last evaluated value of the expression
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 233
diff changeset
5853 register. (For use in maps.)
282
33d9c918b8ab updated for version 7.0075
vimboss
parents: 277
diff changeset
5854 getreg('=', 1) returns the expression itself, so that it can
33d9c918b8ab updated for version 7.0075
vimboss
parents: 277
diff changeset
5855 be restored with |setreg()|. For other registers the extra
33d9c918b8ab updated for version 7.0075
vimboss
parents: 277
diff changeset
5856 argument is ignored, thus you can always give it.
8951
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
5857
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
5858 If {list} is present and |TRUE|, the result type is changed
8951
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
5859 to |List|. Each list item is one text line. Use it if you care
5796
f084024c0ddb updated for version 7.4.242
Bram Moolenaar <bram@vim.org>
parents: 5794
diff changeset
5860 about zero bytes possibly present inside register: without
f084024c0ddb updated for version 7.4.242
Bram Moolenaar <bram@vim.org>
parents: 5794
diff changeset
5861 third argument both NLs and zero bytes are represented as NLs
f084024c0ddb updated for version 7.4.242
Bram Moolenaar <bram@vim.org>
parents: 5794
diff changeset
5862 (see |NL-used-for-Nul|).
8951
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
5863 When the register was not set an empty list is returned.
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
5864
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5865 If {regname} is not specified, |v:register| is used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5866
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5867 Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5868 GetRegname()->getreg()
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5869
20743
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5870 getreginfo([{regname}]) *getreginfo()*
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5871 Returns detailed information about register {regname} as a
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5872 Dictionary with the following entries:
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5873 regcontents List of lines contained in register
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5874 {regname}, like
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5875 |getreg|({regname}, 1, 1).
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5876 regtype the type of register {regname}, as in
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5877 |getregtype()|.
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5878 isunnamed Boolean flag, v:true if this register
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5879 is currently pointed to by the unnamed
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5880 register.
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5881 points_to for the unnamed register, gives the
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5882 single letter name of the register
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5883 currently pointed to (see |quotequote|).
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5884 For example, after deleting a line
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5885 with `dd`, this field will be "1",
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5886 which is the register that got the
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5887 deleted text.
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5888
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5889 If {regname} is invalid or not set, an empty Dictionary
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5890 will be returned.
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5891 If {regname} is not specified, |v:register| is used.
21991
bbca88cd13d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21989
diff changeset
5892 The returned Dictionary can be passed to |setreg()|.
20743
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5893
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5894 Can also be used as a |method|: >
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
5895 GetRegname()->getreginfo()
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
5896
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5897 getregtype([{regname}]) *getregtype()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5898 The result is a String, which is type of register {regname}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5899 The value will be one of:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5900 "v" for |characterwise| text
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5901 "V" for |linewise| text
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5902 "<CTRL-V>{width}" for |blockwise-visual| text
5596
1098b7b6e147 updated for version 7.4.145
Bram Moolenaar <bram@vim.org>
parents: 5555
diff changeset
5903 "" for an empty or unknown register
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5904 <CTRL-V> is one character with value 0x16.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5905 If {regname} is not specified, |v:register| is used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5906
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5907 Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5908 GetRegname()->getregtype()
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5909
9858
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5910 gettabinfo([{arg}]) *gettabinfo()*
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5911 If {arg} is not specified, then information about all the tab
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
5912 pages is returned as a |List|. Each List item is a |Dictionary|.
9858
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5913 Otherwise, {arg} specifies the tab page number and information
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5914 about that one is returned. If the tab page does not exist an
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5915 empty List is returned.
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5916
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
5917 Each List item is a |Dictionary| with the following entries:
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
5918 tabnr tab page number.
10000
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
5919 variables a reference to the dictionary with
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
5920 tabpage-local variables
15932
c3c1abe7aff2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 15878
diff changeset
5921 windows List of |window-ID|s in the tab page.
9858
3e96d9ed2ca1 commit https://github.com/vim/vim/commit/b5ae48e9ffd3b8eb6ca4057de11f1bddcde8ce6f
Christian Brabandt <cb@256bit.org>
parents: 9850
diff changeset
5922
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5923 Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5924 GetTabnr()->gettabinfo()
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5925
4157
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
5926 gettabvar({tabnr}, {varname} [, {def}]) *gettabvar()*
2207
b17bbfa96fa0 Add the settabvar() and gettabvar() functions.
Bram Moolenaar <bram@vim.org>
parents: 2206
diff changeset
5927 Get the value of a tab-local variable {varname} in tab page
b17bbfa96fa0 Add the settabvar() and gettabvar() functions.
Bram Moolenaar <bram@vim.org>
parents: 2206
diff changeset
5928 {tabnr}. |t:var|
b17bbfa96fa0 Add the settabvar() and gettabvar() functions.
Bram Moolenaar <bram@vim.org>
parents: 2206
diff changeset
5929 Tabs are numbered starting with one.
6197
4176c48c7dd5 updated for version 7.4.434
Bram Moolenaar <bram@vim.org>
parents: 6183
diff changeset
5930 When {varname} is empty a dictionary with all tab-local
4176c48c7dd5 updated for version 7.4.434
Bram Moolenaar <bram@vim.org>
parents: 6183
diff changeset
5931 variables is returned.
2207
b17bbfa96fa0 Add the settabvar() and gettabvar() functions.
Bram Moolenaar <bram@vim.org>
parents: 2206
diff changeset
5932 Note that the name without "t:" must be used.
4157
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
5933 When the tab or variable doesn't exist {def} or an empty
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
5934 string is returned, there is no error message.
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
5935
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5936 Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5937 GetTabnr()->gettabvar(varname)
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5938
4157
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
5939 gettabwinvar({tabnr}, {winnr}, {varname} [, {def}]) *gettabwinvar()*
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
5940 Get the value of window-local variable {varname} in window
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
5941 {winnr} in tab page {tabnr}.
4157
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
5942 When {varname} is empty a dictionary with all window-local
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
5943 variables is returned.
10000
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
5944 When {varname} is equal to "&" get the values of all
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
5945 window-local options in a |Dictionary|.
10000
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
5946 Otherwise, when {varname} starts with "&" get the value of a
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
5947 window-local option.
4157
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
5948 Note that {varname} must be the name without "w:".
831
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
5949 Tabs are numbered starting with one. For the current tabpage
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
5950 use |getwinvar()|.
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
5951 {winnr} can be the window number or the |window-ID|.
831
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
5952 When {winnr} is zero the current window is used.
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
5953 This also works for a global option, buffer-local option and
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
5954 window-local option, but it doesn't work for a global variable
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
5955 or buffer-local variable.
4157
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
5956 When the tab, window or variable doesn't exist {def} or an
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
5957 empty string is returned, there is no error message.
831
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
5958 Examples: >
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
5959 :let list_is_on = gettabwinvar(1, 2, '&list')
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
5960 :echo "myvar = " . gettabwinvar(3, 1, 'myvar')
1266
54588e2e8041 updated for version 7.1
vimboss
parents: 1215
diff changeset
5961 <
14347
723487cd7876 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14343
diff changeset
5962 To obtain all window-local variables use: >
723487cd7876 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14343
diff changeset
5963 gettabwinvar({tabnr}, {winnr}, '&')
723487cd7876 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14343
diff changeset
5964
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5965 < Can also be used as a |method|: >
17912
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
5966 GetTabnr()->gettabwinvar(winnr, varname)
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
5967
15016
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5968 gettagstack([{nr}]) *gettagstack()*
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5969 The result is a Dict, which is the tag stack of window {nr}.
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5970 {nr} can be the window number or the |window-ID|.
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5971 When {nr} is not specified, the current window is used.
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5972 When window {nr} doesn't exist, an empty Dict is returned.
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5973
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5974 The returned dictionary contains the following entries:
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5975 curidx Current index in the stack. When at
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5976 top of the stack, set to (length + 1).
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5977 Index of bottom of the stack is 1.
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5978 items List of items in the stack. Each item
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5979 is a dictionary containing the
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5980 entries described below.
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5981 length Number of entries in the stack.
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5982
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5983 Each item in the stack is a dictionary with the following
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5984 entries:
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5985 bufnr buffer number of the current jump
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5986 from cursor position before the tag jump.
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5987 See |getpos()| for the format of the
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5988 returned list.
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5989 matchnr current matching tag number. Used when
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5990 multiple matching tags are found for a
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5991 name.
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5992 tagname name of the tag
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5993
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5994 See |tagstack| for more information about the tag stack.
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
5995
17912
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
5996 Can also be used as a |method|: >
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
5997 GetWinnr()->gettagstack()
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
5998
21989
52e970719f4b patch 8.2.1544: cannot translate messages in a Vim script
Bram Moolenaar <Bram@vim.org>
parents: 21973
diff changeset
5999
52e970719f4b patch 8.2.1544: cannot translate messages in a Vim script
Bram Moolenaar <Bram@vim.org>
parents: 21973
diff changeset
6000 gettext({text}) *gettext()*
52e970719f4b patch 8.2.1544: cannot translate messages in a Vim script
Bram Moolenaar <Bram@vim.org>
parents: 21973
diff changeset
6001 Translate {text} if possible.
52e970719f4b patch 8.2.1544: cannot translate messages in a Vim script
Bram Moolenaar <Bram@vim.org>
parents: 21973
diff changeset
6002 This is mainly for use in the distributed Vim scripts. When
52e970719f4b patch 8.2.1544: cannot translate messages in a Vim script
Bram Moolenaar <Bram@vim.org>
parents: 21973
diff changeset
6003 generating message translations the {text} is extracted by
52e970719f4b patch 8.2.1544: cannot translate messages in a Vim script
Bram Moolenaar <Bram@vim.org>
parents: 21973
diff changeset
6004 xgettext, the translator can add the translated message in the
52e970719f4b patch 8.2.1544: cannot translate messages in a Vim script
Bram Moolenaar <Bram@vim.org>
parents: 21973
diff changeset
6005 .po file and Vim will lookup the translation when gettext() is
52e970719f4b patch 8.2.1544: cannot translate messages in a Vim script
Bram Moolenaar <Bram@vim.org>
parents: 21973
diff changeset
6006 called.
52e970719f4b patch 8.2.1544: cannot translate messages in a Vim script
Bram Moolenaar <Bram@vim.org>
parents: 21973
diff changeset
6007 For {text} double quoted strings are preferred, because
52e970719f4b patch 8.2.1544: cannot translate messages in a Vim script
Bram Moolenaar <Bram@vim.org>
parents: 21973
diff changeset
6008 xgettext does not understand escaping in single quoted
52e970719f4b patch 8.2.1544: cannot translate messages in a Vim script
Bram Moolenaar <Bram@vim.org>
parents: 21973
diff changeset
6009 strings.
52e970719f4b patch 8.2.1544: cannot translate messages in a Vim script
Bram Moolenaar <Bram@vim.org>
parents: 21973
diff changeset
6010
52e970719f4b patch 8.2.1544: cannot translate messages in a Vim script
Bram Moolenaar <Bram@vim.org>
parents: 21973
diff changeset
6011
14343
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6012 getwininfo([{winid}]) *getwininfo()*
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
6013 Returns information about windows as a |List| with Dictionaries.
14343
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6014
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6015 If {winid} is given Information about the window with that ID
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
6016 is returned, as a |List| with one item. If the window does not
20965
59f93c2d2551 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20889
diff changeset
6017 exist the result is an empty list.
14343
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6018
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6019 Without {winid} information about all the windows in all the
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6020 tab pages is returned.
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6021
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
6022 Each List item is a |Dictionary| with the following entries:
15977
7fbdceabad64 patch 8.1.0994: relative cursor position is not calculated correctly
Bram Moolenaar <Bram@vim.org>
parents: 15932
diff changeset
6023 botline last displayed buffer line
14343
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6024 bufnr number of buffer in the window
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6025 height window height (excluding winbar)
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6026 loclist 1 if showing a location list
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6027 {only with the +quickfix feature}
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6028 quickfix 1 if quickfix or location list window
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6029 {only with the +quickfix feature}
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6030 terminal 1 if a terminal window
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6031 {only with the +terminal feature}
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6032 tabnr tab page number
18669
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
6033 topline first displayed buffer line
14343
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6034 variables a reference to the dictionary with
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6035 window-local variables
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6036 width window width
14347
723487cd7876 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14343
diff changeset
6037 winbar 1 if the window has a toolbar, 0
723487cd7876 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14343
diff changeset
6038 otherwise
14343
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6039 wincol leftmost screen column of the window,
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6040 col from |win_screenpos()|
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6041 winid |window-ID|
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6042 winnr window number
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6043 winrow topmost screen column of the window,
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6044 row from |win_screenpos()|
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
6045
17912
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6046 Can also be used as a |method|: >
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6047 GetWinnr()->getwininfo()
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6048
13379
0f9dd1b43244 patch 8.0.1563: timeout of getwinposx() can be too short
Christian Brabandt <cb@256bit.org>
parents: 13341
diff changeset
6049 getwinpos([{timeout}]) *getwinpos()*
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
6050 The result is a |List| with two numbers, the result of
18669
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
6051 |getwinposx()| and |getwinposy()| combined:
13379
0f9dd1b43244 patch 8.0.1563: timeout of getwinposx() can be too short
Christian Brabandt <cb@256bit.org>
parents: 13341
diff changeset
6052 [x-pos, y-pos]
0f9dd1b43244 patch 8.0.1563: timeout of getwinposx() can be too short
Christian Brabandt <cb@256bit.org>
parents: 13341
diff changeset
6053 {timeout} can be used to specify how long to wait in msec for
0f9dd1b43244 patch 8.0.1563: timeout of getwinposx() can be too short
Christian Brabandt <cb@256bit.org>
parents: 13341
diff changeset
6054 a response from the terminal. When omitted 100 msec is used.
13437
02b3f719eacb Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13379
diff changeset
6055 Use a longer time for a remote terminal.
02b3f719eacb Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13379
diff changeset
6056 When using a value less than 10 and no response is received
02b3f719eacb Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13379
diff changeset
6057 within that time, a previously reported position is returned,
02b3f719eacb Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13379
diff changeset
6058 if available. This can be used to poll for the position and
15424
90c8ff9c19ee patch 8.1.0720: cannot easily change the current quickfx list index
Bram Moolenaar <Bram@vim.org>
parents: 15418
diff changeset
6059 do some work in the meantime: >
13437
02b3f719eacb Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13379
diff changeset
6060 while 1
02b3f719eacb Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13379
diff changeset
6061 let res = getwinpos(1)
02b3f719eacb Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13379
diff changeset
6062 if res[0] >= 0
02b3f719eacb Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13379
diff changeset
6063 break
02b3f719eacb Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13379
diff changeset
6064 endif
02b3f719eacb Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13379
diff changeset
6065 " Do some work here
02b3f719eacb Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13379
diff changeset
6066 endwhile
02b3f719eacb Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13379
diff changeset
6067 <
17912
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6068
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6069 Can also be used as a |method|: >
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6070 GetTimeout()->getwinpos()
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6071 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6072 *getwinposx()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6073 getwinposx() The result is a Number, which is the X coordinate in pixels of
11347
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6074 the left hand side of the GUI Vim window. Also works for an
13379
0f9dd1b43244 patch 8.0.1563: timeout of getwinposx() can be too short
Christian Brabandt <cb@256bit.org>
parents: 13341
diff changeset
6075 xterm (uses a timeout of 100 msec).
11347
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6076 The result will be -1 if the information is not available.
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6077 The value can be used with `:winpos`.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6078
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6079 *getwinposy()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6080 getwinposy() The result is a Number, which is the Y coordinate in pixels of
13379
0f9dd1b43244 patch 8.0.1563: timeout of getwinposx() can be too short
Christian Brabandt <cb@256bit.org>
parents: 13341
diff changeset
6081 the top of the GUI Vim window. Also works for an xterm (uses
0f9dd1b43244 patch 8.0.1563: timeout of getwinposx() can be too short
Christian Brabandt <cb@256bit.org>
parents: 13341
diff changeset
6082 a timeout of 100 msec).
11347
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6083 The result will be -1 if the information is not available.
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6084 The value can be used with `:winpos`.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6085
4157
cb185366f5c8 updated for version 7.3.831
Bram Moolenaar <bram@vim.org>
parents: 4151
diff changeset
6086 getwinvar({winnr}, {varname} [, {def}]) *getwinvar()*
831
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
6087 Like |gettabwinvar()| for the current tabpage.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6088 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6089 :let list_is_on = getwinvar(2, '&list')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6090 :echo "myvar = " . getwinvar(1, 'myvar')
17912
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6091
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6092 < Can also be used as a |method|: >
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6093 GetWinnr()->getwinvar(varname)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6094 <
6663
056809de0b29 updated for version 7.4.656
Bram Moolenaar <bram@vim.org>
parents: 6647
diff changeset
6095 glob({expr} [, {nosuf} [, {list} [, {alllinks}]]]) *glob()*
1754
28d0c20ad8a0 updated for version 7.2-051
vimboss
parents: 1733
diff changeset
6096 Expand the file wildcards in {expr}. See |wildcards| for the
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
6097 use of special characters.
3410
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
6098
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
6099 Unless the optional {nosuf} argument is given and is |TRUE|,
1754
28d0c20ad8a0 updated for version 7.2-051
vimboss
parents: 1733
diff changeset
6100 the 'suffixes' and 'wildignore' options apply: Names matching
28d0c20ad8a0 updated for version 7.2-051
vimboss
parents: 1733
diff changeset
6101 one of the patterns in 'wildignore' will be skipped and
28d0c20ad8a0 updated for version 7.2-051
vimboss
parents: 1733
diff changeset
6102 'suffixes' affect the ordering of matches.
2662
916c90b37ea9 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2642
diff changeset
6103 'wildignorecase' always applies.
3410
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
6104
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
6105 When {list} is present and it is |TRUE| the result is a |List|
3410
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
6106 with all matching files. The advantage of using a List is,
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
6107 you also get filenames containing newlines correctly.
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
6108 Otherwise the result is a String and when there are several
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
6109 matches, they are separated by <NL> characters.
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
6110
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
6111 If the expansion fails, the result is an empty String or List.
6663
056809de0b29 updated for version 7.4.656
Bram Moolenaar <bram@vim.org>
parents: 6647
diff changeset
6112
16267
b471858040bc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16235
diff changeset
6113 You can also use |readdir()| if you need to do complicated
b471858040bc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16235
diff changeset
6114 things, such as limiting the number of matches.
b471858040bc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16235
diff changeset
6115
3445
2cfb68fa26cd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3410
diff changeset
6116 A name for a non-existing file is not included. A symbolic
2cfb68fa26cd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3410
diff changeset
6117 link is only included if it points to an existing file.
6663
056809de0b29 updated for version 7.4.656
Bram Moolenaar <bram@vim.org>
parents: 6647
diff changeset
6118 However, when the {alllinks} argument is present and it is
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
6119 |TRUE| then all symbolic links are included.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6120
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6121 For most systems backticks can be used to get files names from
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6122 any external command. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6123 :let tagfiles = glob("`find . -name tags -print`")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6124 :let &tags = substitute(tagfiles, "\n", ",", "g")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6125 < The result of the program inside the backticks should be one
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
6126 item per line. Spaces inside an item are allowed.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6127
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6128 See |expand()| for expanding special Vim variables. See
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6129 |system()| for getting the raw output of an external command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6130
17912
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6131 Can also be used as a |method|: >
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6132 GetExpr()->glob()
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6133
6697
12155a47f6c2 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6663
diff changeset
6134 glob2regpat({expr}) *glob2regpat()*
12155a47f6c2 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6663
diff changeset
6135 Convert a file pattern, as used by glob(), into a search
12155a47f6c2 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6663
diff changeset
6136 pattern. The result can be used to match with a string that
12155a47f6c2 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6663
diff changeset
6137 is a file name. E.g. >
12155a47f6c2 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6663
diff changeset
6138 if filename =~ glob2regpat('Make*.mak')
12155a47f6c2 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6663
diff changeset
6139 < This is equivalent to: >
12155a47f6c2 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6663
diff changeset
6140 if filename =~ '^Make.*\.mak$'
7788
192ae655ac91 commit https://github.com/vim/vim/commit/3b5f929b18492fec291d1ec95a91f54e5912c03b
Christian Brabandt <cb@256bit.org>
parents: 7782
diff changeset
6141 < When {expr} is an empty string the result is "^$", match an
192ae655ac91 commit https://github.com/vim/vim/commit/3b5f929b18492fec291d1ec95a91f54e5912c03b
Christian Brabandt <cb@256bit.org>
parents: 7782
diff changeset
6142 empty string.
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
6143 Note that the result depends on the system. On MS-Windows
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
6144 a backslash usually means a path separator.
7788
192ae655ac91 commit https://github.com/vim/vim/commit/3b5f929b18492fec291d1ec95a91f54e5912c03b
Christian Brabandt <cb@256bit.org>
parents: 7782
diff changeset
6145
17912
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6146 Can also be used as a |method|: >
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6147 GetExpr()->glob2regpat()
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6148 < *globpath()*
8031
ece323e2b57f commit https://github.com/vim/vim/commit/6463ca229cb9412581419497924c85fcbfc854ab
Christian Brabandt <cb@256bit.org>
parents: 8019
diff changeset
6149 globpath({path}, {expr} [, {nosuf} [, {list} [, {alllinks}]]])
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
6150 Perform glob() for {expr} on all directories in {path} and
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
6151 concatenate the results. Example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6152 :echo globpath(&rtp, "syntax/c.vim")
5873
8e9db1f27a00 updated for version 7.4.279
Bram Moolenaar <bram@vim.org>
parents: 5862
diff changeset
6153 <
8e9db1f27a00 updated for version 7.4.279
Bram Moolenaar <bram@vim.org>
parents: 5862
diff changeset
6154 {path} is a comma-separated list of directory names. Each
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6155 directory name is prepended to {expr} and expanded like with
1754
28d0c20ad8a0 updated for version 7.2-051
vimboss
parents: 1733
diff changeset
6156 |glob()|. A path separator is inserted when needed.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6157 To add a comma inside a directory name escape it with a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6158 backslash. Note that on MS-Windows a directory may have a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6159 trailing backslash, remove it if you put a comma after it.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6160 If the expansion fails for one of the directories, there is no
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6161 error message.
5873
8e9db1f27a00 updated for version 7.4.279
Bram Moolenaar <bram@vim.org>
parents: 5862
diff changeset
6162
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
6163 Unless the optional {nosuf} argument is given and is |TRUE|,
1754
28d0c20ad8a0 updated for version 7.2-051
vimboss
parents: 1733
diff changeset
6164 the 'suffixes' and 'wildignore' options apply: Names matching
28d0c20ad8a0 updated for version 7.2-051
vimboss
parents: 1733
diff changeset
6165 one of the patterns in 'wildignore' will be skipped and
28d0c20ad8a0 updated for version 7.2-051
vimboss
parents: 1733
diff changeset
6166 'suffixes' affect the ordering of matches.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6167
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
6168 When {list} is present and it is |TRUE| the result is a |List|
5873
8e9db1f27a00 updated for version 7.4.279
Bram Moolenaar <bram@vim.org>
parents: 5862
diff changeset
6169 with all matching files. The advantage of using a List is, you
8e9db1f27a00 updated for version 7.4.279
Bram Moolenaar <bram@vim.org>
parents: 5862
diff changeset
6170 also get filenames containing newlines correctly. Otherwise
8e9db1f27a00 updated for version 7.4.279
Bram Moolenaar <bram@vim.org>
parents: 5862
diff changeset
6171 the result is a String and when there are several matches,
8e9db1f27a00 updated for version 7.4.279
Bram Moolenaar <bram@vim.org>
parents: 5862
diff changeset
6172 they are separated by <NL> characters. Example: >
8e9db1f27a00 updated for version 7.4.279
Bram Moolenaar <bram@vim.org>
parents: 5862
diff changeset
6173 :echo globpath(&rtp, "syntax/c.vim", 0, 1)
8e9db1f27a00 updated for version 7.4.279
Bram Moolenaar <bram@vim.org>
parents: 5862
diff changeset
6174 <
8031
ece323e2b57f commit https://github.com/vim/vim/commit/6463ca229cb9412581419497924c85fcbfc854ab
Christian Brabandt <cb@256bit.org>
parents: 8019
diff changeset
6175 {alllinks} is used as with |glob()|.
6663
056809de0b29 updated for version 7.4.656
Bram Moolenaar <bram@vim.org>
parents: 6647
diff changeset
6176
444
d0d15b184c56 updated for version 7.0116
vimboss
parents: 438
diff changeset
6177 The "**" item can be used to search in a directory tree.
d0d15b184c56 updated for version 7.0116
vimboss
parents: 438
diff changeset
6178 For example, to find all "README.txt" files in the directories
d0d15b184c56 updated for version 7.0116
vimboss
parents: 438
diff changeset
6179 in 'runtimepath' and below: >
d0d15b184c56 updated for version 7.0116
vimboss
parents: 438
diff changeset
6180 :echo globpath(&rtp, "**/README.txt")
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
6181 < Upwards search and limiting the depth of "**" is not
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
6182 supported, thus using 'path' will not always work properly.
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
6183
17912
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6184 Can also be used as a |method|, the base is passed as the
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6185 second argument: >
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6186 GetExpr()->globpath(&rtp)
9fac6d0de69a patch 8.1.1952: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17909
diff changeset
6187 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6188 *has()*
19742
810eee1b42e3 patch 8.2.0427: it is not possible to check for a typo in a feature name
Bram Moolenaar <Bram@vim.org>
parents: 19721
diff changeset
6189 has({feature} [, {check}])
810eee1b42e3 patch 8.2.0427: it is not possible to check for a typo in a feature name
Bram Moolenaar <Bram@vim.org>
parents: 19721
diff changeset
6190 When {check} is omitted or is zero: The result is a Number,
810eee1b42e3 patch 8.2.0427: it is not possible to check for a typo in a feature name
Bram Moolenaar <Bram@vim.org>
parents: 19721
diff changeset
6191 which is 1 if the feature {feature} is supported, zero
810eee1b42e3 patch 8.2.0427: it is not possible to check for a typo in a feature name
Bram Moolenaar <Bram@vim.org>
parents: 19721
diff changeset
6192 otherwise. The {feature} argument is a string, case is
810eee1b42e3 patch 8.2.0427: it is not possible to check for a typo in a feature name
Bram Moolenaar <Bram@vim.org>
parents: 19721
diff changeset
6193 ignored. See |feature-list| below.
810eee1b42e3 patch 8.2.0427: it is not possible to check for a typo in a feature name
Bram Moolenaar <Bram@vim.org>
parents: 19721
diff changeset
6194
810eee1b42e3 patch 8.2.0427: it is not possible to check for a typo in a feature name
Bram Moolenaar <Bram@vim.org>
parents: 19721
diff changeset
6195 When {check} is present and not zero: The result is a Number,
810eee1b42e3 patch 8.2.0427: it is not possible to check for a typo in a feature name
Bram Moolenaar <Bram@vim.org>
parents: 19721
diff changeset
6196 which is 1 if the feature {feature} could ever be supported,
810eee1b42e3 patch 8.2.0427: it is not possible to check for a typo in a feature name
Bram Moolenaar <Bram@vim.org>
parents: 19721
diff changeset
6197 zero otherwise. This is useful to check for a typo in
19813
350e1d3131d8 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19805
diff changeset
6198 {feature} and to detect dead code. Keep in mind that an older
350e1d3131d8 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19805
diff changeset
6199 Vim version will not know about a feature added later and
21991
bbca88cd13d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21989
diff changeset
6200 features that have been abandoned will not be known by the
19813
350e1d3131d8 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19805
diff changeset
6201 current Vim version.
19742
810eee1b42e3 patch 8.2.0427: it is not possible to check for a typo in a feature name
Bram Moolenaar <Bram@vim.org>
parents: 19721
diff changeset
6202
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6203 Also see |exists()|.
19742
810eee1b42e3 patch 8.2.0427: it is not possible to check for a typo in a feature name
Bram Moolenaar <Bram@vim.org>
parents: 19721
diff changeset
6204
19646
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
6205 Note that to skip code that has a syntax error when the
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
6206 feature is not available, Vim may skip the rest of the line
20241
56265f711890 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20178
diff changeset
6207 and miss a following `endif`. Therefore put the `endif` on a
19646
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
6208 separate line: >
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
6209 if has('feature')
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
6210 let x = this->breaks->without->the->feature
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
6211 endif
19721
bceeded72898 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19657
diff changeset
6212 < If the `endif` would be moved to the second line as "| endif" it
bceeded72898 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19657
diff changeset
6213 would not be found.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6214
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
6215
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
6216 has_key({dict}, {key}) *has_key()*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
6217 The result is a Number, which is 1 if |Dictionary| {dict} has
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
6218 an entry with key {key}. Zero otherwise.
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
6219
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
6220 Can also be used as a |method|: >
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
6221 mydict->has_key(key)
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
6222
7653
d4370fef0175 commit https://github.com/vim/vim/commit/c970330676eaae7ba7cd05cfa46df5a413853ef9
Christian Brabandt <cb@256bit.org>
parents: 7651
diff changeset
6223 haslocaldir([{winnr} [, {tabnr}]]) *haslocaldir()*
16427
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6224 The result is a Number:
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6225 1 when the window has set a local directory via |:lcd|
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6226 2 when the tab-page has set a local directory via |:tcd|
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6227 0 otherwise.
7653
d4370fef0175 commit https://github.com/vim/vim/commit/c970330676eaae7ba7cd05cfa46df5a413853ef9
Christian Brabandt <cb@256bit.org>
parents: 7651
diff changeset
6228
d4370fef0175 commit https://github.com/vim/vim/commit/c970330676eaae7ba7cd05cfa46df5a413853ef9
Christian Brabandt <cb@256bit.org>
parents: 7651
diff changeset
6229 Without arguments use the current window.
d4370fef0175 commit https://github.com/vim/vim/commit/c970330676eaae7ba7cd05cfa46df5a413853ef9
Christian Brabandt <cb@256bit.org>
parents: 7651
diff changeset
6230 With {winnr} use this window in the current tab page.
d4370fef0175 commit https://github.com/vim/vim/commit/c970330676eaae7ba7cd05cfa46df5a413853ef9
Christian Brabandt <cb@256bit.org>
parents: 7651
diff changeset
6231 With {winnr} and {tabnr} use the window in the specified tab
d4370fef0175 commit https://github.com/vim/vim/commit/c970330676eaae7ba7cd05cfa46df5a413853ef9
Christian Brabandt <cb@256bit.org>
parents: 7651
diff changeset
6232 page.
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
6233 {winnr} can be the window number or the |window-ID|.
16427
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6234 If {winnr} is -1 it is ignored and only the tabpage is used.
7653
d4370fef0175 commit https://github.com/vim/vim/commit/c970330676eaae7ba7cd05cfa46df5a413853ef9
Christian Brabandt <cb@256bit.org>
parents: 7651
diff changeset
6235 Return 0 if the arguments are invalid.
16427
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6236 Examples: >
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6237 if haslocaldir() == 1
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6238 " window local directory case
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6239 elseif haslocaldir() == 2
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6240 " tab-local directory case
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6241 else
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6242 " global directory case
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6243 endif
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6244
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6245 " current window
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6246 :echo haslocaldir()
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6247 :echo haslocaldir(0)
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6248 :echo haslocaldir(0, 0)
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6249 " window n in current tab page
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6250 :echo haslocaldir(n)
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6251 :echo haslocaldir(n, 0)
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6252 " window n in tab page m
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6253 :echo haslocaldir(n, m)
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6254 " tab page m
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6255 :echo haslocaldir(-1, m)
8c3a1bd270bb patch 8.1.1218: cannot set a directory for a tab page
Bram Moolenaar <Bram@vim.org>
parents: 16411
diff changeset
6256 <
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6257 Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6258 GetWinnr()->haslocaldir()
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6259
782
d20041a02ee5 updated for version 7.0228
vimboss
parents: 777
diff changeset
6260 hasmapto({what} [, {mode} [, {abbr}]]) *hasmapto()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6261 The result is a Number, which is 1 if there is a mapping that
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6262 contains {what} in somewhere in the rhs (what it is mapped to)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6263 and this mapping exists in one of the modes indicated by
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6264 {mode}.
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
6265 When {abbr} is there and it is |TRUE| use abbreviations
786
8f6a426bc1e0 updated for version 7.0229
vimboss
parents: 782
diff changeset
6266 instead of mappings. Don't forget to specify Insert and/or
8f6a426bc1e0 updated for version 7.0229
vimboss
parents: 782
diff changeset
6267 Command-line mode.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6268 Both the global mappings and the mappings local to the current
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6269 buffer are checked for a match.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6270 If no matching mapping is found 0 is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6271 The following characters are recognized in {mode}:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6272 n Normal mode
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
6273 v Visual and Select mode
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
6274 x Visual mode
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
6275 s Select mode
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6276 o Operator-pending mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6277 i Insert mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6278 l Language-Argument ("r", "f", "t", etc.)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6279 c Command-line mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6280 When {mode} is omitted, "nvo" is used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6281
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6282 This function is useful to check if a mapping already exists
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
6283 to a function in a Vim script. Example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6284 :if !hasmapto('\ABCdoit')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6285 : map <Leader>d \ABCdoit
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6286 :endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6287 < This installs the mapping to "\ABCdoit" only if there isn't
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6288 already a mapping to "\ABCdoit".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6289
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6290 Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6291 GetRHS()->hasmapto()
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6292
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6293 histadd({history}, {item}) *histadd()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6294 Add the String {item} to the history {history} which can be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6295 one of: *hist-names*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6296 "cmd" or ":" command line history
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6297 "search" or "/" search pattern history
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
6298 "expr" or "=" typed expression history
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6299 "input" or "@" input line history
3682
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
6300 "debug" or ">" debug command history
10228
8a1481e59d64 commit https://github.com/vim/vim/commit/3e496b0ea31996b665824f45664dee1fdd73c4d0
Christian Brabandt <cb@256bit.org>
parents: 10218
diff changeset
6301 empty the current or last used history
3682
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
6302 The {history} string does not need to be the whole name, one
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
6303 character is sufficient.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6304 If {item} does already exist in the history, it will be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6305 shifted to become the newest entry.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6306 The result is a Number: 1 if the operation was successful,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6307 otherwise 0 is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6308
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6309 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6310 :call histadd("input", strftime("%Y %b %d"))
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6311 :let date=input("Enter date: ")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6312 < This function is not available in the |sandbox|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6313
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
6314 Can also be used as a |method|, the base is passed as the
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6315 second argument: >
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
6316 GetHistory()->histadd('search')
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6317
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6318 histdel({history} [, {item}]) *histdel()*
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 233
diff changeset
6319 Clear {history}, i.e. delete all its entries. See |hist-names|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6320 for the possible values of {history}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6321
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
6322 If the parameter {item} evaluates to a String, it is used as a
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
6323 regular expression. All entries matching that expression will
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
6324 be removed from the history (if there are any).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6325 Upper/lowercase must match, unless "\c" is used |/\c|.
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
6326 If {item} evaluates to a Number, it will be interpreted as
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
6327 an index, see |:history-indexing|. The respective entry will
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
6328 be removed if it exists.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6329
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6330 The result is a Number: 1 for a successful operation,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6331 otherwise 0 is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6332
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6333 Examples:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6334 Clear expression register history: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6335 :call histdel("expr")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6336 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6337 Remove all entries starting with "*" from the search history: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6338 :call histdel("/", '^\*')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6339 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6340 The following three are equivalent: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6341 :call histdel("search", histnr("search"))
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6342 :call histdel("search", -1)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6343 :call histdel("search", '^'.histget("search", -1).'$')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6344 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6345 To delete the last search pattern and use the last-but-one for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6346 the "n" command and 'hlsearch': >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6347 :call histdel("search", -1)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6348 :let @/ = histget("search", -1)
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6349 <
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6350 Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6351 GetHistory()->histdel()
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6352
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6353 histget({history} [, {index}]) *histget()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6354 The result is a String, the entry with Number {index} from
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6355 {history}. See |hist-names| for the possible values of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6356 {history}, and |:history-indexing| for {index}. If there is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6357 no such entry, an empty String is returned. When {index} is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6358 omitted, the most recent item from the history is used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6359
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6360 Examples:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6361 Redo the second last search from history. >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6362 :execute '/' . histget("search", -2)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6363
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6364 < Define an Ex command ":H {num}" that supports re-execution of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6365 the {num}th entry from the output of |:history|. >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6366 :command -nargs=1 H execute histget("cmd", 0+<args>)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6367 <
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6368 Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6369 GetHistory()->histget()
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6370
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6371 histnr({history}) *histnr()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6372 The result is the Number of the current entry in {history}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6373 See |hist-names| for the possible values of {history}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6374 If an error occurred, -1 is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6375
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6376 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6377 :let inp_index = histnr("expr")
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6378
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6379 < Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6380 GetHistory()->histnr()
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6381 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6382 hlexists({name}) *hlexists()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6383 The result is a Number, which is non-zero if a highlight group
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6384 called {name} exists. This is when the group has been
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6385 defined in some way. Not necessarily when highlighting has
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6386 been defined for it, it may also have been used for a syntax
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6387 item.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6388 *highlight_exists()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6389 Obsolete name: highlight_exists().
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6390
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6391 Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6392 GetName()->hlexists()
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6393 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6394 *hlID()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6395 hlID({name}) The result is a Number, which is the ID of the highlight group
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6396 with name {name}. When the highlight group doesn't exist,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6397 zero is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6398 This can be used to retrieve information about the highlight
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
6399 group. For example, to get the background color of the
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6400 "Comment" group: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6401 :echo synIDattr(synIDtrans(hlID("Comment")), "bg")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6402 < *highlightID()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6403 Obsolete name: highlightID().
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6404
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6405 Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6406 GetName()->hlID()
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6407
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6408 hostname() *hostname()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6409 The result is a String, which is the name of the machine on
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 233
diff changeset
6410 which Vim is currently running. Machine names greater than
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6411 256 characters long are truncated.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6412
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6413 iconv({expr}, {from}, {to}) *iconv()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6414 The result is a String, which is the text {expr} converted
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6415 from encoding {from} to encoding {to}.
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
6416 When the conversion completely fails an empty string is
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
6417 returned. When some characters could not be converted they
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
6418 are replaced with "?".
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6419 The encoding names are whatever the iconv() library function
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6420 can accept, see ":!man 3 iconv".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6421 Most conversions require Vim to be compiled with the |+iconv|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6422 feature. Otherwise only UTF-8 to latin1 conversion and back
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6423 can be done.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6424 This can be used to display messages with special characters,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6425 no matter what 'encoding' is set to. Write the message in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6426 UTF-8 and use: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6427 echo iconv(utf8_str, "utf-8", &enc)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6428 < Note that Vim uses UTF-8 for all Unicode encodings, conversion
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6429 from/to UCS-2 is automatically changed to use UTF-8. You
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6430 cannot use UCS-2 in a string anyway, because of the NUL bytes.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6431
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6432 Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6433 GetText()->iconv('latin1', 'utf-8')
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6434 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6435 *indent()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6436 indent({lnum}) The result is a Number, which is indent of line {lnum} in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6437 current buffer. The indent is counted in spaces, the value
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6438 of 'tabstop' is relevant. {lnum} is used just like in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6439 |getline()|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6440 When {lnum} is invalid -1 is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6441
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6442 Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6443 GetLnum()->indent()
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
6444
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6445 index({object}, {expr} [, {start} [, {ic}]]) *index()*
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6446 If {object} is a |List| return the lowest index where the item
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6447 has a value equal to {expr}. There is no automatic
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6448 conversion, so the String "4" is different from the Number 4.
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6449 And the number 4 is different from the Float 4.0. The value
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6450 of 'ignorecase' is not used here, case always matters.
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6451
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6452 If {object} is |Blob| return the lowest index where the byte
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6453 value is equal to {expr}.
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6454
153
19670b05ee32 updated for version 7.0047
vimboss
parents: 148
diff changeset
6455 If {start} is given then start looking at the item with index
19670b05ee32 updated for version 7.0047
vimboss
parents: 148
diff changeset
6456 {start} (may be negative for an item relative to the end).
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
6457 When {ic} is given and it is |TRUE|, ignore case. Otherwise
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
6458 case must match.
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6459 -1 is returned when {expr} is not found in {object}.
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
6460 Example: >
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
6461 :let idx = index(words, "the")
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
6462 :if index(numbers, 123) >= 0
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
6463
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6464 < Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6465 GetObject()->index(what)
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
6466
531
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6467 input({prompt} [, {text} [, {completion}]]) *input()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6468 The result is a String, which is whatever the user typed on
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
6469 the command-line. The {prompt} argument is either a prompt
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
6470 string, or a blank string (for no prompt). A '\n' can be used
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
6471 in the prompt to start a new line.
531
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6472 The highlighting set with |:echohl| is used for the prompt.
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6473 The input is entered just like a command-line, with the same
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
6474 editing commands and mappings. There is a separate history
531
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6475 for lines typed for input().
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6476 Example: >
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6477 :if input("Coffee or beer? ") == "beer"
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6478 : echo "Cheers!"
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6479 :endif
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6480 <
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
6481 If the optional {text} argument is present and not empty, this
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
6482 is used for the default reply, as if the user typed this.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
6483 Example: >
531
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6484 :let color = input("Color? ", "white")
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6485
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6486 < The optional {completion} argument specifies the type of
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6487 completion supported for the input. Without it completion is
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
6488 not performed. The supported completion types are the same as
531
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6489 that can be supplied to a user-defined command using the
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
6490 "-complete=" argument. Refer to |:command-completion| for
531
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6491 more information. Example: >
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6492 let fname = input("File: ", "", "file")
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6493 <
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6494 NOTE: This function must not be used in a startup file, for
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6495 the versions that only run in GUI mode (e.g., the Win32 GUI).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6496 Note: When input() is called from within a mapping it will
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6497 consume remaining characters from that mapping, because a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6498 mapping is handled like the characters were typed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6499 Use |inputsave()| before input() and |inputrestore()|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6500 after input() to avoid that. Another solution is to avoid
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6501 that further characters follow in the mapping, e.g., by using
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6502 |:execute| or |:normal|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6503
531
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6504 Example with a mapping: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6505 :nmap \x :call GetFoo()<CR>:exe "/" . Foo<CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6506 :function GetFoo()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6507 : call inputsave()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6508 : let g:Foo = input("enter search pattern: ")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6509 : call inputrestore()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6510 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6511
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6512 < Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6513 GetPrompt()->input()
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6514
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6515 inputdialog({prompt} [, {text} [, {cancelreturn}]]) *inputdialog()*
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
6516 Like |input()|, but when the GUI is running and text dialogs
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
6517 are supported, a dialog window pops up to input the text.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6518 Example: >
3875
8235ccf121bb updated for version 7.3.694
Bram Moolenaar <bram@vim.org>
parents: 3830
diff changeset
6519 :let n = inputdialog("value for shiftwidth", shiftwidth())
8235ccf121bb updated for version 7.3.694
Bram Moolenaar <bram@vim.org>
parents: 3830
diff changeset
6520 :if n != ""
8235ccf121bb updated for version 7.3.694
Bram Moolenaar <bram@vim.org>
parents: 3830
diff changeset
6521 : let &sw = n
8235ccf121bb updated for version 7.3.694
Bram Moolenaar <bram@vim.org>
parents: 3830
diff changeset
6522 :endif
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6523 < When the dialog is cancelled {cancelreturn} is returned. When
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6524 omitted an empty string is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6525 Hitting <Enter> works like pressing the OK button. Hitting
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6526 <Esc> works like pressing the Cancel button.
531
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6527 NOTE: Command-line completion is not supported.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6528
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6529 Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6530 GetPrompt()->inputdialog()
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6531
519
d50452846776 updated for version 7.0145
vimboss
parents: 515
diff changeset
6532 inputlist({textlist}) *inputlist()*
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
6533 {textlist} must be a |List| of strings. This |List| is
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
6534 displayed, one string per line. The user will be prompted to
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
6535 enter a number, which is returned.
519
d50452846776 updated for version 7.0145
vimboss
parents: 515
diff changeset
6536 The user can also select an item by clicking on it with the
20856
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
6537 mouse, if the mouse is enabled in the command line ('mouse' is
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
6538 "a" or includes "c"). For the first string 0 is returned.
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
6539 When clicking above the first item a negative number is
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
6540 returned. When clicking on the prompt one more than the
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
6541 length of {textlist} is returned.
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
6542 Make sure {textlist} has less than 'lines' entries, otherwise
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
6543 it won't work. It's a good idea to put the entry number at
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
6544 the start of the string. And put a prompt in the first item.
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
6545 Example: >
519
d50452846776 updated for version 7.0145
vimboss
parents: 515
diff changeset
6546 let color = inputlist(['Select color:', '1. red',
d50452846776 updated for version 7.0145
vimboss
parents: 515
diff changeset
6547 \ '2. green', '3. blue'])
d50452846776 updated for version 7.0145
vimboss
parents: 515
diff changeset
6548
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6549 < Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6550 GetChoices()->inputlist()
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6551
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6552 inputrestore() *inputrestore()*
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
6553 Restore typeahead that was saved with a previous |inputsave()|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6554 Should be called the same number of times inputsave() is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6555 called. Calling it more often is harmless though.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6556 Returns 1 when there is nothing to restore, 0 otherwise.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6557
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6558 inputsave() *inputsave()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6559 Preserve typeahead (also from mappings) and clear it, so that
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6560 a following prompt gets input from the user. Should be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6561 followed by a matching inputrestore() after the prompt. Can
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6562 be used several times, in which case there must be just as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6563 many inputrestore() calls.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6564 Returns 1 when out of memory, 0 otherwise.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6565
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6566 inputsecret({prompt} [, {text}]) *inputsecret()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6567 This function acts much like the |input()| function with but
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6568 two exceptions:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6569 a) the user's response will be displayed as a sequence of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6570 asterisks ("*") thereby keeping the entry secret, and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6571 b) the user's response will not be recorded on the input
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6572 |history| stack.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6573 The result is a String, which is whatever the user actually
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6574 typed on the command-line in response to the issued prompt.
531
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
6575 NOTE: Command-line completion is not supported.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6576
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6577 Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6578 GetPrompt()->inputsecret()
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6579
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6580 insert({object}, {item} [, {idx}]) *insert()*
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6581 When {object} is a |List| or a |Blob| insert {item} at the start
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6582 of it.
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6583
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
6584 If {idx} is specified insert {item} before the item with index
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
6585 {idx}. If {idx} is zero it goes before the first item, just
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
6586 like omitting {idx}. A negative {idx} is also possible, see
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
6587 |list-index|. -1 inserts just before the last item.
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6588
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
6589 Returns the resulting |List| or |Blob|. Examples: >
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
6590 :let mylist = insert([2, 3, 5], 1)
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
6591 :call insert(mylist, 4, -1)
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
6592 :call insert(mylist, 6, len(mylist))
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
6593 < The last example can be done simpler with |add()|.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
6594 Note that when {item} is a |List| it is inserted as a single
692
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
6595 item. Use |extend()| to concatenate |Lists|.
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
6596
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6597 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6598 mylist->insert(item)
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6599
18699
1febd1aa9930 patch 8.1.2341: not so easy to interrupt a script programatically
Bram Moolenaar <Bram@vim.org>
parents: 18669
diff changeset
6600 interrupt() *interrupt()*
1febd1aa9930 patch 8.1.2341: not so easy to interrupt a script programatically
Bram Moolenaar <Bram@vim.org>
parents: 18669
diff changeset
6601 Interrupt script execution. It works more or less like the
1febd1aa9930 patch 8.1.2341: not so easy to interrupt a script programatically
Bram Moolenaar <Bram@vim.org>
parents: 18669
diff changeset
6602 user typing CTRL-C, most commands won't execute and control
1febd1aa9930 patch 8.1.2341: not so easy to interrupt a script programatically
Bram Moolenaar <Bram@vim.org>
parents: 18669
diff changeset
6603 returns to the user. This is useful to abort execution
1febd1aa9930 patch 8.1.2341: not so easy to interrupt a script programatically
Bram Moolenaar <Bram@vim.org>
parents: 18669
diff changeset
6604 from lower down, e.g. in an autocommand. Example: >
1febd1aa9930 patch 8.1.2341: not so easy to interrupt a script programatically
Bram Moolenaar <Bram@vim.org>
parents: 18669
diff changeset
6605 :function s:check_typoname(file)
1febd1aa9930 patch 8.1.2341: not so easy to interrupt a script programatically
Bram Moolenaar <Bram@vim.org>
parents: 18669
diff changeset
6606 : if fnamemodify(a:file, ':t') == '['
1febd1aa9930 patch 8.1.2341: not so easy to interrupt a script programatically
Bram Moolenaar <Bram@vim.org>
parents: 18669
diff changeset
6607 : echomsg 'Maybe typo'
1febd1aa9930 patch 8.1.2341: not so easy to interrupt a script programatically
Bram Moolenaar <Bram@vim.org>
parents: 18669
diff changeset
6608 : call interrupt()
1febd1aa9930 patch 8.1.2341: not so easy to interrupt a script programatically
Bram Moolenaar <Bram@vim.org>
parents: 18669
diff changeset
6609 : endif
1febd1aa9930 patch 8.1.2341: not so easy to interrupt a script programatically
Bram Moolenaar <Bram@vim.org>
parents: 18669
diff changeset
6610 :endfunction
1febd1aa9930 patch 8.1.2341: not so easy to interrupt a script programatically
Bram Moolenaar <Bram@vim.org>
parents: 18669
diff changeset
6611 :au BufWritePre * call s:check_typoname(expand('<amatch>'))
1febd1aa9930 patch 8.1.2341: not so easy to interrupt a script programatically
Bram Moolenaar <Bram@vim.org>
parents: 18669
diff changeset
6612
3214
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
6613 invert({expr}) *invert()*
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
6614 Bitwise invert. The argument is converted to a number. A
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
6615 List, Dict or Float argument causes an error. Example: >
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
6616 :let bits = invert(bits)
17783
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
6617 < Can also be used as a |method|: >
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
6618 :let bits = bits->invert()
3214
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
6619
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6620 isdirectory({directory}) *isdirectory()*
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
6621 The result is a Number, which is |TRUE| when a directory
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6622 with the name {directory} exists. If {directory} doesn't
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
6623 exist, or isn't a directory, the result is |FALSE|. {directory}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6624 is any expression, which is used as a String.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6625
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6626 Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6627 GetName()->isdirectory()
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6628
16213
2c33b119ba92 patch 8.1.1111: it is not easy to check for infinity
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
6629 isinf({expr}) *isinf()*
2c33b119ba92 patch 8.1.1111: it is not easy to check for infinity
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
6630 Return 1 if {expr} is a positive infinity, or -1 a negative
2c33b119ba92 patch 8.1.1111: it is not easy to check for infinity
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
6631 infinity, otherwise 0. >
2c33b119ba92 patch 8.1.1111: it is not easy to check for infinity
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
6632 :echo isinf(1.0 / 0.0)
2c33b119ba92 patch 8.1.1111: it is not easy to check for infinity
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
6633 < 1 >
2c33b119ba92 patch 8.1.1111: it is not easy to check for infinity
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
6634 :echo isinf(-1.0 / 0.0)
2c33b119ba92 patch 8.1.1111: it is not easy to check for infinity
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
6635 < -1
2c33b119ba92 patch 8.1.1111: it is not easy to check for infinity
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
6636
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
6637 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
6638 Compute()->isinf()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
6639 <
16213
2c33b119ba92 patch 8.1.1111: it is not easy to check for infinity
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
6640 {only available when compiled with the |+float| feature}
2c33b119ba92 patch 8.1.1111: it is not easy to check for infinity
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
6641
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
6642 islocked({expr}) *islocked()* *E786*
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
6643 The result is a Number, which is |TRUE| when {expr} is the
148
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
6644 name of a locked variable.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
6645 {expr} must be the name of a variable, |List| item or
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
6646 |Dictionary| entry, not the variable itself! Example: >
148
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
6647 :let alist = [0, ['a', 'b'], 2, 3]
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
6648 :lockvar 1 alist
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
6649 :echo islocked('alist') " 1
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
6650 :echo islocked('alist[1]') " 0
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
6651
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
6652 < When {expr} is a variable that does not exist you get an error
843
9f279ebda751 updated for version 7.0f01
vimboss
parents: 842
diff changeset
6653 message. Use |exists()| to check for existence.
148
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
6654
17914
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6655 Can also be used as a |method|: >
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6656 GetName()->islocked()
af3d441845cd patch 8.1.1953: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17912
diff changeset
6657
8246
f16bfe02cef1 commit https://github.com/vim/vim/commit/f391327adbbffb11180cf6038a92af1ed144e907
Christian Brabandt <cb@256bit.org>
parents: 8218
diff changeset
6658 isnan({expr}) *isnan()*
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
6659 Return |TRUE| if {expr} is a float with value NaN. >
8246
f16bfe02cef1 commit https://github.com/vim/vim/commit/f391327adbbffb11180cf6038a92af1ed144e907
Christian Brabandt <cb@256bit.org>
parents: 8218
diff changeset
6660 echo isnan(0.0 / 0.0)
16219
bd49e1656c72 patch 8.1.1114: confusing overloaded operator "." for string concatenation
Bram Moolenaar <Bram@vim.org>
parents: 16213
diff changeset
6661 < 1
8246
f16bfe02cef1 commit https://github.com/vim/vim/commit/f391327adbbffb11180cf6038a92af1ed144e907
Christian Brabandt <cb@256bit.org>
parents: 8218
diff changeset
6662
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
6663 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
6664 Compute()->isnan()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
6665 <
8246
f16bfe02cef1 commit https://github.com/vim/vim/commit/f391327adbbffb11180cf6038a92af1ed144e907
Christian Brabandt <cb@256bit.org>
parents: 8218
diff changeset
6666 {only available when compiled with the |+float| feature}
f16bfe02cef1 commit https://github.com/vim/vim/commit/f391327adbbffb11180cf6038a92af1ed144e907
Christian Brabandt <cb@256bit.org>
parents: 8218
diff changeset
6667
140
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
6668 items({dict}) *items()*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
6669 Return a |List| with all the key-value pairs of {dict}. Each
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
6670 |List| item is a list with two items: the key of a {dict}
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
6671 entry and the value of this entry. The |List| is in arbitrary
15571
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
6672 order. Also see |keys()| and |values()|.
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
6673 Example: >
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
6674 for [key, value] in items(mydict)
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
6675 echo key . ': ' . value
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
6676 endfor
140
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
6677
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6678 < Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6679 mydict->items()
17456
e414281d8bb4 patch 8.1.1726: the eval.txt help file is too big
Bram Moolenaar <Bram@vim.org>
parents: 17450
diff changeset
6680
e414281d8bb4 patch 8.1.1726: the eval.txt help file is too big
Bram Moolenaar <Bram@vim.org>
parents: 17450
diff changeset
6681 job_ functions are documented here: |job-functions-details|
e414281d8bb4 patch 8.1.1726: the eval.txt help file is too big
Bram Moolenaar <Bram@vim.org>
parents: 17450
diff changeset
6682
7957
b74549818500 commit https://github.com/vim/vim/commit/835dc636a5350f610b62f110227d2363b5b2880a
Christian Brabandt <cb@256bit.org>
parents: 7935
diff changeset
6683
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
6684 join({list} [, {sep}]) *join()*
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
6685 Join the items in {list} together into one String.
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
6686 When {sep} is specified it is put in between the items. If
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
6687 {sep} is omitted a single space is used.
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
6688 Note that {sep} is not added at the end. You might want to
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
6689 add it there too: >
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
6690 let lines = join(mylist, "\n") . "\n"
692
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
6691 < String items are used as-is. |Lists| and |Dictionaries| are
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
6692 converted into a string like with |string()|.
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
6693 The opposite function is |split()|.
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
6694
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6695 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6696 mylist->join()
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6697
8019
d685893d852e commit https://github.com/vim/vim/commit/7823a3bd2eed6ff9e544d201de96710bd5344aaf
Christian Brabandt <cb@256bit.org>
parents: 7992
diff changeset
6698 js_decode({string}) *js_decode()*
d685893d852e commit https://github.com/vim/vim/commit/7823a3bd2eed6ff9e544d201de96710bd5344aaf
Christian Brabandt <cb@256bit.org>
parents: 7992
diff changeset
6699 This is similar to |json_decode()| with these differences:
7967
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6700 - Object key names do not have to be in quotes.
10563
bac9cec298ed patch 8.0.0171: JS style JSON does not support single quotes
Christian Brabandt <cb@256bit.org>
parents: 10548
diff changeset
6701 - Strings can be in single quotes.
7967
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6702 - Empty items in an array (between two commas) are allowed and
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6703 result in v:none items.
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6704
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6705 Can also be used as a |method|: >
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6706 ReadObject()->js_decode()
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6707
8019
d685893d852e commit https://github.com/vim/vim/commit/7823a3bd2eed6ff9e544d201de96710bd5344aaf
Christian Brabandt <cb@256bit.org>
parents: 7992
diff changeset
6708 js_encode({expr}) *js_encode()*
d685893d852e commit https://github.com/vim/vim/commit/7823a3bd2eed6ff9e544d201de96710bd5344aaf
Christian Brabandt <cb@256bit.org>
parents: 7992
diff changeset
6709 This is similar to |json_encode()| with these differences:
7967
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6710 - Object key names are not in quotes.
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6711 - v:none items in an array result in an empty item between
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6712 commas.
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6713 For example, the Vim object:
8019
d685893d852e commit https://github.com/vim/vim/commit/7823a3bd2eed6ff9e544d201de96710bd5344aaf
Christian Brabandt <cb@256bit.org>
parents: 7992
diff changeset
6714 [1,v:none,{"one":1},v:none] ~
7967
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6715 Will be encoded as:
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6716 [1,,{one:1},,] ~
8019
d685893d852e commit https://github.com/vim/vim/commit/7823a3bd2eed6ff9e544d201de96710bd5344aaf
Christian Brabandt <cb@256bit.org>
parents: 7992
diff changeset
6717 While json_encode() would produce:
7967
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6718 [1,null,{"one":1},null] ~
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6719 This encoding is valid for JavaScript. It is more efficient
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6720 than JSON, especially when using an array with optional items.
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6721
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6722 Can also be used as a |method|: >
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6723 GetObject()->js_encode()
7967
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6724
8019
d685893d852e commit https://github.com/vim/vim/commit/7823a3bd2eed6ff9e544d201de96710bd5344aaf
Christian Brabandt <cb@256bit.org>
parents: 7992
diff changeset
6725 json_decode({string}) *json_decode()*
7742
5f6f35a3cb12 commit https://github.com/vim/vim/commit/705ada1aff27ecd9c47c690df817d043c2ceb5e2
Christian Brabandt <cb@256bit.org>
parents: 7712
diff changeset
6726 This parses a JSON formatted string and returns the equivalent
8019
d685893d852e commit https://github.com/vim/vim/commit/7823a3bd2eed6ff9e544d201de96710bd5344aaf
Christian Brabandt <cb@256bit.org>
parents: 7992
diff changeset
6727 in Vim values. See |json_encode()| for the relation between
7742
5f6f35a3cb12 commit https://github.com/vim/vim/commit/705ada1aff27ecd9c47c690df817d043c2ceb5e2
Christian Brabandt <cb@256bit.org>
parents: 7712
diff changeset
6728 JSON and Vim values.
5f6f35a3cb12 commit https://github.com/vim/vim/commit/705ada1aff27ecd9c47c690df817d043c2ceb5e2
Christian Brabandt <cb@256bit.org>
parents: 7712
diff changeset
6729 The decoding is permissive:
11347
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6730 - A trailing comma in an array and object is ignored, e.g.
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6731 "[1, 2, ]" is the same as "[1, 2]".
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
6732 - Integer keys are accepted in objects, e.g. {1:2} is the
15571
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
6733 same as {"1":2}.
7742
5f6f35a3cb12 commit https://github.com/vim/vim/commit/705ada1aff27ecd9c47c690df817d043c2ceb5e2
Christian Brabandt <cb@256bit.org>
parents: 7712
diff changeset
6734 - More floating point numbers are recognized, e.g. "1." for
11347
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6735 "1.0", or "001.2" for "1.2". Special floating point values
15446
8ac454818352 patch 8.1.0731: JS encoding does not handle negative infinity
Bram Moolenaar <Bram@vim.org>
parents: 15424
diff changeset
6736 "Infinity", "-Infinity" and "NaN" (capitalization ignored)
8ac454818352 patch 8.1.0731: JS encoding does not handle negative infinity
Bram Moolenaar <Bram@vim.org>
parents: 15424
diff changeset
6737 are accepted.
11347
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6738 - Leading zeroes in integer numbers are ignored, e.g. "012"
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6739 for "12" or "-012" for "-12".
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6740 - Capitalization is ignored in literal names null, true or
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6741 false, e.g. "NULL" for "null", "True" for "true".
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6742 - Control characters U+0000 through U+001F which are not
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6743 escaped in strings are accepted, e.g. " " (tab
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6744 character in string) for "\t".
15571
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
6745 - An empty JSON expression or made of only spaces is accepted
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
6746 and results in v:none.
11347
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6747 - Backslash in an invalid 2-character sequence escape is
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6748 ignored, e.g. "\a" is decoded as "a".
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6749 - A correct surrogate pair in JSON strings should normally be
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6750 a 12 character sequence such as "\uD834\uDD1E", but
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6751 json_decode() silently accepts truncated surrogate pairs
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6752 such as "\uD834" or "\uD834\u"
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6753 *E938*
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6754 A duplicate key in an object, valid in rfc7159, is not
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6755 accepted by json_decode() as the result must be a valid Vim
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6756 type, e.g. this fails: {"a":"b", "a":"c"}
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
6757
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6758 Can also be used as a |method|: >
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6759 ReadObject()->json_decode()
7712
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
6760
8019
d685893d852e commit https://github.com/vim/vim/commit/7823a3bd2eed6ff9e544d201de96710bd5344aaf
Christian Brabandt <cb@256bit.org>
parents: 7992
diff changeset
6761 json_encode({expr}) *json_encode()*
7742
5f6f35a3cb12 commit https://github.com/vim/vim/commit/705ada1aff27ecd9c47c690df817d043c2ceb5e2
Christian Brabandt <cb@256bit.org>
parents: 7712
diff changeset
6762 Encode {expr} as JSON and return this as a string.
7712
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
6763 The encoding is specified in:
7782
3a99194bd187 commit https://github.com/vim/vim/commit/009d84a34f3678ec93921bee3bc05be2fd606264
Christian Brabandt <cb@256bit.org>
parents: 7742
diff changeset
6764 https://tools.ietf.org/html/rfc7159.html
7712
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
6765 Vim values are converted as follows:
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
6766 |Number| decimal number
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
6767 |Float| floating point number
8275
ff900e499f79 commit https://github.com/vim/vim/commit/7ce686c990ea8c490d16be7f1c6bd95eb48816f9
Christian Brabandt <cb@256bit.org>
parents: 8251
diff changeset
6768 Float nan "NaN"
ff900e499f79 commit https://github.com/vim/vim/commit/7ce686c990ea8c490d16be7f1c6bd95eb48816f9
Christian Brabandt <cb@256bit.org>
parents: 8251
diff changeset
6769 Float inf "Infinity"
15446
8ac454818352 patch 8.1.0731: JS encoding does not handle negative infinity
Bram Moolenaar <Bram@vim.org>
parents: 15424
diff changeset
6770 Float -inf "-Infinity"
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
6771 |String| in double quotes (possibly null)
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
6772 |Funcref| not possible, error
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
6773 |List| as an array (possibly null); when
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
6774 used recursively: []
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
6775 |Dict| as an object (possibly null); when
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
6776 used recursively: {}
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
6777 |Blob| as an array of the individual bytes
7712
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
6778 v:false "false"
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
6779 v:true "true"
7967
45ea5ebf3a98 commit https://github.com/vim/vim/commit/595e64e259faefb330866852e1b9f6168544572a
Christian Brabandt <cb@256bit.org>
parents: 7957
diff changeset
6780 v:none "null"
7712
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
6781 v:null "null"
8275
ff900e499f79 commit https://github.com/vim/vim/commit/7ce686c990ea8c490d16be7f1c6bd95eb48816f9
Christian Brabandt <cb@256bit.org>
parents: 8251
diff changeset
6782 Note that NaN and Infinity are passed on as values. This is
ff900e499f79 commit https://github.com/vim/vim/commit/7ce686c990ea8c490d16be7f1c6bd95eb48816f9
Christian Brabandt <cb@256bit.org>
parents: 8251
diff changeset
6783 missing in the JSON standard, but several implementations do
ff900e499f79 commit https://github.com/vim/vim/commit/7ce686c990ea8c490d16be7f1c6bd95eb48816f9
Christian Brabandt <cb@256bit.org>
parents: 8251
diff changeset
6784 allow it. If not then you will get an error.
7712
bce3b5ddb393 commit https://github.com/vim/vim/commit/520e1e41f35b063ede63b41738c82d6636e78c34
Christian Brabandt <cb@256bit.org>
parents: 7707
diff changeset
6785
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6786 Can also be used as a |method|: >
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6787 GetObject()->json_encode()
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6788
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
6789 keys({dict}) *keys()*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
6790 Return a |List| with all the keys of {dict}. The |List| is in
15571
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
6791 arbitrary order. Also see |items()| and |values()|.
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
6792
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6793 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6794 mydict->keys()
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6795
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6796 < *len()* *E701*
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
6797 len({expr}) The result is a Number, which is the length of the argument.
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
6798 When {expr} is a String or a Number the length in bytes is
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
6799 used, as with |strlen()|.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
6800 When {expr} is a |List| the number of items in the |List| is
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
6801 returned.
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
6802 When {expr} is a |Blob| the number of bytes is returned.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
6803 When {expr} is a |Dictionary| the number of entries in the
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
6804 |Dictionary| is returned.
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
6805 Otherwise an error is given.
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
6806
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6807 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6808 mylist->len()
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6809
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
6810 < *libcall()* *E364* *E368*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6811 libcall({libname}, {funcname}, {argument})
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6812 Call function {funcname} in the run-time library {libname}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6813 with single argument {argument}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6814 This is useful to call functions in a library that you
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6815 especially made to be used with Vim. Since only one argument
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6816 is possible, calling standard library functions is rather
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6817 limited.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6818 The result is the String returned by the function. If the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6819 function returns NULL, this will appear as an empty string ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6820 to Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6821 If the function returns a number, use libcallnr()!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6822 If {argument} is a number, it is passed to the function as an
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6823 int; if {argument} is a string, it is passed as a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6824 null-terminated string.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6825 This function will fail in |restricted-mode|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6826
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6827 libcall() allows you to write your own 'plug-in' extensions to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6828 Vim without having to recompile the program. It is NOT a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6829 means to call system functions! If you try to do so Vim will
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6830 very probably crash.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6831
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6832 For Win32, the functions you write must be placed in a DLL
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6833 and use the normal C calling convention (NOT Pascal which is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6834 used in Windows System DLLs). The function must take exactly
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6835 one parameter, either a character pointer or a long integer,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6836 and must return a character pointer or NULL. The character
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6837 pointer returned must point to memory that will remain valid
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6838 after the function has returned (e.g. in static data in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6839 DLL). If it points to allocated memory, that memory will
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6840 leak away. Using a static buffer in the function should work,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6841 it's then freed when the DLL is unloaded.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6842
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6843 WARNING: If the function returns a non-valid pointer, Vim may
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
6844 crash! This also happens if the function returns a number,
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6845 because Vim thinks it's a pointer.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6846 For Win32 systems, {libname} should be the filename of the DLL
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6847 without the ".DLL" suffix. A full path is only required if
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6848 the DLL is not in the usual places.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6849 For Unix: When compiling your own plugins, remember that the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6850 object code must be compiled as position-independent ('PIC').
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
6851 {only in Win32 and some Unix versions, when the |+libcall|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6852 feature is present}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6853 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6854 :echo libcall("libc.so", "getenv", "HOME")
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6855
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
6856 < Can also be used as a |method|, the base is passed as the
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
6857 third argument: >
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6858 GetValue()->libcall("libc.so", "getenv")
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6859 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6860 *libcallnr()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6861 libcallnr({libname}, {funcname}, {argument})
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
6862 Just like |libcall()|, but used for a function that returns an
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6863 int instead of a string.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6864 {only in Win32 on some Unix versions, when the |+libcall|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6865 feature is present}
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
6866 Examples: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
6867 :echo libcallnr("/usr/lib/libc.so", "getpid", "")
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6868 :call libcallnr("libc.so", "printf", "Hello World!\n")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6869 :call libcallnr("libc.so", "sleep", 10)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6870 <
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
6871 Can also be used as a |method|, the base is passed as the
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
6872 third argument: >
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6873 GetValue()->libcallnr("libc.so", "printf")
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6874 <
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
6875
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
6876 line({expr} [, {winid}]) *line()*
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
6877 The result is a Number, which is the line number of the file
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6878 position given with {expr}. The accepted positions are:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6879 . the cursor position
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6880 $ the last line in the current buffer
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6881 'x position of mark x (if the mark is not set, 0 is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6882 returned)
11313
327a04a762f6 patch 8.0.0542: getpos() can return a negative line number
Christian Brabandt <cb@256bit.org>
parents: 11263
diff changeset
6883 w0 first line visible in current window (one if the
327a04a762f6 patch 8.0.0542: getpos() can return a negative line number
Christian Brabandt <cb@256bit.org>
parents: 11263
diff changeset
6884 display isn't updated, e.g. in silent Ex mode)
327a04a762f6 patch 8.0.0542: getpos() can return a negative line number
Christian Brabandt <cb@256bit.org>
parents: 11263
diff changeset
6885 w$ last line visible in current window (this is one
327a04a762f6 patch 8.0.0542: getpos() can return a negative line number
Christian Brabandt <cb@256bit.org>
parents: 11263
diff changeset
6886 less than "w0" if no lines are visible)
1609
1324b7b755f3 updated for version 7.1-322
vimboss
parents: 1586
diff changeset
6887 v In Visual mode: the start of the Visual area (the
1324b7b755f3 updated for version 7.1-322
vimboss
parents: 1586
diff changeset
6888 cursor is the end). When not in Visual mode
1324b7b755f3 updated for version 7.1-322
vimboss
parents: 1586
diff changeset
6889 returns the cursor position. Differs from |'<| in
1324b7b755f3 updated for version 7.1-322
vimboss
parents: 1586
diff changeset
6890 that it's updated right away.
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
6891 Note that a mark in another file can be used. The line number
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
6892 then applies to another buffer.
703
2fae45239fb3 updated for version 7.0212
vimboss
parents: 697
diff changeset
6893 To get the column number use |col()|. To get both use
2fae45239fb3 updated for version 7.0212
vimboss
parents: 697
diff changeset
6894 |getpos()|.
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
6895 With the optional {winid} argument the values are obtained for
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
6896 that window instead of the current window.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6897 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6898 line(".") line number of the cursor
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
6899 line(".", winid) idem, in window "winid"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6900 line("'t") line number of mark t
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6901 line("'" . marker) line number of mark marker
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
6902 <
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
6903 To jump to the last known position when opening a file see
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
6904 |last-position-jump|.
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
6905
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6906 Can also be used as a |method|: >
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6907 GetValue()->line()
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6908
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6909 line2byte({lnum}) *line2byte()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6910 Return the byte count from the start of the buffer for line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6911 {lnum}. This includes the end-of-line character, depending on
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6912 the 'fileformat' option for the current buffer. The first
3237
91e53bcb7946 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3224
diff changeset
6913 line returns 1. 'encoding' matters, 'fileencoding' is ignored.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6914 This can also be used to get the byte count for the line just
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6915 below the last line: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6916 line2byte(line("$") + 1)
3237
91e53bcb7946 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3224
diff changeset
6917 < This is the buffer size plus one. If 'fileencoding' is empty
91e53bcb7946 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3224
diff changeset
6918 it is the file size plus one.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6919 When {lnum} is invalid, or the |+byte_offset| feature has been
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6920 disabled at compile time, -1 is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6921 Also see |byte2line()|, |go| and |:goto|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6922
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6923 Can also be used as a |method|: >
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6924 GetLnum()->line2byte()
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6925
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6926 lispindent({lnum}) *lispindent()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6927 Get the amount of indent for line {lnum} according the lisp
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6928 indenting rules, as with 'lisp'.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6929 The indent is counted in spaces, the value of 'tabstop' is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6930 relevant. {lnum} is used just like in |getline()|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6931 When {lnum} is invalid or Vim was not compiled the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6932 |+lispindent| feature, -1 is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6933
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6934 Can also be used as a |method|: >
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6935 GetLnum()->lispindent()
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6936
16235
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
6937 list2str({list} [, {utf8}]) *list2str()*
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
6938 Convert each number in {list} to a character string can
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
6939 concatenate them all. Examples: >
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
6940 list2str([32]) returns " "
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
6941 list2str([65, 66, 67]) returns "ABC"
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
6942 < The same can be done (slowly) with: >
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
6943 join(map(list, {nr, val -> nr2char(val)}), '')
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
6944 < |str2list()| does the opposite.
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
6945
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
6946 When {utf8} is omitted or zero, the current 'encoding' is used.
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
6947 With {utf8} is 1, always return utf-8 characters.
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
6948 With utf-8 composing characters work as expected: >
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
6949 list2str([97, 769]) returns "á"
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
6950 <
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6951 Can also be used as a |method|: >
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6952 GetList()->list2str()
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
6953
16638
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6954 listener_add({callback} [, {buf}]) *listener_add()*
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6955 Add a callback function that will be invoked when changes have
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6956 been made to buffer {buf}.
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6957 {buf} refers to a buffer name or number. For the accepted
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6958 values, see |bufname()|. When {buf} is omitted the current
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6959 buffer is used.
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6960 Returns a unique ID that can be passed to |listener_remove()|.
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6961
18000
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
6962 The {callback} is invoked with five arguments:
16660
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
6963 a:bufnr the buffer that was changed
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
6964 a:start first changed line number
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
6965 a:end first line number below the change
18456
6d11fc4aa683 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18343
diff changeset
6966 a:added number of lines added, negative if lines were
6d11fc4aa683 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18343
diff changeset
6967 deleted
16660
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
6968 a:changes a List of items with details about the changes
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
6969
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
6970 Example: >
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
6971 func Listener(bufnr, start, end, added, changes)
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
6972 echo 'lines ' .. a:start .. ' until ' .. a:end .. ' changed'
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
6973 endfunc
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
6974 call listener_add('Listener', bufnr)
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
6975
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
6976 < The List cannot be changed. Each item in a:changes is a
16648
a7f06505ad39 patch 8.1.1326: no test for listener with partial
Bram Moolenaar <Bram@vim.org>
parents: 16638
diff changeset
6977 dictionary with these entries:
16638
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6978 lnum the first line number of the change
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6979 end the first line below the change
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6980 added number of lines added; negative if lines were
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6981 deleted
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6982 col first column in "lnum" that was affected by
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6983 the change; one if unknown or the whole line
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6984 was affected; this is a byte index, first
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6985 character has a value of one.
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6986 When lines are inserted the values are:
16808
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16704
diff changeset
6987 lnum line above which the new line is added
16638
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6988 end equal to "lnum"
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6989 added number of lines inserted
16660
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
6990 col 1
16638
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6991 When lines are deleted the values are:
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6992 lnum the first deleted line
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6993 end the line below the first deleted line, before
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6994 the deletion was done
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6995 added negative, number of lines deleted
16660
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
6996 col 1
16638
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6997 When lines are changed:
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6998 lnum the first changed line
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
6999 end the line below the last changed line
16660
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7000 added 0
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7001 col first column with a change or 1
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7002
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7003 The entries are in the order the changes were made, thus the
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7004 most recent change is at the end. The line numbers are valid
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7005 when the callback is invoked, but later changes may make them
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7006 invalid, thus keeping a copy for later might not work.
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7007
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7008 The {callback} is invoked just before the screen is updated,
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7009 when |listener_flush()| is called or when a change is being
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7010 made that changes the line count in a way it causes a line
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7011 number in the list of changes to become invalid.
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7012
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7013 The {callback} is invoked with the text locked, see
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7014 |textlock|. If you do need to make changes to the buffer, use
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7015 a timer to do this later |timer_start()|.
16638
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
7016
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
7017 The {callback} is not invoked when the buffer is first loaded.
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
7018 Use the |BufReadPost| autocmd event to handle the initial text
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
7019 of a buffer.
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
7020 The {callback} is also not invoked when the buffer is
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
7021 unloaded, use the |BufUnload| autocmd event for that.
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
7022
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
7023 Can also be used as a |method|, the base is passed as the
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
7024 second argument: >
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
7025 GetBuffer()->listener_add(callback)
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
7026
16660
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7027 listener_flush([{buf}]) *listener_flush()*
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7028 Invoke listener callbacks for buffer {buf}. If there are no
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7029 pending changes then no callbacks are invoked.
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7030
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7031 {buf} refers to a buffer name or number. For the accepted
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7032 values, see |bufname()|. When {buf} is omitted the current
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7033 buffer is used.
04c2614af21c patch 8.1.1332: cannot flush listeners without redrawing, mix of changes
Bram Moolenaar <Bram@vim.org>
parents: 16648
diff changeset
7034
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
7035 Can also be used as a |method|: >
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
7036 GetBuffer()->listener_flush()
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
7037
16638
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
7038 listener_remove({id}) *listener_remove()*
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
7039 Remove a listener previously added with listener_add().
17366
9843fbfa0ee5 patch 8.1.1682: placing a larger number of signs is slow
Bram Moolenaar <Bram@vim.org>
parents: 17292
diff changeset
7040 Returns zero when {id} could not be found, one when {id} was
9843fbfa0ee5 patch 8.1.1682: placing a larger number of signs is slow
Bram Moolenaar <Bram@vim.org>
parents: 17292
diff changeset
7041 removed.
16638
4790302965fc patch 8.1.1321: no docs or tests for listener functions
Bram Moolenaar <Bram@vim.org>
parents: 16615
diff changeset
7042
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
7043 Can also be used as a |method|: >
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
7044 GetListenerId()->listener_remove()
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
7045
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7046 localtime() *localtime()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7047 Return the current time, measured as seconds since 1st Jan
18669
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
7048 1970. See also |strftime()|, |strptime()| and |getftime()|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7049
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
7050
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
7051 log({expr}) *log()*
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
7052 Return the natural logarithm (base e) of {expr} as a |Float|.
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
7053 {expr} must evaluate to a |Float| or a |Number| in the range
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
7054 (0, inf].
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
7055 Examples: >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
7056 :echo log(10)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
7057 < 2.302585 >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
7058 :echo log(exp(5))
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
7059 < 5.0
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
7060
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
7061 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
7062 Compute()->log()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
7063 <
2570
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2569
diff changeset
7064 {only available when compiled with the |+float| feature}
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
7065
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
7066
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7067 log10({expr}) *log10()*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7068 Return the logarithm of Float {expr} to base 10 as a |Float|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7069 {expr} must evaluate to a |Float| or a |Number|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7070 Examples: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7071 :echo log10(1000)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7072 < 3.0 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7073 :echo log10(0.01)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7074 < -2.0
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
7075
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
7076 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
7077 Compute()->log10()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
7078 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7079 {only available when compiled with the |+float| feature}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7080
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7081 luaeval({expr} [, {expr}]) *luaeval()*
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7082 Evaluate Lua expression {expr} and return its result converted
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7083 to Vim data structures. Second {expr} may hold additional
3492
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
7084 argument accessible as _A inside first {expr}.
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
7085 Strings are returned as they are.
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
7086 Boolean objects are converted to numbers.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7087 Numbers are converted to |Float| values if vim was compiled
3492
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
7088 with |+float| and to numbers otherwise.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7089 Dictionaries and lists obtained by vim.eval() are returned
3492
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
7090 as-is.
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
7091 Other objects are returned as zero without any errors.
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
7092 See |lua-luaeval| for more details.
17916
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
7093
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
7094 Can also be used as a |method|: >
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
7095 GetExpr()->luaeval()
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
7096
2e53305f2239 patch 8.1.1954: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17914
diff changeset
7097 < {only available when compiled with the |+lua| feature}
3492
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
7098
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7099 map({expr1}, {expr2}) *map()*
22844
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7100 {expr1} must be a |List|, |Blob| or |Dictionary|.
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7101 Replace each item in {expr1} with the result of evaluating
22844
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7102 {expr2}. For a |Blob| each byte is replaced.
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7103 If the item type changes you may want to use |mapnew()| to
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7104 create a new List or Dictionary. This is required when using
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7105 Vim9 script.
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7106
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7107 {expr2} must be a |string| or |Funcref|.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7108
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7109 If {expr2} is a |string|, inside {expr2} |v:val| has the value
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7110 of the current item. For a |Dictionary| |v:key| has the key
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7111 of the current item and for a |List| |v:key| has the index of
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7112 the current item.
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
7113 Example: >
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
7114 :call map(mylist, '"> " . v:val . " <"')
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
7115 < This puts "> " before and " <" after each item in "mylist".
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
7116
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7117 Note that {expr2} is the result of an expression and is then
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
7118 used as an expression again. Often it is good to use a
158
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
7119 |literal-string| to avoid having to double backslashes. You
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
7120 still have to double ' quotes
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
7121
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7122 If {expr2} is a |Funcref| it is called with two arguments:
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7123 1. The key or the index of the current item.
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7124 2. the value of the current item.
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7125 The function must return the new value of the item. Example
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7126 that changes each value by "key-value": >
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7127 func KeyValue(key, val)
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7128 return a:key . '-' . a:val
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7129 endfunc
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7130 call map(myDict, function('KeyValue'))
10218
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
7131 < It is shorter when using a |lambda|: >
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
7132 call map(myDict, {key, val -> key . '-' . val})
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
7133 < If you do not use "val" you can leave it out: >
584c835a2de1 commit https://github.com/vim/vim/commit/50ba526fbf3e9e5e0e6b0b3086a4d5df581ebc7e
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
7134 call map(myDict, {key -> 'item: ' . key})
17667
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
7135 < If you do not use "key" you can use a short name: >
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
7136 call map(myDict, {_, val -> 'item: ' . val})
9416
cbf052ccb120 commit https://github.com/vim/vim/commit/b33c7eb5b813cb631b2b0ca5c4029e1788a09bde
Christian Brabandt <cb@256bit.org>
parents: 9407
diff changeset
7137 <
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
7138 The operation is done in-place. If you want a |List| or
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
7139 |Dictionary| to remain unmodified make a copy first: >
3682
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
7140 :let tlist = map(copy(mylist), ' v:val . "\t"')
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
7141
22844
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7142 < Returns {expr1}, the |List|, |Blob| or |Dictionary| that was
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7143 filtered. When an error is encountered while evaluating
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7144 {expr2} no further items in {expr1} are processed. When
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7145 {expr2} is a Funcref errors inside a function are ignored,
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7146 unless it was defined with the "abort" flag.
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
7147
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
7148 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
7149 mylist->map(expr2)
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
7150
20506
aee0b72ca6d6 patch 8.2.0807: cannot easily restore a mapping
Bram Moolenaar <Bram@vim.org>
parents: 20386
diff changeset
7151
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7152 maparg({name} [, {mode} [, {abbr} [, {dict}]]]) *maparg()*
2610
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7153 When {dict} is omitted or zero: Return the rhs of mapping
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7154 {name} in mode {mode}. The returned String has special
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7155 characters translated like in the output of the ":map" command
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7156 listing.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7157
2610
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7158 When there is no mapping for {name}, an empty String is
14006
665fe1f419b0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14004
diff changeset
7159 returned. When the mapping for {name} is empty, then "<Nop>"
665fe1f419b0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14004
diff changeset
7160 is returned.
2610
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7161
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7162 The {name} can have special key names, like in the ":map"
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7163 command.
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7164
644
e4fa26ce8769 updated for version 7.0187
vimboss
parents: 634
diff changeset
7165 {mode} can be one of these strings:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7166 "n" Normal
2610
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7167 "v" Visual (including Select)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7168 "o" Operator-pending
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7169 "i" Insert
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7170 "c" Cmd-line
2610
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7171 "s" Select
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7172 "x" Visual
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7173 "l" langmap |language-mapping|
12499
d91cf2e26ef0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12465
diff changeset
7174 "t" Terminal-Job
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7175 "" Normal, Visual and Operator-pending
644
e4fa26ce8769 updated for version 7.0187
vimboss
parents: 634
diff changeset
7176 When {mode} is omitted, the modes for "" are used.
2610
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7177
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
7178 When {abbr} is there and it is |TRUE| use abbreviations
782
d20041a02ee5 updated for version 7.0228
vimboss
parents: 777
diff changeset
7179 instead of mappings.
2610
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7180
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
7181 When {dict} is there and it is |TRUE| return a dictionary
2610
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7182 containing all the information of the mapping with the
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7183 following items:
20522
729853a754ea patch 8.2.0815: maparg() does not provide enough information for mapset()
Bram Moolenaar <Bram@vim.org>
parents: 20506
diff changeset
7184 "lhs" The {lhs} of the mapping as it would be typed
729853a754ea patch 8.2.0815: maparg() does not provide enough information for mapset()
Bram Moolenaar <Bram@vim.org>
parents: 20506
diff changeset
7185 "lhsraw" The {lhs} of the mapping as raw bytes
729853a754ea patch 8.2.0815: maparg() does not provide enough information for mapset()
Bram Moolenaar <Bram@vim.org>
parents: 20506
diff changeset
7186 "lhsrawalt" The {lhs} of the mapping as raw bytes, alternate
729853a754ea patch 8.2.0815: maparg() does not provide enough information for mapset()
Bram Moolenaar <Bram@vim.org>
parents: 20506
diff changeset
7187 form, only present when it differs from "lhsraw"
2610
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7188 "rhs" The {rhs} of the mapping as typed.
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7189 "silent" 1 for a |:map-silent| mapping, else 0.
2625
0aa21d63aba0 Updated runtile files.
Bram Moolenaar <bram@vim.org>
parents: 2616
diff changeset
7190 "noremap" 1 if the {rhs} of the mapping is not remappable.
19870
658248b68f7c patch 8.2.0491: cannot recognize a <script> mapping using maparg()
Bram Moolenaar <Bram@vim.org>
parents: 19813
diff changeset
7191 "script" 1 if mapping was defined with <script>.
2610
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7192 "expr" 1 for an expression mapping (|:map-<expr>|).
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7193 "buffer" 1 for a buffer local mapping (|:map-local|).
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7194 "mode" Modes for which the mapping is defined. In
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7195 addition to the modes mentioned above, these
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7196 characters will be used:
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7197 " " Normal, Visual and Operator-pending
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7198 "!" Insert and Commandline mode
2642
840c3cadb842 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2625
diff changeset
7199 (|mapmode-ic|)
2625
0aa21d63aba0 Updated runtile files.
Bram Moolenaar <bram@vim.org>
parents: 2616
diff changeset
7200 "sid" The script local ID, used for <sid> mappings
0aa21d63aba0 Updated runtile files.
Bram Moolenaar <bram@vim.org>
parents: 2616
diff changeset
7201 (|<SID>|).
14700
0a3b9ecf7cb8 patch 8.1.0362: cannot get the script line number when executing a function
Christian Brabandt <cb@256bit.org>
parents: 14695
diff changeset
7202 "lnum" The line number in "sid", zero if unknown.
5555
7818ca6de3d0 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5466
diff changeset
7203 "nowait" Do not wait for other, longer mappings.
7818ca6de3d0 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5466
diff changeset
7204 (|:map-<nowait>|).
20506
aee0b72ca6d6 patch 8.2.0807: cannot easily restore a mapping
Bram Moolenaar <Bram@vim.org>
parents: 20386
diff changeset
7205
aee0b72ca6d6 patch 8.2.0807: cannot easily restore a mapping
Bram Moolenaar <Bram@vim.org>
parents: 20386
diff changeset
7206 The dictionary can be used to restore a mapping with
aee0b72ca6d6 patch 8.2.0807: cannot easily restore a mapping
Bram Moolenaar <Bram@vim.org>
parents: 20386
diff changeset
7207 |mapset()|.
2610
6c05b5e5c1be updated for version 7.3.032
Bram Moolenaar <bram@vim.org>
parents: 2609
diff changeset
7208
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7209 The mappings local to the current buffer are checked first,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7210 then the global mappings.
626
732c7ae5743e updated for version 7.0180
vimboss
parents: 625
diff changeset
7211 This function can be used to map a key even when it's already
732c7ae5743e updated for version 7.0180
vimboss
parents: 625
diff changeset
7212 mapped, and have it do the original mapping too. Sketch: >
732c7ae5743e updated for version 7.0180
vimboss
parents: 625
diff changeset
7213 exe 'nnoremap <Tab> ==' . maparg('<Tab>', 'n')
732c7ae5743e updated for version 7.0180
vimboss
parents: 625
diff changeset
7214
17930
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7215 < Can also be used as a |method|: >
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7216 GetKey()->maparg('n')
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7217
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7218 mapcheck({name} [, {mode} [, {abbr}]]) *mapcheck()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7219 Check if there is a mapping that matches with {name} in mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7220 {mode}. See |maparg()| for {mode} and special names in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7221 {name}.
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
7222 When {abbr} is there and it is |TRUE| use abbreviations
782
d20041a02ee5 updated for version 7.0228
vimboss
parents: 777
diff changeset
7223 instead of mappings.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7224 A match happens with a mapping that starts with {name} and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7225 with a mapping which is equal to the start of {name}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7226
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7227 matches mapping "a" "ab" "abc" ~
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7228 mapcheck("a") yes yes yes
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7229 mapcheck("abc") yes yes yes
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7230 mapcheck("ax") yes no no
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7231 mapcheck("b") no no no
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7232
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7233 The difference with maparg() is that mapcheck() finds a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7234 mapping that matches with {name}, while maparg() only finds a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7235 mapping for {name} exactly.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7236 When there is no mapping that starts with {name}, an empty
14006
665fe1f419b0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14004
diff changeset
7237 String is returned. If there is one, the RHS of that mapping
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7238 is returned. If there are several mappings that start with
14006
665fe1f419b0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14004
diff changeset
7239 {name}, the RHS of one of them is returned. This will be
665fe1f419b0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14004
diff changeset
7240 "<Nop>" if the RHS is empty.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7241 The mappings local to the current buffer are checked first,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7242 then the global mappings.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7243 This function can be used to check if a mapping can be added
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7244 without being ambiguous. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7245 :if mapcheck("_vv") == ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7246 : map _vv :set guifont=7x13<CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7247 :endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7248 < This avoids adding the "_vv" mapping when there already is a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7249 mapping for "_v" or for "_vvv".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7250
17930
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7251 Can also be used as a |method|: >
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7252 GetKey()->mapcheck('n')
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7253
20522
729853a754ea patch 8.2.0815: maparg() does not provide enough information for mapset()
Bram Moolenaar <Bram@vim.org>
parents: 20506
diff changeset
7254
22844
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7255 mapnew({expr1}, {expr2}) *mapnew()*
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7256 Like |map()| but instead of replacing items in {expr1} a new
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7257 List or Dictionary is created and returned. {expr1} remains
23164
99ef85ff1af4 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23048
diff changeset
7258 unchanged. Items can still be changed by {expr2}, if you
99ef85ff1af4 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23048
diff changeset
7259 don't want that use |deepcopy()| first.
22844
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7260
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7261
36fc73078bce patch 8.2.1969: Vim9: map() may change the list or dict item type
Bram Moolenaar <Bram@vim.org>
parents: 22824
diff changeset
7262 mapset({mode}, {abbr}, {dict}) *mapset()*
20506
aee0b72ca6d6 patch 8.2.0807: cannot easily restore a mapping
Bram Moolenaar <Bram@vim.org>
parents: 20386
diff changeset
7263 Restore a mapping from a dictionary returned by |maparg()|.
20522
729853a754ea patch 8.2.0815: maparg() does not provide enough information for mapset()
Bram Moolenaar <Bram@vim.org>
parents: 20506
diff changeset
7264 {mode} and {abbr} should be the same as for the call to
729853a754ea patch 8.2.0815: maparg() does not provide enough information for mapset()
Bram Moolenaar <Bram@vim.org>
parents: 20506
diff changeset
7265 |maparg()|. *E460*
20506
aee0b72ca6d6 patch 8.2.0807: cannot easily restore a mapping
Bram Moolenaar <Bram@vim.org>
parents: 20386
diff changeset
7266 {mode} is used to define the mode in which the mapping is set,
aee0b72ca6d6 patch 8.2.0807: cannot easily restore a mapping
Bram Moolenaar <Bram@vim.org>
parents: 20386
diff changeset
7267 not the "mode" entry in {dict}.
aee0b72ca6d6 patch 8.2.0807: cannot easily restore a mapping
Bram Moolenaar <Bram@vim.org>
parents: 20386
diff changeset
7268 Example for saving and restoring a mapping: >
aee0b72ca6d6 patch 8.2.0807: cannot easily restore a mapping
Bram Moolenaar <Bram@vim.org>
parents: 20386
diff changeset
7269 let save_map = maparg('K', 'n', 0, 1)
aee0b72ca6d6 patch 8.2.0807: cannot easily restore a mapping
Bram Moolenaar <Bram@vim.org>
parents: 20386
diff changeset
7270 nnoremap K somethingelse
aee0b72ca6d6 patch 8.2.0807: cannot easily restore a mapping
Bram Moolenaar <Bram@vim.org>
parents: 20386
diff changeset
7271 ...
aee0b72ca6d6 patch 8.2.0807: cannot easily restore a mapping
Bram Moolenaar <Bram@vim.org>
parents: 20386
diff changeset
7272 call mapset('n', 0, save_map)
20522
729853a754ea patch 8.2.0815: maparg() does not provide enough information for mapset()
Bram Moolenaar <Bram@vim.org>
parents: 20506
diff changeset
7273 < Note that if you are going to replace a map in several modes,
729853a754ea patch 8.2.0815: maparg() does not provide enough information for mapset()
Bram Moolenaar <Bram@vim.org>
parents: 20506
diff changeset
7274 e.g. with `:map!`, you need to save the mapping for all of
20687
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
7275 them, since they can differ.
20522
729853a754ea patch 8.2.0815: maparg() does not provide enough information for mapset()
Bram Moolenaar <Bram@vim.org>
parents: 20506
diff changeset
7276
729853a754ea patch 8.2.0815: maparg() does not provide enough information for mapset()
Bram Moolenaar <Bram@vim.org>
parents: 20506
diff changeset
7277
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7278 match({expr}, {pat} [, {start} [, {count}]]) *match()*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
7279 When {expr} is a |List| then this returns the index of the
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
7280 first item where {pat} matches. Each item is used as a
692
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
7281 String, |Lists| and |Dictionaries| are used as echoed.
14695
b178e2039b2d Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14673
diff changeset
7282
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
7283 Otherwise, {expr} is used as a String. The result is a
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
7284 Number, which gives the index (byte offset) in {expr} where
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
7285 {pat} matches.
14695
b178e2039b2d Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14673
diff changeset
7286
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
7287 A match at the first character or |List| item returns zero.
19
a81bc802c17c updated for version 7.0011
vimboss
parents: 18
diff changeset
7288 If there is no match -1 is returned.
14695
b178e2039b2d Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14673
diff changeset
7289
2833
c869ff170ddc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2826
diff changeset
7290 For getting submatches see |matchlist()|.
19
a81bc802c17c updated for version 7.0011
vimboss
parents: 18
diff changeset
7291 Example: >
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
7292 :echo match("testing", "ing") " results in 4
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
7293 :echo match([1, 'x'], '\a') " results in 1
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
7294 < See |string-match| for how {pat} is used.
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
7295 *strpbrk()*
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
7296 Vim doesn't have a strpbrk() function. But you can do: >
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
7297 :let sepidx = match(line, '[.,;: \t]')
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
7298 < *strcasestr()*
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
7299 Vim doesn't have a strcasestr() function. But you can add
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
7300 "\c" to the pattern to ignore case: >
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
7301 :let idx = match(haystack, '\cneedle')
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
7302 <
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
7303 If {start} is given, the search starts from byte index
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
7304 {start} in a String or item {start} in a |List|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7305 The result, however, is still the index counted from the
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 233
diff changeset
7306 first character/item. Example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7307 :echo match("testing", "ing", 2)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7308 < result is again "4". >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7309 :echo match("testing", "ing", 4)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7310 < result is again "4". >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7311 :echo match("testing", "t", 2)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7312 < result is "3".
694
07d199fe02ed updated for version 7.0209
vimboss
parents: 692
diff changeset
7313 For a String, if {start} > 0 then it is like the string starts
703
2fae45239fb3 updated for version 7.0212
vimboss
parents: 697
diff changeset
7314 {start} bytes later, thus "^" will match at {start}. Except
2fae45239fb3 updated for version 7.0212
vimboss
parents: 697
diff changeset
7315 when {count} is given, then it's like matches before the
2fae45239fb3 updated for version 7.0212
vimboss
parents: 697
diff changeset
7316 {start} byte are ignored (this is a bit complicated to keep it
2fae45239fb3 updated for version 7.0212
vimboss
parents: 697
diff changeset
7317 backwards compatible).
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
7318 For a String, if {start} < 0, it will be set to 0. For a list
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
7319 the index is counted from the end.
697
f08390485cd3 updated for version 7.0210
vimboss
parents: 694
diff changeset
7320 If {start} is out of range ({start} > strlen({expr}) for a
f08390485cd3 updated for version 7.0210
vimboss
parents: 694
diff changeset
7321 String or {start} > len({expr}) for a |List|) -1 is returned.
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
7322
694
07d199fe02ed updated for version 7.0209
vimboss
parents: 692
diff changeset
7323 When {count} is given use the {count}'th match. When a match
697
f08390485cd3 updated for version 7.0210
vimboss
parents: 694
diff changeset
7324 is found in a String the search for the next one starts one
694
07d199fe02ed updated for version 7.0209
vimboss
parents: 692
diff changeset
7325 character further. Thus this example results in 1: >
07d199fe02ed updated for version 7.0209
vimboss
parents: 692
diff changeset
7326 echo match("testing", "..", 0, 2)
07d199fe02ed updated for version 7.0209
vimboss
parents: 692
diff changeset
7327 < In a |List| the search continues in the next item.
703
2fae45239fb3 updated for version 7.0212
vimboss
parents: 697
diff changeset
7328 Note that when {count} is added the way {start} works changes,
2fae45239fb3 updated for version 7.0212
vimboss
parents: 697
diff changeset
7329 see above.
694
07d199fe02ed updated for version 7.0209
vimboss
parents: 692
diff changeset
7330
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7331 See |pattern| for the patterns that are accepted.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7332 The 'ignorecase' option is used to set the ignore-caseness of
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
7333 the pattern. 'smartcase' is NOT used. The matching is always
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7334 done like 'magic' is set and 'cpoptions' is empty.
19523
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
7335 Note that a match at the start is preferred, thus when the
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
7336 pattern is using "*" (any number of matches) it tends to find
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
7337 zero matches at the start instead of a number of matches
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
7338 further down in the text.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7339
17930
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7340 Can also be used as a |method|: >
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7341 GetList()->match('word')
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7342 <
14407
631344964949 patch 8.1.0218: cannot add matches to another window
Christian Brabandt <cb@256bit.org>
parents: 14347
diff changeset
7343 *matchadd()* *E798* *E799* *E801* *E957*
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7344 matchadd({group}, {pattern} [, {priority} [, {id} [, {dict}]]])
1326
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7345 Defines a pattern to be highlighted in the current window (a
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7346 "match"). It will be highlighted with {group}. Returns an
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7347 identification number (ID), which can be used to delete the
16158
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
7348 match using |matchdelete()|. The ID is bound to the window.
5466
d060c429b21f Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5460
diff changeset
7349 Matching is case sensitive and magic, unless case sensitivity
d060c429b21f Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5460
diff changeset
7350 or magicness are explicitly overridden in {pattern}. The
d060c429b21f Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5460
diff changeset
7351 'magic', 'smartcase' and 'ignorecase' options are not used.
6951
b2673982c625 Updated and new runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6947
diff changeset
7352 The "Conceal" value is special, it causes the match to be
b2673982c625 Updated and new runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6947
diff changeset
7353 concealed.
1326
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7354
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7355 The optional {priority} argument assigns a priority to the
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
7356 match. A match with a high priority will have its
1326
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7357 highlighting overrule that of a match with a lower priority.
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7358 A priority is specified as an integer (negative numbers are no
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7359 exception). If the {priority} argument is not specified, the
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7360 default priority is 10. The priority of 'hlsearch' is zero,
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7361 hence all matches with a priority greater than zero will
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7362 overrule it. Syntax highlighting (see 'syntax') is a separate
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7363 mechanism, and regardless of the chosen priority a match will
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7364 always overrule syntax highlighting.
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7365
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7366 The optional {id} argument allows the request for a specific
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7367 match ID. If a specified ID is already taken, an error
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7368 message will appear and the match will not be added. An ID
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7369 is specified as a positive integer (zero excluded). IDs 1, 2
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7370 and 3 are reserved for |:match|, |:2match| and |:3match|,
6947
1efa7c2b9368 patch 7.4.792
Bram Moolenaar <bram@vim.org>
parents: 6935
diff changeset
7371 respectively. If the {id} argument is not specified or -1,
1326
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7372 |matchadd()| automatically chooses a free ID.
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7373
7659
07f11de5efca commit https://github.com/vim/vim/commit/85084ef1e999dcf50e8d466106a33bac24a0febb
Christian Brabandt <cb@256bit.org>
parents: 7653
diff changeset
7374 The optional {dict} argument allows for further custom
07f11de5efca commit https://github.com/vim/vim/commit/85084ef1e999dcf50e8d466106a33bac24a0febb
Christian Brabandt <cb@256bit.org>
parents: 7653
diff changeset
7375 values. Currently this is used to specify a match specific
6947
1efa7c2b9368 patch 7.4.792
Bram Moolenaar <bram@vim.org>
parents: 6935
diff changeset
7376 conceal character that will be shown for |hl-Conceal|
1efa7c2b9368 patch 7.4.792
Bram Moolenaar <bram@vim.org>
parents: 6935
diff changeset
7377 highlighted matches. The dict can have the following members:
1efa7c2b9368 patch 7.4.792
Bram Moolenaar <bram@vim.org>
parents: 6935
diff changeset
7378
1efa7c2b9368 patch 7.4.792
Bram Moolenaar <bram@vim.org>
parents: 6935
diff changeset
7379 conceal Special character to show instead of the
8031
ece323e2b57f commit https://github.com/vim/vim/commit/6463ca229cb9412581419497924c85fcbfc854ab
Christian Brabandt <cb@256bit.org>
parents: 8019
diff changeset
7380 match (only for |hl-Conceal| highlighted
6947
1efa7c2b9368 patch 7.4.792
Bram Moolenaar <bram@vim.org>
parents: 6935
diff changeset
7381 matches, see |:syn-cchar|)
14407
631344964949 patch 8.1.0218: cannot add matches to another window
Christian Brabandt <cb@256bit.org>
parents: 14347
diff changeset
7382 window Instead of the current window use the
631344964949 patch 8.1.0218: cannot add matches to another window
Christian Brabandt <cb@256bit.org>
parents: 14347
diff changeset
7383 window with this number or window ID.
6947
1efa7c2b9368 patch 7.4.792
Bram Moolenaar <bram@vim.org>
parents: 6935
diff changeset
7384
1326
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7385 The number of matches is not limited, as it is the case with
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7386 the |:match| commands.
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7387
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7388 Example: >
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7389 :highlight MyGroup ctermbg=green guibg=green
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7390 :let m = matchadd("MyGroup", "TODO")
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7391 < Deletion of the pattern: >
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7392 :call matchdelete(m)
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7393
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7394 < A list of matches defined by |matchadd()| and |:match| are
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
7395 available from |getmatches()|. All matches can be deleted in
1326
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7396 one operation by |clearmatches()|.
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
7397
17930
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7398 Can also be used as a |method|: >
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7399 GetGroup()->matchadd('TODO')
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7400 <
9790
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
7401 *matchaddpos()*
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7402 matchaddpos({group}, {pos} [, {priority} [, {id} [, {dict}]]])
5979
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7403 Same as |matchadd()|, but requires a list of positions {pos}
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7404 instead of a pattern. This command is faster than |matchadd()|
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7405 because it does not require to handle regular expressions and
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7406 sets buffer line boundaries to redraw screen. It is supposed
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7407 to be used when fast match additions and deletions are
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7408 required, for example to highlight matching parentheses.
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7409
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7410 The list {pos} can contain one of these items:
6007
ce284c205558 updated for version 7.4.344
Bram Moolenaar <bram@vim.org>
parents: 5995
diff changeset
7411 - A number. This whole line will be highlighted. The first
5979
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7412 line has number 1.
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7413 - A list with one number, e.g., [23]. The whole line with this
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7414 number will be highlighted.
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7415 - A list with two numbers, e.g., [23, 11]. The first number is
6007
ce284c205558 updated for version 7.4.344
Bram Moolenaar <bram@vim.org>
parents: 5995
diff changeset
7416 the line number, the second one is the column number (first
ce284c205558 updated for version 7.4.344
Bram Moolenaar <bram@vim.org>
parents: 5995
diff changeset
7417 column is 1, the value must correspond to the byte index as
ce284c205558 updated for version 7.4.344
Bram Moolenaar <bram@vim.org>
parents: 5995
diff changeset
7418 |col()| would return). The character at this position will
ce284c205558 updated for version 7.4.344
Bram Moolenaar <bram@vim.org>
parents: 5995
diff changeset
7419 be highlighted.
5979
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7420 - A list with three numbers, e.g., [23, 11, 3]. As above, but
6007
ce284c205558 updated for version 7.4.344
Bram Moolenaar <bram@vim.org>
parents: 5995
diff changeset
7421 the third number gives the length of the highlight in bytes.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7422
5979
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7423 The maximum number of positions is 8.
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7424
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7425 Example: >
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7426 :highlight MyGroup ctermbg=green guibg=green
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7427 :let m = matchaddpos("MyGroup", [[23, 24], 34])
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7428 < Deletion of the pattern: >
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7429 :call matchdelete(m)
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7430
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7431 < Matches added by |matchaddpos()| are returned by
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7432 |getmatches()| with an entry "pos1", "pos2", etc., with the
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7433 value a list like the {pos} item.
f9fa2e506b9f updated for version 7.4.330
Bram Moolenaar <bram@vim.org>
parents: 5968
diff changeset
7434
17930
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7435 Can also be used as a |method|: >
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7436 GetGroup()->matchaddpos([23, 11])
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7437
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
7438 matcharg({nr}) *matcharg()*
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
7439 Selects the {nr} match item, as set with a |:match|,
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
7440 |:2match| or |:3match| command.
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
7441 Return a |List| with two elements:
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
7442 The name of the highlight group used
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
7443 The pattern used.
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
7444 When {nr} is not 1, 2 or 3 returns an empty |List|.
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
7445 When there is no match item set returns ['', ''].
1326
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7446 This is useful to save and restore a |:match|.
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7447 Highlighting matches using the |:match| commands are limited
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7448 to three matches. |matchadd()| does not have this limitation.
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7449
17930
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7450 Can also be used as a |method|: >
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7451 GetMatch()->matcharg()
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7452
16158
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
7453 matchdelete({id} [, {win}) *matchdelete()* *E802* *E803*
1326
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7454 Deletes a match with ID {id} previously defined by |matchadd()|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7455 or one of the |:match| commands. Returns 0 if successful,
1326
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7456 otherwise -1. See example for |matchadd()|. All matches can
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
7457 be deleted in one operation by |clearmatches()|.
16158
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
7458 If {win} is specified, use the window with this number or
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
7459 window ID instead of the current window.
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
7460
17930
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7461 Can also be used as a |method|: >
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7462 GetMatch()->matchdelete()
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7463
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7464 matchend({expr}, {pat} [, {start} [, {count}]]) *matchend()*
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
7465 Same as |match()|, but return the index of first character
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
7466 after the match. Example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7467 :echo matchend("testing", "ing")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7468 < results in "7".
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
7469 *strspn()* *strcspn()*
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
7470 Vim doesn't have a strspn() or strcspn() function, but you can
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
7471 do it with matchend(): >
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
7472 :let span = matchend(line, '[a-zA-Z]')
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
7473 :let span = matchend(line, '[^a-zA-Z]')
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
7474 < Except that -1 is returned when there are no matches.
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
7475
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
7476 The {start}, if given, has the same meaning as for |match()|. >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7477 :echo matchend("testing", "ing", 2)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7478 < results in "7". >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7479 :echo matchend("testing", "ing", 5)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7480 < result is "-1".
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
7481 When {expr} is a |List| the result is equal to |match()|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7482
17930
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7483 Can also be used as a |method|: >
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7484 GetText()->matchend('word')
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7485
22232
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7486
22355
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7487 matchfuzzy({list}, {str} [, {dict}]) *matchfuzzy()*
23164
99ef85ff1af4 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23048
diff changeset
7488 If {list} is a list of strings, then returns a |List| with all
22355
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7489 the strings in {list} that fuzzy match {str}. The strings in
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7490 the returned list are sorted based on the matching score.
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7491
22689
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7492 The optional {dict} argument always supports the following
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7493 items:
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7494 matchseq When this item is present and {str} contains
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7495 multiple words separated by white space, then
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7496 returns only matches that contain the words in
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7497 the given sequence.
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7498
22355
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7499 If {list} is a list of dictionaries, then the optional {dict}
22689
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7500 argument supports the following additional items:
22355
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7501 key key of the item which is fuzzy matched against
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7502 {str}. The value of this item should be a
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7503 string.
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7504 text_cb |Funcref| that will be called for every item
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7505 in {list} to get the text for fuzzy matching.
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7506 This should accept a dictionary item as the
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7507 argument and return the text for that item to
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7508 use for fuzzy matching.
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7509
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7510 {str} is treated as a literal string and regular expression
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7511 matching is NOT supported. The maximum supported {str} length
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7512 is 256.
22232
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7513
22689
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7514 When {str} has multiple words each separated by white space,
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7515 then the list of strings that have all the words is returned.
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7516
22232
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7517 If there are no matching strings or there is an error, then an
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7518 empty list is returned. If length of {str} is greater than
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7519 256, then returns an empty list.
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7520
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7521 Example: >
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7522 :echo matchfuzzy(["clay", "crow"], "cay")
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7523 < results in ["clay"]. >
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7524 :echo getbufinfo()->map({_, v -> v.name})->matchfuzzy("ndl")
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7525 < results in a list of buffer names fuzzy matching "ndl". >
22355
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7526 :echo getbufinfo()->matchfuzzy("ndl", {'key' : 'name'})
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7527 < results in a list of buffer information dicts with buffer
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7528 names fuzzy matching "ndl". >
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7529 :echo getbufinfo()->matchfuzzy("spl",
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7530 \ {'text_cb' : {v -> v.name}})
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7531 < results in a list of buffer information dicts with buffer
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7532 names fuzzy matching "spl". >
22232
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7533 :echo v:oldfiles->matchfuzzy("test")
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7534 < results in a list of file names fuzzy matching "test". >
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7535 :let l = readfile("buffer.c")->matchfuzzy("str")
22689
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7536 < results in a list of lines in "buffer.c" fuzzy matching "str". >
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7537 :echo ['one two', 'two one']->matchfuzzy('two one')
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7538 < results in ['two one', 'one two']. >
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7539 :echo ['one two', 'two one']->matchfuzzy('two one',
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7540 \ {'matchseq': 1})
f8bf2c122452 patch 8.2.1893: fuzzy matching does not support multiple words
Bram Moolenaar <Bram@vim.org>
parents: 22565
diff changeset
7541 < results in ['two one'].
22232
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7542
22355
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7543 matchfuzzypos({list}, {str} [, {dict}]) *matchfuzzypos()*
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7544 Same as |matchfuzzy()|, but returns the list of matched
23475
79fd5217b125 patch 8.2.2280: fuzzy matching doesn't give access to the scores
Bram Moolenaar <Bram@vim.org>
parents: 23466
diff changeset
7545 strings, the list of character positions where characters
79fd5217b125 patch 8.2.2280: fuzzy matching doesn't give access to the scores
Bram Moolenaar <Bram@vim.org>
parents: 23466
diff changeset
7546 in {str} matches and a list of matching scores. You can
79fd5217b125 patch 8.2.2280: fuzzy matching doesn't give access to the scores
Bram Moolenaar <Bram@vim.org>
parents: 23466
diff changeset
7547 use |byteidx()|to convert a character position to a byte
79fd5217b125 patch 8.2.2280: fuzzy matching doesn't give access to the scores
Bram Moolenaar <Bram@vim.org>
parents: 23466
diff changeset
7548 position.
22355
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7549
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7550 If {str} matches multiple times in a string, then only the
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7551 positions for the best match is returned.
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7552
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7553 If there are no matching strings or there is an error, then a
23475
79fd5217b125 patch 8.2.2280: fuzzy matching doesn't give access to the scores
Bram Moolenaar <Bram@vim.org>
parents: 23466
diff changeset
7554 list with three empty list items is returned.
22355
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7555
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7556 Example: >
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7557 :echo matchfuzzypos(['testing'], 'tsg')
23475
79fd5217b125 patch 8.2.2280: fuzzy matching doesn't give access to the scores
Bram Moolenaar <Bram@vim.org>
parents: 23466
diff changeset
7558 < results in [['testing'], [[0, 2, 6]], [99]] >
22355
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7559 :echo matchfuzzypos(['clay', 'lacy'], 'la')
23475
79fd5217b125 patch 8.2.2280: fuzzy matching doesn't give access to the scores
Bram Moolenaar <Bram@vim.org>
parents: 23466
diff changeset
7560 < results in [['lacy', 'clay'], [[0, 1], [1, 2]], [153, 133]] >
22355
0491b9cafd44 patch 8.2.1726: fuzzy matching only works on strings
Bram Moolenaar <Bram@vim.org>
parents: 22328
diff changeset
7561 :echo [{'text': 'hello', 'id' : 10}]->matchfuzzypos('ll', {'key' : 'text'})
23475
79fd5217b125 patch 8.2.2280: fuzzy matching doesn't give access to the scores
Bram Moolenaar <Bram@vim.org>
parents: 23466
diff changeset
7562 < results in [[{'id': 10, 'text': 'hello'}], [[2, 3]], [127]]
22232
f22acf6472da patch 8.2.1665: cannot do fuzzy string matching
Bram Moolenaar <Bram@vim.org>
parents: 22171
diff changeset
7563
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7564 matchlist({expr}, {pat} [, {start} [, {count}]]) *matchlist()*
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
7565 Same as |match()|, but return a |List|. The first item in the
158
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
7566 list is the matched string, same as what matchstr() would
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
7567 return. Following items are submatches, like "\1", "\2", etc.
842
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
7568 in |:substitute|. When an optional submatch didn't match an
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
7569 empty string is used. Example: >
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
7570 echo matchlist('acd', '\(a\)\?\(b\)\?\(c\)\?\(.*\)')
a209672376fd updated for version 7.0f
vimboss
parents: 841
diff changeset
7571 < Results in: ['acd', 'a', '', 'c', 'd', '', '', '', '', '']
158
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
7572 When there is no match an empty list is returned.
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
7573
17930
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7574 Can also be used as a |method|: >
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7575 GetList()->matchlist('word')
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7576
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7577 matchstr({expr}, {pat} [, {start} [, {count}]]) *matchstr()*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7578 Same as |match()|, but return the matched string. Example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7579 :echo matchstr("testing", "ing")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7580 < results in "ing".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7581 When there is no match "" is returned.
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
7582 The {start}, if given, has the same meaning as for |match()|. >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7583 :echo matchstr("testing", "ing", 2)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7584 < results in "ing". >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7585 :echo matchstr("testing", "ing", 5)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7586 < result is "".
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
7587 When {expr} is a |List| then the matching item is returned.
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
7588 The type isn't changed, it's not necessarily a String.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7589
17930
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7590 Can also be used as a |method|: >
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7591 GetText()->matchstr('word')
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7592
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7593 matchstrpos({expr}, {pat} [, {start} [, {count}]]) *matchstrpos()*
8793
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7594 Same as |matchstr()|, but return the matched string, the start
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7595 position and the end position of the match. Example: >
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7596 :echo matchstrpos("testing", "ing")
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7597 < results in ["ing", 4, 7].
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7598 When there is no match ["", -1, -1] is returned.
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7599 The {start}, if given, has the same meaning as for |match()|. >
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7600 :echo matchstrpos("testing", "ing", 2)
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7601 < results in ["ing", 4, 7]. >
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7602 :echo matchstrpos("testing", "ing", 5)
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7603 < result is ["", -1, -1].
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7604 When {expr} is a |List| then the matching item, the index
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7605 of first item where {pat} matches, the start position and the
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7606 end position of the match are returned. >
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7607 :echo matchstrpos([1, '__x'], '\a')
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7608 < result is ["x", 1, 2, 3].
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7609 The type isn't changed, it's not necessarily a String.
dda254280bab commit https://github.com/vim/vim/commit/7fed5c18f8577b75404b80d8b9a9907b1bbd27e4
Christian Brabandt <cb@256bit.org>
parents: 8749
diff changeset
7610
17930
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7611 Can also be used as a |method|: >
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7612 GetText()->matchstrpos('word')
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
7613 <
19657
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7614
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
7615 *max()*
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
7616 max({expr}) Return the maximum value of all items in {expr}. Example: >
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
7617 echo max([apples, pears, oranges])
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
7618
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
7619 < {expr} can be a |List| or a |Dictionary|. For a Dictionary,
19099
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
7620 it returns the maximum of all values in the Dictionary.
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
7621 If {expr} is neither a List nor a Dictionary, or one of the
10734
523cd59d6db0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10730
diff changeset
7622 items in {expr} cannot be used as a Number this results in
11561
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
7623 an error. An empty |List| or |Dictionary| results in zero.
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
7624
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
7625 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
7626 mylist->max()
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
7627
19657
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7628
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7629 menu_info({name} [, {mode}]) *menu_info()*
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7630 Return information about the specified menu {name} in
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7631 mode {mode}. The menu name should be specified without the
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7632 shortcut character ('&').
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7633
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7634 {mode} can be one of these strings:
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7635 "n" Normal
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7636 "v" Visual (including Select)
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7637 "o" Operator-pending
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7638 "i" Insert
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7639 "c" Cmd-line
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7640 "s" Select
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7641 "x" Visual
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7642 "t" Terminal-Job
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7643 "" Normal, Visual and Operator-pending
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7644 "!" Insert and Cmd-line
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7645 When {mode} is omitted, the modes for "" are used.
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7646
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7647 Returns a |Dictionary| containing the following items:
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7648 accel menu item accelerator text |menu-text|
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7649 display display name (name without '&')
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7650 enabled v:true if this menu item is enabled
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7651 Refer to |:menu-enable|
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7652 icon name of the icon file (for toolbar)
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7653 |toolbar-icon|
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7654 iconidx index of a built-in icon
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7655 modes modes for which the menu is defined. In
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7656 addition to the modes mentioned above, these
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7657 characters will be used:
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7658 " " Normal, Visual and Operator-pending
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7659 name menu item name.
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7660 noremenu v:true if the {rhs} of the menu item is not
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7661 remappable else v:false.
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7662 priority menu order priority |menu-priority|
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7663 rhs right-hand-side of the menu item. The returned
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7664 string has special characters translated like
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7665 in the output of the ":menu" command listing.
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7666 When the {rhs} of a menu item is empty, then
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7667 "<Nop>" is returned.
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7668 script v:true if script-local remapping of {rhs} is
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7669 allowed else v:false. See |:menu-script|.
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7670 shortcut shortcut key (character after '&' in
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7671 the menu name) |menu-shortcut|
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7672 silent v:true if the menu item is created
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7673 with <silent> argument |:menu-silent|
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7674 submenus |List| containing the names of
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7675 all the submenus. Present only if the menu
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7676 item has submenus.
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7677
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7678 Returns an empty dictionary if the menu item is not found.
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7679
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7680 Examples: >
19721
bceeded72898 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19657
diff changeset
7681 :echo menu_info('Edit.Cut')
bceeded72898 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19657
diff changeset
7682 :echo menu_info('File.Save', 'n')
bceeded72898 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19657
diff changeset
7683 <
bceeded72898 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19657
diff changeset
7684 Can also be used as a |method|: >
bceeded72898 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19657
diff changeset
7685 GetMenuName()->menu_info('v')
19657
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7686
da791e5c0139 patch 8.2.0385: menu functionality insufficiently tested
Bram Moolenaar <Bram@vim.org>
parents: 19646
diff changeset
7687
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
7688 < *min()*
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
7689 min({expr}) Return the minimum value of all items in {expr}. Example: >
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
7690 echo min([apples, pears, oranges])
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
7691
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
7692 < {expr} can be a |List| or a |Dictionary|. For a Dictionary,
19099
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
7693 it returns the minimum of all values in the Dictionary.
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
7694 If {expr} is neither a List nor a Dictionary, or one of the
10734
523cd59d6db0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10730
diff changeset
7695 items in {expr} cannot be used as a Number this results in
11561
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
7696 an error. An empty |List| or |Dictionary| results in zero.
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
7697
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
7698 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
7699 mylist->min()
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
7700
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
7701 < *mkdir()* *E739*
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
7702 mkdir({name} [, {path} [, {prot}]])
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
7703 Create directory {name}.
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
7704
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
7705 If {path} is "p" then intermediate directories are created as
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
7706 necessary. Otherwise it must be "".
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
7707
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
7708 If {prot} is given it is used to set the protection bits of
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
7709 the new directory. The default is 0o755 (rwxr-xr-x: r/w for
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
7710 the user, readable for others). Use 0o700 to make it
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
7711 unreadable for others. This is only used for the last part of
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
7712 {name}. Thus if you create /tmp/foo/bar then /tmp/foo will be
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
7713 created with 0o755.
1702
5232b9862f23 updated for version 7.2-000
vimboss
parents: 1700
diff changeset
7714 Example: >
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
7715 :call mkdir($HOME . "/tmp/foo/bar", "p", 0o700)
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
7716
1702
5232b9862f23 updated for version 7.2-000
vimboss
parents: 1700
diff changeset
7717 < This function is not available in the |sandbox|.
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
7718
13672
4a1efd1a6018 patch 8.0.1708: mkdir with 'p' flag fails on existing directory
Christian Brabandt <cb@256bit.org>
parents: 13626
diff changeset
7719 There is no error if the directory already exists and the "p"
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
7720 flag is passed (since patch 8.0.1708). However, without the
18669
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
7721 "p" option the call will fail.
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
7722
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
7723 The function result is a Number, which is 1 if the call was
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
7724 successful or 0 if the directory creation failed or partly
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
7725 failed.
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
7726
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
7727 Not available on all systems. To check use: >
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
7728 :if exists("*mkdir")
17930
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7729
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7730 < Can also be used as a |method|: >
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7731 GetName()->mkdir()
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
7732 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7733 *mode()*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7734 mode([expr]) Return a string that indicates the current mode.
1661
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
7735 If [expr] is supplied and it evaluates to a non-zero Number or
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
7736 a non-empty String (|non-zero-arg|), then the full mode is
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
7737 returned, otherwise only the first letter is returned.
18104
e59ff7b5d7a7 patch 8.1.2047: cannot check the current state
Bram Moolenaar <Bram@vim.org>
parents: 18080
diff changeset
7738 Also see |state()|.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7739
14422
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7740 n Normal, Terminal-Normal
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7741 no Operator-pending
15279
54457fc4af0b patch 8.1.0648: custom operators can't act upon a forced motion
Bram Moolenaar <Bram@vim.org>
parents: 15271
diff changeset
7742 nov Operator-pending (forced characterwise |o_v|)
54457fc4af0b patch 8.1.0648: custom operators can't act upon a forced motion
Bram Moolenaar <Bram@vim.org>
parents: 15271
diff changeset
7743 noV Operator-pending (forced linewise |o_V|)
54457fc4af0b patch 8.1.0648: custom operators can't act upon a forced motion
Bram Moolenaar <Bram@vim.org>
parents: 15271
diff changeset
7744 noCTRL-V Operator-pending (forced blockwise |o_CTRL-V|);
15424
90c8ff9c19ee patch 8.1.0720: cannot easily change the current quickfx list index
Bram Moolenaar <Bram@vim.org>
parents: 15418
diff changeset
7745 CTRL-V is one character
14422
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7746 niI Normal using |i_CTRL-O| in |Insert-mode|
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7747 niR Normal using |i_CTRL-O| in |Replace-mode|
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7748 niV Normal using |i_CTRL-O| in |Virtual-Replace-mode|
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7749 v Visual by character
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7750 V Visual by line
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7751 CTRL-V Visual blockwise
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7752 s Select by character
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7753 S Select by line
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7754 CTRL-S Select blockwise
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7755 i Insert
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7756 ic Insert mode completion |compl-generic|
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7757 ix Insert mode |i_CTRL-X| completion
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7758 R Replace |R|
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7759 Rc Replace mode completion |compl-generic|
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7760 Rv Virtual Replace |gR|
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7761 Rx Replace mode |i_CTRL-X| completion
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7762 c Command-line editing
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7763 cv Vim Ex mode |gQ|
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7764 ce Normal Ex mode |Q|
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7765 r Hit-enter prompt
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7766 rm The -- more -- prompt
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7767 r? A |:confirm| query of some sort
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7768 ! Shell or external command is executing
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7769 t Terminal-Job mode: keys go to the job
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7770 This is useful in the 'statusline' option or when used
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7771 with |remote_expr()| In most other places it always returns
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7772 "c" or "n".
14422
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7773 Note that in the future more modes and more specific modes may
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7774 be added. It's better not to compare the whole string but only
06316dbd66bc patch 8.1.0225: mode() does not indicate using CTRL-O from Insert mode
Christian Brabandt <cb@256bit.org>
parents: 14421
diff changeset
7775 the leading character(s).
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7776 Also see |visualmode()|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7777
17930
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7778 Can also be used as a |method|: >
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7779 DoFull()->mode()
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7780
2050
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7781 mzeval({expr}) *mzeval()*
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7782 Evaluate MzScheme expression {expr} and return its result
3492
3482d151136b Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3465
diff changeset
7783 converted to Vim data structures.
2050
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7784 Numbers and strings are returned as they are.
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7785 Pairs (including lists and improper lists) and vectors are
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7786 returned as Vim |Lists|.
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7787 Hash tables are represented as Vim |Dictionary| type with keys
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7788 converted to strings.
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7789 All other types are converted to string with display function.
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7790 Examples: >
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7791 :mz (define l (list 1 2 3))
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7792 :mz (define h (make-hash)) (hash-set! h "list" l)
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7793 :echo mzeval("l")
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7794 :echo mzeval("h")
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7795 <
17930
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7796 Can also be used as a |method|: >
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7797 GetExpr()->mzeval()
0cdb6ac20748 patch 8.1.1961: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17916
diff changeset
7798 <
2050
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7799 {only available when compiled with the |+mzscheme| feature}
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
7800
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7801 nextnonblank({lnum}) *nextnonblank()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7802 Return the line number of the first line at or below {lnum}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7803 that is not blank. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7804 if getline(nextnonblank(1)) =~ "Java"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7805 < When {lnum} is invalid or there is no non-blank line at or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7806 below it, zero is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7807 See also |prevnonblank()|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7808
17976
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
7809 Can also be used as a |method|: >
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
7810 GetLnum()->nextnonblank()
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
7811
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7812 nr2char({expr} [, {utf8}]) *nr2char()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7813 Return a string with a single character, which has the number
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7814 value {expr}. Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7815 nr2char(64) returns "@"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7816 nr2char(32) returns " "
4051
42edc5dac33c updated for version 7.3.780
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
7817 < When {utf8} is omitted or zero, the current 'encoding' is used.
42edc5dac33c updated for version 7.3.780
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
7818 Example for "utf-8": >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7819 nr2char(300) returns I with bow character
4051
42edc5dac33c updated for version 7.3.780
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
7820 < With {utf8} set to 1, always return utf-8 characters.
42edc5dac33c updated for version 7.3.780
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
7821 Note that a NUL character in the file is specified with
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7822 nr2char(10), because NULs are represented with newline
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7823 characters. nr2char(0) is a real NUL and terminates the
119
e8f07016e34d updated for version 7.0042
vimboss
parents: 114
diff changeset
7824 string, thus results in an empty string.
16158
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
7825 To turn a list of character numbers into a string: >
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
7826 let list = [65, 66, 67]
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
7827 let str = join(map(list, {_, val -> nr2char(val)}), '')
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
7828 < Result: "ABC"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7829
17976
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
7830 Can also be used as a |method|: >
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
7831 GetNumber()->nr2char()
17783
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
7832
3214
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
7833 or({expr}, {expr}) *or()*
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
7834 Bitwise OR on the two arguments. The arguments are converted
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
7835 to a number. A List, Dict or Float argument causes an error.
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
7836 Example: >
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
7837 :let bits = or(bits, 0x80)
17783
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
7838 < Can also be used as a |method|: >
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
7839 :let bits = bits->or(0x80)
3214
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
7840
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
7841
22385
770fe121ca64 patch 8.2.1741: pathshorten() only supports using one character
Bram Moolenaar <Bram@vim.org>
parents: 22357
diff changeset
7842 pathshorten({expr} [, {len}]) *pathshorten()*
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
7843 Shorten directory names in the path {expr} and return the
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
7844 result. The tail, the file name, is kept as-is. The other
22385
770fe121ca64 patch 8.2.1741: pathshorten() only supports using one character
Bram Moolenaar <Bram@vim.org>
parents: 22357
diff changeset
7845 components in the path are reduced to {len} letters in length.
770fe121ca64 patch 8.2.1741: pathshorten() only supports using one character
Bram Moolenaar <Bram@vim.org>
parents: 22357
diff changeset
7846 If {len} is omitted or smaller than 1 then 1 is used (single
770fe121ca64 patch 8.2.1741: pathshorten() only supports using one character
Bram Moolenaar <Bram@vim.org>
parents: 22357
diff changeset
7847 letters). Leading '~' and '.' characters are kept. Examples: >
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
7848 :echo pathshorten('~/.vim/autoload/myfile.vim')
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
7849 < ~/.v/a/myfile.vim ~
22385
770fe121ca64 patch 8.2.1741: pathshorten() only supports using one character
Bram Moolenaar <Bram@vim.org>
parents: 22357
diff changeset
7850 >
770fe121ca64 patch 8.2.1741: pathshorten() only supports using one character
Bram Moolenaar <Bram@vim.org>
parents: 22357
diff changeset
7851 :echo pathshorten('~/.vim/autoload/myfile.vim', 2)
770fe121ca64 patch 8.2.1741: pathshorten() only supports using one character
Bram Moolenaar <Bram@vim.org>
parents: 22357
diff changeset
7852 < ~/.vi/au/myfile.vim ~
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
7853 It doesn't matter if the path exists or not.
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
7854
17976
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
7855 Can also be used as a |method|: >
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
7856 GetDirectories()->pathshorten()
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
7857
7651
c7575b07de98 commit https://github.com/vim/vim/commit/e9b892ebcd8596bf813793a1eed5a460a9495a28
Christian Brabandt <cb@256bit.org>
parents: 7629
diff changeset
7858 perleval({expr}) *perleval()*
c7575b07de98 commit https://github.com/vim/vim/commit/e9b892ebcd8596bf813793a1eed5a460a9495a28
Christian Brabandt <cb@256bit.org>
parents: 7629
diff changeset
7859 Evaluate Perl expression {expr} in scalar context and return
c7575b07de98 commit https://github.com/vim/vim/commit/e9b892ebcd8596bf813793a1eed5a460a9495a28
Christian Brabandt <cb@256bit.org>
parents: 7629
diff changeset
7860 its result converted to Vim data structures. If value can't be
7659
07f11de5efca commit https://github.com/vim/vim/commit/85084ef1e999dcf50e8d466106a33bac24a0febb
Christian Brabandt <cb@256bit.org>
parents: 7653
diff changeset
7861 converted, it is returned as a string Perl representation.
07f11de5efca commit https://github.com/vim/vim/commit/85084ef1e999dcf50e8d466106a33bac24a0febb
Christian Brabandt <cb@256bit.org>
parents: 7653
diff changeset
7862 Note: If you want an array or hash, {expr} must return a
07f11de5efca commit https://github.com/vim/vim/commit/85084ef1e999dcf50e8d466106a33bac24a0febb
Christian Brabandt <cb@256bit.org>
parents: 7653
diff changeset
7863 reference to it.
7651
c7575b07de98 commit https://github.com/vim/vim/commit/e9b892ebcd8596bf813793a1eed5a460a9495a28
Christian Brabandt <cb@256bit.org>
parents: 7629
diff changeset
7864 Example: >
c7575b07de98 commit https://github.com/vim/vim/commit/e9b892ebcd8596bf813793a1eed5a460a9495a28
Christian Brabandt <cb@256bit.org>
parents: 7629
diff changeset
7865 :echo perleval('[1 .. 4]')
c7575b07de98 commit https://github.com/vim/vim/commit/e9b892ebcd8596bf813793a1eed5a460a9495a28
Christian Brabandt <cb@256bit.org>
parents: 7629
diff changeset
7866 < [1, 2, 3, 4]
17976
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
7867
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
7868 Can also be used as a |method|: >
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
7869 GetExpr()->perleval()
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
7870
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
7871 < {only available when compiled with the |+perl| feature}
7651
c7575b07de98 commit https://github.com/vim/vim/commit/e9b892ebcd8596bf813793a1eed5a460a9495a28
Christian Brabandt <cb@256bit.org>
parents: 7629
diff changeset
7872
17257
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
7873
22171
d4c7b3e9cd17 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22077
diff changeset
7874 popup_ functions are documented here: |popup-functions|
17257
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
7875
cb0ca75f0c26 patch 8.1.1628: popup window functions not in list of functions
Bram Moolenaar <Bram@vim.org>
parents: 17253
diff changeset
7876
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7877 pow({x}, {y}) *pow()*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7878 Return the power of {x} to the exponent {y} as a |Float|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7879 {x} and {y} must evaluate to a |Float| or a |Number|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7880 Examples: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7881 :echo pow(3, 3)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7882 < 27.0 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7883 :echo pow(2, 16)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7884 < 65536.0 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7885 :echo pow(32, 0.20)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7886 < 2.0
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
7887
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
7888 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
7889 Compute()->pow(3)
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
7890 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7891 {only available when compiled with the |+float| feature}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
7892
667
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
7893 prevnonblank({lnum}) *prevnonblank()*
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
7894 Return the line number of the first line at or above {lnum}
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
7895 that is not blank. Example: >
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
7896 let ind = indent(prevnonblank(v:lnum - 1))
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
7897 < When {lnum} is invalid or there is no non-blank line at or
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
7898 above it, zero is returned.
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
7899 Also see |nextnonblank()|.
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
7900
17976
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
7901 Can also be used as a |method|: >
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
7902 GetLnum()->prevnonblank()
667
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
7903
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7904 printf({fmt}, {expr1} ...) *printf()*
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7905 Return a String with {fmt}, where "%" items are replaced by
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7906 the formatted form of their respective arguments. Example: >
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7907 printf("%4d: E%d %.30s", lnum, errno, msg)
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7908 < May result in:
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7909 " 99: E42 asdfasdfasdfasdfasdfasdfasdfas" ~
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7910
17676
14ac8c31e598 patch 8.1.1835: cannot use printf() as a method
Bram Moolenaar <Bram@vim.org>
parents: 17674
diff changeset
7911 When used as a |method| the base is passed as the second
14ac8c31e598 patch 8.1.1835: cannot use printf() as a method
Bram Moolenaar <Bram@vim.org>
parents: 17674
diff changeset
7912 argument: >
14ac8c31e598 patch 8.1.1835: cannot use printf() as a method
Bram Moolenaar <Bram@vim.org>
parents: 17674
diff changeset
7913 Compute()->printf("result: %d")
14ac8c31e598 patch 8.1.1835: cannot use printf() as a method
Bram Moolenaar <Bram@vim.org>
parents: 17674
diff changeset
7914
14ac8c31e598 patch 8.1.1835: cannot use printf() as a method
Bram Moolenaar <Bram@vim.org>
parents: 17674
diff changeset
7915 < Often used items are:
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
7916 %s string
3914
f15769bce0b8 updated for version 7.3.713
Bram Moolenaar <bram@vim.org>
parents: 3893
diff changeset
7917 %6S string right-aligned in 6 display cells
653
5acda076fb0c updated for version 7.0192
vimboss
parents: 650
diff changeset
7918 %6s string right-aligned in 6 bytes
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7919 %.9s string truncated to 9 bytes
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7920 %c single byte
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7921 %d decimal number
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7922 %5d decimal number padded with spaces to 5 characters
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7923 %x hex number
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7924 %04x hex number padded with zeros to at least 4 characters
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7925 %X hex number using upper case letters
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7926 %o octal number
9894
b01afb4e8f66 commit https://github.com/vim/vim/commit/91984b9034d3b698459622be277d963e0c6df60e
Christian Brabandt <cb@256bit.org>
parents: 9887
diff changeset
7927 %08b binary number padded with zeros to at least 8 chars
10038
7cf4e210cf3c commit https://github.com/vim/vim/commit/04186095346daa60e82e981dad114de2b641d672
Christian Brabandt <cb@256bit.org>
parents: 10027
diff changeset
7928 %f floating point number as 12.23, inf, -inf or nan
7cf4e210cf3c commit https://github.com/vim/vim/commit/04186095346daa60e82e981dad114de2b641d672
Christian Brabandt <cb@256bit.org>
parents: 10027
diff changeset
7929 %F floating point number as 12.23, INF, -INF or NAN
7cf4e210cf3c commit https://github.com/vim/vim/commit/04186095346daa60e82e981dad114de2b641d672
Christian Brabandt <cb@256bit.org>
parents: 10027
diff changeset
7930 %e floating point number as 1.23e3, inf, -inf or nan
7cf4e210cf3c commit https://github.com/vim/vim/commit/04186095346daa60e82e981dad114de2b641d672
Christian Brabandt <cb@256bit.org>
parents: 10027
diff changeset
7931 %E floating point number as 1.23E3, INF, -INF or NAN
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7932 %g floating point number, as %f or %e depending on value
10895
c391bfbdb452 Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10787
diff changeset
7933 %G floating point number, as %F or %E depending on value
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7934 %% the % character itself
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7935
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7936 Conversion specifications start with '%' and end with the
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7937 conversion type. All other characters are copied unchanged to
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7938 the result.
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7939
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7940 The "%" starts a conversion specification. The following
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7941 arguments appear in sequence:
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7942
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7943 % [flags] [field-width] [.precision] type
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7944
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
7945 flags
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7946 Zero or more of the following flags:
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7947
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7948 # The value should be converted to an "alternate
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7949 form". For c, d, and s conversions, this option
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7950 has no effect. For o conversions, the precision
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7951 of the number is increased to force the first
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7952 character of the output string to a zero (except
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7953 if a zero value is printed with an explicit
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7954 precision of zero).
9894
b01afb4e8f66 commit https://github.com/vim/vim/commit/91984b9034d3b698459622be277d963e0c6df60e
Christian Brabandt <cb@256bit.org>
parents: 9887
diff changeset
7955 For b and B conversions, a non-zero result has
b01afb4e8f66 commit https://github.com/vim/vim/commit/91984b9034d3b698459622be277d963e0c6df60e
Christian Brabandt <cb@256bit.org>
parents: 9887
diff changeset
7956 the string "0b" (or "0B" for B conversions)
b01afb4e8f66 commit https://github.com/vim/vim/commit/91984b9034d3b698459622be277d963e0c6df60e
Christian Brabandt <cb@256bit.org>
parents: 9887
diff changeset
7957 prepended to it.
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7958 For x and X conversions, a non-zero result has
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7959 the string "0x" (or "0X" for X conversions)
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7960 prepended to it.
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7961
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7962 0 (zero) Zero padding. For all conversions the converted
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7963 value is padded on the left with zeros rather
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7964 than blanks. If a precision is given with a
9894
b01afb4e8f66 commit https://github.com/vim/vim/commit/91984b9034d3b698459622be277d963e0c6df60e
Christian Brabandt <cb@256bit.org>
parents: 9887
diff changeset
7965 numeric conversion (d, b, B, o, x, and X), the 0
b01afb4e8f66 commit https://github.com/vim/vim/commit/91984b9034d3b698459622be277d963e0c6df60e
Christian Brabandt <cb@256bit.org>
parents: 9887
diff changeset
7966 flag is ignored.
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7967
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7968 - A negative field width flag; the converted value
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7969 is to be left adjusted on the field boundary.
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7970 The converted value is padded on the right with
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7971 blanks, rather than on the left with blanks or
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7972 zeros. A - overrides a 0 if both are given.
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7973
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7974 ' ' (space) A blank should be left before a positive
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7975 number produced by a signed conversion (d).
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7976
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7977 + A sign must always be placed before a number
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
7978 produced by a signed conversion. A + overrides
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
7979 a space if both are used.
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7980
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7981 field-width
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7982 An optional decimal digit string specifying a minimum
653
5acda076fb0c updated for version 7.0192
vimboss
parents: 650
diff changeset
7983 field width. If the converted value has fewer bytes
5acda076fb0c updated for version 7.0192
vimboss
parents: 650
diff changeset
7984 than the field width, it will be padded with spaces on
5acda076fb0c updated for version 7.0192
vimboss
parents: 650
diff changeset
7985 the left (or right, if the left-adjustment flag has
5acda076fb0c updated for version 7.0192
vimboss
parents: 650
diff changeset
7986 been given) to fill out the field width.
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7987
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7988 .precision
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7989 An optional precision, in the form of a period '.'
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7990 followed by an optional digit string. If the digit
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7991 string is omitted, the precision is taken as zero.
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7992 This gives the minimum number of digits to appear for
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7993 d, o, x, and X conversions, or the maximum number of
653
5acda076fb0c updated for version 7.0192
vimboss
parents: 650
diff changeset
7994 bytes to be printed from a string for s conversions.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7995 For floating point it is the number of digits after
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
7996 the decimal point.
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7997
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7998 type
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
7999 A character that specifies the type of conversion to
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8000 be applied, see below.
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8001
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
8002 A field width or precision, or both, may be indicated by an
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
8003 asterisk '*' instead of a digit string. In this case, a
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
8004 Number argument supplies the field width or precision. A
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
8005 negative field width is treated as a left adjustment flag
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
8006 followed by a positive field width; a negative precision is
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
8007 treated as though it were missing. Example: >
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8008 :echo printf("%d: %.*s", nr, width, line)
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
8009 < This limits the length of the text used from "line" to
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8010 "width" bytes.
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
8011
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
8012 The conversion specifiers and their meanings are:
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8013
9894
b01afb4e8f66 commit https://github.com/vim/vim/commit/91984b9034d3b698459622be277d963e0c6df60e
Christian Brabandt <cb@256bit.org>
parents: 9887
diff changeset
8014 *printf-d* *printf-b* *printf-B* *printf-o*
b01afb4e8f66 commit https://github.com/vim/vim/commit/91984b9034d3b698459622be277d963e0c6df60e
Christian Brabandt <cb@256bit.org>
parents: 9887
diff changeset
8015 *printf-x* *printf-X*
b01afb4e8f66 commit https://github.com/vim/vim/commit/91984b9034d3b698459622be277d963e0c6df60e
Christian Brabandt <cb@256bit.org>
parents: 9887
diff changeset
8016 dbBoxX The Number argument is converted to signed decimal
b01afb4e8f66 commit https://github.com/vim/vim/commit/91984b9034d3b698459622be277d963e0c6df60e
Christian Brabandt <cb@256bit.org>
parents: 9887
diff changeset
8017 (d), unsigned binary (b and B), unsigned octal (o), or
b01afb4e8f66 commit https://github.com/vim/vim/commit/91984b9034d3b698459622be277d963e0c6df60e
Christian Brabandt <cb@256bit.org>
parents: 9887
diff changeset
8018 unsigned hexadecimal (x and X) notation. The letters
b01afb4e8f66 commit https://github.com/vim/vim/commit/91984b9034d3b698459622be277d963e0c6df60e
Christian Brabandt <cb@256bit.org>
parents: 9887
diff changeset
8019 "abcdef" are used for x conversions; the letters
b01afb4e8f66 commit https://github.com/vim/vim/commit/91984b9034d3b698459622be277d963e0c6df60e
Christian Brabandt <cb@256bit.org>
parents: 9887
diff changeset
8020 "ABCDEF" are used for X conversions.
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8021 The precision, if any, gives the minimum number of
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8022 digits that must appear; if the converted value
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8023 requires fewer digits, it is padded on the left with
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8024 zeros.
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8025 In no case does a non-existent or small field width
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8026 cause truncation of a numeric field; if the result of
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8027 a conversion is wider than the field width, the field
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8028 is expanded to contain the conversion result.
10000
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
8029 The 'h' modifier indicates the argument is 16 bits.
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
8030 The 'l' modifier indicates the argument is 32 bits.
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
8031 The 'L' modifier indicates the argument is 64 bits.
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
8032 Generally, these modifiers are not useful. They are
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
8033 ignored when type is known from the argument.
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
8034
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
8035 i alias for d
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
8036 D alias for ld
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
8037 U alias for lu
233289599874 commit https://github.com/vim/vim/commit/3056735ae8a366aa7fcb51872520895251858637
Christian Brabandt <cb@256bit.org>
parents: 9975
diff changeset
8038 O alias for lo
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8039
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8040 *printf-c*
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8041 c The Number argument is converted to a byte, and the
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8042 resulting character is written.
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8043
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8044 *printf-s*
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8045 s The text of the String argument is used. If a
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8046 precision is specified, no more bytes than the number
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8047 specified are used.
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
8048 If the argument is not a String type, it is
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
8049 automatically converted to text with the same format
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
8050 as ":echo".
6583
b0a227941705 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6549
diff changeset
8051 *printf-S*
3914
f15769bce0b8 updated for version 7.3.713
Bram Moolenaar <bram@vim.org>
parents: 3893
diff changeset
8052 S The text of the String argument is used. If a
f15769bce0b8 updated for version 7.3.713
Bram Moolenaar <bram@vim.org>
parents: 3893
diff changeset
8053 precision is specified, no more display cells than the
15878
314694a2e74a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15790
diff changeset
8054 number specified are used.
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8055
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8056 *printf-f* *E807*
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
8057 f F The Float argument is converted into a string of the
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8058 form 123.456. The precision specifies the number of
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8059 digits after the decimal point. When the precision is
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8060 zero the decimal point is omitted. When the precision
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8061 is not specified 6 is used. A really big number
10038
7cf4e210cf3c commit https://github.com/vim/vim/commit/04186095346daa60e82e981dad114de2b641d672
Christian Brabandt <cb@256bit.org>
parents: 10027
diff changeset
8062 (out of range or dividing by zero) results in "inf"
11561
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
8063 or "-inf" with %f (INF or -INF with %F).
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
8064 "0.0 / 0.0" results in "nan" with %f (NAN with %F).
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8065 Example: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8066 echo printf("%.2f", 12.115)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8067 < 12.12
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8068 Note that roundoff depends on the system libraries.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8069 Use |round()| when in doubt.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8070
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8071 *printf-e* *printf-E*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8072 e E The Float argument is converted into a string of the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8073 form 1.234e+03 or 1.234E+03 when using 'E'. The
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8074 precision specifies the number of digits after the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8075 decimal point, like with 'f'.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8076
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8077 *printf-g* *printf-G*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8078 g G The Float argument is converted like with 'f' if the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8079 value is between 0.001 (inclusive) and 10000000.0
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8080 (exclusive). Otherwise 'e' is used for 'g' and 'E'
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8081 for 'G'. When no precision is specified superfluous
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8082 zeroes and '+' signs are removed, except for the zero
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8083 immediately after the decimal point. Thus 10000000.0
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8084 results in 1.0e7.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8085
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8086 *printf-%*
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
8087 % A '%' is written. No argument is converted. The
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
8088 complete conversion specification is "%%".
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8089
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
8090 When a Number argument is expected a String argument is also
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
8091 accepted and automatically converted.
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
8092 When a Float or String argument is expected a Number argument
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
8093 is also accepted and automatically converted.
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
8094 Any other argument type results in an error message.
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
8095
459
d9d38102399f updated for version 7.0122
vimboss
parents: 452
diff changeset
8096 *E766* *E767*
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
8097 The number of {exprN} arguments must exactly match the number
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
8098 of "%" items. If there are not sufficient or too many
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
8099 arguments an error is given. Up to 18 arguments can be used.
449
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
8100
3709cf52b9b5 updated for version 7.0119
vimboss
parents: 448
diff changeset
8101
22077
335365fcbb60 patch 8.2.1588: cannot read back the prompt of a prompt buffer
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
8102 prompt_getprompt({buf}) *prompt_getprompt()*
22723
5b7ea82bc18f Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22689
diff changeset
8103 Returns the effective prompt text for buffer {buf}. {buf} can
5b7ea82bc18f Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22689
diff changeset
8104 be a buffer name or number. See |prompt-buffer|.
22077
335365fcbb60 patch 8.2.1588: cannot read back the prompt of a prompt buffer
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
8105
335365fcbb60 patch 8.2.1588: cannot read back the prompt of a prompt buffer
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
8106 If the buffer doesn't exist or isn't a prompt buffer, an empty
335365fcbb60 patch 8.2.1588: cannot read back the prompt of a prompt buffer
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
8107 string is returned.
335365fcbb60 patch 8.2.1588: cannot read back the prompt of a prompt buffer
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
8108
335365fcbb60 patch 8.2.1588: cannot read back the prompt of a prompt buffer
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
8109 Can also be used as a |method|: >
335365fcbb60 patch 8.2.1588: cannot read back the prompt of a prompt buffer
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
8110 GetBuffer()->prompt_getprompt()
335365fcbb60 patch 8.2.1588: cannot read back the prompt of a prompt buffer
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
8111
335365fcbb60 patch 8.2.1588: cannot read back the prompt of a prompt buffer
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
8112
14019
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8113 prompt_setcallback({buf}, {expr}) *prompt_setcallback()*
14103
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8114 Set prompt callback for buffer {buf} to {expr}. When {expr}
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8115 is an empty string the callback is removed. This has only
14019
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8116 effect if {buf} has 'buftype' set to "prompt".
14103
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8117
14019
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8118 The callback is invoked when pressing Enter. The current
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8119 buffer will always be the prompt buffer. A new line for a
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8120 prompt is added before invoking the callback, thus the prompt
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8121 for which the callback was invoked will be in the last but one
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8122 line.
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8123 If the callback wants to add text to the buffer, it must
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8124 insert it above the last line, since that is where the current
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8125 prompt is. This can also be done asynchronously.
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8126 The callback is invoked with one argument, which is the text
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8127 that was entered at the prompt. This can be an empty string
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8128 if the user only typed Enter.
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8129 Example: >
17855
285f7a700185 patch 8.1.1924: using empty string for current buffer is unexpected
Bram Moolenaar <Bram@vim.org>
parents: 17849
diff changeset
8130 call prompt_setcallback(bufnr(), function('s:TextEntered'))
14019
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8131 func s:TextEntered(text)
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8132 if a:text == 'exit' || a:text == 'quit'
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8133 stopinsert
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8134 close
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8135 else
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8136 call append(line('$') - 1, 'Entered: "' . a:text . '"')
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8137 " Reset 'modified' to allow the buffer to be closed.
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8138 set nomodified
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8139 endif
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8140 endfunc
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8141
17976
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8142 < Can also be used as a |method|: >
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8143 GetBuffer()->prompt_setcallback(callback)
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8144
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8145
14103
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8146 prompt_setinterrupt({buf}, {expr}) *prompt_setinterrupt()*
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8147 Set a callback for buffer {buf} to {expr}. When {expr} is an
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8148 empty string the callback is removed. This has only effect if
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8149 {buf} has 'buftype' set to "prompt".
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8150
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8151 This callback will be invoked when pressing CTRL-C in Insert
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8152 mode. Without setting a callback Vim will exit Insert mode,
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8153 as in any buffer.
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8154
17976
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8155 Can also be used as a |method|: >
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8156 GetBuffer()->prompt_setinterrupt(callback)
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8157
14103
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8158 prompt_setprompt({buf}, {text}) *prompt_setprompt()*
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8159 Set prompt for buffer {buf} to {text}. You most likely want
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8160 {text} to end in a space.
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8161 The result is only visible if {buf} has 'buftype' set to
d053ec57d886 patch 8.1.0069: cannot handle pressing CTRL-C in a prompt buffer
Christian Brabandt <cb@256bit.org>
parents: 14043
diff changeset
8162 "prompt". Example: >
17855
285f7a700185 patch 8.1.1924: using empty string for current buffer is unexpected
Bram Moolenaar <Bram@vim.org>
parents: 17849
diff changeset
8163 call prompt_setprompt(bufnr(), 'command: ')
15138
9df130fd5e0d patch 8.1.0579: cannot attach properties to text
Bram Moolenaar <Bram@vim.org>
parents: 15131
diff changeset
8164 <
17976
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8165 Can also be used as a |method|: >
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8166 GetBuffer()->prompt_setprompt('command: ')
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8167
22077
335365fcbb60 patch 8.2.1588: cannot read back the prompt of a prompt buffer
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
8168 prop_ functions are documented here: |text-prop-functions|
14019
dc67449d648c patch 8.1.0027: difficult to make a plugin that feeds a line to a job
Christian Brabandt <cb@256bit.org>
parents: 14006
diff changeset
8169
17756
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
8170 pum_getpos() *pum_getpos()*
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
8171 If the popup menu (see |ins-completion-menu|) is not visible,
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
8172 returns an empty |Dictionary|, otherwise, returns a
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
8173 |Dictionary| with the following keys:
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
8174 height nr of items visible
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
8175 width screen cells
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
8176 row top screen row (0 first row)
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
8177 col leftmost screen column (0 first col)
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
8178 size total nr of items
18456
6d11fc4aa683 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18343
diff changeset
8179 scrollbar |TRUE| if scrollbar is visible
17756
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
8180
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
8181 The values are the same as in |v:event| during
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
8182 |CompleteChanged|.
a7afcea6f40a patch 8.1.1875: cannot get size and position of the popup menu
Bram Moolenaar <Bram@vim.org>
parents: 17680
diff changeset
8183
667
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
8184 pumvisible() *pumvisible()*
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
8185 Returns non-zero when the popup menu is visible, zero
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
8186 otherwise. See |ins-completion-menu|.
712
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8187 This can be used to avoid some things that would remove the
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8188 popup menu.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8189
3682
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
8190 py3eval({expr}) *py3eval()*
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
8191 Evaluate Python expression {expr} and return its result
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
8192 converted to Vim data structures.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
8193 Numbers and strings are returned as they are (strings are
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
8194 copied though, Unicode strings are additionally converted to
3682
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
8195 'encoding').
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
8196 Lists are represented as Vim |List| type.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
8197 Dictionaries are represented as Vim |Dictionary| type with
3682
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
8198 keys converted to strings.
17976
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8199
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8200 Can also be used as a |method|: >
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8201 GetExpr()->py3eval()
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8202
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8203 < {only available when compiled with the |+python3| feature}
3682
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
8204
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
8205 *E858* *E859*
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
8206 pyeval({expr}) *pyeval()*
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
8207 Evaluate Python expression {expr} and return its result
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
8208 converted to Vim data structures.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
8209 Numbers and strings are returned as they are (strings are
3682
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
8210 copied though).
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
8211 Lists are represented as Vim |List| type.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
8212 Dictionaries are represented as Vim |Dictionary| type,
3830
04592728474a Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
8213 non-string keys result in error.
17976
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8214
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8215 Can also be used as a |method|: >
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8216 GetExpr()->pyeval()
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8217
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8218 < {only available when compiled with the |+python| feature}
3682
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
8219
10722
7598ce51bf2a patch 8.0.0251: not easy to select Python 2 or 3
Christian Brabandt <cb@256bit.org>
parents: 10617
diff changeset
8220 pyxeval({expr}) *pyxeval()*
7598ce51bf2a patch 8.0.0251: not easy to select Python 2 or 3
Christian Brabandt <cb@256bit.org>
parents: 10617
diff changeset
8221 Evaluate Python expression {expr} and return its result
7598ce51bf2a patch 8.0.0251: not easy to select Python 2 or 3
Christian Brabandt <cb@256bit.org>
parents: 10617
diff changeset
8222 converted to Vim data structures.
7598ce51bf2a patch 8.0.0251: not easy to select Python 2 or 3
Christian Brabandt <cb@256bit.org>
parents: 10617
diff changeset
8223 Uses Python 2 or 3, see |python_x| and 'pyxversion'.
7598ce51bf2a patch 8.0.0251: not easy to select Python 2 or 3
Christian Brabandt <cb@256bit.org>
parents: 10617
diff changeset
8224 See also: |pyeval()|, |py3eval()|
17976
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8225
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8226 Can also be used as a |method|: >
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8227 GetExpr()->pyxeval()
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8228
6d11a0d5751d patch 8.1.1984: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17930
diff changeset
8229 < {only available when compiled with the |+python| or the
10722
7598ce51bf2a patch 8.0.0251: not easy to select Python 2 or 3
Christian Brabandt <cb@256bit.org>
parents: 10617
diff changeset
8230 |+python3| feature}
7598ce51bf2a patch 8.0.0251: not easy to select Python 2 or 3
Christian Brabandt <cb@256bit.org>
parents: 10617
diff changeset
8231
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
8232 *E726* *E727*
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
8233 range({expr} [, {max} [, {stride}]]) *range()*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
8234 Returns a |List| with Numbers:
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
8235 - If only {expr} is specified: [0, 1, ..., {expr} - 1]
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
8236 - If {max} is specified: [{expr}, {expr} + 1, ..., {max}]
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
8237 - If {stride} is specified: [{expr}, {expr} + {stride}, ...,
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
8238 {max}] (increasing {expr} with {stride} each time, not
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
8239 producing a value past {max}).
336
2d8c2622e1fa updated for version 7.0087
vimboss
parents: 327
diff changeset
8240 When the maximum is one before the start the result is an
2d8c2622e1fa updated for version 7.0087
vimboss
parents: 327
diff changeset
8241 empty list. When the maximum is more than one before the
2d8c2622e1fa updated for version 7.0087
vimboss
parents: 327
diff changeset
8242 start this is an error.
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
8243 Examples: >
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
8244 range(4) " [0, 1, 2, 3]
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
8245 range(2, 4) " [2, 3, 4]
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
8246 range(2, 9, 3) " [2, 5, 8]
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
8247 range(2, -2, -1) " [2, 1, 0, -1, -2]
336
2d8c2622e1fa updated for version 7.0087
vimboss
parents: 327
diff changeset
8248 range(0) " []
2d8c2622e1fa updated for version 7.0087
vimboss
parents: 327
diff changeset
8249 range(2, 0) " error!
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
8250 <
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8251 Can also be used as a |method|: >
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8252 GetExpr()->range()
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8253 <
18701
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
8254
20115
bd021eb62e73 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20037
diff changeset
8255 rand([{expr}]) *rand()* *random*
18732
2513e666aa82 patch 8.1.2356: rand() does not use the best algorithm
Bram Moolenaar <Bram@vim.org>
parents: 18719
diff changeset
8256 Return a pseudo-random Number generated with an xoshiro128**
18719
99586852c2db Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18701
diff changeset
8257 algorithm using seed {expr}. The returned number is 32 bits,
99586852c2db Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18701
diff changeset
8258 also on 64 bits systems, for consistency.
99586852c2db Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18701
diff changeset
8259 {expr} can be initialized by |srand()| and will be updated by
99586852c2db Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18701
diff changeset
8260 rand(). If {expr} is omitted, an internal seed value is used
99586852c2db Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18701
diff changeset
8261 and updated.
18701
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
8262
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
8263 Examples: >
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
8264 :echo rand()
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
8265 :let seed = srand()
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
8266 :echo rand(seed)
18719
99586852c2db Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18701
diff changeset
8267 :echo rand(seed) % 16 " random number 0 - 15
18701
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
8268 <
23602
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
8269
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
8270 readblob({fname}) *readblob()*
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
8271 Read file {fname} in binary mode and return a |Blob|.
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
8272 When the file can't be opened an error message is given and
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
8273 the result is an empty |Blob|.
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
8274 Also see |readfile()| and |writefile()|.
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
8275
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
8276
20873
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8277 readdir({directory} [, {expr} [, {dict}]]) *readdir()*
16231
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8278 Return a list with file and directory names in {directory}.
16267
b471858040bc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16235
diff changeset
8279 You can also use |glob()| if you don't need to do complicated
b471858040bc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16235
diff changeset
8280 things, such as limiting the number of matches.
20873
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8281 The list will be sorted (case sensitive), see the {dict}
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8282 argument below for changing the sort order.
16231
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8283
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8284 When {expr} is omitted all entries are included.
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8285 When {expr} is given, it is evaluated to check what to do:
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8286 If {expr} results in -1 then no further entries will
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8287 be handled.
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8288 If {expr} results in 0 then this entry will not be
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8289 added to the list.
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8290 If {expr} results in 1 then this entry will be added
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8291 to the list.
20643
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8292 The entries "." and ".." are always excluded.
16231
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8293 Each time {expr} is evaluated |v:val| is set to the entry name.
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8294 When {expr} is a function the name is passed as the argument.
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8295 For example, to get a list of files ending in ".txt": >
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8296 readdir(dirname, {n -> n =~ '.txt$'})
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8297 < To skip hidden and backup files: >
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8298 readdir(dirname, {n -> n !~ '^\.\|\~$'})
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8299
20873
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8300 < The optional {dict} argument allows for further custom
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8301 values. Currently this is used to specify if and how sorting
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8302 should be performed. The dict can have the following members:
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8303
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8304 sort How to sort the result returned from the system.
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8305 Valid values are:
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8306 "none" do not sort (fastest method)
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8307 "case" sort case sensitive (byte value of
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8308 each character, technically, using
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8309 strcmp()) (default)
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8310 "icase" sort case insensitive (technically
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8311 using strcasecmp())
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8312 "collate" sort using the collation order
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8313 of the "POSIX" or "C" |locale|
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8314 (technically using strcoll())
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8315 Other values are silently ignored.
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8316
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8317 For example, to get a list of all files in the current
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8318 directory without sorting the individual entries: >
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8319 readdir('.', '1', #{sort: 'none'})
16231
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8320 < If you want to get a directory tree: >
20873
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8321 function! s:tree(dir)
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8322 return {a:dir : map(readdir(a:dir),
16231
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8323 \ {_, x -> isdirectory(x) ?
20873
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8324 \ {x : s:tree(a:dir . '/' . x)} : x})}
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8325 endfunction
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8326 echo s:tree(".")
16231
0761a4c111a7 patch 8.1.1120: cannot easily get directory entry matches
Bram Moolenaar <Bram@vim.org>
parents: 16223
diff changeset
8327 <
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8328 Can also be used as a |method|: >
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8329 GetDirName()->readdir()
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8330 <
20873
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8331 readdirex({directory} [, {expr} [, {dict}]]) *readdirex()*
20643
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8332 Extended version of |readdir()|.
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8333 Return a list of Dictionaries with file and directory
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8334 information in {directory}.
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8335 This is useful if you want to get the attributes of file and
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8336 directory at the same time as getting a list of a directory.
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8337 This is much faster than calling |readdir()| then calling
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8338 |getfperm()|, |getfsize()|, |getftime()| and |getftype()| for
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8339 each file and directory especially on MS-Windows.
20873
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8340 The list will by default be sorted by name (case sensitive),
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8341 the sorting can be changed by using the optional {dict}
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8342 argument, see |readdir()|.
20643
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8343
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8344 The Dictionary for file and directory information has the
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8345 following items:
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8346 group Group name of the entry. (Only on Unix)
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8347 name Name of the entry.
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8348 perm Permissions of the entry. See |getfperm()|.
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8349 size Size of the entry. See |getfsize()|.
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8350 time Timestamp of the entry. See |getftime()|.
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8351 type Type of the entry.
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8352 On Unix, almost same as |getftype()| except:
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8353 Symlink to a dir "linkd"
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8354 Other symlink "link"
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8355 On MS-Windows:
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8356 Normal file "file"
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8357 Directory "dir"
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8358 Junction "junction"
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8359 Symlink to a dir "linkd"
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8360 Other symlink "link"
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8361 Other reparse point "reparse"
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8362 user User name of the entry's owner. (Only on Unix)
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8363 On Unix, if the entry is a symlink, the Dictionary includes
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8364 the information of the target (except the "type" item).
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8365 On MS-Windows, it includes the information of the symlink
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8366 itself because of performance reasons.
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8367
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8368 When {expr} is omitted all entries are included.
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8369 When {expr} is given, it is evaluated to check what to do:
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8370 If {expr} results in -1 then no further entries will
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8371 be handled.
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8372 If {expr} results in 0 then this entry will not be
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8373 added to the list.
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8374 If {expr} results in 1 then this entry will be added
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8375 to the list.
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8376 The entries "." and ".." are always excluded.
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
8377 Each time {expr} is evaluated |v:val| is set to a |Dictionary|
20643
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8378 of the entry.
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8379 When {expr} is a function the entry is passed as the argument.
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8380 For example, to get a list of files ending in ".txt": >
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8381 readdirex(dirname, {e -> e.name =~ '.txt$'})
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8382 <
20873
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8383 For example, to get a list of all files in the current
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8384 directory without sorting the individual entries: >
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8385 readdirex(dirname, '1', #{sort: 'none'})
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8386
69055d27e85e patch 8.2.0988: getting directory contents is always case sorted
Bram Moolenaar <Bram@vim.org>
parents: 20856
diff changeset
8387 <
20643
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8388 Can also be used as a |method|: >
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8389 GetDirName()->readdirex()
c2beb6baa42c patch 8.2.0875: getting attributes for directory entries is slow
Bram Moolenaar <Bram@vim.org>
parents: 20635
diff changeset
8390 <
23602
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
8391
158
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
8392 *readfile()*
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8393 readfile({fname} [, {type} [, {max}]])
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
8394 Read file {fname} and return a |List|, each line of the file
10245
d76ccdacb41e commit https://github.com/vim/vim/commit/6100d02aab7c8294b581cb299250eea164b50e9d
Christian Brabandt <cb@256bit.org>
parents: 10244
diff changeset
8395 as an item. Lines are broken at NL characters. Macintosh
d76ccdacb41e commit https://github.com/vim/vim/commit/6100d02aab7c8294b581cb299250eea164b50e9d
Christian Brabandt <cb@256bit.org>
parents: 10244
diff changeset
8396 files separated with CR will result in a single long line
d76ccdacb41e commit https://github.com/vim/vim/commit/6100d02aab7c8294b581cb299250eea164b50e9d
Christian Brabandt <cb@256bit.org>
parents: 10244
diff changeset
8397 (unless a NL appears somewhere).
2513
a88237afdb20 Change readfile() to ignore byte order marks, unless in binary mode.
Bram Moolenaar <bram@vim.org>
parents: 2490
diff changeset
8398 All NUL characters are replaced with a NL character.
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8399 When {type} contains "b" binary mode is used:
158
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
8400 - When the last line ends in a NL an extra empty list item is
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
8401 added.
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
8402 - No CR characters are removed.
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
8403 Otherwise:
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
8404 - CR characters that appear before a NL are removed.
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
8405 - Whether the last line ends in a NL or not does not matter.
2513
a88237afdb20 Change readfile() to ignore byte order marks, unless in binary mode.
Bram Moolenaar <bram@vim.org>
parents: 2490
diff changeset
8406 - When 'encoding' is Unicode any UTF-8 byte order mark is
a88237afdb20 Change readfile() to ignore byte order marks, unless in binary mode.
Bram Moolenaar <bram@vim.org>
parents: 2490
diff changeset
8407 removed from the text.
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
8408 When {max} is given this specifies the maximum number of lines
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
8409 to be read. Useful if you only want to check the first ten
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
8410 lines of a file: >
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
8411 :for line in readfile(fname, '', 10)
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
8412 : if line =~ 'Date' | echo line | endif
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
8413 :endfor
233
fca8a9b65afa updated for version 7.0065
vimboss
parents: 230
diff changeset
8414 < When {max} is negative -{max} lines from the end of the file
fca8a9b65afa updated for version 7.0065
vimboss
parents: 230
diff changeset
8415 are returned, or as many as there are.
fca8a9b65afa updated for version 7.0065
vimboss
parents: 230
diff changeset
8416 When {max} is zero the result is an empty list.
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
8417 Note that without {max} the whole file is read into memory.
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
8418 Also note that there is no recognition of encoding. Read a
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
8419 file into a buffer if you need to.
23602
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
8420 Deprecated (use |readblob()| instead): When {type} contains
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
8421 "B" a |Blob| is returned with the binary data of the file
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
8422 unmodified.
158
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
8423 When the file can't be opened an error message is given and
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
8424 the result is an empty list.
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
8425 Also see |writefile()|.
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
8426
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8427 Can also be used as a |method|: >
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8428 GetFileName()->readfile()
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8429
20649
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8430 reduce({object}, {func} [, {initial}]) *reduce()* *E998*
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8431 {func} is called for every item in {object}, which can be a
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8432 |List| or a |Blob|. {func} is called with two arguments: the
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8433 result so far and current item. After processing all items
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8434 the result is returned.
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8435
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8436 {initial} is the initial result. When omitted, the first item
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8437 in {object} is used and {func} is first called for the second
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8438 item. If {initial} is not given and {object} is empty no
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8439 result can be computed, an E998 error is given.
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8440
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8441 Examples: >
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8442 echo reduce([1, 3, 5], { acc, val -> acc + val })
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8443 echo reduce(['x', 'y'], { acc, val -> acc .. val }, 'a')
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8444 echo reduce(0z1122, { acc, val -> 2 * acc + val })
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8445 <
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8446 Can also be used as a |method|: >
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8447 echo mylist->reduce({ acc, val -> acc + val }, 0)
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8448
1fa0ace0ba65 patch 8.2.0878: no reduce() function
Bram Moolenaar <Bram@vim.org>
parents: 20647
diff changeset
8449
14004
e124262d435e patch 8.1.0020: cannot tell whether a register is executing or recording
Christian Brabandt <cb@256bit.org>
parents: 13967
diff changeset
8450 reg_executing() *reg_executing()*
e124262d435e patch 8.1.0020: cannot tell whether a register is executing or recording
Christian Brabandt <cb@256bit.org>
parents: 13967
diff changeset
8451 Returns the single letter name of the register being executed.
e124262d435e patch 8.1.0020: cannot tell whether a register is executing or recording
Christian Brabandt <cb@256bit.org>
parents: 13967
diff changeset
8452 Returns an empty string when no register is being executed.
e124262d435e patch 8.1.0020: cannot tell whether a register is executing or recording
Christian Brabandt <cb@256bit.org>
parents: 13967
diff changeset
8453 See |@|.
e124262d435e patch 8.1.0020: cannot tell whether a register is executing or recording
Christian Brabandt <cb@256bit.org>
parents: 13967
diff changeset
8454
e124262d435e patch 8.1.0020: cannot tell whether a register is executing or recording
Christian Brabandt <cb@256bit.org>
parents: 13967
diff changeset
8455 reg_recording() *reg_recording()*
e124262d435e patch 8.1.0020: cannot tell whether a register is executing or recording
Christian Brabandt <cb@256bit.org>
parents: 13967
diff changeset
8456 Returns the single letter name of the register being recorded.
16267
b471858040bc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16235
diff changeset
8457 Returns an empty string when not recording. See |q|.
14004
e124262d435e patch 8.1.0020: cannot tell whether a register is executing or recording
Christian Brabandt <cb@256bit.org>
parents: 13967
diff changeset
8458
794
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8459 reltime([{start} [, {end}]]) *reltime()*
22824
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
8460 Return an item that represents a time value. The item is a
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
8461 list with items that depend on the system. In Vim 9 script
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
8462 list<any> can be used.
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
8463 The item can be passed to |reltimestr()| to convert it to a
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
8464 string or |reltimefloat()| to convert to a Float.
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
8465
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
8466 Without an argument reltime() returns the current time.
794
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8467 With one argument is returns the time passed since the time
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8468 specified in the argument.
843
9f279ebda751 updated for version 7.0f01
vimboss
parents: 842
diff changeset
8469 With two arguments it returns the time passed between {start}
794
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8470 and {end}.
22824
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
8471
794
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8472 The {start} and {end} arguments must be values returned by
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8473 reltime().
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8474
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8475 Can also be used as a |method|: >
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8476 GetStart()->reltime()
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8477 <
2570
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2569
diff changeset
8478 {only available when compiled with the |+reltime| feature}
794
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8479
8876
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
8480 reltimefloat({time}) *reltimefloat()*
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
8481 Return a Float that represents the time value of {time}.
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
8482 Example: >
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
8483 let start = reltime()
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
8484 call MyFunction()
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
8485 let seconds = reltimefloat(reltime(start))
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
8486 < See the note of reltimestr() about overhead.
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
8487 Also see |profiling|.
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8488
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8489 Can also be used as a |method|: >
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8490 reltime(start)->reltimefloat()
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8491
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8492 < {only available when compiled with the |+reltime| feature}
8876
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
8493
794
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8494 reltimestr({time}) *reltimestr()*
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8495 Return a String that represents the time value of {time}.
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8496 This is the number of seconds, a dot and the number of
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8497 microseconds. Example: >
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8498 let start = reltime()
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8499 call MyFunction()
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8500 echo reltimestr(reltime(start))
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8501 < Note that overhead for the commands will be added to the time.
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8502 The accuracy depends on the system.
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
8503 Leading spaces are used to make the string align nicely. You
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
8504 can use split() to remove it. >
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
8505 echo split(reltimestr(reltime(start)))[0]
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
8506 < Also see |profiling|.
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8507
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8508 Can also be used as a |method|: >
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8509 reltime(start)->reltimestr()
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8510
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8511 < {only available when compiled with the |+reltime| feature}
794
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
8512
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8513 *remote_expr()* *E449*
11211
71311d899b42 patch 8.0.0492: a failing client-server request can make Vim hang
Christian Brabandt <cb@256bit.org>
parents: 11181
diff changeset
8514 remote_expr({server}, {string} [, {idvar} [, {timeout}]])
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
8515 Send the {string} to {server}. The string is sent as an
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8516 expression and the result is returned after evaluation.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
8517 The result must be a String or a |List|. A |List| is turned
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
8518 into a String by joining the items with a line break in
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
8519 between (not at the end), like with join(expr, "\n").
11211
71311d899b42 patch 8.0.0492: a failing client-server request can make Vim hang
Christian Brabandt <cb@256bit.org>
parents: 11181
diff changeset
8520 If {idvar} is present and not empty, it is taken as the name
71311d899b42 patch 8.0.0492: a failing client-server request can make Vim hang
Christian Brabandt <cb@256bit.org>
parents: 11181
diff changeset
8521 of a variable and a {serverid} for later use with
13329
424321d6eea7 patch 8.0.1539: no test for the popup menu positioning
Christian Brabandt <cb@256bit.org>
parents: 13298
diff changeset
8522 |remote_read()| is stored there.
11211
71311d899b42 patch 8.0.0492: a failing client-server request can make Vim hang
Christian Brabandt <cb@256bit.org>
parents: 11181
diff changeset
8523 If {timeout} is given the read times out after this many
71311d899b42 patch 8.0.0492: a failing client-server request can make Vim hang
Christian Brabandt <cb@256bit.org>
parents: 11181
diff changeset
8524 seconds. Otherwise a timeout of 600 seconds is used.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8525 See also |clientserver| |RemoteReply|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8526 This function is not available in the |sandbox|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8527 {only available when compiled with the |+clientserver| feature}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8528 Note: Any errors will cause a local error message to be issued
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8529 and the result will be the empty string.
12756
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
8530
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
8531 Variables will be evaluated in the global namespace,
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
8532 independent of a function currently being active. Except
12756
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
8533 when in debug mode, then local function variables and
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
8534 arguments can be evaluated.
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
8535
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8536 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8537 :echo remote_expr("gvim", "2+2")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8538 :echo remote_expr("gvim1", "b:current_syntax")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8539 <
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8540 Can also be used as a |method|: >
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8541 ServerName()->remote_expr(expr)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8542
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8543 remote_foreground({server}) *remote_foreground()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8544 Move the Vim server with the name {server} to the foreground.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8545 This works like: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8546 remote_expr({server}, "foreground()")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8547 < Except that on Win32 systems the client does the work, to work
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8548 around the problem that the OS doesn't always allow the server
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8549 to bring itself to the foreground.
574
25a70b1cd2da updated for version 7.0163
vimboss
parents: 557
diff changeset
8550 Note: This does not restore the window if it was minimized,
25a70b1cd2da updated for version 7.0163
vimboss
parents: 557
diff changeset
8551 like foreground() does.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8552 This function is not available in the |sandbox|.
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8553
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8554 Can also be used as a |method|: >
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8555 ServerName()->remote_foreground()
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8556
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8557 < {only in the Win32, Athena, Motif and GTK GUI versions and the
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8558 Win32 console version}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8559
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8560
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8561 remote_peek({serverid} [, {retvar}]) *remote_peek()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8562 Returns a positive number if there are available strings
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8563 from {serverid}. Copies any reply string into the variable
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
8564 {retvar} if specified. {retvar} must be a string with the
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8565 name of a variable.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8566 Returns zero if none are available.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8567 Returns -1 if something is wrong.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8568 See also |clientserver|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8569 This function is not available in the |sandbox|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8570 {only available when compiled with the |+clientserver| feature}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8571 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8572 :let repl = ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8573 :echo "PEEK: ".remote_peek(id, "repl").": ".repl
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8574
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8575 < Can also be used as a |method|: >
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8576 ServerId()->remote_peek()
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8577
11211
71311d899b42 patch 8.0.0492: a failing client-server request can make Vim hang
Christian Brabandt <cb@256bit.org>
parents: 11181
diff changeset
8578 remote_read({serverid}, [{timeout}]) *remote_read()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8579 Return the oldest available reply from {serverid} and consume
11211
71311d899b42 patch 8.0.0492: a failing client-server request can make Vim hang
Christian Brabandt <cb@256bit.org>
parents: 11181
diff changeset
8580 it. Unless a {timeout} in seconds is given, it blocks until a
71311d899b42 patch 8.0.0492: a failing client-server request can make Vim hang
Christian Brabandt <cb@256bit.org>
parents: 11181
diff changeset
8581 reply is available.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8582 See also |clientserver|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8583 This function is not available in the |sandbox|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8584 {only available when compiled with the |+clientserver| feature}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8585 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8586 :echo remote_read(id)
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8587
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8588 < Can also be used as a |method|: >
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8589 ServerId()->remote_read()
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8590 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8591 *remote_send()* *E241*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8592 remote_send({server}, {string} [, {idvar}])
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
8593 Send the {string} to {server}. The string is sent as input
22
cc049b00ee70 updated for version 7.0014
vimboss
parents: 20
diff changeset
8594 keys and the function returns immediately. At the Vim server
cc049b00ee70 updated for version 7.0014
vimboss
parents: 20
diff changeset
8595 the keys are not mapped |:map|.
667
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
8596 If {idvar} is present, it is taken as the name of a variable
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
8597 and a {serverid} for later use with remote_read() is stored
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
8598 there.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8599 See also |clientserver| |RemoteReply|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8600 This function is not available in the |sandbox|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8601 {only available when compiled with the |+clientserver| feature}
11177
76fb679a310e patch 8.0.0475: not enough testing for the client-server feature
Christian Brabandt <cb@256bit.org>
parents: 11160
diff changeset
8602
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8603 Note: Any errors will be reported in the server and may mess
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8604 up the display.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8605 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8606 :echo remote_send("gvim", ":DropAndReply ".file, "serverid").
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8607 \ remote_read(serverid)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8608
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8609 :autocmd NONE RemoteReply *
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8610 \ echo remote_read(expand("<amatch>"))
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8611 :echo remote_send("gvim", ":sleep 10 | echo ".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8612 \ 'server2client(expand("<client>"), "HELLO")<CR>')
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
8613 <
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8614 Can also be used as a |method|: >
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8615 ServerName()->remote_send(keys)
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8616 <
11177
76fb679a310e patch 8.0.0475: not enough testing for the client-server feature
Christian Brabandt <cb@256bit.org>
parents: 11160
diff changeset
8617 *remote_startserver()* *E941* *E942*
76fb679a310e patch 8.0.0475: not enough testing for the client-server feature
Christian Brabandt <cb@256bit.org>
parents: 11160
diff changeset
8618 remote_startserver({name})
76fb679a310e patch 8.0.0475: not enough testing for the client-server feature
Christian Brabandt <cb@256bit.org>
parents: 11160
diff changeset
8619 Become the server {name}. This fails if already running as a
76fb679a310e patch 8.0.0475: not enough testing for the client-server feature
Christian Brabandt <cb@256bit.org>
parents: 11160
diff changeset
8620 server, when |v:servername| is not empty.
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8621
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8622 Can also be used as a |method|: >
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8623 ServerName()->remote_startserver()
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8624
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8625 < {only available when compiled with the |+clientserver| feature}
11177
76fb679a310e patch 8.0.0475: not enough testing for the client-server feature
Christian Brabandt <cb@256bit.org>
parents: 11160
diff changeset
8626
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
8627 remove({list}, {idx} [, {end}]) *remove()*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
8628 Without {end}: Remove the item at {idx} from |List| {list} and
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
8629 return the item.
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
8630 With {end}: Remove items from {idx} to {end} (inclusive) and
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
8631 return a |List| with these items. When {idx} points to the same
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
8632 item as {end} a list with one item is returned. When {end}
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
8633 points to an item before {idx} this is an error.
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
8634 See |list-index| for possible values of {idx} and {end}.
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
8635 Example: >
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
8636 :echo "last item: " . remove(mylist, -1)
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
8637 :call remove(mylist, 0, 9)
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
8638 <
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
8639 Use |delete()| to remove a file.
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
8640
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
8641 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
8642 mylist->remove(idx)
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
8643
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8644 remove({blob}, {idx} [, {end}])
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8645 Without {end}: Remove the byte at {idx} from |Blob| {blob} and
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8646 return the byte.
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8647 With {end}: Remove bytes from {idx} to {end} (inclusive) and
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8648 return a |Blob| with these bytes. When {idx} points to the same
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8649 byte as {end} a |Blob| with one byte is returned. When {end}
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8650 points to a byte before {idx} this is an error.
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8651 Example: >
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8652 :echo "last byte: " . remove(myblob, -1)
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8653 :call remove(mylist, 0, 9)
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
8654
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
8655 remove({dict}, {key})
17571
2704c4e3e20a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17545
diff changeset
8656 Remove the entry from {dict} with key {key} and return it.
2704c4e3e20a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17545
diff changeset
8657 Example: >
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
8658 :echo "removed " . remove(dict, "one")
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
8659 < If there is no {key} in {dict} this is an error.
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
8660
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8661 rename({from}, {to}) *rename()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8662 Rename the file by the name {from} to the name {to}. This
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8663 should also work to move files across file systems. The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8664 result is a Number, which is 0 if the file was renamed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8665 successfully, and non-zero when the renaming failed.
1851
e7f6ca5594cf updated for version 7.2-149
vimboss
parents: 1768
diff changeset
8666 NOTE: If {to} exists it is overwritten without warning.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8667 This function is not available in the |sandbox|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8668
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8669 Can also be used as a |method|: >
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8670 GetOldName()->rename(newname)
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8671
18
293621502c4d updated for version 7.0010
vimboss
parents: 15
diff changeset
8672 repeat({expr}, {count}) *repeat()*
293621502c4d updated for version 7.0010
vimboss
parents: 15
diff changeset
8673 Repeat {expr} {count} times and return the concatenated
293621502c4d updated for version 7.0010
vimboss
parents: 15
diff changeset
8674 result. Example: >
843
9f279ebda751 updated for version 7.0f01
vimboss
parents: 842
diff changeset
8675 :let separator = repeat('-', 80)
18
293621502c4d updated for version 7.0010
vimboss
parents: 15
diff changeset
8676 < When {count} is zero or negative the result is empty.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
8677 When {expr} is a |List| the result is {expr} concatenated
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
8678 {count} times. Example: >
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
8679 :let longlist = repeat(['a', 'b'], 3)
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
8680 < Results in ['a', 'b', 'a', 'b', 'a', 'b'].
18
293621502c4d updated for version 7.0010
vimboss
parents: 15
diff changeset
8681
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
8682 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
8683 mylist->repeat(count)
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
8684
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8685 resolve({filename}) *resolve()* *E655*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8686 On MS-Windows, when {filename} is a shortcut (a .lnk file),
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8687 returns the path the shortcut points to in a simplified form.
15774
c4efa095f323 patch 8.1.0894: MS-Windows: resolve() does not return a reparse point
Bram Moolenaar <Bram@vim.org>
parents: 15746
diff changeset
8688 When {filename} is a symbolic link or junction point, return
c4efa095f323 patch 8.1.0894: MS-Windows: resolve() does not return a reparse point
Bram Moolenaar <Bram@vim.org>
parents: 15746
diff changeset
8689 the full path to the target. If the target of junction is
c4efa095f323 patch 8.1.0894: MS-Windows: resolve() does not return a reparse point
Bram Moolenaar <Bram@vim.org>
parents: 15746
diff changeset
8690 removed, return {filename}.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8691 On Unix, repeat resolving symbolic links in all path
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8692 components of {filename} and return the simplified result.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8693 To cope with link cycles, resolving of symbolic links is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8694 stopped after 100 iterations.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8695 On other systems, return the simplified {filename}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8696 The simplification step is done as by |simplify()|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8697 resolve() keeps a leading path component specifying the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8698 current directory (provided the result is still a relative
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8699 path name) and also keeps a trailing path separator.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8700
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8701 Can also be used as a |method|: >
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8702 GetName()->resolve()
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
8703
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
8704 reverse({object}) *reverse()*
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8705 Reverse the order of items in {object} in-place.
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8706 {object} can be a |List| or a |Blob|.
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8707 Returns {object}.
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
8708 If you want an object to remain unmodified make a copy first: >
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
8709 :let revlist = reverse(copy(mylist))
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
8710 < Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
8711 mylist->reverse()
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
8712
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8713 round({expr}) *round()*
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
8714 Round off {expr} to the nearest integral value and return it
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8715 as a |Float|. If {expr} lies halfway between two integral
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8716 values, then use the larger one (away from zero).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8717 {expr} must evaluate to a |Float| or a |Number|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8718 Examples: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8719 echo round(0.456)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8720 < 0.0 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8721 echo round(4.5)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8722 < 5.0 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8723 echo round(-4.5)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8724 < -5.0
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
8725
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
8726 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
8727 Compute()->round()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
8728 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8729 {only available when compiled with the |+float| feature}
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8730
16103
518f44125207 patch 8.1.1056: no eval function for Ruby
Bram Moolenaar <Bram@vim.org>
parents: 16086
diff changeset
8731 rubyeval({expr}) *rubyeval()*
518f44125207 patch 8.1.1056: no eval function for Ruby
Bram Moolenaar <Bram@vim.org>
parents: 16086
diff changeset
8732 Evaluate Ruby expression {expr} and return its result
518f44125207 patch 8.1.1056: no eval function for Ruby
Bram Moolenaar <Bram@vim.org>
parents: 16086
diff changeset
8733 converted to Vim data structures.
518f44125207 patch 8.1.1056: no eval function for Ruby
Bram Moolenaar <Bram@vim.org>
parents: 16086
diff changeset
8734 Numbers, floats and strings are returned as they are (strings
518f44125207 patch 8.1.1056: no eval function for Ruby
Bram Moolenaar <Bram@vim.org>
parents: 16086
diff changeset
8735 are copied though).
518f44125207 patch 8.1.1056: no eval function for Ruby
Bram Moolenaar <Bram@vim.org>
parents: 16086
diff changeset
8736 Arrays are represented as Vim |List| type.
518f44125207 patch 8.1.1056: no eval function for Ruby
Bram Moolenaar <Bram@vim.org>
parents: 16086
diff changeset
8737 Hashes are represented as Vim |Dictionary| type.
518f44125207 patch 8.1.1056: no eval function for Ruby
Bram Moolenaar <Bram@vim.org>
parents: 16086
diff changeset
8738 Other objects are represented as strings resulted from their
518f44125207 patch 8.1.1056: no eval function for Ruby
Bram Moolenaar <Bram@vim.org>
parents: 16086
diff changeset
8739 "Object#to_s" method.
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8740
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8741 Can also be used as a |method|: >
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8742 GetRubyExpr()->rubyeval()
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8743
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
8744 < {only available when compiled with the |+ruby| feature}
16103
518f44125207 patch 8.1.1056: no eval function for Ruby
Bram Moolenaar <Bram@vim.org>
parents: 16086
diff changeset
8745
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
8746 screenattr({row}, {col}) *screenattr()*
10027
018fead968c1 commit https://github.com/vim/vim/commit/36f44c21da2e912c008683a0c4447fca2a071e9a
Christian Brabandt <cb@256bit.org>
parents: 10004
diff changeset
8747 Like |screenchar()|, but return the attribute. This is a rather
4835
4db0bf9f1b44 updated for version 7.3.1164
Bram Moolenaar <bram@vim.org>
parents: 4502
diff changeset
8748 arbitrary number that can only be used to compare to the
4db0bf9f1b44 updated for version 7.3.1164
Bram Moolenaar <bram@vim.org>
parents: 4502
diff changeset
8749 attribute at other positions.
4db0bf9f1b44 updated for version 7.3.1164
Bram Moolenaar <bram@vim.org>
parents: 4502
diff changeset
8750
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8751 Can also be used as a |method|: >
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8752 GetRow()->screenattr(col)
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8753
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
8754 screenchar({row}, {col}) *screenchar()*
4835
4db0bf9f1b44 updated for version 7.3.1164
Bram Moolenaar <bram@vim.org>
parents: 4502
diff changeset
8755 The result is a Number, which is the character at position
4db0bf9f1b44 updated for version 7.3.1164
Bram Moolenaar <bram@vim.org>
parents: 4502
diff changeset
8756 [row, col] on the screen. This works for every possible
4db0bf9f1b44 updated for version 7.3.1164
Bram Moolenaar <bram@vim.org>
parents: 4502
diff changeset
8757 screen position, also status lines, window separators and the
4db0bf9f1b44 updated for version 7.3.1164
Bram Moolenaar <bram@vim.org>
parents: 4502
diff changeset
8758 command line. The top left position is row one, column one
4db0bf9f1b44 updated for version 7.3.1164
Bram Moolenaar <bram@vim.org>
parents: 4502
diff changeset
8759 The character excludes composing characters. For double-byte
4db0bf9f1b44 updated for version 7.3.1164
Bram Moolenaar <bram@vim.org>
parents: 4502
diff changeset
8760 encodings it may only be the first byte.
4db0bf9f1b44 updated for version 7.3.1164
Bram Moolenaar <bram@vim.org>
parents: 4502
diff changeset
8761 This is mainly to be used for testing.
4db0bf9f1b44 updated for version 7.3.1164
Bram Moolenaar <bram@vim.org>
parents: 4502
diff changeset
8762 Returns -1 when row or col is out of range.
4db0bf9f1b44 updated for version 7.3.1164
Bram Moolenaar <bram@vim.org>
parents: 4502
diff changeset
8763
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8764 Can also be used as a |method|: >
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8765 GetRow()->screenchar(col)
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8766
16133
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
8767 screenchars({row}, {col}) *screenchars()*
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
8768 The result is a |List| of Numbers. The first number is the same
16133
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
8769 as what |screenchar()| returns. Further numbers are
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
8770 composing characters on top of the base character.
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
8771 This is mainly to be used for testing.
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
8772 Returns an empty List when row or col is out of range.
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
8773
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8774 Can also be used as a |method|: >
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8775 GetRow()->screenchars(col)
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8776
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8777 screencol() *screencol()*
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8778 The result is a Number, which is the current screen column of
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8779 the cursor. The leftmost column has number 1.
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8780 This function is mainly used for testing.
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8781
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8782 Note: Always returns the current screen column, thus if used
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8783 in a command (e.g. ":echo screencol()") it will return the
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8784 column inside the command line, which is 1 when the command is
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8785 executed. To get the cursor position in the file use one of
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8786 the following mappings: >
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8787 nnoremap <expr> GG ":echom ".screencol()."\n"
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8788 nnoremap <silent> GG :echom screencol()<CR>
22862
6d50182e7e24 patch 8.2.1978: making a mapping work in all modes is complicated
Bram Moolenaar <Bram@vim.org>
parents: 22844
diff changeset
8789 nnoremap GG <Cmd>echom screencol()<CR>
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8790 <
17292
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8791 screenpos({winid}, {lnum}, {col}) *screenpos()*
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8792 The result is a Dict with the screen position of the text
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8793 character in window {winid} at buffer line {lnum} and column
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8794 {col}. {col} is a one-based byte index.
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8795 The Dict has these members:
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8796 row screen row
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8797 col first screen column
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8798 endcol last screen column
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8799 curscol cursor screen column
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8800 If the specified position is not visible, all values are zero.
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8801 The "endcol" value differs from "col" when the character
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8802 occupies more than one screen cell. E.g. for a Tab "col" can
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8803 be 1 and "endcol" can be 8.
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8804 The "curscol" value is where the cursor would be placed. For
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8805 a Tab it would be the same as "endcol", while for a double
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8806 width character it would be the same as "col".
8a095d343c59 patch 8.1.1645: cannot use a popup window for a balloon
Bram Moolenaar <Bram@vim.org>
parents: 17259
diff changeset
8807
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8808 Can also be used as a |method|: >
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8809 GetWinid()->screenpos(lnum, col)
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8810
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8811 screenrow() *screenrow()*
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8812 The result is a Number, which is the current screen row of the
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8813 cursor. The top line has number one.
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8814 This function is mainly used for testing.
9723
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
8815 Alternatively you can use |winline()|.
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8816
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8817 Note: Same restrictions as with |screencol()|.
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3986
diff changeset
8818
16133
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
8819 screenstring({row}, {col}) *screenstring()*
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
8820 The result is a String that contains the base character and
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
8821 any composing characters at position [row, col] on the screen.
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
8822 This is like |screenchars()| but returning a String with the
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
8823 characters.
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
8824 This is mainly to be used for testing.
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
8825 Returns an empty String when row or col is out of range.
eb087f8a26a8 patch 8.1.1071: cannot get composing characters from the screen
Bram Moolenaar <Bram@vim.org>
parents: 16127
diff changeset
8826
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8827 Can also be used as a |method|: >
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8828 GetRow()->screenstring(col)
20725
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
8829 <
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
8830 *search()*
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
8831 search({pattern} [, {flags} [, {stopline} [, {timeout} [, {skip}]]]])
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8832 Search for regexp pattern {pattern}. The search starts at the
119
e8f07016e34d updated for version 7.0042
vimboss
parents: 114
diff changeset
8833 cursor position (you can use |cursor()| to set it).
707
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
8834
3967
fdb8a9c7bd91 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
8835 When a match has been found its line number is returned.
3312
b7811ab264bf updated for version 7.3.423
Bram Moolenaar <bram@vim.org>
parents: 3256
diff changeset
8836 If there is no match a 0 is returned and the cursor doesn't
b7811ab264bf updated for version 7.3.423
Bram Moolenaar <bram@vim.org>
parents: 3256
diff changeset
8837 move. No error message is given.
b7811ab264bf updated for version 7.3.423
Bram Moolenaar <bram@vim.org>
parents: 3256
diff changeset
8838
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8839 {flags} is a String, which can contain these character flags:
7358
6fbeef3b65e6 commit https://github.com/vim/vim/commit/ad4d8a192abf44b89371af87d70b971cd654b799
Christian Brabandt <cb@256bit.org>
parents: 7315
diff changeset
8840 'b' search Backward instead of forward
6fbeef3b65e6 commit https://github.com/vim/vim/commit/ad4d8a192abf44b89371af87d70b971cd654b799
Christian Brabandt <cb@256bit.org>
parents: 7315
diff changeset
8841 'c' accept a match at the Cursor position
712
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8842 'e' move to the End of the match
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
8843 'n' do Not move the cursor
7358
6fbeef3b65e6 commit https://github.com/vim/vim/commit/ad4d8a192abf44b89371af87d70b971cd654b799
Christian Brabandt <cb@256bit.org>
parents: 7315
diff changeset
8844 'p' return number of matching sub-Pattern (see below)
6fbeef3b65e6 commit https://github.com/vim/vim/commit/ad4d8a192abf44b89371af87d70b971cd654b799
Christian Brabandt <cb@256bit.org>
parents: 7315
diff changeset
8845 's' Set the ' mark at the previous location of the cursor
6fbeef3b65e6 commit https://github.com/vim/vim/commit/ad4d8a192abf44b89371af87d70b971cd654b799
Christian Brabandt <cb@256bit.org>
parents: 7315
diff changeset
8846 'w' Wrap around the end of the file
6fbeef3b65e6 commit https://github.com/vim/vim/commit/ad4d8a192abf44b89371af87d70b971cd654b799
Christian Brabandt <cb@256bit.org>
parents: 7315
diff changeset
8847 'W' don't Wrap around the end of the file
6fbeef3b65e6 commit https://github.com/vim/vim/commit/ad4d8a192abf44b89371af87d70b971cd654b799
Christian Brabandt <cb@256bit.org>
parents: 7315
diff changeset
8848 'z' start searching at the cursor column instead of zero
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8849 If neither 'w' or 'W' is given, the 'wrapscan' option applies.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8850
444
d0d15b184c56 updated for version 7.0116
vimboss
parents: 438
diff changeset
8851 If the 's' flag is supplied, the ' mark is set, only if the
d0d15b184c56 updated for version 7.0116
vimboss
parents: 438
diff changeset
8852 cursor is moved. The 's' flag cannot be combined with the 'n'
d0d15b184c56 updated for version 7.0116
vimboss
parents: 438
diff changeset
8853 flag.
d0d15b184c56 updated for version 7.0116
vimboss
parents: 438
diff changeset
8854
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
8855 'ignorecase', 'smartcase' and 'magic' are used.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
8856
22958
e7c125224b1a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22862
diff changeset
8857 When the 'z' flag is not given, forward searching always
e7c125224b1a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22862
diff changeset
8858 starts in column zero and then matches before the cursor are
e7c125224b1a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22862
diff changeset
8859 skipped. When the 'c' flag is present in 'cpo' the next
e7c125224b1a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22862
diff changeset
8860 search starts after the match. Without the 'c' flag the next
e7c125224b1a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22862
diff changeset
8861 search starts one column further. This matters for
e7c125224b1a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22862
diff changeset
8862 overlapping matches.
e7c125224b1a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22862
diff changeset
8863 When searching backwards and the 'z' flag is given then the
e7c125224b1a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22862
diff changeset
8864 search starts in column zero, thus no match in the current
e7c125224b1a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22862
diff changeset
8865 line will be found (unless wrapping around the end of the
e7c125224b1a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22862
diff changeset
8866 file).
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
8867
692
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
8868 When the {stopline} argument is given then the search stops
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
8869 after searching this line. This is useful to restrict the
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
8870 search to a range of lines. Examples: >
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
8871 let match = search('(', 'b', line("w0"))
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
8872 let end = search('END', '', line("w$"))
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
8873 < When {stopline} is used and it is not zero this also implies
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
8874 that the search does not wrap around the end of the file.
1496
29c09fa57168 updated for version 7.1-211
vimboss
parents: 1490
diff changeset
8875 A zero value is equal to not giving the argument.
29c09fa57168 updated for version 7.1-211
vimboss
parents: 1490
diff changeset
8876
29c09fa57168 updated for version 7.1-211
vimboss
parents: 1490
diff changeset
8877 When the {timeout} argument is given the search stops when
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
8878 more than this many milliseconds have passed. Thus when
1496
29c09fa57168 updated for version 7.1-211
vimboss
parents: 1490
diff changeset
8879 {timeout} is 500 the search stops after half a second.
29c09fa57168 updated for version 7.1-211
vimboss
parents: 1490
diff changeset
8880 The value must not be negative. A zero value is like not
29c09fa57168 updated for version 7.1-211
vimboss
parents: 1490
diff changeset
8881 giving the argument.
2570
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2569
diff changeset
8882 {only available when compiled with the |+reltime| feature}
692
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
8883
20725
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
8884 If the {skip} expression is given it is evaluated with the
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
8885 cursor positioned on the start of a match. If it evaluates to
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
8886 non-zero this match is skipped. This can be used, for
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
8887 example, to skip a match in a comment or a string.
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
8888 {skip} can be a string, which is evaluated as an expression, a
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
8889 function reference or a lambda.
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
8890 When {skip} is omitted or empty, every match is accepted.
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
8891 When evaluating {skip} causes an error the search is aborted
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
8892 and -1 returned.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
8893 *search()-sub-match*
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
8894 With the 'p' flag the returned value is one more than the
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
8895 first sub-match in \(\). One if none of them matched but the
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
8896 whole pattern did match.
712
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8897 To get the column number too use |searchpos()|.
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8898
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
8899 The cursor will be positioned at the match, unless the 'n'
707
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
8900 flag is used.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8901
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8902 Example (goes over all files in the argument list): >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8903 :let n = 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8904 :while n <= argc() " loop over all files in arglist
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8905 : exe "argument " . n
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8906 : " start at the last char in the file and wrap for the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8907 : " first search to find match at start of file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8908 : normal G$
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8909 : let flags = "w"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8910 : while search("foo", flags) > 0
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
8911 : s/foo/bar/g
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8912 : let flags = "W"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8913 : endwhile
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8914 : update " write the file if modified
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8915 : let n = n + 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8916 :endwhile
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8917 <
712
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8918 Example for using some flags: >
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8919 :echo search('\<if\|\(else\)\|\(endif\)', 'ncpe')
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8920 < This will search for the keywords "if", "else", and "endif"
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8921 under or after the cursor. Because of the 'p' flag, it
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8922 returns 1, 2, or 3 depending on which keyword is found, or 0
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8923 if the search fails. With the cursor on the first word of the
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8924 line:
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8925 if (foo == 0) | let foo = foo + 1 | endif ~
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8926 the function returns 1. Without the 'c' flag, the function
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8927 finds the "endif" and returns 3. The same thing happens
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8928 without the 'e' flag if the cursor is on the "f" of "if".
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8929 The 'n' flag tells the function not to move the cursor.
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
8930
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8931 Can also be used as a |method|: >
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
8932 GetPattern()->search()
504
35cde31bdcbd updated for version 7.0141
vimboss
parents: 502
diff changeset
8933
20647
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8934 searchcount([{options}]) *searchcount()*
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8935 Get or update the last search count, like what is displayed
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8936 without the "S" flag in 'shortmess'. This works even if
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8937 'shortmess' does contain the "S" flag.
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8938
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
8939 This returns a |Dictionary|. The dictionary is empty if the
20647
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8940 previous pattern was not set and "pattern" was not specified.
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8941
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8942 key type meaning ~
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8943 current |Number| current position of match;
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8944 0 if the cursor position is
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8945 before the first match
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8946 exact_match |Boolean| 1 if "current" is matched on
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8947 "pos", otherwise 0
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8948 total |Number| total count of matches found
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8949 incomplete |Number| 0: search was fully completed
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8950 1: recomputing was timed out
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8951 2: max count exceeded
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8952
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8953 For {options} see further down.
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8954
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8955 To get the last search count when |n| or |N| was pressed, call
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8956 this function with `recompute: 0` . This sometimes returns
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8957 wrong information because |n| and |N|'s maximum count is 99.
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8958 If it exceeded 99 the result must be max count + 1 (100). If
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8959 you want to get correct information, specify `recompute: 1`: >
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8960
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8961 " result == maxcount + 1 (100) when many matches
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8962 let result = searchcount(#{recompute: 0})
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8963
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8964 " Below returns correct result (recompute defaults
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8965 " to 1)
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8966 let result = searchcount()
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8967 <
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8968 The function is useful to add the count to |statusline|: >
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8969 function! LastSearchCount() abort
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8970 let result = searchcount(#{recompute: 0})
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8971 if empty(result)
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8972 return ''
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8973 endif
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8974 if result.incomplete ==# 1 " timed out
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8975 return printf(' /%s [?/??]', @/)
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8976 elseif result.incomplete ==# 2 " max count exceeded
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8977 if result.total > result.maxcount &&
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8978 \ result.current > result.maxcount
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8979 return printf(' /%s [>%d/>%d]', @/,
20965
59f93c2d2551 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20889
diff changeset
8980 \ result.current, result.total)
20647
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8981 elseif result.total > result.maxcount
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8982 return printf(' /%s [%d/>%d]', @/,
20965
59f93c2d2551 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20889
diff changeset
8983 \ result.current, result.total)
20647
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8984 endif
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8985 endif
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8986 return printf(' /%s [%d/%d]', @/,
20965
59f93c2d2551 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20889
diff changeset
8987 \ result.current, result.total)
20647
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8988 endfunction
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8989 let &statusline .= '%{LastSearchCount()}'
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8990
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8991 " Or if you want to show the count only when
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8992 " 'hlsearch' was on
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8993 " let &statusline .=
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8994 " \ '%{v:hlsearch ? LastSearchCount() : ""}'
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8995 <
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8996 You can also update the search count, which can be useful in a
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8997 |CursorMoved| or |CursorMovedI| autocommand: >
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8998
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
8999 autocmd CursorMoved,CursorMovedI *
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9000 \ let s:searchcount_timer = timer_start(
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9001 \ 200, function('s:update_searchcount'))
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9002 function! s:update_searchcount(timer) abort
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9003 if a:timer ==# s:searchcount_timer
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9004 call searchcount(#{
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9005 \ recompute: 1, maxcount: 0, timeout: 100})
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9006 redrawstatus
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9007 endif
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9008 endfunction
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9009 <
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9010 This can also be used to count matched texts with specified
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9011 pattern in the current buffer using "pattern": >
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9012
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9013 " Count '\<foo\>' in this buffer
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9014 " (Note that it also updates search count)
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9015 let result = searchcount(#{pattern: '\<foo\>'})
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9016
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9017 " To restore old search count by old pattern,
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9018 " search again
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9019 call searchcount()
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9020 <
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
9021 {options} must be a |Dictionary|. It can contain:
20647
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9022 key type meaning ~
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9023 recompute |Boolean| if |TRUE|, recompute the count
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9024 like |n| or |N| was executed.
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9025 otherwise returns the last
20687
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
9026 computed result (when |n| or
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
9027 |N| was used when "S" is not
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
9028 in 'shortmess', or this
770a8e9c4781 patch 8.2.0897: list of functions in patched version is outdated
Bram Moolenaar <Bram@vim.org>
parents: 20679
diff changeset
9029 function was called).
20647
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9030 (default: |TRUE|)
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9031 pattern |String| recompute if this was given
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9032 and different with |@/|.
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9033 this works as same as the
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9034 below command is executed
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9035 before calling this function >
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9036 let @/ = pattern
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9037 < (default: |@/|)
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9038 timeout |Number| 0 or negative number is no
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9039 timeout. timeout milliseconds
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9040 for recomputing the result
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9041 (default: 0)
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9042 maxcount |Number| 0 or negative number is no
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9043 limit. max count of matched
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9044 text while recomputing the
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9045 result. if search exceeded
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9046 total count, "total" value
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9047 becomes `maxcount + 1`
23466
15fa3923cc49 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23380
diff changeset
9048 (default: 99)
20647
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9049 pos |List| `[lnum, col, off]` value
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9050 when recomputing the result.
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9051 this changes "current" result
21676
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
9052 value. see |cursor()|,
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
9053 |getpos()|
20647
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9054 (default: cursor's position)
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9055
8a2b86a39ef4 patch 8.2.0877: cannot get the search statistics
Bram Moolenaar <Bram@vim.org>
parents: 20643
diff changeset
9056
523
a7ae7e043e43 updated for version 7.0146
vimboss
parents: 519
diff changeset
9057 searchdecl({name} [, {global} [, {thisblock}]]) *searchdecl()*
a7ae7e043e43 updated for version 7.0146
vimboss
parents: 519
diff changeset
9058 Search for the declaration of {name}.
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
9059
523
a7ae7e043e43 updated for version 7.0146
vimboss
parents: 519
diff changeset
9060 With a non-zero {global} argument it works like |gD|, find
a7ae7e043e43 updated for version 7.0146
vimboss
parents: 519
diff changeset
9061 first match in the file. Otherwise it works like |gd|, find
a7ae7e043e43 updated for version 7.0146
vimboss
parents: 519
diff changeset
9062 first match in the function.
a7ae7e043e43 updated for version 7.0146
vimboss
parents: 519
diff changeset
9063
a7ae7e043e43 updated for version 7.0146
vimboss
parents: 519
diff changeset
9064 With a non-zero {thisblock} argument matches in a {} block
a7ae7e043e43 updated for version 7.0146
vimboss
parents: 519
diff changeset
9065 that ends before the cursor position are ignored. Avoids
a7ae7e043e43 updated for version 7.0146
vimboss
parents: 519
diff changeset
9066 finding variable declarations only valid in another scope.
a7ae7e043e43 updated for version 7.0146
vimboss
parents: 519
diff changeset
9067
504
35cde31bdcbd updated for version 7.0141
vimboss
parents: 502
diff changeset
9068 Moves the cursor to the found match.
35cde31bdcbd updated for version 7.0141
vimboss
parents: 502
diff changeset
9069 Returns zero for success, non-zero for failure.
35cde31bdcbd updated for version 7.0141
vimboss
parents: 502
diff changeset
9070 Example: >
35cde31bdcbd updated for version 7.0141
vimboss
parents: 502
diff changeset
9071 if searchdecl('myvar') == 0
35cde31bdcbd updated for version 7.0141
vimboss
parents: 502
diff changeset
9072 echo getline('.')
35cde31bdcbd updated for version 7.0141
vimboss
parents: 502
diff changeset
9073 endif
35cde31bdcbd updated for version 7.0141
vimboss
parents: 502
diff changeset
9074 <
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9075 Can also be used as a |method|: >
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9076 GetName()->searchdecl()
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9077 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9078 *searchpair()*
1496
29c09fa57168 updated for version 7.1-211
vimboss
parents: 1490
diff changeset
9079 searchpair({start}, {middle}, {end} [, {flags} [, {skip}
29c09fa57168 updated for version 7.1-211
vimboss
parents: 1490
diff changeset
9080 [, {stopline} [, {timeout}]]]])
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9081 Search for the match of a nested start-end pair. This can be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9082 used to find the "endif" that matches an "if", while other
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9083 if/endif pairs in between are ignored.
677
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
9084 The search starts at the cursor. The default is to search
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
9085 forward, include 'b' in {flags} to search backward.
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
9086 If a match is found, the cursor is positioned at it and the
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
9087 line number is returned. If no match is found 0 or -1 is
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
9088 returned and the cursor doesn't move. No error message is
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
9089 given.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9090
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9091 {start}, {middle} and {end} are patterns, see |pattern|. They
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9092 must not contain \( \) pairs. Use of \%( \) is allowed. When
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9093 {middle} is not empty, it is found when searching from either
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9094 direction, but only when not in a nested start-end pair. A
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9095 typical use is: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9096 searchpair('\<if\>', '\<else\>', '\<endif\>')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9097 < By leaving {middle} empty the "else" is skipped.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9098
712
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
9099 {flags} 'b', 'c', 'n', 's', 'w' and 'W' are used like with
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
9100 |search()|. Additionally:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9101 'r' Repeat until no more matches found; will find the
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9102 outer pair. Implies the 'W' flag.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9103 'm' Return number of matches instead of line number with
712
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
9104 the match; will be > 1 when 'r' is used.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9105 Note: it's nearly always a good idea to use the 'W' flag, to
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9106 avoid wrapping around the end of the file.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9107
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9108 When a match for {start}, {middle} or {end} is found, the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9109 {skip} expression is evaluated with the cursor positioned on
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9110 the start of the match. It should return non-zero if this
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9111 match is to be skipped. E.g., because it is inside a comment
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9112 or a string.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9113 When {skip} is omitted or empty, every match is accepted.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9114 When evaluating {skip} causes an error the search is aborted
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9115 and -1 returned.
12722
7749260f261c patch 8.0.1239: cannot use a lambda for the skip argument to searchpair()
Christian Brabandt <cb@256bit.org>
parents: 12716
diff changeset
9116 {skip} can be a string, a lambda, a funcref or a partial.
14193
c460506890ba Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14161
diff changeset
9117 Anything else makes the function fail.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9118
1496
29c09fa57168 updated for version 7.1-211
vimboss
parents: 1490
diff changeset
9119 For {stopline} and {timeout} see |search()|.
692
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
9120
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9121 The value of 'ignorecase' is used. 'magic' is ignored, the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9122 patterns are used like it's on.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9123
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9124 The search starts exactly at the cursor. A match with
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9125 {start}, {middle} or {end} at the next character, in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9126 direction of searching, is the first one found. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9127 if 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9128 if 2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9129 endif 2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9130 endif 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9131 < When starting at the "if 2", with the cursor on the "i", and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9132 searching forwards, the "endif 2" is found. When starting on
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9133 the character just before the "if 2", the "endif 1" will be
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
9134 found. That's because the "if 2" will be found first, and
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9135 then this is considered to be a nested if/endif from "if 2" to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9136 "endif 2".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9137 When searching backwards and {end} is more than one character,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9138 it may be useful to put "\zs" at the end of the pattern, so
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9139 that when the cursor is inside a match with the end it finds
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9140 the matching start.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9141
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9142 Example, to find the "endif" command in a Vim script: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9143
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9144 :echo searchpair('\<if\>', '\<el\%[seif]\>', '\<en\%[dif]\>', 'W',
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9145 \ 'getline(".") =~ "^\\s*\""')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9146
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9147 < The cursor must be at or after the "if" for which a match is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9148 to be found. Note that single-quote strings are used to avoid
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9149 having to double the backslashes. The skip expression only
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9150 catches comments at the start of a line, not after a command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9151 Also, a word "en" or "if" halfway a line is considered a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9152 match.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9153 Another example, to search for the matching "{" of a "}": >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9154
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9155 :echo searchpair('{', '', '}', 'bW')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9156
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9157 < This works when the cursor is at or before the "}" for which a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9158 match is to be found. To reject matches that syntax
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9159 highlighting recognized as strings: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9160
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9161 :echo searchpair('{', '', '}', 'bW',
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9162 \ 'synIDattr(synID(line("."), col("."), 0), "name") =~? "string"')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9163 <
667
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
9164 *searchpairpos()*
1496
29c09fa57168 updated for version 7.1-211
vimboss
parents: 1490
diff changeset
9165 searchpairpos({start}, {middle}, {end} [, {flags} [, {skip}
29c09fa57168 updated for version 7.1-211
vimboss
parents: 1490
diff changeset
9166 [, {stopline} [, {timeout}]]]])
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
9167 Same as |searchpair()|, but returns a |List| with the line and
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
9168 column position of the match. The first element of the |List|
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
9169 is the line number and the second element is the byte index of
667
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
9170 the column position of the match. If no match is found,
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
9171 returns [0, 0]. >
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
9172
667
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
9173 :let [lnum,col] = searchpairpos('{', '', '}', 'n')
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
9174 <
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
9175 See |match-parens| for a bigger and more useful example.
9090f866cd57 updated for version 7.0197
vimboss
parents: 665
diff changeset
9176
20725
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
9177 *searchpos()*
f4455c71a8aa patch 8.2.0915: search() cannot skip over matches like searchpair() can
Bram Moolenaar <Bram@vim.org>
parents: 20687
diff changeset
9178 searchpos({pattern} [, {flags} [, {stopline} [, {timeout} [, {skip}]]]])
692
a28f83d37113 updated for version 7.0208
vimboss
parents: 688
diff changeset
9179 Same as |search()|, but returns a |List| with the line and
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
9180 column position of the match. The first element of the |List|
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
9181 is the line number and the second element is the byte index of
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
9182 the column position of the match. If no match is found,
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
9183 returns [0, 0].
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
9184 Example: >
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
9185 :let [lnum, col] = searchpos('mypattern', 'n')
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
9186
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
9187 < When the 'p' flag is given then there is an extra item with
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
9188 the sub-pattern match number |search()-sub-match|. Example: >
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
9189 :let [lnum, col, submatch] = searchpos('\(\l\)\|\(\u\)', 'np')
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
9190 < In this example "submatch" is 2 when a lowercase letter is
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
9191 found |/\l|, 3 when an uppercase letter is found |/\u|.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 712
diff changeset
9192
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9193 Can also be used as a |method|: >
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9194 GetPattern()->searchpos()
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9195
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
9196 server2client({clientid}, {string}) *server2client()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9197 Send a reply string to {clientid}. The most recent {clientid}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9198 that sent a string can be retrieved with expand("<client>").
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9199 {only available when compiled with the |+clientserver| feature}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9200 Note:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9201 This id has to be stored before the next command can be
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 233
diff changeset
9202 received. I.e. before returning from the received command and
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9203 before calling any commands that waits for input.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9204 See also |clientserver|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9205 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9206 :echo server2client(expand("<client>"), "HELLO")
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9207
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9208 < Can also be used as a |method|: >
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9209 GetClientId()->server2client(string)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9210 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9211 serverlist() *serverlist()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9212 Return a list of available server names, one per line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9213 When there are no servers or the information is not available
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9214 an empty string is returned. See also |clientserver|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9215 {only available when compiled with the |+clientserver| feature}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9216 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9217 :echo serverlist()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9218 <
12319
c7e95667d14b patch 8.0.1039: cannot change a line in not current buffer
Christian Brabandt <cb@256bit.org>
parents: 12317
diff changeset
9219 setbufline({expr}, {lnum}, {text}) *setbufline()*
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9220 Set line {lnum} to {text} in buffer {expr}. This works like
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9221 |setline()| for the specified buffer.
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9222
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9223 This function works only for loaded buffers. First call
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9224 |bufload()| if needed.
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9225
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9226 To insert lines use |appendbufline()|.
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9227 Any text properties in {lnum} are cleared.
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9228
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9229 {text} can be a string to set one line, or a list of strings
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9230 to set multiple lines. If the list extends below the last
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9231 line then those lines are added.
12319
c7e95667d14b patch 8.0.1039: cannot change a line in not current buffer
Christian Brabandt <cb@256bit.org>
parents: 12317
diff changeset
9232
c7e95667d14b patch 8.0.1039: cannot change a line in not current buffer
Christian Brabandt <cb@256bit.org>
parents: 12317
diff changeset
9233 For the use of {expr}, see |bufname()| above.
c7e95667d14b patch 8.0.1039: cannot change a line in not current buffer
Christian Brabandt <cb@256bit.org>
parents: 12317
diff changeset
9234
c7e95667d14b patch 8.0.1039: cannot change a line in not current buffer
Christian Brabandt <cb@256bit.org>
parents: 12317
diff changeset
9235 {lnum} is used like with |setline()|.
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9236 When {lnum} is just below the last line the {text} will be
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9237 added below the last line.
17131
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
9238
17259
6dbb9b3c53e2 patch 8.1.1629: terminal function help is in the wrong file
Bram Moolenaar <Bram@vim.org>
parents: 17257
diff changeset
9239 When {expr} is not a valid buffer, the buffer is not loaded or
6dbb9b3c53e2 patch 8.1.1629: terminal function help is in the wrong file
Bram Moolenaar <Bram@vim.org>
parents: 17257
diff changeset
9240 {lnum} is not valid then 1 is returned. On success 0 is
6dbb9b3c53e2 patch 8.1.1629: terminal function help is in the wrong file
Bram Moolenaar <Bram@vim.org>
parents: 17257
diff changeset
9241 returned.
12319
c7e95667d14b patch 8.0.1039: cannot change a line in not current buffer
Christian Brabandt <cb@256bit.org>
parents: 12317
diff changeset
9242
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9243 Can also be used as a |method|, the base is passed as the
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9244 third argument: >
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9245 GetText()->setbufline(buf, lnum)
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9246
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9247 setbufvar({expr}, {varname}, {val}) *setbufvar()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9248 Set option or local variable {varname} in buffer {expr} to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9249 {val}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9250 This also works for a global or local window option, but it
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9251 doesn't work for a global or local window variable.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9252 For a local window option the global value is unchanged.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9253 For the use of {expr}, see |bufname()| above.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9254 Note that the variable name without "b:" must be used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9255 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9256 :call setbufvar(1, "&mod", 1)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9257 :call setbufvar("todo", "myvar", "foobar")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9258 < This function is not available in the |sandbox|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9259
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9260 Can also be used as a |method|, the base is passed as the
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9261 third argument: >
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9262 GetValue()->setbufvar(buf, varname)
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9263
21971
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9264
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9265 setcellwidths({list}) *setcellwidths()*
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9266 Specify overrides for cell widths of character ranges. This
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9267 tells Vim how wide characters are, counted in screen cells.
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9268 This overrides 'ambiwidth'. Example: >
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9269 setcellwidths([[0xad, 0xad, 1],
21991
bbca88cd13d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21989
diff changeset
9270 \ [0x2194, 0x2199, 2]])
21971
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9271
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9272 < *E1109* *E1110* *E1111* *E1112* *E1113*
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9273 The {list} argument is a list of lists with each three
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9274 numbers. These three numbers are [low, high, width]. "low"
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9275 and "high" can be the same, in which case this refers to one
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9276 character. Otherwise it is the range of characters from "low"
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9277 to "high" (inclusive). "width" is either 1 or 2, indicating
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9278 the character width in screen cells.
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9279 An error is given if the argument is invalid, also when a
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9280 range overlaps with another.
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9281 Only characters with value 0x100 and higher can be used.
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9282
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9283 To clear the overrides pass an empty list: >
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9284 setcellwidths([]);
21991
bbca88cd13d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21989
diff changeset
9285 < You can use the script $VIMRUNTIME/tools/emoji_list.vim to see
bbca88cd13d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21989
diff changeset
9286 the effect for known emoji characters.
21971
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9287
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9288 setcharpos({expr}, {list}) *setcharpos()*
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9289 Same as |setpos()| but uses the specified column number as the
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9290 character index instead of the byte index in the line.
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9291
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9292 Example:
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9293 With the text "여보세요" in line 8: >
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9294 call setcharpos('.', [0, 8, 4, 0])
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9295 < positions the cursor on the fourth character '요'. >
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9296 call setpos('.', [0, 8, 4, 0])
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9297 < positions the cursor on the second character '보'.
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9298
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9299 Can also be used as a |method|: >
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9300 GetPosition()->setcharpos('.')
21971
0bc43a704f56 patch 8.2.1535: it is not possible to specify cell widths of characters
Bram Moolenaar <Bram@vim.org>
parents: 21935
diff changeset
9301
7100
f717d96a39b3 commit https://github.com/vim/vim/commit/12969c04fe7bd27dc0cbf37709eb40a86d4a27f9
Christian Brabandt <cb@256bit.org>
parents: 7013
diff changeset
9302 setcharsearch({dict}) *setcharsearch()*
6991
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9303 Set the current character search information to {dict},
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9304 which contains one or more of the following entries:
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9305
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9306 char character which will be used for a subsequent
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9307 |,| or |;| command; an empty string clears the
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9308 character search
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9309 forward direction of character search; 1 for forward,
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9310 0 for backward
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9311 until type of character search; 1 for a |t| or |T|
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9312 character search, 0 for an |f| or |F|
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9313 character search
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9314
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9315 This can be useful to save/restore a user's character search
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9316 from a script: >
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9317 :let prevsearch = getcharsearch()
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9318 :" Perform a command which clobbers user's search
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9319 :call setcharsearch(prevsearch)
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9320 < Also see |getcharsearch()|.
814f1f569e4a patch 7.4.813
Bram Moolenaar <bram@vim.org>
parents: 6951
diff changeset
9321
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9322 Can also be used as a |method|: >
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9323 SavedSearch()->setcharsearch()
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9324
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9325 setcmdpos({pos}) *setcmdpos()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9326 Set the cursor position in the command line to byte position
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
9327 {pos}. The first position is 1.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9328 Use |getcmdpos()| to obtain the current position.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9329 Only works while editing the command line, thus you must use
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
9330 |c_CTRL-\_e|, |c_CTRL-R_=| or |c_CTRL-R_CTRL-R| with '='. For
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
9331 |c_CTRL-\_e| and |c_CTRL-R_CTRL-R| with '=' the position is
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
9332 set after the command line is set to the expression. For
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
9333 |c_CTRL-R_=| it is set after evaluating the expression but
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
9334 before inserting the resulting text.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9335 When the number is too big the cursor is put at the end of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9336 line. A number smaller than one has undefined results.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9337 Returns 0 when successful, 1 when not editing the command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9338 line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9339
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9340 Can also be used as a |method|: >
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9341 GetPos()->setcmdpos()
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9342
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9343 setcursorcharpos({lnum}, {col} [, {off}]) *setcursorcharpos()*
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9344 setcursorcharpos({list})
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9345 Same as |cursor()| but uses the specified column number as the
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9346 character index instead of the byte index in the line.
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9347
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9348 Example:
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9349 With the text "여보세요" in line 4: >
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9350 call setcursorcharpos(4, 3)
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9351 < positions the cursor on the third character '세'. >
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9352 call cursor(4, 3)
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9353 < positions the cursor on the first character '여'.
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9354
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9355 Can also be used as a |method|: >
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9356 GetCursorPos()->setcursorcharpos()
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9357
16604
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
9358 setenv({name}, {val}) *setenv()*
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
9359 Set environment variable {name} to {val}.
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
9360 When {val} is |v:null| the environment variable is deleted.
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
9361 See also |expr-env|.
1e0a5f09fdf1 patch 8.1.1305: there is no easy way to manipulate environment variables
Bram Moolenaar <Bram@vim.org>
parents: 16600
diff changeset
9362
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9363 Can also be used as a |method|, the base is passed as the
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9364 second argument: >
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9365 GetPath()->setenv('PATH')
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9366
8451
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9367 setfperm({fname}, {mode}) *setfperm()* *chmod*
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9368 Set the file permissions for {fname} to {mode}.
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9369 {mode} must be a string with 9 characters. It is of the form
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9370 "rwxrwxrwx", where each group of "rwx" flags represent, in
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9371 turn, the permissions of the owner of the file, the group the
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9372 file belongs to, and other users. A '-' character means the
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9373 permission is off, any other character means on. Multi-byte
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9374 characters are not supported.
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9375
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9376 For example "rw-r-----" means read-write for the user,
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9377 readable by the group, not accessible by others. "xx-x-----"
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9378 would do the same thing.
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9379
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9380 Returns non-zero for success, zero for failure.
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9381
17857
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
9382 Can also be used as a |method|: >
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
9383 GetFilename()->setfperm(mode)
4935244c1128 patch 8.1.1925: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17855
diff changeset
9384 <
8451
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9385 To read permissions see |getfperm()|.
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9386
c0b5c2b0a5ee commit https://github.com/vim/vim/commit/8049253b96838b3584600e5ad229abad37a95b10
Christian Brabandt <cb@256bit.org>
parents: 8440
diff changeset
9387
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9388 setline({lnum}, {text}) *setline()*
3312
b7811ab264bf updated for version 7.3.423
Bram Moolenaar <bram@vim.org>
parents: 3256
diff changeset
9389 Set line {lnum} of the current buffer to {text}. To insert
12319
c7e95667d14b patch 8.0.1039: cannot change a line in not current buffer
Christian Brabandt <cb@256bit.org>
parents: 12317
diff changeset
9390 lines use |append()|. To set lines in another buffer use
15378
0d76dd701e49 patch 8.1.0697: ":sign place" requires the buffer argument
Bram Moolenaar <Bram@vim.org>
parents: 15335
diff changeset
9391 |setbufline()|. Any text properties in {lnum} are cleared.
12319
c7e95667d14b patch 8.0.1039: cannot change a line in not current buffer
Christian Brabandt <cb@256bit.org>
parents: 12317
diff changeset
9392
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 233
diff changeset
9393 {lnum} is used like with |getline()|.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9394 When {lnum} is just below the last line the {text} will be
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9395 added below the last line.
12319
c7e95667d14b patch 8.0.1039: cannot change a line in not current buffer
Christian Brabandt <cb@256bit.org>
parents: 12317
diff changeset
9396
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 233
diff changeset
9397 If this succeeds, 0 is returned. If this fails (most likely
12319
c7e95667d14b patch 8.0.1039: cannot change a line in not current buffer
Christian Brabandt <cb@256bit.org>
parents: 12317
diff changeset
9398 because {lnum} is invalid) 1 is returned.
c7e95667d14b patch 8.0.1039: cannot change a line in not current buffer
Christian Brabandt <cb@256bit.org>
parents: 12317
diff changeset
9399
c7e95667d14b patch 8.0.1039: cannot change a line in not current buffer
Christian Brabandt <cb@256bit.org>
parents: 12317
diff changeset
9400 Example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9401 :call setline(5, strftime("%c"))
12319
c7e95667d14b patch 8.0.1039: cannot change a line in not current buffer
Christian Brabandt <cb@256bit.org>
parents: 12317
diff changeset
9402
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9403 < When {text} is a |List| then line {lnum} and following lines
282
33d9c918b8ab updated for version 7.0075
vimboss
parents: 277
diff changeset
9404 will be set to the items in the list. Example: >
33d9c918b8ab updated for version 7.0075
vimboss
parents: 277
diff changeset
9405 :call setline(5, ['aaa', 'bbb', 'ccc'])
33d9c918b8ab updated for version 7.0075
vimboss
parents: 277
diff changeset
9406 < This is equivalent to: >
3465
161d01cbb165 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
9407 :for [n, l] in [[5, 'aaa'], [6, 'bbb'], [7, 'ccc']]
282
33d9c918b8ab updated for version 7.0075
vimboss
parents: 277
diff changeset
9408 : call setline(n, l)
33d9c918b8ab updated for version 7.0075
vimboss
parents: 277
diff changeset
9409 :endfor
12427
fc3e2d5614dd patch 8.0.1093: various small quickfix issues
Christian Brabandt <cb@256bit.org>
parents: 12389
diff changeset
9410
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9411 < Note: The '[ and '] marks are not set.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9412
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9413 Can also be used as a |method|, the base is passed as the
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9414 second argument: >
17994
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9415 GetText()->setline(lnum)
0dcc2ee838dd patch 8.1.1993: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17982
diff changeset
9416
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
9417 setloclist({nr}, {list} [, {action} [, {what}]]) *setloclist()*
647
19106f131c87 updated for version 7.0188
vimboss
parents: 644
diff changeset
9418 Create or replace or add to the location list for window {nr}.
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
9419 {nr} can be the window number or the |window-ID|.
9223
6c4d610fce0a commit https://github.com/vim/vim/commit/888ccac8902cee186fbd47e971881f6d9b19c068
Christian Brabandt <cb@256bit.org>
parents: 9221
diff changeset
9420 When {nr} is zero the current window is used.
6c4d610fce0a commit https://github.com/vim/vim/commit/888ccac8902cee186fbd47e971881f6d9b19c068
Christian Brabandt <cb@256bit.org>
parents: 9221
diff changeset
9421
6c4d610fce0a commit https://github.com/vim/vim/commit/888ccac8902cee186fbd47e971881f6d9b19c068
Christian Brabandt <cb@256bit.org>
parents: 9221
diff changeset
9422 For a location list window, the displayed location list is
6c4d610fce0a commit https://github.com/vim/vim/commit/888ccac8902cee186fbd47e971881f6d9b19c068
Christian Brabandt <cb@256bit.org>
parents: 9221
diff changeset
9423 modified. For an invalid window number {nr}, -1 is returned.
1326
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
9424 Otherwise, same as |setqflist()|.
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
9425 Also see |location-list|.
22886f3d882d updated for version 7.1-040
vimboss
parents: 1317
diff changeset
9426
21250
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
9427 For {action} see |setqflist-action|.
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
9428
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
9429 If the optional {what} dictionary argument is supplied, then
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
9430 only the items listed in {what} are set. Refer to |setqflist()|
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
9431 for the list of supported keys in {what}.
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
9432
18000
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9433 Can also be used as a |method|, the base is passed as the
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9434 second argument: >
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9435 GetLoclist()->setloclist(winnr)
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9436
16158
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
9437 setmatches({list} [, {win}]) *setmatches()*
20178
2fb397573541 patch 8.2.0644: insufficient testing for invalid function arguments
Bram Moolenaar <Bram@vim.org>
parents: 20115
diff changeset
9438 Restores a list of matches saved by |getmatches()| for the
2fb397573541 patch 8.2.0644: insufficient testing for invalid function arguments
Bram Moolenaar <Bram@vim.org>
parents: 20115
diff changeset
9439 current window. Returns 0 if successful, otherwise -1. All
16127
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
9440 current matches are cleared before the list is restored. See
0375e54f0adc patch 8.1.1068: cannot get all the information about current completion
Bram Moolenaar <Bram@vim.org>
parents: 16103
diff changeset
9441 example for |getmatches()|.
16158
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
9442 If {win} is specified, use the window with this number or
aef0f93d3eba patch 8.1.1084: cannot delete a match from another window
Bram Moolenaar <Bram@vim.org>
parents: 16133
diff changeset
9443 window ID instead of the current window.
230
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
9444
18000
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9445 Can also be used as a |method|: >
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9446 GetMatches()->setmatches()
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9447 <
707
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9448 *setpos()*
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9449 setpos({expr}, {list})
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9450 Set the position for {expr}. Possible values:
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9451 . the cursor
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9452 'x mark x
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9453
5938
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
9454 {list} must be a |List| with four or five numbers:
707
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9455 [bufnum, lnum, col, off]
5938
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
9456 [bufnum, lnum, col, off, curswant]
707
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9457
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
9458 "bufnum" is the buffer number. Zero can be used for the
10730
44e9340dc604 patch 8.0.0255: setpos() does not use the buffer argument for all marks
Christian Brabandt <cb@256bit.org>
parents: 10722
diff changeset
9459 current buffer. When setting an uppercase mark "bufnum" is
44e9340dc604 patch 8.0.0255: setpos() does not use the buffer argument for all marks
Christian Brabandt <cb@256bit.org>
parents: 10722
diff changeset
9460 used for the mark position. For other marks it specifies the
44e9340dc604 patch 8.0.0255: setpos() does not use the buffer argument for all marks
Christian Brabandt <cb@256bit.org>
parents: 10722
diff changeset
9461 buffer to set the mark in. You can use the |bufnr()| function
44e9340dc604 patch 8.0.0255: setpos() does not use the buffer argument for all marks
Christian Brabandt <cb@256bit.org>
parents: 10722
diff changeset
9462 to turn a file name into a buffer number.
44e9340dc604 patch 8.0.0255: setpos() does not use the buffer argument for all marks
Christian Brabandt <cb@256bit.org>
parents: 10722
diff changeset
9463 For setting the cursor and the ' mark "bufnum" is ignored,
44e9340dc604 patch 8.0.0255: setpos() does not use the buffer argument for all marks
Christian Brabandt <cb@256bit.org>
parents: 10722
diff changeset
9464 since these are associated with a window, not a buffer.
798
95dac6af3b3a updated for version 7.0232
vimboss
parents: 794
diff changeset
9465 Does not change the jumplist.
707
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9466
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9467 "lnum" and "col" are the position in the buffer. The first
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
9468 column is 1. Use a zero "lnum" to delete a mark. If "col" is
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9469 smaller than 1 then 1 is used. To use the character count
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9470 instead of the byte count, use |setcharpos()|.
707
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9471
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9472 The "off" number is only used when 'virtualedit' is set. Then
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9473 it is the offset in screen columns from the start of the
1266
54588e2e8041 updated for version 7.1
vimboss
parents: 1215
diff changeset
9474 character. E.g., a position within a <Tab> or after the last
707
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9475 character.
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9476
5938
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
9477 The "curswant" number is only used when setting the cursor
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
9478 position. It sets the preferred column for when moving the
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
9479 cursor vertically. When the "curswant" number is missing the
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
9480 preferred column is not set. When it is present and setting a
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
9481 mark position it is not used.
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
9482
5555
7818ca6de3d0 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5466
diff changeset
9483 Note that for '< and '> changing the line number may result in
7818ca6de3d0 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5466
diff changeset
9484 the marks to be effectively be swapped, so that '< is always
7818ca6de3d0 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5466
diff changeset
9485 before '>.
7818ca6de3d0 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5466
diff changeset
9486
1533
8abc0abf8cbd updated for version 7.1-248
vimboss
parents: 1504
diff changeset
9487 Returns 0 when the position could be set, -1 otherwise.
8abc0abf8cbd updated for version 7.1-248
vimboss
parents: 1504
diff changeset
9488 An error message is given if {expr} is invalid.
8abc0abf8cbd updated for version 7.1-248
vimboss
parents: 1504
diff changeset
9489
23563
87671ccc6c6b patch 8.2.2324: not easy to get mark en cursor posotion by character count
Bram Moolenaar <Bram@vim.org>
parents: 23475
diff changeset
9490 Also see |setcharpos()|, |getpos()| and |getcurpos()|.
707
111b7dcc8a17 updated for version 7.0213
vimboss
parents: 703
diff changeset
9491
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
9492 This does not restore the preferred column for moving
5938
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
9493 vertically; if you set the cursor position with this, |j| and
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
9494 |k| motions will jump to previous columns! Use |cursor()| to
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
9495 also set the preferred column. Also see the "curswant" key in
ccac0aa34eea updated for version 7.4.310
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
9496 |winrestview()|.
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
9497
18000
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9498 Can also be used as a |method|: >
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9499 GetPosition()->setpos('.')
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9500
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
9501 setqflist({list} [, {action} [, {what}]]) *setqflist()*
12048
ebd313aa5a6c patch 8.0.0904: cannot set a location list from text
Christian Brabandt <cb@256bit.org>
parents: 12045
diff changeset
9502 Create or replace or add to the quickfix list.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
9503
19646
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
9504 If the optional {what} dictionary argument is supplied, then
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
9505 only the items listed in {what} are set. The first {list}
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
9506 argument is ignored. See below for the supported items in
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
9507 {what}.
21250
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
9508 *setqflist-what*
21676
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
9509 When {what} is not present, the items in {list} are used. Each
12048
ebd313aa5a6c patch 8.0.0904: cannot set a location list from text
Christian Brabandt <cb@256bit.org>
parents: 12045
diff changeset
9510 item must be a dictionary. Non-dictionary items in {list} are
ebd313aa5a6c patch 8.0.0904: cannot set a location list from text
Christian Brabandt <cb@256bit.org>
parents: 12045
diff changeset
9511 ignored. Each dictionary item can contain the following
ebd313aa5a6c patch 8.0.0904: cannot set a location list from text
Christian Brabandt <cb@256bit.org>
parents: 12045
diff changeset
9512 entries:
230
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
9513
1065
caa550fe4457 updated for version 7.0-191
vimboss
parents: 1029
diff changeset
9514 bufnr buffer number; must be the number of a valid
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9515 buffer
1065
caa550fe4457 updated for version 7.0-191
vimboss
parents: 1029
diff changeset
9516 filename name of a file; only used when "bufnr" is not
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9517 present or it is invalid.
13821
98274127d675 patch 8.0.1782: no simple way to label quickfix entries
Christian Brabandt <cb@256bit.org>
parents: 13818
diff changeset
9518 module name of a module; if given it will be used in
98274127d675 patch 8.0.1782: no simple way to label quickfix entries
Christian Brabandt <cb@256bit.org>
parents: 13818
diff changeset
9519 quickfix error window instead of the filename.
230
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
9520 lnum line number in the file
233
fca8a9b65afa updated for version 7.0065
vimboss
parents: 230
diff changeset
9521 pattern search pattern used to locate the error
230
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
9522 col column number
233
fca8a9b65afa updated for version 7.0065
vimboss
parents: 230
diff changeset
9523 vcol when non-zero: "col" is visual column
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
9524 when zero: "col" is byte index
233
fca8a9b65afa updated for version 7.0065
vimboss
parents: 230
diff changeset
9525 nr error number
230
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
9526 text description of the error
233
fca8a9b65afa updated for version 7.0065
vimboss
parents: 230
diff changeset
9527 type single-character error type, 'E', 'W', etc.
11390
73cfcf11d983 patch 8.0.0580: cannot set the valid flag with setqflist()
Christian Brabandt <cb@256bit.org>
parents: 11347
diff changeset
9528 valid recognized error message
233
fca8a9b65afa updated for version 7.0065
vimboss
parents: 230
diff changeset
9529
fca8a9b65afa updated for version 7.0065
vimboss
parents: 230
diff changeset
9530 The "col", "vcol", "nr", "type" and "text" entries are
fca8a9b65afa updated for version 7.0065
vimboss
parents: 230
diff changeset
9531 optional. Either "lnum" or "pattern" entry can be used to
fca8a9b65afa updated for version 7.0065
vimboss
parents: 230
diff changeset
9532 locate a matching error line.
1065
caa550fe4457 updated for version 7.0-191
vimboss
parents: 1029
diff changeset
9533 If the "filename" and "bufnr" entries are not present or
caa550fe4457 updated for version 7.0-191
vimboss
parents: 1029
diff changeset
9534 neither the "lnum" or "pattern" entries are present, then the
caa550fe4457 updated for version 7.0-191
vimboss
parents: 1029
diff changeset
9535 item will not be handled as an error line.
230
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
9536 If both "pattern" and "lnum" are present then "pattern" will
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
9537 be used.
11390
73cfcf11d983 patch 8.0.0580: cannot set the valid flag with setqflist()
Christian Brabandt <cb@256bit.org>
parents: 11347
diff changeset
9538 If the "valid" entry is not supplied, then the valid flag is
73cfcf11d983 patch 8.0.0580: cannot set the valid flag with setqflist()
Christian Brabandt <cb@256bit.org>
parents: 11347
diff changeset
9539 set when "bufnr" is a valid buffer or "filename" exists.
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2120
diff changeset
9540 If you supply an empty {list}, the quickfix list will be
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2120
diff changeset
9541 cleared.
1065
caa550fe4457 updated for version 7.0-191
vimboss
parents: 1029
diff changeset
9542 Note that the list is not exactly the same as what
caa550fe4457 updated for version 7.0-191
vimboss
parents: 1029
diff changeset
9543 |getqflist()| returns.
230
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
9544
21250
21fb2a3ad3ca Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21230
diff changeset
9545 {action} values: *setqflist-action* *E927*
11263
ae5f9f26f81c patch 8.0.0517: there is no way to remove quickfix lists
Christian Brabandt <cb@256bit.org>
parents: 11262
diff changeset
9546 'a' The items from {list} are added to the existing
ae5f9f26f81c patch 8.0.0517: there is no way to remove quickfix lists
Christian Brabandt <cb@256bit.org>
parents: 11262
diff changeset
9547 quickfix list. If there is no existing list, then a
ae5f9f26f81c patch 8.0.0517: there is no way to remove quickfix lists
Christian Brabandt <cb@256bit.org>
parents: 11262
diff changeset
9548 new list is created.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
9549
11263
ae5f9f26f81c patch 8.0.0517: there is no way to remove quickfix lists
Christian Brabandt <cb@256bit.org>
parents: 11262
diff changeset
9550 'r' The items from the current quickfix list are replaced
ae5f9f26f81c patch 8.0.0517: there is no way to remove quickfix lists
Christian Brabandt <cb@256bit.org>
parents: 11262
diff changeset
9551 with the items from {list}. This can also be used to
ae5f9f26f81c patch 8.0.0517: there is no way to remove quickfix lists
Christian Brabandt <cb@256bit.org>
parents: 11262
diff changeset
9552 clear the list: >
ae5f9f26f81c patch 8.0.0517: there is no way to remove quickfix lists
Christian Brabandt <cb@256bit.org>
parents: 11262
diff changeset
9553 :call setqflist([], 'r')
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
9554 <
11263
ae5f9f26f81c patch 8.0.0517: there is no way to remove quickfix lists
Christian Brabandt <cb@256bit.org>
parents: 11262
diff changeset
9555 'f' All the quickfix lists in the quickfix stack are
ae5f9f26f81c patch 8.0.0517: there is no way to remove quickfix lists
Christian Brabandt <cb@256bit.org>
parents: 11262
diff changeset
9556 freed.
ae5f9f26f81c patch 8.0.0517: there is no way to remove quickfix lists
Christian Brabandt <cb@256bit.org>
parents: 11262
diff changeset
9557
9221
17fa362f10be commit https://github.com/vim/vim/commit/511972d810ea490955161ff5097ec2f57919ceaf
Christian Brabandt <cb@256bit.org>
parents: 9219
diff changeset
9558 If {action} is not present or is set to ' ', then a new list
12084
69ce6b3f0834 patch 8.0.0922: quickfix list always added after current one
Christian Brabandt <cb@256bit.org>
parents: 12076
diff changeset
9559 is created. The new quickfix list is added after the current
69ce6b3f0834 patch 8.0.0922: quickfix list always added after current one
Christian Brabandt <cb@256bit.org>
parents: 12076
diff changeset
9560 quickfix list in the stack and all the following lists are
69ce6b3f0834 patch 8.0.0922: quickfix list always added after current one
Christian Brabandt <cb@256bit.org>
parents: 12076
diff changeset
9561 freed. To add a new quickfix list at the end of the stack,
12321
2779d593a706 patch 8.0.1040: cannot use another error format in getqflist()
Christian Brabandt <cb@256bit.org>
parents: 12319
diff changeset
9562 set "nr" in {what} to "$".
277
fe16c18c24a7 updated for version 7.0074
vimboss
parents: 270
diff changeset
9563
19646
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
9564 The following items can be specified in dictionary {what}:
13818
28ac7914b2b6 Update runtime files and translations
Christian Brabandt <cb@256bit.org>
parents: 13796
diff changeset
9565 context quickfix list context. See |quickfix-context|
12321
2779d593a706 patch 8.0.1040: cannot use another error format in getqflist()
Christian Brabandt <cb@256bit.org>
parents: 12319
diff changeset
9566 efm errorformat to use when parsing text from
2779d593a706 patch 8.0.1040: cannot use another error format in getqflist()
Christian Brabandt <cb@256bit.org>
parents: 12319
diff changeset
9567 "lines". If this is not present, then the
2779d593a706 patch 8.0.1040: cannot use another error format in getqflist()
Christian Brabandt <cb@256bit.org>
parents: 12319
diff changeset
9568 'errorformat' option value is used.
15424
90c8ff9c19ee patch 8.1.0720: cannot easily change the current quickfx list index
Bram Moolenaar <Bram@vim.org>
parents: 15418
diff changeset
9569 See |quickfix-parse|
12287
20641a7e1fc9 patch 8.0.1023: it is not easy to identify a quickfix list
Christian Brabandt <cb@256bit.org>
parents: 12273
diff changeset
9570 id quickfix list identifier |quickfix-ID|
15424
90c8ff9c19ee patch 8.1.0720: cannot easily change the current quickfx list index
Bram Moolenaar <Bram@vim.org>
parents: 15418
diff changeset
9571 idx index of the current entry in the quickfix
90c8ff9c19ee patch 8.1.0720: cannot easily change the current quickfx list index
Bram Moolenaar <Bram@vim.org>
parents: 15418
diff changeset
9572 list specified by 'id' or 'nr'. If set to '$',
90c8ff9c19ee patch 8.1.0720: cannot easily change the current quickfx list index
Bram Moolenaar <Bram@vim.org>
parents: 15418
diff changeset
9573 then the last entry in the list is set as the
90c8ff9c19ee patch 8.1.0720: cannot easily change the current quickfx list index
Bram Moolenaar <Bram@vim.org>
parents: 15418
diff changeset
9574 current entry. See |quickfix-index|
11549
f5add45f9848 patch 8.0.0657: cannot get and set quickfix list items
Christian Brabandt <cb@256bit.org>
parents: 11543
diff changeset
9575 items list of quickfix entries. Same as the {list}
f5add45f9848 patch 8.0.0657: cannot get and set quickfix list items
Christian Brabandt <cb@256bit.org>
parents: 11543
diff changeset
9576 argument.
12303
ec7a4fd21dd5 patch 8.0.1031: "text" argument for getqflist() is confusing
Christian Brabandt <cb@256bit.org>
parents: 12287
diff changeset
9577 lines use 'errorformat' to parse a list of lines and
ec7a4fd21dd5 patch 8.0.1031: "text" argument for getqflist() is confusing
Christian Brabandt <cb@256bit.org>
parents: 12287
diff changeset
9578 add the resulting entries to the quickfix list
ec7a4fd21dd5 patch 8.0.1031: "text" argument for getqflist() is confusing
Christian Brabandt <cb@256bit.org>
parents: 12287
diff changeset
9579 {nr} or {id}. Only a |List| value is supported.
15424
90c8ff9c19ee patch 8.1.0720: cannot easily change the current quickfx list index
Bram Moolenaar <Bram@vim.org>
parents: 15418
diff changeset
9580 See |quickfix-parse|
11502
46bbef0ee9a6 patch 8.0.0634: cannot easily get to the last quickfix list
Christian Brabandt <cb@256bit.org>
parents: 11473
diff changeset
9581 nr list number in the quickfix stack; zero
12321
2779d593a706 patch 8.0.1040: cannot use another error format in getqflist()
Christian Brabandt <cb@256bit.org>
parents: 12319
diff changeset
9582 means the current quickfix list and "$" means
15424
90c8ff9c19ee patch 8.1.0720: cannot easily change the current quickfx list index
Bram Moolenaar <Bram@vim.org>
parents: 15418
diff changeset
9583 the last quickfix list.
20631
d6827bd31d1d patch 8.2.0869: it is not possible to customize the quickfix window contents
Bram Moolenaar <Bram@vim.org>
parents: 20629
diff changeset
9584 quickfixtextfunc
d6827bd31d1d patch 8.2.0869: it is not possible to customize the quickfix window contents
Bram Moolenaar <Bram@vim.org>
parents: 20629
diff changeset
9585 function to get the text to display in the
21409
2c40e60017a8 patch 8.2.1255: cannot use a lambda with quickfix functions
Bram Moolenaar <Bram@vim.org>
parents: 21381
diff changeset
9586 quickfix window. The value can be the name of
2c40e60017a8 patch 8.2.1255: cannot use a lambda with quickfix functions
Bram Moolenaar <Bram@vim.org>
parents: 21381
diff changeset
9587 a function or a funcref or a lambda. Refer to
20631
d6827bd31d1d patch 8.2.0869: it is not possible to customize the quickfix window contents
Bram Moolenaar <Bram@vim.org>
parents: 20629
diff changeset
9588 |quickfix-window-function| for an explanation
d6827bd31d1d patch 8.2.0869: it is not possible to customize the quickfix window contents
Bram Moolenaar <Bram@vim.org>
parents: 20629
diff changeset
9589 of how to write the function and an example.
15424
90c8ff9c19ee patch 8.1.0720: cannot easily change the current quickfx list index
Bram Moolenaar <Bram@vim.org>
parents: 15418
diff changeset
9590 title quickfix list title text. See |quickfix-title|
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
9591 Unsupported keys in {what} are ignored.
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
9592 If the "nr" item is not present, then the current quickfix list
11609
6f11697fb92c patch 8.0.0687: minor issues related to quickfix
Christian Brabandt <cb@256bit.org>
parents: 11587
diff changeset
9593 is modified. When creating a new quickfix list, "nr" can be
6f11697fb92c patch 8.0.0687: minor issues related to quickfix
Christian Brabandt <cb@256bit.org>
parents: 11587
diff changeset
9594 set to a value one greater than the quickfix stack size.
12287
20641a7e1fc9 patch 8.0.1023: it is not easy to identify a quickfix list
Christian Brabandt <cb@256bit.org>
parents: 12273
diff changeset
9595 When modifying a quickfix list, to guarantee that the correct
12321
2779d593a706 patch 8.0.1040: cannot use another error format in getqflist()
Christian Brabandt <cb@256bit.org>
parents: 12319
diff changeset
9596 list is modified, "id" should be used instead of "nr" to
12287
20641a7e1fc9 patch 8.0.1023: it is not easy to identify a quickfix list
Christian Brabandt <cb@256bit.org>
parents: 12273
diff changeset
9597 specify the list.
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
9598
13818
28ac7914b2b6 Update runtime files and translations
Christian Brabandt <cb@256bit.org>
parents: 13796
diff changeset
9599 Examples (See also |setqflist-examples|): >
12303
ec7a4fd21dd5 patch 8.0.1031: "text" argument for getqflist() is confusing
Christian Brabandt <cb@256bit.org>
parents: 12287
diff changeset
9600 :call setqflist([], 'r', {'title': 'My search'})
ec7a4fd21dd5 patch 8.0.1031: "text" argument for getqflist() is confusing
Christian Brabandt <cb@256bit.org>
parents: 12287
diff changeset
9601 :call setqflist([], 'r', {'nr': 2, 'title': 'Errors'})
13818
28ac7914b2b6 Update runtime files and translations
Christian Brabandt <cb@256bit.org>
parents: 13796
diff changeset
9602 :call setqflist([], 'a', {'id':qfid, 'lines':["F1:10:L10"]})
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
9603 <
230
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
9604 Returns zero for success, -1 for failure.
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
9605
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
9606 This function can be used to create a quickfix list
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
9607 independent of the 'errorformat' setting. Use a command like
11400
0f8713fe20dc Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11390
diff changeset
9608 `:cc 1` to jump to the first position.
230
9281a51ca7a2 updated for version 7.0064
vimboss
parents: 216
diff changeset
9609
18000
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9610 Can also be used as a |method|, the base is passed as the
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9611 second argument: >
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9612 GetErrorlist()->setqflist()
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9613 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9614 *setreg()*
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 8094
diff changeset
9615 setreg({regname}, {value} [, {options}])
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9616 Set the register {regname} to {value}.
19783
546bdeef35f1 patch 8.2.0448: various functions not properly tested
Bram Moolenaar <Bram@vim.org>
parents: 19742
diff changeset
9617 If {regname} is "" or "@", the unnamed register '"' is used.
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
9618
20743
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
9619 {value} may be any value returned by |getreg()| or
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
9620 |getreginfo()|, including a |List| or |Dict|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9621 If {options} contains "a" or {regname} is upper case,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9622 then the value is appended.
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
9623
2423
71899235e72d Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
9624 {options} can also contain a register type specification:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9625 "c" or "v" |characterwise| mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9626 "l" or "V" |linewise| mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9627 "b" or "<CTRL-V>" |blockwise-visual| mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9628 If a number immediately follows "b" or "<CTRL-V>" then this is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9629 used as the width of the selection - if it is not specified
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9630 then the width of the block is set to the number of characters
1266
54588e2e8041 updated for version 7.1
vimboss
parents: 1215
diff changeset
9631 in the longest line (counting a <Tab> as 1 character).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9632
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9633 If {options} contains no register settings, then the default
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
9634 is to use character mode unless {value} ends in a <NL> for
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
9635 string {value} and linewise mode for list {value}. Blockwise
5798
9f8fa56f1906 updated for version 7.4.243
Bram Moolenaar <bram@vim.org>
parents: 5796
diff changeset
9636 mode is never selected automatically.
9f8fa56f1906 updated for version 7.4.243
Bram Moolenaar <bram@vim.org>
parents: 5796
diff changeset
9637 Returns zero for success, non-zero for failure.
9f8fa56f1906 updated for version 7.4.243
Bram Moolenaar <bram@vim.org>
parents: 5796
diff changeset
9638
9f8fa56f1906 updated for version 7.4.243
Bram Moolenaar <bram@vim.org>
parents: 5796
diff changeset
9639 *E883*
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
9640 Note: you may not use |List| containing more than one item to
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
9641 set search and expression registers. Lists containing no
5798
9f8fa56f1906 updated for version 7.4.243
Bram Moolenaar <bram@vim.org>
parents: 5796
diff changeset
9642 items act like empty strings.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9643
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9644 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9645 :call setreg(v:register, @*)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9646 :call setreg('*', @%, 'ac')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9647 :call setreg('a', "1\n2\n3", 'b5')
20743
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
9648 :call setreg('"', { 'points_to': 'a'})
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9649
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9650 < This example shows using the functions to save and restore a
12427
fc3e2d5614dd patch 8.0.1093: various small quickfix issues
Christian Brabandt <cb@256bit.org>
parents: 12389
diff changeset
9651 register: >
20743
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
9652 :let var_a = getreginfo()
a672feb8fc4f patch 8.2.0924: cannot save and restore a register properly
Bram Moolenaar <Bram@vim.org>
parents: 20725
diff changeset
9653 :call setreg('a', var_a)
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
9654 < or: >
5798
9f8fa56f1906 updated for version 7.4.243
Bram Moolenaar <bram@vim.org>
parents: 5796
diff changeset
9655 :let var_a = getreg('a', 1, 1)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9656 :let var_amode = getregtype('a')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9657 ....
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9658 :call setreg('a', var_a, var_amode)
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
9659 < Note: you may not reliably restore register value
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
9660 without using the third argument to |getreg()| as without it
12427
fc3e2d5614dd patch 8.0.1093: various small quickfix issues
Christian Brabandt <cb@256bit.org>
parents: 12389
diff changeset
9661 newlines are represented as newlines AND Nul bytes are
fc3e2d5614dd patch 8.0.1093: various small quickfix issues
Christian Brabandt <cb@256bit.org>
parents: 12389
diff changeset
9662 represented as newlines as well, see |NL-used-for-Nul|.
fc3e2d5614dd patch 8.0.1093: various small quickfix issues
Christian Brabandt <cb@256bit.org>
parents: 12389
diff changeset
9663
fc3e2d5614dd patch 8.0.1093: various small quickfix issues
Christian Brabandt <cb@256bit.org>
parents: 12389
diff changeset
9664 You can also change the type of a register by appending
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9665 nothing: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9666 :call setreg('a', '', 'al')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9667
18000
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9668 < Can also be used as a |method|, the base is passed as the
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9669 second argument: >
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9670 GetText()->setreg('a')
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9671
2207
b17bbfa96fa0 Add the settabvar() and gettabvar() functions.
Bram Moolenaar <bram@vim.org>
parents: 2206
diff changeset
9672 settabvar({tabnr}, {varname}, {val}) *settabvar()*
b17bbfa96fa0 Add the settabvar() and gettabvar() functions.
Bram Moolenaar <bram@vim.org>
parents: 2206
diff changeset
9673 Set tab-local variable {varname} to {val} in tab page {tabnr}.
b17bbfa96fa0 Add the settabvar() and gettabvar() functions.
Bram Moolenaar <bram@vim.org>
parents: 2206
diff changeset
9674 |t:var|
16849
629f3d3b6886 patch 8.1.1426: no test for syntax highlight in popup window
Bram Moolenaar <Bram@vim.org>
parents: 16833
diff changeset
9675 Note that autocommands are blocked, side effects may not be
629f3d3b6886 patch 8.1.1426: no test for syntax highlight in popup window
Bram Moolenaar <Bram@vim.org>
parents: 16833
diff changeset
9676 triggered, e.g. when setting 'filetype'.
2207
b17bbfa96fa0 Add the settabvar() and gettabvar() functions.
Bram Moolenaar <bram@vim.org>
parents: 2206
diff changeset
9677 Note that the variable name without "t:" must be used.
b17bbfa96fa0 Add the settabvar() and gettabvar() functions.
Bram Moolenaar <bram@vim.org>
parents: 2206
diff changeset
9678 Tabs are numbered starting with one.
b17bbfa96fa0 Add the settabvar() and gettabvar() functions.
Bram Moolenaar <bram@vim.org>
parents: 2206
diff changeset
9679 This function is not available in the |sandbox|.
b17bbfa96fa0 Add the settabvar() and gettabvar() functions.
Bram Moolenaar <bram@vim.org>
parents: 2206
diff changeset
9680
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9681 Can also be used as a |method|, the base is passed as the
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9682 third argument: >
18000
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9683 GetValue()->settabvar(tab, name)
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9684
831
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
9685 settabwinvar({tabnr}, {winnr}, {varname}, {val}) *settabwinvar()*
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
9686 Set option or local variable {varname} in window {winnr} to
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
9687 {val}.
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
9688 Tabs are numbered starting with one. For the current tabpage
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
9689 use |setwinvar()|.
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
9690 {winnr} can be the window number or the |window-ID|.
831
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
9691 When {winnr} is zero the current window is used.
16849
629f3d3b6886 patch 8.1.1426: no test for syntax highlight in popup window
Bram Moolenaar <Bram@vim.org>
parents: 16833
diff changeset
9692 Note that autocommands are blocked, side effects may not be
629f3d3b6886 patch 8.1.1426: no test for syntax highlight in popup window
Bram Moolenaar <Bram@vim.org>
parents: 16833
diff changeset
9693 triggered, e.g. when setting 'filetype' or 'syntax'.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9694 This also works for a global or local buffer option, but it
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9695 doesn't work for a global or local buffer variable.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9696 For a local buffer option the global value is unchanged.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9697 Note that the variable name without "w:" must be used.
831
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
9698 Examples: >
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
9699 :call settabwinvar(1, 1, "&list", 0)
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
9700 :call settabwinvar(3, 2, "myvar", "foobar")
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
9701 < This function is not available in the |sandbox|.
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
9702
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9703 Can also be used as a |method|, the base is passed as the
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9704 fourth argument: >
18000
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9705 GetValue()->settabvar(tab, winnr, name)
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9706
15016
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9707 settagstack({nr}, {dict} [, {action}]) *settagstack()*
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9708 Modify the tag stack of the window {nr} using {dict}.
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9709 {nr} can be the window number or the |window-ID|.
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9710
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9711 For a list of supported items in {dict}, refer to
19033
f0312cf3c792 patch 8.2.0077: settagstack() cannot truncate at current index
Bram Moolenaar <Bram@vim.org>
parents: 18987
diff changeset
9712 |gettagstack()|. "curidx" takes effect before changing the tag
f0312cf3c792 patch 8.2.0077: settagstack() cannot truncate at current index
Bram Moolenaar <Bram@vim.org>
parents: 18987
diff changeset
9713 stack.
15016
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9714 *E962*
19033
f0312cf3c792 patch 8.2.0077: settagstack() cannot truncate at current index
Bram Moolenaar <Bram@vim.org>
parents: 18987
diff changeset
9715 How the tag stack is modified depends on the {action}
f0312cf3c792 patch 8.2.0077: settagstack() cannot truncate at current index
Bram Moolenaar <Bram@vim.org>
parents: 18987
diff changeset
9716 argument:
f0312cf3c792 patch 8.2.0077: settagstack() cannot truncate at current index
Bram Moolenaar <Bram@vim.org>
parents: 18987
diff changeset
9717 - If {action} is not present or is set to 'r', then the tag
f0312cf3c792 patch 8.2.0077: settagstack() cannot truncate at current index
Bram Moolenaar <Bram@vim.org>
parents: 18987
diff changeset
9718 stack is replaced.
f0312cf3c792 patch 8.2.0077: settagstack() cannot truncate at current index
Bram Moolenaar <Bram@vim.org>
parents: 18987
diff changeset
9719 - If {action} is set to 'a', then new entries from {dict} are
f0312cf3c792 patch 8.2.0077: settagstack() cannot truncate at current index
Bram Moolenaar <Bram@vim.org>
parents: 18987
diff changeset
9720 pushed (added) onto the tag stack.
f0312cf3c792 patch 8.2.0077: settagstack() cannot truncate at current index
Bram Moolenaar <Bram@vim.org>
parents: 18987
diff changeset
9721 - If {action} is set to 't', then all the entries from the
f0312cf3c792 patch 8.2.0077: settagstack() cannot truncate at current index
Bram Moolenaar <Bram@vim.org>
parents: 18987
diff changeset
9722 current entry in the tag stack or "curidx" in {dict} are
f0312cf3c792 patch 8.2.0077: settagstack() cannot truncate at current index
Bram Moolenaar <Bram@vim.org>
parents: 18987
diff changeset
9723 removed and then new entries are pushed to the stack.
f0312cf3c792 patch 8.2.0077: settagstack() cannot truncate at current index
Bram Moolenaar <Bram@vim.org>
parents: 18987
diff changeset
9724
f0312cf3c792 patch 8.2.0077: settagstack() cannot truncate at current index
Bram Moolenaar <Bram@vim.org>
parents: 18987
diff changeset
9725 The current index is set to one after the length of the tag
f0312cf3c792 patch 8.2.0077: settagstack() cannot truncate at current index
Bram Moolenaar <Bram@vim.org>
parents: 18987
diff changeset
9726 stack after the modification.
15016
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9727
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9728 Returns zero for success, -1 for failure.
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9729
21676
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
9730 Examples (for more examples see |tagstack-examples|):
19968
1908e92b02fd Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19952
diff changeset
9731 Empty the tag stack of window 3: >
15016
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9732 call settagstack(3, {'items' : []})
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9733
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9734 < Save and restore the tag stack: >
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9735 let stack = gettagstack(1003)
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9736 " do something else
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9737 call settagstack(1003, stack)
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9738 unlet stack
c338c91086b9 patch 8.1.0519: cannot save and restore the tag stack
Bram Moolenaar <Bram@vim.org>
parents: 15008
diff changeset
9739 <
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9740 Can also be used as a |method|, the base is passed as the
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9741 second argument: >
18000
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9742 GetStack()->settagstack(winnr)
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9743
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9744 setwinvar({winnr}, {varname}, {val}) *setwinvar()*
831
f24a95dae8ee updated for version 7.0d05
vimboss
parents: 829
diff changeset
9745 Like |settabwinvar()| for the current tab page.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9746 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9747 :call setwinvar(1, "&list", 0)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9748 :call setwinvar(2, "myvar", "foobar")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9749
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9750 < Can also be used as a |method|, the base is passed as the
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
9751 third argument: >
18000
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9752 GetValue()->setwinvar(winnr, name)
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9753
4126
2b340e5c5baa updated for version 7.3.816
Bram Moolenaar <bram@vim.org>
parents: 4073
diff changeset
9754 sha256({string}) *sha256()*
6647
3af822eb4da5 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6583
diff changeset
9755 Returns a String with 64 hex characters, which is the SHA256
4126
2b340e5c5baa updated for version 7.3.816
Bram Moolenaar <bram@vim.org>
parents: 4073
diff changeset
9756 checksum of {string}.
18000
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9757
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9758 Can also be used as a |method|: >
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9759 GetText()->sha256()
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9760
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9761 < {only available when compiled with the |+cryptv| feature}
4126
2b340e5c5baa updated for version 7.3.816
Bram Moolenaar <bram@vim.org>
parents: 4073
diff changeset
9762
1661
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
9763 shellescape({string} [, {special}]) *shellescape()*
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
9764 Escape {string} for use as a shell command argument.
17620
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
9765 On MS-Windows, when 'shellslash' is not set, it will enclose
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
9766 {string} in double quotes and double all double quotes within
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
9767 {string}.
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
9768 Otherwise it will enclose {string} in single quotes and
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
9769 replace all "'" with "'\''".
11502
46bbef0ee9a6 patch 8.0.0634: cannot easily get to the last quickfix list
Christian Brabandt <cb@256bit.org>
parents: 11473
diff changeset
9770
1661
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
9771 When the {special} argument is present and it's a non-zero
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
9772 Number or a non-empty String (|non-zero-arg|), then special
1698
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
9773 items such as "!", "%", "#" and "<cword>" will be preceded by
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
9774 a backslash. This backslash will be removed again by the |:!|
1661
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
9775 command.
11502
46bbef0ee9a6 patch 8.0.0634: cannot easily get to the last quickfix list
Christian Brabandt <cb@256bit.org>
parents: 11473
diff changeset
9776
1698
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
9777 The "!" character will be escaped (again with a |non-zero-arg|
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
9778 {special}) when 'shell' contains "csh" in the tail. That is
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
9779 because for csh and tcsh "!" is used for history replacement
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
9780 even when inside single quotes.
11502
46bbef0ee9a6 patch 8.0.0634: cannot easily get to the last quickfix list
Christian Brabandt <cb@256bit.org>
parents: 11473
diff changeset
9781
46bbef0ee9a6 patch 8.0.0634: cannot easily get to the last quickfix list
Christian Brabandt <cb@256bit.org>
parents: 11473
diff changeset
9782 With a |non-zero-arg| {special} the <NL> character is also
46bbef0ee9a6 patch 8.0.0634: cannot easily get to the last quickfix list
Christian Brabandt <cb@256bit.org>
parents: 11473
diff changeset
9783 escaped. When 'shell' containing "csh" in the tail it's
1698
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
9784 escaped a second time.
11502
46bbef0ee9a6 patch 8.0.0634: cannot easily get to the last quickfix list
Christian Brabandt <cb@256bit.org>
parents: 11473
diff changeset
9785
1661
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
9786 Example of use with a |:!| command: >
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
9787 :exe '!dir ' . shellescape(expand('<cfile>'), 1)
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
9788 < This results in a directory listing for the file under the
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
9789 cursor. Example of use with |system()|: >
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
9790 :call system("chmod +w -- " . shellescape(expand("%")))
5690
40f18a1c1592 updated for version 7.4.191
Bram Moolenaar <bram@vim.org>
parents: 5663
diff changeset
9791 < See also |::S|.
985
656853d9c014 updated for version 7.0-111
vimboss
parents: 874
diff changeset
9792
18000
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9793 Can also be used as a |method|: >
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9794 GetCommand()->shellescape()
985
656853d9c014 updated for version 7.0-111
vimboss
parents: 874
diff changeset
9795
15062
3a94f7918980 patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents: 15033
diff changeset
9796 shiftwidth([{col}]) *shiftwidth()*
3875
8235ccf121bb updated for version 7.3.694
Bram Moolenaar <bram@vim.org>
parents: 3830
diff changeset
9797 Returns the effective value of 'shiftwidth'. This is the
8235ccf121bb updated for version 7.3.694
Bram Moolenaar <bram@vim.org>
parents: 3830
diff changeset
9798 'shiftwidth' value unless it is zero, in which case it is the
7782
3a99194bd187 commit https://github.com/vim/vim/commit/009d84a34f3678ec93921bee3bc05be2fd606264
Christian Brabandt <cb@256bit.org>
parents: 7742
diff changeset
9799 'tabstop' value. This function was introduced with patch
15062
3a94f7918980 patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents: 15033
diff changeset
9800 7.3.694 in 2012, everybody should have it by now (however it
3a94f7918980 patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents: 15033
diff changeset
9801 did not allow for the optional {col} argument until 8.1.542).
3a94f7918980 patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents: 15033
diff changeset
9802
3a94f7918980 patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents: 15033
diff changeset
9803 When there is one argument {col} this is used as column number
3a94f7918980 patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents: 15033
diff changeset
9804 for which to return the 'shiftwidth' value. This matters for the
3a94f7918980 patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents: 15033
diff changeset
9805 'vartabstop' feature. If the 'vartabstop' setting is enabled and
3a94f7918980 patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents: 15033
diff changeset
9806 no {col} argument is given, column 1 will be assumed.
15033
f8b0f1e42f2c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15016
diff changeset
9807
18000
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9808 Can also be used as a |method|: >
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9809 GetColumn()->shiftwidth()
7a19c8d6bb9e patch 8.1.1996: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17994
diff changeset
9810
17456
e414281d8bb4 patch 8.1.1726: the eval.txt help file is too big
Bram Moolenaar <Bram@vim.org>
parents: 17450
diff changeset
9811 sign_ functions are documented here: |sign-functions-details|
e414281d8bb4 patch 8.1.1726: the eval.txt help file is too big
Bram Moolenaar <Bram@vim.org>
parents: 17450
diff changeset
9812
e414281d8bb4 patch 8.1.1726: the eval.txt help file is too big
Bram Moolenaar <Bram@vim.org>
parents: 17450
diff changeset
9813
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9814 simplify({filename}) *simplify()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9815 Simplify the file name as much as possible without changing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9816 the meaning. Shortcuts (on MS-Windows) or symbolic links (on
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9817 Unix) are not resolved. If the first path component in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9818 {filename} designates the current directory, this will be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9819 valid for the result as well. A trailing path separator is
20965
59f93c2d2551 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20889
diff changeset
9820 not removed either. On Unix "//path" is unchanged, but
59f93c2d2551 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20889
diff changeset
9821 "///path" is simplified to "/path" (this follows the Posix
59f93c2d2551 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20889
diff changeset
9822 standard).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9823 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9824 simplify("./dir/.././/file/") == "./file/"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9825 < Note: The combination "dir/.." is only removed if "dir" is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9826 a searchable directory or does not exist. On Unix, it is also
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9827 removed when "dir" is a symbolic link within the same
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9828 directory. In order to resolve all the involved symbolic
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9829 links before simplifying the path name, use |resolve()|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9830
19952
82ea10d554fb patch 8.2.0532: cannot use simplify() as a method
Bram Moolenaar <Bram@vim.org>
parents: 19874
diff changeset
9831 Can also be used as a |method|: >
82ea10d554fb patch 8.2.0532: cannot use simplify() as a method
Bram Moolenaar <Bram@vim.org>
parents: 19874
diff changeset
9832 GetName()->simplify()
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
9833
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9834 sin({expr}) *sin()*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9835 Return the sine of {expr}, measured in radians, as a |Float|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9836 {expr} must evaluate to a |Float| or a |Number|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9837 Examples: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9838 :echo sin(100)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9839 < -0.506366 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9840 :echo sin(-4.01)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9841 < 0.763301
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
9842
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
9843 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
9844 Compute()->sin()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
9845 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9846 {only available when compiled with the |+float| feature}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
9847
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
9848
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
9849 sinh({expr}) *sinh()*
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
9850 Return the hyperbolic sine of {expr} as a |Float| in the range
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
9851 [-inf, inf].
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
9852 {expr} must evaluate to a |Float| or a |Number|.
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
9853 Examples: >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
9854 :echo sinh(0.5)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
9855 < 0.521095 >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
9856 :echo sinh(-0.9)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
9857 < -1.026517
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
9858
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
9859 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
9860 Compute()->sinh()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
9861 <
2570
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2569
diff changeset
9862 {only available when compiled with the |+float| feature}
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
9863
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
9864
2902
69e0783ed0ef updated for version 7.3.224
Bram Moolenaar <bram@vim.org>
parents: 2845
diff changeset
9865 sort({list} [, {func} [, {dict}]]) *sort()* *E702*
5747
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
9866 Sort the items in {list} in-place. Returns {list}.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
9867
5747
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
9868 If you want a list to remain unmodified make a copy first: >
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
9869 :let sortedlist = sort(copy(mylist))
5968
92751673cc37 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5944
diff changeset
9870
6009
7b83c190d370 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6007
diff changeset
9871 < When {func} is omitted, is empty or zero, then sort() uses the
7b83c190d370 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6007
diff changeset
9872 string representation of each item to sort on. Numbers sort
7b83c190d370 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6007
diff changeset
9873 after Strings, |Lists| after Numbers. For sorting text in the
7b83c190d370 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6007
diff changeset
9874 current buffer use |:sort|.
7b83c190d370 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6007
diff changeset
9875
6180
6921742f396a Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6153
diff changeset
9876 When {func} is given and it is '1' or 'i' then case is
6009
7b83c190d370 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6007
diff changeset
9877 ignored.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
9878
22824
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9879 When {func} is given and it is 'l' then the current collation
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9880 locale is used for ordering. Implementation details: strcoll()
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9881 is used to compare strings. See |:language| check or set the
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9882 collation locale. |v:collate| can also be used to check the
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9883 current locale. Sorting using the locale typically ignores
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9884 case. Example: >
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9885 " ö is sorted similarly to o with English locale.
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9886 :language collate en_US.UTF8
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9887 :echo sort(['n', 'o', 'O', 'ö', 'p', 'z'], 'l')
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9888 < ['n', 'o', 'O', 'ö', 'p', 'z'] ~
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9889 >
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9890 " ö is sorted after z with Swedish locale.
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9891 :language collate sv_SE.UTF8
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9892 :echo sort(['n', 'o', 'O', 'ö', 'p', 'z'], 'l')
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9893 < ['n', 'o', 'O', 'p', 'z', 'ö'] ~
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9894 This does not work properly on Mac.
22770
3e4981de5636 patch 8.2.1933: cannot sort using locale ordering
Bram Moolenaar <Bram@vim.org>
parents: 22723
diff changeset
9895
6009
7b83c190d370 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6007
diff changeset
9896 When {func} is given and it is 'n' then all items will be
22824
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
9897 sorted numerical (Implementation detail: this uses the
6009
7b83c190d370 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6007
diff changeset
9898 strtod() function to parse numbers, Strings, Lists, Dicts and
7b83c190d370 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6007
diff changeset
9899 Funcrefs will be considered as being 0).
7b83c190d370 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6007
diff changeset
9900
7291
6ffc75d807bd commit https://github.com/vim/vim/commit/b00da1d6d1655cb6e415f84ecc3be5ff3b790811
Christian Brabandt <cb@256bit.org>
parents: 7279
diff changeset
9901 When {func} is given and it is 'N' then all items will be
6ffc75d807bd commit https://github.com/vim/vim/commit/b00da1d6d1655cb6e415f84ecc3be5ff3b790811
Christian Brabandt <cb@256bit.org>
parents: 7279
diff changeset
9902 sorted numerical. This is like 'n' but a string containing
6ffc75d807bd commit https://github.com/vim/vim/commit/b00da1d6d1655cb6e415f84ecc3be5ff3b790811
Christian Brabandt <cb@256bit.org>
parents: 7279
diff changeset
9903 digits will be used as the number they represent.
6ffc75d807bd commit https://github.com/vim/vim/commit/b00da1d6d1655cb6e415f84ecc3be5ff3b790811
Christian Brabandt <cb@256bit.org>
parents: 7279
diff changeset
9904
7707
41768bcebc9b commit https://github.com/vim/vim/commit/13d5aeef56e3140a8eb8f40c7062aa1c5700f76e
Christian Brabandt <cb@256bit.org>
parents: 7703
diff changeset
9905 When {func} is given and it is 'f' then all items will be
41768bcebc9b commit https://github.com/vim/vim/commit/13d5aeef56e3140a8eb8f40c7062aa1c5700f76e
Christian Brabandt <cb@256bit.org>
parents: 7703
diff changeset
9906 sorted numerical. All values must be a Number or a Float.
41768bcebc9b commit https://github.com/vim/vim/commit/13d5aeef56e3140a8eb8f40c7062aa1c5700f76e
Christian Brabandt <cb@256bit.org>
parents: 7703
diff changeset
9907
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
9908 When {func} is a |Funcref| or a function name, this function
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
9909 is called to compare items. The function is invoked with two
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
9910 items as argument and must return zero if they are equal, 1 or
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
9911 bigger if the first one sorts after the second one, -1 or
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
9912 smaller if the first one sorts before the second one.
5747
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
9913
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
9914 {dict} is for functions with the "dict" attribute. It will be
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
9915 used to set the local variable "self". |Dictionary-function|
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
9916
6032
b8f703a4e55f Updated runtime files. Overhauled HTML indent script.
Bram Moolenaar <bram@vim.org>
parents: 6009
diff changeset
9917 The sort is stable, items which compare equal (as number or as
b8f703a4e55f Updated runtime files. Overhauled HTML indent script.
Bram Moolenaar <bram@vim.org>
parents: 6009
diff changeset
9918 string) will keep their relative position. E.g., when sorting
6051
0efec12f52ac Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6032
diff changeset
9919 on numbers, text strings will sort next to each other, in the
6032
b8f703a4e55f Updated runtime files. Overhauled HTML indent script.
Bram Moolenaar <bram@vim.org>
parents: 6009
diff changeset
9920 same order as they were originally.
b8f703a4e55f Updated runtime files. Overhauled HTML indent script.
Bram Moolenaar <bram@vim.org>
parents: 6009
diff changeset
9921
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
9922 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
9923 mylist->sort()
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
9924
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
9925 < Also see |uniq()|.
5747
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
9926
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
9927 Example: >
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
9928 func MyCompare(i1, i2)
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
9929 return a:i1 == a:i2 ? 0 : a:i1 > a:i2 ? 1 : -1
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
9930 endfunc
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
9931 let sortedlist = sort(mylist, "MyCompare")
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
9932 < A shorter compare version for this specific simple case, which
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
9933 ignores overflow: >
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
9934 func MyCompare(i1, i2)
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
9935 return a:i1 - a:i2
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
9936 endfunc
344
7033303ea0c0 updated for version 7.0089
vimboss
parents: 336
diff changeset
9937 <
17026
905e1b154058 patch 8.1.1513: all popup functionality is in functions, except :popupclear
Bram Moolenaar <Bram@vim.org>
parents: 17020
diff changeset
9938 sound_clear() *sound_clear()*
905e1b154058 patch 8.1.1513: all popup functionality is in functions, except :popupclear
Bram Moolenaar <Bram@vim.org>
parents: 17020
diff changeset
9939 Stop playing all sounds.
17131
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
9940 {only available when compiled with the |+sound| feature}
17026
905e1b154058 patch 8.1.1513: all popup functionality is in functions, except :popupclear
Bram Moolenaar <Bram@vim.org>
parents: 17020
diff changeset
9941
17004
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9942 *sound_playevent()*
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9943 sound_playevent({name} [, {callback}])
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9944 Play a sound identified by {name}. Which event names are
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9945 supported depends on the system. Often the XDG sound names
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9946 are used. On Ubuntu they may be found in
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9947 /usr/share/sounds/freedesktop/stereo. Example: >
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9948 call sound_playevent('bell')
17131
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
9949 < On MS-Windows, {name} can be SystemAsterisk, SystemDefault,
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
9950 SystemExclamation, SystemExit, SystemHand, SystemQuestion,
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
9951 SystemStart, SystemWelcome, etc.
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
9952
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
9953 When {callback} is specified it is invoked when the sound is
17004
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9954 finished. The first argument is the sound ID, the second
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9955 argument is the status:
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9956 0 sound was played to the end
17036
235cbf491430 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 17026
diff changeset
9957 1 sound was interrupted
17161
9ccb1ea9b2fc Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 17159
diff changeset
9958 2 error occurred after sound started
17004
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9959 Example: >
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9960 func Callback(id, status)
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9961 echomsg "sound " .. a:id .. " finished with " .. a:status
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9962 endfunc
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9963 call sound_playevent('bell', 'Callback')
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9964
17131
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
9965 < MS-Windows: {callback} doesn't work for this function.
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
9966
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
9967 Returns the sound ID, which can be passed to `sound_stop()`.
17004
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9968 Returns zero if the sound could not be played.
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
9969
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
9970 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
9971 GetSoundName()->sound_playevent()
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
9972
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
9973 < {only available when compiled with the |+sound| feature}
17004
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9974
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9975 *sound_playfile()*
17026
905e1b154058 patch 8.1.1513: all popup functionality is in functions, except :popupclear
Bram Moolenaar <Bram@vim.org>
parents: 17020
diff changeset
9976 sound_playfile({path} [, {callback}])
905e1b154058 patch 8.1.1513: all popup functionality is in functions, except :popupclear
Bram Moolenaar <Bram@vim.org>
parents: 17020
diff changeset
9977 Like `sound_playevent()` but play sound file {path}. {path}
17004
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9978 must be a full path. On Ubuntu you may find files to play
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9979 with this command: >
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9980 :!find /usr/share/sounds -type f | grep -v index.theme
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
9981
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
9982 < Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
9983 GetSoundPath()->sound_playfile()
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
9984
17036
235cbf491430 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 17026
diff changeset
9985 < {only available when compiled with the |+sound| feature}
17004
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9986
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9987
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9988 sound_stop({id}) *sound_stop()*
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9989 Stop playing sound {id}. {id} must be previously returned by
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9990 `sound_playevent()` or `sound_playfile()`.
17131
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
9991
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
9992 On MS-Windows, this does not work for event sound started by
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
9993 `sound_playevent()`. To stop event sounds, use `sound_clear()`.
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
9994
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
9995 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
9996 soundid->sound_stop()
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
9997
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
9998 < {only available when compiled with the |+sound| feature}
17004
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
9999
374
575dacb554d8 updated for version 7.0096
vimboss
parents: 370
diff changeset
10000 *soundfold()*
575dacb554d8 updated for version 7.0096
vimboss
parents: 370
diff changeset
10001 soundfold({word})
575dacb554d8 updated for version 7.0096
vimboss
parents: 370
diff changeset
10002 Return the sound-folded equivalent of {word}. Uses the first
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10003 language in 'spelllang' for the current window that supports
375
f14cbd913415 updated for version 7.0097
vimboss
parents: 374
diff changeset
10004 soundfolding. 'spell' must be set. When no sound folding is
f14cbd913415 updated for version 7.0097
vimboss
parents: 374
diff changeset
10005 possible the {word} is returned unmodified.
374
575dacb554d8 updated for version 7.0096
vimboss
parents: 370
diff changeset
10006 This can be used for making spelling suggestions. Note that
575dacb554d8 updated for version 7.0096
vimboss
parents: 370
diff changeset
10007 the method can be quite slow.
575dacb554d8 updated for version 7.0096
vimboss
parents: 370
diff changeset
10008
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10009 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10010 GetWord()->soundfold()
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10011 <
344
7033303ea0c0 updated for version 7.0089
vimboss
parents: 336
diff changeset
10012 *spellbadword()*
532
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10013 spellbadword([{sentence}])
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10014 Without argument: The result is the badly spelled word under
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10015 or after the cursor. The cursor is moved to the start of the
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10016 bad word. When no bad word is found in the cursor line the
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10017 result is an empty string and the cursor doesn't move.
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10018
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10019 With argument: The result is the first word in {sentence} that
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10020 is badly spelled. If there are no spelling mistakes the
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10021 result is an empty string.
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10022
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10023 The return value is a list with two items:
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10024 - The badly spelled word or an empty string.
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10025 - The type of the spelling error:
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
10026 "bad" spelling mistake
532
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10027 "rare" rare word
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10028 "local" word only valid in another region
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10029 "caps" word should start with Capital
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10030 Example: >
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10031 echo spellbadword("the quik brown fox")
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10032 < ['quik', 'bad'] ~
7052f11a3dc9 updated for version 7.0150
vimboss
parents: 531
diff changeset
10033
20786
90b96fa35e4b patch 8.2.0945: cannot use "z=" when 'spell' is off
Bram Moolenaar <Bram@vim.org>
parents: 20766
diff changeset
10034 The spelling information for the current window and the value
90b96fa35e4b patch 8.2.0945: cannot use "z=" when 'spell' is off
Bram Moolenaar <Bram@vim.org>
parents: 20766
diff changeset
10035 of 'spelllang' are used.
344
7033303ea0c0 updated for version 7.0089
vimboss
parents: 336
diff changeset
10036
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10037 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10038 GetText()->spellbadword()
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10039 <
344
7033303ea0c0 updated for version 7.0089
vimboss
parents: 336
diff changeset
10040 *spellsuggest()*
537
e321639cfa3e updated for version 7.0152
vimboss
parents: 532
diff changeset
10041 spellsuggest({word} [, {max} [, {capital}]])
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
10042 Return a |List| with spelling suggestions to replace {word}.
344
7033303ea0c0 updated for version 7.0089
vimboss
parents: 336
diff changeset
10043 When {max} is given up to this number of suggestions are
7033303ea0c0 updated for version 7.0089
vimboss
parents: 336
diff changeset
10044 returned. Otherwise up to 25 suggestions are returned.
7033303ea0c0 updated for version 7.0089
vimboss
parents: 336
diff changeset
10045
537
e321639cfa3e updated for version 7.0152
vimboss
parents: 532
diff changeset
10046 When the {capital} argument is given and it's non-zero only
e321639cfa3e updated for version 7.0152
vimboss
parents: 532
diff changeset
10047 suggestions with a leading capital will be given. Use this
e321639cfa3e updated for version 7.0152
vimboss
parents: 532
diff changeset
10048 after a match with 'spellcapcheck'.
e321639cfa3e updated for version 7.0152
vimboss
parents: 532
diff changeset
10049
344
7033303ea0c0 updated for version 7.0089
vimboss
parents: 336
diff changeset
10050 {word} can be a badly spelled word followed by other text.
7033303ea0c0 updated for version 7.0089
vimboss
parents: 336
diff changeset
10051 This allows for joining two words that were split. The
359
6c62b9b939bd updated for version 7.0093
vimboss
parents: 344
diff changeset
10052 suggestions also include the following text, thus you can
6c62b9b939bd updated for version 7.0093
vimboss
parents: 344
diff changeset
10053 replace a line.
6c62b9b939bd updated for version 7.0093
vimboss
parents: 344
diff changeset
10054
6c62b9b939bd updated for version 7.0093
vimboss
parents: 344
diff changeset
10055 {word} may also be a good word. Similar words will then be
537
e321639cfa3e updated for version 7.0152
vimboss
parents: 532
diff changeset
10056 returned. {word} itself is not included in the suggestions,
e321639cfa3e updated for version 7.0152
vimboss
parents: 532
diff changeset
10057 although it may appear capitalized.
344
7033303ea0c0 updated for version 7.0089
vimboss
parents: 336
diff changeset
10058
7033303ea0c0 updated for version 7.0089
vimboss
parents: 336
diff changeset
10059 The spelling information for the current window is used. The
20786
90b96fa35e4b patch 8.2.0945: cannot use "z=" when 'spell' is off
Bram Moolenaar <Bram@vim.org>
parents: 20766
diff changeset
10060 values of 'spelllang' and 'spellsuggest' are used.
344
7033303ea0c0 updated for version 7.0089
vimboss
parents: 336
diff changeset
10061
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10062 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10063 GetWord()->spellsuggest()
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
10064
282
33d9c918b8ab updated for version 7.0075
vimboss
parents: 277
diff changeset
10065 split({expr} [, {pattern} [, {keepempty}]]) *split()*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
10066 Make a |List| out of {expr}. When {pattern} is omitted or
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
10067 empty each white-separated sequence of characters becomes an
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
10068 item.
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
10069 Otherwise the string is split where {pattern} matches,
3920
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3914
diff changeset
10070 removing the matched characters. 'ignorecase' is not used
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3914
diff changeset
10071 here, add \c to ignore case. |/\c|
282
33d9c918b8ab updated for version 7.0075
vimboss
parents: 277
diff changeset
10072 When the first or last item is empty it is omitted, unless the
33d9c918b8ab updated for version 7.0075
vimboss
parents: 277
diff changeset
10073 {keepempty} argument is given and it's non-zero.
293
f811be6fa9b5 updated for version 7.0077
vimboss
parents: 282
diff changeset
10074 Other empty items are kept when {pattern} matches at least one
f811be6fa9b5 updated for version 7.0077
vimboss
parents: 282
diff changeset
10075 character or when {keepempty} is non-zero.
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
10076 Example: >
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
10077 :let words = split(getline('.'), '\W\+')
282
33d9c918b8ab updated for version 7.0075
vimboss
parents: 277
diff changeset
10078 < To split a string in individual characters: >
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 233
diff changeset
10079 :for c in split(mystring, '\zs')
7100
f717d96a39b3 commit https://github.com/vim/vim/commit/12969c04fe7bd27dc0cbf37709eb40a86d4a27f9
Christian Brabandt <cb@256bit.org>
parents: 7013
diff changeset
10080 < If you want to keep the separator you can also use '\zs' at
f717d96a39b3 commit https://github.com/vim/vim/commit/12969c04fe7bd27dc0cbf37709eb40a86d4a27f9
Christian Brabandt <cb@256bit.org>
parents: 7013
diff changeset
10081 the end of the pattern: >
258
f93df7322443 updated for version 7.0070
vimboss
parents: 236
diff changeset
10082 :echo split('abc:def:ghi', ':\zs')
f93df7322443 updated for version 7.0070
vimboss
parents: 236
diff changeset
10083 < ['abc:', 'def:', 'ghi'] ~
282
33d9c918b8ab updated for version 7.0075
vimboss
parents: 277
diff changeset
10084 Splitting a table where the first element can be empty: >
33d9c918b8ab updated for version 7.0075
vimboss
parents: 277
diff changeset
10085 :let items = split(line, ':', 1)
33d9c918b8ab updated for version 7.0075
vimboss
parents: 277
diff changeset
10086 < The opposite function is |join()|.
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
10087
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10088 Can also be used as a |method|: >
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10089 GetString()->split()
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
10090
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10091 sqrt({expr}) *sqrt()*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10092 Return the non-negative square root of Float {expr} as a
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10093 |Float|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10094 {expr} must evaluate to a |Float| or a |Number|. When {expr}
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10095 is negative the result is NaN (Not a Number).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10096 Examples: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10097 :echo sqrt(100)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10098 < 10.0 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10099 :echo sqrt(-4.01)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10100 < nan
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
10101 "nan" may be different, it depends on system libraries.
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10102
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10103 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10104 Compute()->sqrt()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10105 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10106 {only available when compiled with the |+float| feature}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10107
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10108
18701
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
10109 srand([{expr}]) *srand()*
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
10110 Initialize seed used by |rand()|:
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
10111 - If {expr} is not given, seed values are initialized by
18732
2513e666aa82 patch 8.1.2356: rand() does not use the best algorithm
Bram Moolenaar <Bram@vim.org>
parents: 18719
diff changeset
10112 reading from /dev/urandom, if possible, or using time(NULL)
2513e666aa82 patch 8.1.2356: rand() does not use the best algorithm
Bram Moolenaar <Bram@vim.org>
parents: 18719
diff changeset
10113 a.k.a. epoch time otherwise; this only has second accuracy.
2513e666aa82 patch 8.1.2356: rand() does not use the best algorithm
Bram Moolenaar <Bram@vim.org>
parents: 18719
diff changeset
10114 - If {expr} is given it must be a Number. It is used to
2513e666aa82 patch 8.1.2356: rand() does not use the best algorithm
Bram Moolenaar <Bram@vim.org>
parents: 18719
diff changeset
10115 initialize the seed values. This is useful for testing or
2513e666aa82 patch 8.1.2356: rand() does not use the best algorithm
Bram Moolenaar <Bram@vim.org>
parents: 18719
diff changeset
10116 when a predictable sequence is intended.
18701
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
10117
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
10118 Examples: >
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
10119 :let seed = srand()
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
10120 :let seed = srand(userinput)
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
10121 :echo rand(seed)
128662297ddf patch 8.1.2342: random number generator in Vim script is slow
Bram Moolenaar <Bram@vim.org>
parents: 18699
diff changeset
10122
18104
e59ff7b5d7a7 patch 8.1.2047: cannot check the current state
Bram Moolenaar <Bram@vim.org>
parents: 18080
diff changeset
10123 state([{what}]) *state()*
e59ff7b5d7a7 patch 8.1.2047: cannot check the current state
Bram Moolenaar <Bram@vim.org>
parents: 18080
diff changeset
10124 Return a string which contains characters indicating the
e59ff7b5d7a7 patch 8.1.2047: cannot check the current state
Bram Moolenaar <Bram@vim.org>
parents: 18080
diff changeset
10125 current state. Mostly useful in callbacks that want to do
e59ff7b5d7a7 patch 8.1.2047: cannot check the current state
Bram Moolenaar <Bram@vim.org>
parents: 18080
diff changeset
10126 work that may not always be safe. Roughly this works like:
e59ff7b5d7a7 patch 8.1.2047: cannot check the current state
Bram Moolenaar <Bram@vim.org>
parents: 18080
diff changeset
10127 - callback uses state() to check if work is safe to do.
18130
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10128 Yes: then do it right away.
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10129 No: add to work queue and add a |SafeState| and/or
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10130 |SafeStateAgain| autocommand (|SafeState| triggers at
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10131 toplevel, |SafeStateAgain| triggers after handling
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10132 messages and callbacks).
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10133 - When SafeState or SafeStateAgain is triggered and executes
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10134 your autocommand, check with `state()` if the work can be
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10135 done now, and if yes remove it from the queue and execute.
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10136 Remove the autocommand if the queue is now empty.
18104
e59ff7b5d7a7 patch 8.1.2047: cannot check the current state
Bram Moolenaar <Bram@vim.org>
parents: 18080
diff changeset
10137 Also see |mode()|.
e59ff7b5d7a7 patch 8.1.2047: cannot check the current state
Bram Moolenaar <Bram@vim.org>
parents: 18080
diff changeset
10138
e59ff7b5d7a7 patch 8.1.2047: cannot check the current state
Bram Moolenaar <Bram@vim.org>
parents: 18080
diff changeset
10139 When {what} is given only characters in this string will be
e59ff7b5d7a7 patch 8.1.2047: cannot check the current state
Bram Moolenaar <Bram@vim.org>
parents: 18080
diff changeset
10140 added. E.g, this checks if the screen has scrolled: >
18130
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10141 if state('s') == ''
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10142 " screen has not scrolled
18104
e59ff7b5d7a7 patch 8.1.2047: cannot check the current state
Bram Moolenaar <Bram@vim.org>
parents: 18080
diff changeset
10143 <
18116
7f57ea9a4ba8 patch 8.1.2053: SafeStateAgain not triggered if callback uses feedkeys()
Bram Moolenaar <Bram@vim.org>
parents: 18104
diff changeset
10144 These characters indicate the state, generally indicating that
7f57ea9a4ba8 patch 8.1.2053: SafeStateAgain not triggered if callback uses feedkeys()
Bram Moolenaar <Bram@vim.org>
parents: 18104
diff changeset
10145 something is busy:
18130
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10146 m halfway a mapping, :normal command, feedkeys() or
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10147 stuffed command
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
10148 o operator pending, e.g. after |d|
18130
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10149 a Insert mode autocomplete active
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10150 x executing an autocommand
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
10151 w blocked on waiting, e.g. ch_evalexpr(), ch_read() and
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
10152 ch_readraw() when reading json
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
10153 S not triggering SafeState or SafeStateAgain, e.g. after
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
10154 |f| or a count
18130
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10155 c callback invoked, including timer (repeats for
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10156 recursiveness up to "ccc")
1e5672da6a69 Updte runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18116
diff changeset
10157 s screen has scrolled for messages
18104
e59ff7b5d7a7 patch 8.1.2047: cannot check the current state
Bram Moolenaar <Bram@vim.org>
parents: 18080
diff changeset
10158
8883
b7de875169e6 commit https://github.com/vim/vim/commit/81edd171a9465cf99cede4fa4a7b7bca3d538b0f
Christian Brabandt <cb@256bit.org>
parents: 8881
diff changeset
10159 str2float({expr}) *str2float()*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10160 Convert String {expr} to a Float. This mostly works the same
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10161 as when using a floating point number in an expression, see
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10162 |floating-point-format|. But it's a bit more permissive.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10163 E.g., "1e40" is accepted, while in an expression you need to
15131
bc1a8d21c811 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15062
diff changeset
10164 write "1.0e40". The hexadecimal form "0x123" is also
bc1a8d21c811 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15062
diff changeset
10165 accepted, but not others, like binary or octal.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10166 Text after the number is silently ignored.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10167 The decimal point is always '.', no matter what the locale is
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10168 set to. A comma ends the number: "12,345.67" is converted to
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10169 12.0. You can strip out thousands separators with
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10170 |substitute()|: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10171 let f = str2float(substitute(text, ',', '', 'g'))
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10172 <
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10173 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10174 let f = text->substitute(',', '', 'g')->str2float()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10175 <
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10176 {only available when compiled with the |+float| feature}
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10177
16235
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
10178 str2list({expr} [, {utf8}]) *str2list()*
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
10179 Return a list containing the number values which represent
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
10180 each character in String {expr}. Examples: >
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
10181 str2list(" ") returns [32]
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
10182 str2list("ABC") returns [65, 66, 67]
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
10183 < |list2str()| does the opposite.
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
10184
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
10185 When {utf8} is omitted or zero, the current 'encoding' is used.
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
10186 With {utf8} set to 1, always treat the String as utf-8
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
10187 characters. With utf-8 composing characters are handled
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
10188 properly: >
219c58b3879c patch 8.1.1122: char2nr() does not handle composing characters
Bram Moolenaar <Bram@vim.org>
parents: 16231
diff changeset
10189 str2list("á") returns [97, 769]
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10190
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10191 < Can also be used as a |method|: >
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10192 GetString()->str2list()
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10193
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10194
18080
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
10195 str2nr({expr} [, {base} [, {quoted}]]) *str2nr()*
782
d20041a02ee5 updated for version 7.0228
vimboss
parents: 777
diff changeset
10196 Convert string {expr} to a number.
7477
05cf4cc72a9f commit https://github.com/vim/vim/commit/fa7353428f705f7a13465a1943dddeede4083023
Christian Brabandt <cb@256bit.org>
parents: 7384
diff changeset
10197 {base} is the conversion base, it can be 2, 8, 10 or 16.
18080
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
10198 When {quoted} is present and non-zero then embedded single
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
10199 quotes are ignored, thus "1'000'000" is a million.
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10200
782
d20041a02ee5 updated for version 7.0228
vimboss
parents: 777
diff changeset
10201 When {base} is omitted base 10 is used. This also means that
d20041a02ee5 updated for version 7.0228
vimboss
parents: 777
diff changeset
10202 a leading zero doesn't cause octal conversion to be used, as
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10203 with the default String to Number conversion. Example: >
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
10204 let nr = str2nr('0123')
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10205 <
782
d20041a02ee5 updated for version 7.0228
vimboss
parents: 777
diff changeset
10206 When {base} is 16 a leading "0x" or "0X" is ignored. With a
7477
05cf4cc72a9f commit https://github.com/vim/vim/commit/fa7353428f705f7a13465a1943dddeede4083023
Christian Brabandt <cb@256bit.org>
parents: 7384
diff changeset
10207 different base the result will be zero. Similarly, when
20665
6ff992bf4c82 patch 8.2.0886: cannot use octal numbers in scriptversion 4
Bram Moolenaar <Bram@vim.org>
parents: 20649
diff changeset
10208 {base} is 8 a leading "0", "0o" or "0O" is ignored, and when
6ff992bf4c82 patch 8.2.0886: cannot use octal numbers in scriptversion 4
Bram Moolenaar <Bram@vim.org>
parents: 20649
diff changeset
10209 {base} is 2 a leading "0b" or "0B" is ignored.
782
d20041a02ee5 updated for version 7.0228
vimboss
parents: 777
diff changeset
10210 Text after the number is silently ignored.
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
10211
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10212 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10213 GetText()->str2nr()
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10214
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10215 strcharpart({src}, {start} [, {len}]) *strcharpart()*
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10216 Like |strpart()| but using character index and length instead
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10217 of byte index and length.
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10218 When a character index is used where a character does not
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10219 exist it is assumed to be one character. For example: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10220 strcharpart('abc', -1, 2)
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10221 < results in 'a'.
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10222
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10223 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10224 GetText()->strcharpart(5)
782
d20041a02ee5 updated for version 7.0228
vimboss
parents: 777
diff changeset
10225
6884
29c328f69aaa Update help files.
Bram Moolenaar <bram@vim.org>
parents: 6870
diff changeset
10226 strchars({expr} [, {skipcc}]) *strchars()*
2338
da6ec32d8d8f Added strwidth() and strchars() functions.
Bram Moolenaar <bram@vim.org>
parents: 2337
diff changeset
10227 The result is a Number, which is the number of characters
6884
29c328f69aaa Update help files.
Bram Moolenaar <bram@vim.org>
parents: 6870
diff changeset
10228 in String {expr}.
29c328f69aaa Update help files.
Bram Moolenaar <bram@vim.org>
parents: 6870
diff changeset
10229 When {skipcc} is omitted or zero, composing characters are
29c328f69aaa Update help files.
Bram Moolenaar <bram@vim.org>
parents: 6870
diff changeset
10230 counted separately.
29c328f69aaa Update help files.
Bram Moolenaar <bram@vim.org>
parents: 6870
diff changeset
10231 When {skipcc} set to 1, Composing characters are ignored.
2339
01e4b4d37842 Added strdisplaywidth() function.
Bram Moolenaar <bram@vim.org>
parents: 2338
diff changeset
10232 Also see |strlen()|, |strdisplaywidth()| and |strwidth()|.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10233
6918
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10234 {skipcc} is only available after 7.4.755. For backward
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10235 compatibility, you can define a wrapper function: >
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10236 if has("patch-7.4.755")
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10237 function s:strchars(str, skipcc)
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10238 return strchars(a:str, a:skipcc)
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10239 endfunction
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10240 else
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10241 function s:strchars(str, skipcc)
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10242 if a:skipcc
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10243 return strlen(substitute(a:str, ".", "x", "g"))
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10244 else
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10245 return strchars(a:str)
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10246 endif
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10247 endfunction
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10248 endif
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10249 <
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10250 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10251 GetText()->strchars()
6918
2def7b25de60 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6909
diff changeset
10252
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10253 strdisplaywidth({expr} [, {col}]) *strdisplaywidth()*
2339
01e4b4d37842 Added strdisplaywidth() function.
Bram Moolenaar <bram@vim.org>
parents: 2338
diff changeset
10254 The result is a Number, which is the number of display cells
15878
314694a2e74a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15790
diff changeset
10255 String {expr} occupies on the screen when it starts at {col}
314694a2e74a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15790
diff changeset
10256 (first column is zero). When {col} is omitted zero is used.
314694a2e74a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15790
diff changeset
10257 Otherwise it is the screen column where to start. This
314694a2e74a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15790
diff changeset
10258 matters for Tab characters.
2343
0703d2fd5749 Last few changes for the 7.3a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2339
diff changeset
10259 The option settings of the current window are used. This
0703d2fd5749 Last few changes for the 7.3a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2339
diff changeset
10260 matters for anything that's displayed differently, such as
0703d2fd5749 Last few changes for the 7.3a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2339
diff changeset
10261 'tabstop' and 'display'.
2339
01e4b4d37842 Added strdisplaywidth() function.
Bram Moolenaar <bram@vim.org>
parents: 2338
diff changeset
10262 When {expr} contains characters with East Asian Width Class
01e4b4d37842 Added strdisplaywidth() function.
Bram Moolenaar <bram@vim.org>
parents: 2338
diff changeset
10263 Ambiguous, this function's return value depends on 'ambiwidth'.
01e4b4d37842 Added strdisplaywidth() function.
Bram Moolenaar <bram@vim.org>
parents: 2338
diff changeset
10264 Also see |strlen()|, |strwidth()| and |strchars()|.
2338
da6ec32d8d8f Added strwidth() and strchars() functions.
Bram Moolenaar <bram@vim.org>
parents: 2337
diff changeset
10265
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10266 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10267 GetText()->strdisplaywidth()
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10268
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10269 strftime({format} [, {time}]) *strftime()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10270 The result is a String, which is a formatted date and time, as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10271 specified by the {format} string. The given {time} is used,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10272 or the current time if no time is given. The accepted
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10273 {format} depends on your system, thus this is not portable!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10274 See the manual page of the C function strftime() for the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10275 format. The maximum length of the result is 80 characters.
18669
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10276 See also |localtime()|, |getftime()| and |strptime()|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10277 The language can be changed with the |:language| command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10278 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10279 :echo strftime("%c") Sun Apr 27 11:49:23 1997
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10280 :echo strftime("%Y %b %d %X") 1997 Apr 27 11:53:25
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10281 :echo strftime("%y%m%d %T") 970427 11:53:55
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10282 :echo strftime("%H:%M") 11:55
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10283 :echo strftime("%c", getftime("file.c"))
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10284 Show mod time of file.c.
82
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
10285 < Not available on all systems. To check use: >
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
10286 :if exists("*strftime")
366d9947baf2 updated for version 7.0033
vimboss
parents: 79
diff changeset
10287
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10288 < Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10289 GetFormat()->strftime()
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10290
8951
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
10291 strgetchar({str}, {index}) *strgetchar()*
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
10292 Get character {index} from {str}. This uses a character
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
10293 index, not a byte index. Composing characters are considered
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
10294 separate characters here.
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
10295 Also see |strcharpart()| and |strchars()|.
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
10296
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10297 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10298 GetText()->strgetchar(5)
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10299
133
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
10300 stridx({haystack}, {needle} [, {start}]) *stridx()*
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
10301 The result is a Number, which gives the byte index in
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
10302 {haystack} of the first occurrence of the String {needle}.
140
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
10303 If {start} is specified, the search starts at index {start}.
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
10304 This can be used to find a second match: >
2662
916c90b37ea9 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2642
diff changeset
10305 :let colon1 = stridx(line, ":")
916c90b37ea9 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2642
diff changeset
10306 :let colon2 = stridx(line, ":", colon1 + 1)
140
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
10307 < The search is done case-sensitive.
205
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10308 For pattern searches use |match()|.
133
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
10309 -1 is returned if the {needle} does not occur in {haystack}.
140
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
10310 See also |strridx()|.
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
10311 Examples: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10312 :echo stridx("An Example", "Example") 3
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10313 :echo stridx("Starting point", "Start") 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10314 :echo stridx("Starting point", "start") -1
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
10315 < *strstr()* *strchr()*
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
10316 stridx() works similar to the C function strstr(). When used
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
10317 with a single character it works similar to strchr().
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
10318
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10319 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10320 GetHaystack()->stridx(needle)
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
10321 <
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
10322 *string()*
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
10323 string({expr}) Return {expr} converted to a String. If {expr} is a Number,
15571
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
10324 Float, String, Blob or a composition of them, then the result
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
10325 can be parsed back with |eval()|.
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
10326 {expr} type result ~
8748
b1a19a2f73f0 commit https://github.com/vim/vim/commit/4f3f668c8486444e53163c29d2fc79bf47eb3c82
Christian Brabandt <cb@256bit.org>
parents: 8738
diff changeset
10327 String 'string' (single quotes are doubled)
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
10328 Number 123
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10329 Float 123.123456 or 1.123456e8
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
10330 Funcref function('name')
15571
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
10331 Blob 0z00112233.44556677.8899
95
a2081e6febb8 updated for version 7.0037
vimboss
parents: 90
diff changeset
10332 List [item, item]
323
03b3684919e3 updated for version 7.0084
vimboss
parents: 314
diff changeset
10333 Dictionary {key: value, key: value}
8748
b1a19a2f73f0 commit https://github.com/vim/vim/commit/4f3f668c8486444e53163c29d2fc79bf47eb3c82
Christian Brabandt <cb@256bit.org>
parents: 8738
diff changeset
10334
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
10335 When a |List| or |Dictionary| has a recursive reference it is
8748
b1a19a2f73f0 commit https://github.com/vim/vim/commit/4f3f668c8486444e53163c29d2fc79bf47eb3c82
Christian Brabandt <cb@256bit.org>
parents: 8738
diff changeset
10336 replaced by "[...]" or "{...}". Using eval() on the result
b1a19a2f73f0 commit https://github.com/vim/vim/commit/4f3f668c8486444e53163c29d2fc79bf47eb3c82
Christian Brabandt <cb@256bit.org>
parents: 8738
diff changeset
10337 will then fail.
b1a19a2f73f0 commit https://github.com/vim/vim/commit/4f3f668c8486444e53163c29d2fc79bf47eb3c82
Christian Brabandt <cb@256bit.org>
parents: 8738
diff changeset
10338
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
10339 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
10340 mylist->string()
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
10341
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
10342 < Also see |strtrans()|.
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
10343
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10344 *strlen()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10345 strlen({expr}) The result is a Number, which is the length of the String
502
52e76e2b5b65 updated for version 7.0140
vimboss
parents: 493
diff changeset
10346 {expr} in bytes.
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
10347 If the argument is a Number it is first converted to a String.
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
10348 For other types an error is given.
21935
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
10349 If you want to count the number of multibyte characters use
6870
66ab6ec256d1 patch 7.4.755
Bram Moolenaar <bram@vim.org>
parents: 6840
diff changeset
10350 |strchars()|.
66ab6ec256d1 patch 7.4.755
Bram Moolenaar <bram@vim.org>
parents: 6840
diff changeset
10351 Also see |len()|, |strdisplaywidth()| and |strwidth()|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10352
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10353 Can also be used as a |method|: >
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10354 GetString()->strlen()
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10355
21935
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
10356 strpart({src}, {start} [, {len} [, {chars}]]) *strpart()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10357 The result is a String, which is part of {src}, starting from
574
25a70b1cd2da updated for version 7.0163
vimboss
parents: 557
diff changeset
10358 byte {start}, with the byte length {len}.
21935
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
10359 When {chars} is present and TRUE then {len} is the number of
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
10360 characters positions (composing characters are not counted
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
10361 separately, thus "1" means one base character and any
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
10362 following composing characters).
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
10363 To count {start} as characters instead of bytes use
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
10364 |strcharpart()|.
8951
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
10365
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
10366 When bytes are selected which do not exist, this doesn't
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
10367 result in an error, the bytes are simply omitted.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10368 If {len} is missing, the copy continues from {start} till the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10369 end of the {src}. >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10370 strpart("abcdefg", 3, 2) == "de"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10371 strpart("abcdefg", -2, 4) == "ab"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10372 strpart("abcdefg", 5, 4) == "fg"
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
10373 strpart("abcdefg", 3) == "defg"
8951
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8883
diff changeset
10374
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10375 < Note: To get the first character, {start} must be 0. For
21935
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
10376 example, to get the character under the cursor: >
62f933f64447 patch 8.2.1517: cannot easily get the character under the cursor
Bram Moolenaar <Bram@vim.org>
parents: 21847
diff changeset
10377 strpart(getline("."), col(".") - 1, 1, v:true)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10378 <
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10379 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10380 GetText()->strpart(5)
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10381
18669
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10382 strptime({format}, {timestring}) *strptime()*
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10383 The result is a Number, which is a unix timestamp representing
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10384 the date and time in {timestring}, which is expected to match
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10385 the format specified in {format}.
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10386
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10387 The accepted {format} depends on your system, thus this is not
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10388 portable! See the manual page of the C function strptime()
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10389 for the format. Especially avoid "%c". The value of $TZ also
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10390 matters.
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10391
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10392 If the {timestring} cannot be parsed with {format} zero is
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10393 returned. If you do not know the format of {timestring} you
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10394 can try different {format} values until you get a non-zero
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10395 result.
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10396
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10397 See also |strftime()|.
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10398 Examples: >
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10399 :echo strptime("%Y %b %d %X", "1997 Apr 27 11:49:23")
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10400 < 862156163 >
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10401 :echo strftime("%c", strptime("%y%m%d %T", "970427 11:53:55"))
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10402 < Sun Apr 27 11:53:55 1997 >
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10403 :echo strftime("%c", strptime("%Y%m%d%H%M%S", "19970427115355") + 3600)
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10404 < Sun Apr 27 12:53:55 1997
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10405
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10406 Not available on all systems. To check use: >
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10407 :if exists("*strptime")
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10408
9007e9896303 patch 8.1.2326: cannot parse a date/time string
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
10409
140
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
10410 strridx({haystack}, {needle} [, {start}]) *strridx()*
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
10411 The result is a Number, which gives the byte index in
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
10412 {haystack} of the last occurrence of the String {needle}.
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
10413 When {start} is specified, matches beyond this index are
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
10414 ignored. This can be used to find a match before a previous
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
10415 match: >
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
10416 :let lastcomma = strridx(line, ",")
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
10417 :let comma2 = strridx(line, ",", lastcomma - 1)
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
10418 < The search is done case-sensitive.
133
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
10419 For pattern searches use |match()|.
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
10420 -1 is returned if the {needle} does not occur in {haystack}.
22
cc049b00ee70 updated for version 7.0014
vimboss
parents: 20
diff changeset
10421 If the {needle} is empty the length of {haystack} is returned.
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 233
diff changeset
10422 See also |stridx()|. Examples: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10423 :echo strridx("an angry armadillo", "an") 3
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
10424 < *strrchr()*
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
10425 When used with a single character it works similar to the C
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
10426 function strrchr().
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
10427
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10428 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10429 GetHaystack()->strridx(needle)
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10430
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10431 strtrans({expr}) *strtrans()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10432 The result is a String, which is {expr} with all unprintable
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10433 characters translated into printable characters |'isprint'|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10434 Like they are shown in a window. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10435 echo strtrans(@a)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10436 < This displays a newline in register a as "^@" instead of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10437 starting a new line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10438
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10439 Can also be used as a |method|: >
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10440 GetString()->strtrans()
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10441
2338
da6ec32d8d8f Added strwidth() and strchars() functions.
Bram Moolenaar <bram@vim.org>
parents: 2337
diff changeset
10442 strwidth({expr}) *strwidth()*
da6ec32d8d8f Added strwidth() and strchars() functions.
Bram Moolenaar <bram@vim.org>
parents: 2337
diff changeset
10443 The result is a Number, which is the number of display cells
da6ec32d8d8f Added strwidth() and strchars() functions.
Bram Moolenaar <bram@vim.org>
parents: 2337
diff changeset
10444 String {expr} occupies. A Tab character is counted as one
2339
01e4b4d37842 Added strdisplaywidth() function.
Bram Moolenaar <bram@vim.org>
parents: 2338
diff changeset
10445 cell, alternatively use |strdisplaywidth()|.
2338
da6ec32d8d8f Added strwidth() and strchars() functions.
Bram Moolenaar <bram@vim.org>
parents: 2337
diff changeset
10446 When {expr} contains characters with East Asian Width Class
da6ec32d8d8f Added strwidth() and strchars() functions.
Bram Moolenaar <bram@vim.org>
parents: 2337
diff changeset
10447 Ambiguous, this function's return value depends on 'ambiwidth'.
2339
01e4b4d37842 Added strdisplaywidth() function.
Bram Moolenaar <bram@vim.org>
parents: 2338
diff changeset
10448 Also see |strlen()|, |strdisplaywidth()| and |strchars()|.
2338
da6ec32d8d8f Added strwidth() and strchars() functions.
Bram Moolenaar <bram@vim.org>
parents: 2337
diff changeset
10449
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10450 Can also be used as a |method|: >
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10451 GetString()->strwidth()
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10452
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10453 submatch({nr} [, {list}]) *submatch()* *E935*
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10454 Only for an expression in a |:substitute| command or
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10455 substitute() function.
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10456 Returns the {nr}'th submatch of the matched text. When {nr}
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10457 is 0 the whole matched text is returned.
5794
a63d0cd691dc updated for version 7.4.241
Bram Moolenaar <bram@vim.org>
parents: 5786
diff changeset
10458 Note that a NL in the string can stand for a line break of a
a63d0cd691dc updated for version 7.4.241
Bram Moolenaar <bram@vim.org>
parents: 5786
diff changeset
10459 multi-line match or a NUL character in the text.
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10460 Also see |sub-replace-expression|.
5794
a63d0cd691dc updated for version 7.4.241
Bram Moolenaar <bram@vim.org>
parents: 5786
diff changeset
10461
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10462 If {list} is present and non-zero then submatch() returns
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10463 a list of strings, similar to |getline()| with two arguments.
5794
a63d0cd691dc updated for version 7.4.241
Bram Moolenaar <bram@vim.org>
parents: 5786
diff changeset
10464 NL characters in the text represent NUL characters in the
a63d0cd691dc updated for version 7.4.241
Bram Moolenaar <bram@vim.org>
parents: 5786
diff changeset
10465 text.
a63d0cd691dc updated for version 7.4.241
Bram Moolenaar <bram@vim.org>
parents: 5786
diff changeset
10466 Only returns more than one item for |:substitute|, inside
a63d0cd691dc updated for version 7.4.241
Bram Moolenaar <bram@vim.org>
parents: 5786
diff changeset
10467 |substitute()| this list will always contain one or zero
a63d0cd691dc updated for version 7.4.241
Bram Moolenaar <bram@vim.org>
parents: 5786
diff changeset
10468 items, since there are no real line breaks.
a63d0cd691dc updated for version 7.4.241
Bram Moolenaar <bram@vim.org>
parents: 5786
diff changeset
10469
10245
d76ccdacb41e commit https://github.com/vim/vim/commit/6100d02aab7c8294b581cb299250eea164b50e9d
Christian Brabandt <cb@256bit.org>
parents: 10244
diff changeset
10470 When substitute() is used recursively only the submatches in
d76ccdacb41e commit https://github.com/vim/vim/commit/6100d02aab7c8294b581cb299250eea164b50e9d
Christian Brabandt <cb@256bit.org>
parents: 10244
diff changeset
10471 the current (deepest) call can be obtained.
d76ccdacb41e commit https://github.com/vim/vim/commit/6100d02aab7c8294b581cb299250eea164b50e9d
Christian Brabandt <cb@256bit.org>
parents: 10244
diff changeset
10472
12968
45987b1b77dc Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 12909
diff changeset
10473 Examples: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10474 :s/\d\+/\=submatch(0) + 1/
12968
45987b1b77dc Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 12909
diff changeset
10475 :echo substitute(text, '\d\+', '\=submatch(0) + 1', '')
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10476 < This finds the first number in the line and adds one to it.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10477 A line break is included as a newline character.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10478
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10479 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10480 GetNr()->submatch()
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10481
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10482 substitute({expr}, {pat}, {sub}, {flags}) *substitute()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10483 The result is a String, which is a copy of {expr}, in which
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10484 the first match of {pat} is replaced with {sub}.
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10485 When {flags} is "g", all matches of {pat} in {expr} are
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10486 replaced. Otherwise {flags} should be "".
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10487
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10488 This works like the ":substitute" command (without any flags).
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10489 But the matching with {pat} is always done like the 'magic'
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10490 option is set and 'cpoptions' is empty (to make scripts
3967
fdb8a9c7bd91 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
10491 portable). 'ignorecase' is still relevant, use |/\c| or |/\C|
fdb8a9c7bd91 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
10492 if you want to ignore or match case and ignore 'ignorecase'.
fdb8a9c7bd91 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
10493 'smartcase' is not used. See |string-match| for how {pat} is
fdb8a9c7bd91 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
10494 used.
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10495
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10496 A "~" in {sub} is not replaced with the previous {sub}.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10497 Note that some codes in {sub} have a special meaning
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
10498 |sub-replace-special|. For example, to replace something with
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10499 "\n" (two characters), use "\\\\n" or '\\n'.
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10500
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10501 When {pat} does not match in {expr}, {expr} is returned
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10502 unmodified.
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10503
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10504 Example: >
9626
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
10505 :let &path = substitute(&path, ",\\=[^,]*$", "", "")
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10506 < This removes the last component of the 'path' option. >
9626
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
10507 :echo substitute("testing", ".*", "\\U\\0", "")
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10508 < results in "TESTING".
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10509
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10510 When {sub} starts with "\=", the remainder is interpreted as
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2902
diff changeset
10511 an expression. See |sub-replace-expression|. Example: >
9626
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
10512 :echo substitute(s, '%\(\x\x\)',
2833
c869ff170ddc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2826
diff changeset
10513 \ '\=nr2char("0x" . submatch(1))', 'g')
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10514
9626
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
10515 < When {sub} is a Funcref that function is called, with one
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
10516 optional argument. Example: >
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
10517 :echo substitute(s, '%\(\x\x\)', SubNr, 'g')
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
10518 < The optional argument is a list which contains the whole
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
10519 matched string and up to nine submatches, like what
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
10520 |submatch()| returns. Example: >
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
10521 :echo substitute(s, '%\(\x\x\)', {m -> '0x' . m[1]}, 'g')
9626
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
10522
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10523 < Can also be used as a |method|: >
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10524 GetString()->substitute(pat, sub, flags)
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10525
14668
34fd018452ed Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14664
diff changeset
10526 swapinfo({fname}) *swapinfo()*
14599
72d6f6f7ead7 patch 8.1.0313: information about a swap file is unavailable
Christian Brabandt <cb@256bit.org>
parents: 14587
diff changeset
10527 The result is a dictionary, which holds information about the
72d6f6f7ead7 patch 8.1.0313: information about a swap file is unavailable
Christian Brabandt <cb@256bit.org>
parents: 14587
diff changeset
10528 swapfile {fname}. The available fields are:
14864
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
10529 version Vim version
14599
72d6f6f7ead7 patch 8.1.0313: information about a swap file is unavailable
Christian Brabandt <cb@256bit.org>
parents: 14587
diff changeset
10530 user user name
72d6f6f7ead7 patch 8.1.0313: information about a swap file is unavailable
Christian Brabandt <cb@256bit.org>
parents: 14587
diff changeset
10531 host host name
72d6f6f7ead7 patch 8.1.0313: information about a swap file is unavailable
Christian Brabandt <cb@256bit.org>
parents: 14587
diff changeset
10532 fname original file name
14864
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
10533 pid PID of the Vim process that created the swap
14599
72d6f6f7ead7 patch 8.1.0313: information about a swap file is unavailable
Christian Brabandt <cb@256bit.org>
parents: 14587
diff changeset
10534 file
72d6f6f7ead7 patch 8.1.0313: information about a swap file is unavailable
Christian Brabandt <cb@256bit.org>
parents: 14587
diff changeset
10535 mtime last modification time in seconds
72d6f6f7ead7 patch 8.1.0313: information about a swap file is unavailable
Christian Brabandt <cb@256bit.org>
parents: 14587
diff changeset
10536 inode Optional: INODE number of the file
14601
d0ff19a55579 patch 8.1.0314: build failure without the +eval feature
Christian Brabandt <cb@256bit.org>
parents: 14599
diff changeset
10537 dirty 1 if file was modified, 0 if not
14637
0ecb909e3249 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14601
diff changeset
10538 Note that "user" and "host" are truncated to at most 39 bytes.
14599
72d6f6f7ead7 patch 8.1.0313: information about a swap file is unavailable
Christian Brabandt <cb@256bit.org>
parents: 14587
diff changeset
10539 In case of failure an "error" item is added with the reason:
72d6f6f7ead7 patch 8.1.0313: information about a swap file is unavailable
Christian Brabandt <cb@256bit.org>
parents: 14587
diff changeset
10540 Cannot open file: file not found or in accessible
72d6f6f7ead7 patch 8.1.0313: information about a swap file is unavailable
Christian Brabandt <cb@256bit.org>
parents: 14587
diff changeset
10541 Cannot read file: cannot read first block
14601
d0ff19a55579 patch 8.1.0314: build failure without the +eval feature
Christian Brabandt <cb@256bit.org>
parents: 14599
diff changeset
10542 Not a swap file: does not contain correct block ID
d0ff19a55579 patch 8.1.0314: build failure without the +eval feature
Christian Brabandt <cb@256bit.org>
parents: 14599
diff changeset
10543 Magic number mismatch: Info in first block is invalid
14599
72d6f6f7ead7 patch 8.1.0313: information about a swap file is unavailable
Christian Brabandt <cb@256bit.org>
parents: 14587
diff changeset
10544
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10545 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10546 GetFilename()->swapinfo()
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10547
14778
20653d6f3d95 patch 8.1.0401: can't get swap name of another buffer
Christian Brabandt <cb@256bit.org>
parents: 14756
diff changeset
10548 swapname({expr}) *swapname()*
20653d6f3d95 patch 8.1.0401: can't get swap name of another buffer
Christian Brabandt <cb@256bit.org>
parents: 14756
diff changeset
10549 The result is the swap file path of the buffer {expr}.
20653d6f3d95 patch 8.1.0401: can't get swap name of another buffer
Christian Brabandt <cb@256bit.org>
parents: 14756
diff changeset
10550 For the use of {expr}, see |bufname()| above.
20653d6f3d95 patch 8.1.0401: can't get swap name of another buffer
Christian Brabandt <cb@256bit.org>
parents: 14756
diff changeset
10551 If buffer {expr} is the current buffer, the result is equal to
21676
1b345fb68ae3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21608
diff changeset
10552 |:swapname| (unless there is no swap file).
14778
20653d6f3d95 patch 8.1.0401: can't get swap name of another buffer
Christian Brabandt <cb@256bit.org>
parents: 14756
diff changeset
10553 If buffer {expr} has no swap file, returns an empty string.
20653d6f3d95 patch 8.1.0401: can't get swap name of another buffer
Christian Brabandt <cb@256bit.org>
parents: 14756
diff changeset
10554
18017
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10555 Can also be used as a |method|: >
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10556 GetBufname()->swapname()
988e5a868b60 patch 8.1.2004: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18008
diff changeset
10557
32
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
10558 synID({lnum}, {col}, {trans}) *synID()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10559 The result is a Number, which is the syntax ID at the position
32
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
10560 {lnum} and {col} in the current window.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10561 The syntax ID can be used with |synIDattr()| and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10562 |synIDtrans()| to obtain syntax information about text.
419
f713fc55bf7b updated for version 7.0109
vimboss
parents: 401
diff changeset
10563
32
41f9fd58cf13 updated for version 7.0019
vimboss
parents: 29
diff changeset
10564 {col} is 1 for the leftmost column, {lnum} is 1 for the first
419
f713fc55bf7b updated for version 7.0109
vimboss
parents: 401
diff changeset
10565 line. 'synmaxcol' applies, in a longer line zero is returned.
7147
c590de398af9 commit https://github.com/vim/vim/commit/ca63501fbcd1cf9c8aa9ff12c093c95b62a89ed7
Christian Brabandt <cb@256bit.org>
parents: 7100
diff changeset
10566 Note that when the position is after the last character,
c590de398af9 commit https://github.com/vim/vim/commit/ca63501fbcd1cf9c8aa9ff12c093c95b62a89ed7
Christian Brabandt <cb@256bit.org>
parents: 7100
diff changeset
10567 that's where the cursor can be in Insert mode, synID() returns
c590de398af9 commit https://github.com/vim/vim/commit/ca63501fbcd1cf9c8aa9ff12c093c95b62a89ed7
Christian Brabandt <cb@256bit.org>
parents: 7100
diff changeset
10568 zero.
419
f713fc55bf7b updated for version 7.0109
vimboss
parents: 401
diff changeset
10569
9454
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
10570 When {trans} is |TRUE|, transparent items are reduced to the
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
10571 item that they reveal. This is useful when wanting to know
9454
9da0cb39cbee commit https://github.com/vim/vim/commit/79815f1ec77406f2f21a618c053e5793b597db7a
Christian Brabandt <cb@256bit.org>
parents: 9430
diff changeset
10572 the effective color. When {trans} is |FALSE|, the transparent
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10573 item is returned. This is useful when wanting to know which
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10574 syntax item is effective (e.g. inside parens).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10575 Warning: This function can be very slow. Best speed is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10576 obtained by going through the file in forward direction.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10577
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10578 Example (echoes the name of the syntax item under the cursor): >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10579 :echo synIDattr(synID(line("."), col("."), 1), "name")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10580 <
2401
e7751177126b Add the synconcealed() function and use it for :TOhtml. (Benjamin Fritz)
Bram Moolenaar <bram@vim.org>
parents: 2350
diff changeset
10581
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10582 synIDattr({synID}, {what} [, {mode}]) *synIDattr()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10583 The result is a String, which is the {what} attribute of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10584 syntax ID {synID}. This can be used to obtain information
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10585 about a syntax item.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10586 {mode} can be "gui", "cterm" or "term", to get the attributes
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
10587 for that mode. When {mode} is omitted, or an invalid value is
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10588 used, the attributes for the currently active highlighting are
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10589 used (GUI, cterm or term).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10590 Use synIDtrans() to follow linked highlight groups.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10591 {what} result
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10592 "name" the name of the syntax item
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10593 "fg" foreground color (GUI: color name used to set
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10594 the color, cterm: color number as a string,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10595 term: empty string)
1755
0c6c64edcbe0 updated for version 7.2-052
vimboss
parents: 1754
diff changeset
10596 "bg" background color (as with "fg")
2106
15674e198164 updated for version 7.2.389
Bram Moolenaar <bram@zimbu.org>
parents: 2072
diff changeset
10597 "font" font name (only available in the GUI)
15674e198164 updated for version 7.2.389
Bram Moolenaar <bram@zimbu.org>
parents: 2072
diff changeset
10598 |highlight-font|
22446
0cdb03e73ce9 patch 8.2.1771: synIDattr() cannot get the value of ctermul
Bram Moolenaar <Bram@vim.org>
parents: 22441
diff changeset
10599 "sp" special color for the GUI (as with "fg")
0cdb03e73ce9 patch 8.2.1771: synIDattr() cannot get the value of ctermul
Bram Moolenaar <Bram@vim.org>
parents: 22441
diff changeset
10600 |highlight-guisp|
0cdb03e73ce9 patch 8.2.1771: synIDattr() cannot get the value of ctermul
Bram Moolenaar <Bram@vim.org>
parents: 22441
diff changeset
10601 "ul" underline color for cterm: number as a string
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10602 "fg#" like "fg", but for the GUI and the GUI is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10603 running the name in "#RRGGBB" form
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10604 "bg#" like "fg#" for "bg"
1755
0c6c64edcbe0 updated for version 7.2-052
vimboss
parents: 1754
diff changeset
10605 "sp#" like "fg#" for "sp"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10606 "bold" "1" if bold
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10607 "italic" "1" if italic
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10608 "reverse" "1" if reverse
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10609 "inverse" "1" if inverse (= reverse)
2106
15674e198164 updated for version 7.2.389
Bram Moolenaar <bram@zimbu.org>
parents: 2072
diff changeset
10610 "standout" "1" if standout
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10611 "underline" "1" if underlined
205
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10612 "undercurl" "1" if undercurled
12317
2a8890b80923 patch 8.0.1038: strike-through text not supported
Christian Brabandt <cb@256bit.org>
parents: 12311
diff changeset
10613 "strike" "1" if strikethrough
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10614
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10615 Example (echoes the color of the syntax item under the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10616 cursor): >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10617 :echo synIDattr(synIDtrans(synID(line("."), col("."), 1)), "fg")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10618 <
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10619 Can also be used as a |method|: >
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10620 :echo synID(line("."), col("."), 1)->synIDtrans()->synIDattr("fg")
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10621
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10622
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10623 synIDtrans({synID}) *synIDtrans()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10624 The result is a Number, which is the translated syntax ID of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10625 {synID}. This is the syntax group ID of what is being used to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10626 highlight the character. Highlight links given with
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10627 ":highlight link" are followed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10628
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10629 Can also be used as a |method|: >
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10630 :echo synID(line("."), col("."), 1)->synIDtrans()->synIDattr("fg")
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10631
2608
7d8af31066c8 Updated runtime files and translations.
Bram Moolenaar <bram@vim.org>
parents: 2596
diff changeset
10632 synconcealed({lnum}, {col}) *synconcealed()*
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
10633 The result is a |List| with currently three items:
11553
cbceef33af7a patch 8.0.0659: no test for conceal mode
Christian Brabandt <cb@256bit.org>
parents: 11549
diff changeset
10634 1. The first item in the list is 0 if the character at the
cbceef33af7a patch 8.0.0659: no test for conceal mode
Christian Brabandt <cb@256bit.org>
parents: 11549
diff changeset
10635 position {lnum} and {col} is not part of a concealable
cbceef33af7a patch 8.0.0659: no test for conceal mode
Christian Brabandt <cb@256bit.org>
parents: 11549
diff changeset
10636 region, 1 if it is.
cbceef33af7a patch 8.0.0659: no test for conceal mode
Christian Brabandt <cb@256bit.org>
parents: 11549
diff changeset
10637 2. The second item in the list is a string. If the first item
cbceef33af7a patch 8.0.0659: no test for conceal mode
Christian Brabandt <cb@256bit.org>
parents: 11549
diff changeset
10638 is 1, the second item contains the text which will be
cbceef33af7a patch 8.0.0659: no test for conceal mode
Christian Brabandt <cb@256bit.org>
parents: 11549
diff changeset
10639 displayed in place of the concealed text, depending on the
cbceef33af7a patch 8.0.0659: no test for conceal mode
Christian Brabandt <cb@256bit.org>
parents: 11549
diff changeset
10640 current setting of 'conceallevel' and 'listchars'.
11579
52e3a77c097b patch 8.0.0672: third item of synconcealed() changes too often
Christian Brabandt <cb@256bit.org>
parents: 11561
diff changeset
10641 3. The third and final item in the list is a number
52e3a77c097b patch 8.0.0672: third item of synconcealed() changes too often
Christian Brabandt <cb@256bit.org>
parents: 11561
diff changeset
10642 representing the specific syntax region matched in the
52e3a77c097b patch 8.0.0672: third item of synconcealed() changes too often
Christian Brabandt <cb@256bit.org>
parents: 11561
diff changeset
10643 line. When the character is not concealed the value is
52e3a77c097b patch 8.0.0672: third item of synconcealed() changes too often
Christian Brabandt <cb@256bit.org>
parents: 11561
diff changeset
10644 zero. This allows detection of the beginning of a new
52e3a77c097b patch 8.0.0672: third item of synconcealed() changes too often
Christian Brabandt <cb@256bit.org>
parents: 11561
diff changeset
10645 concealable region if there are two consecutive regions
52e3a77c097b patch 8.0.0672: third item of synconcealed() changes too often
Christian Brabandt <cb@256bit.org>
parents: 11561
diff changeset
10646 with the same replacement character. For an example, if
52e3a77c097b patch 8.0.0672: third item of synconcealed() changes too often
Christian Brabandt <cb@256bit.org>
parents: 11561
diff changeset
10647 the text is "123456" and both "23" and "45" are concealed
14864
40ef13331e02 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14778
diff changeset
10648 and replaced by the character "X", then:
11579
52e3a77c097b patch 8.0.0672: third item of synconcealed() changes too often
Christian Brabandt <cb@256bit.org>
parents: 11561
diff changeset
10649 call returns ~
12254
8d76a56861ec Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 12252
diff changeset
10650 synconcealed(lnum, 1) [0, '', 0]
8d76a56861ec Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 12252
diff changeset
10651 synconcealed(lnum, 2) [1, 'X', 1]
8d76a56861ec Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 12252
diff changeset
10652 synconcealed(lnum, 3) [1, 'X', 1]
8d76a56861ec Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 12252
diff changeset
10653 synconcealed(lnum, 4) [1, 'X', 2]
8d76a56861ec Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 12252
diff changeset
10654 synconcealed(lnum, 5) [1, 'X', 2]
8d76a56861ec Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 12252
diff changeset
10655 synconcealed(lnum, 6) [0, '', 0]
2608
7d8af31066c8 Updated runtime files and translations.
Bram Moolenaar <bram@vim.org>
parents: 2596
diff changeset
10656
7d8af31066c8 Updated runtime files and translations.
Bram Moolenaar <bram@vim.org>
parents: 2596
diff changeset
10657
1500
ea9f418ed072 updated for version 7.1-215
vimboss
parents: 1496
diff changeset
10658 synstack({lnum}, {col}) *synstack()*
ea9f418ed072 updated for version 7.1-215
vimboss
parents: 1496
diff changeset
10659 Return a |List|, which is the stack of syntax items at the
ea9f418ed072 updated for version 7.1-215
vimboss
parents: 1496
diff changeset
10660 position {lnum} and {col} in the current window. Each item in
ea9f418ed072 updated for version 7.1-215
vimboss
parents: 1496
diff changeset
10661 the List is an ID like what |synID()| returns.
ea9f418ed072 updated for version 7.1-215
vimboss
parents: 1496
diff changeset
10662 The first item in the List is the outer region, following are
ea9f418ed072 updated for version 7.1-215
vimboss
parents: 1496
diff changeset
10663 items contained in that one. The last one is what |synID()|
ea9f418ed072 updated for version 7.1-215
vimboss
parents: 1496
diff changeset
10664 returns, unless not the whole item is highlighted or it is a
ea9f418ed072 updated for version 7.1-215
vimboss
parents: 1496
diff changeset
10665 transparent item.
ea9f418ed072 updated for version 7.1-215
vimboss
parents: 1496
diff changeset
10666 This function is useful for debugging a syntax file.
ea9f418ed072 updated for version 7.1-215
vimboss
parents: 1496
diff changeset
10667 Example that shows the syntax stack under the cursor: >
ea9f418ed072 updated for version 7.1-215
vimboss
parents: 1496
diff changeset
10668 for id in synstack(line("."), col("."))
ea9f418ed072 updated for version 7.1-215
vimboss
parents: 1496
diff changeset
10669 echo synIDattr(id, "name")
ea9f418ed072 updated for version 7.1-215
vimboss
parents: 1496
diff changeset
10670 endfor
2290
22529abcd646 Fixed ":s" message. Docs updates.
Bram Moolenaar <bram@vim.org>
parents: 2281
diff changeset
10671 < When the position specified with {lnum} and {col} is invalid
22529abcd646 Fixed ":s" message. Docs updates.
Bram Moolenaar <bram@vim.org>
parents: 2281
diff changeset
10672 nothing is returned. The position just after the last
22529abcd646 Fixed ":s" message. Docs updates.
Bram Moolenaar <bram@vim.org>
parents: 2281
diff changeset
10673 character in a line and the first column in an empty line are
22529abcd646 Fixed ":s" message. Docs updates.
Bram Moolenaar <bram@vim.org>
parents: 2281
diff changeset
10674 valid positions.
1500
ea9f418ed072 updated for version 7.1-215
vimboss
parents: 1496
diff changeset
10675
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
10676 system({expr} [, {input}]) *system()* *E677*
5808
e5f1f2ea0b4a updated for version 7.4.248
Bram Moolenaar <bram@vim.org>
parents: 5806
diff changeset
10677 Get the output of the shell command {expr} as a string. See
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
10678 |systemlist()| to get the output as a |List|.
5806
76863b4b48a3 updated for version 7.4.247
Bram Moolenaar <bram@vim.org>
parents: 5798
diff changeset
10679
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10680 When {input} is given and is a string this string is written
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10681 to a file and passed as stdin to the command. The string is
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10682 written as-is, you need to take care of using the correct line
5806
76863b4b48a3 updated for version 7.4.247
Bram Moolenaar <bram@vim.org>
parents: 5798
diff changeset
10683 separators yourself.
76863b4b48a3 updated for version 7.4.247
Bram Moolenaar <bram@vim.org>
parents: 5798
diff changeset
10684 If {input} is given and is a |List| it is written to the file
76863b4b48a3 updated for version 7.4.247
Bram Moolenaar <bram@vim.org>
parents: 5798
diff changeset
10685 in a way |writefile()| does with {binary} set to "b" (i.e.
76863b4b48a3 updated for version 7.4.247
Bram Moolenaar <bram@vim.org>
parents: 5798
diff changeset
10686 with a newline between each list item with newlines inside
10522
7232cd9f8a7c commit https://github.com/vim/vim/commit/12c4492dd35e0cd83c8816be2ec849b836109882
Christian Brabandt <cb@256bit.org>
parents: 10449
diff changeset
10687 list items converted to NULs).
7232cd9f8a7c commit https://github.com/vim/vim/commit/12c4492dd35e0cd83c8816be2ec849b836109882
Christian Brabandt <cb@256bit.org>
parents: 10449
diff changeset
10688 When {input} is given and is a number that is a valid id for
7232cd9f8a7c commit https://github.com/vim/vim/commit/12c4492dd35e0cd83c8816be2ec849b836109882
Christian Brabandt <cb@256bit.org>
parents: 10449
diff changeset
10689 an existing buffer then the content of the buffer is written
7232cd9f8a7c commit https://github.com/vim/vim/commit/12c4492dd35e0cd83c8816be2ec849b836109882
Christian Brabandt <cb@256bit.org>
parents: 10449
diff changeset
10690 to the file line by line, each line terminated by a NL and
7232cd9f8a7c commit https://github.com/vim/vim/commit/12c4492dd35e0cd83c8816be2ec849b836109882
Christian Brabandt <cb@256bit.org>
parents: 10449
diff changeset
10691 NULs characters where the text has a NL.
9527
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
10692
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
10693 Pipes are not used, the 'shelltemp' option is not used.
5806
76863b4b48a3 updated for version 7.4.247
Bram Moolenaar <bram@vim.org>
parents: 5798
diff changeset
10694
10038
7cf4e210cf3c commit https://github.com/vim/vim/commit/04186095346daa60e82e981dad114de2b641d672
Christian Brabandt <cb@256bit.org>
parents: 10027
diff changeset
10695 When prepended by |:silent| the terminal will not be set to
6183
fca35aa9380a updated for version 7.4.427
Bram Moolenaar <bram@vim.org>
parents: 6180
diff changeset
10696 cooked mode. This is meant to be used for commands that do
fca35aa9380a updated for version 7.4.427
Bram Moolenaar <bram@vim.org>
parents: 6180
diff changeset
10697 not need the user to type. It avoids stray characters showing
fca35aa9380a updated for version 7.4.427
Bram Moolenaar <bram@vim.org>
parents: 6180
diff changeset
10698 up on the screen which require |CTRL-L| to remove. >
fca35aa9380a updated for version 7.4.427
Bram Moolenaar <bram@vim.org>
parents: 6180
diff changeset
10699 :silent let f = system('ls *.vim')
fca35aa9380a updated for version 7.4.427
Bram Moolenaar <bram@vim.org>
parents: 6180
diff changeset
10700 <
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10701 Note: Use |shellescape()| or |::S| with |expand()| or
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10702 |fnamemodify()| to escape special characters in a command
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10703 argument. Newlines in {expr} may cause the command to fail.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10704 The characters in 'shellquote' and 'shellxquote' may also
5690
40f18a1c1592 updated for version 7.4.191
Bram Moolenaar <bram@vim.org>
parents: 5663
diff changeset
10705 cause trouble.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10706 This is not to be used for interactive commands.
1661
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
10707
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10708 The result is a String. Example: >
1661
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
10709 :let files = system("ls " . shellescape(expand('%:h')))
5690
40f18a1c1592 updated for version 7.4.191
Bram Moolenaar <bram@vim.org>
parents: 5663
diff changeset
10710 :let files = system('ls ' . expand('%:h:S'))
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10711
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10712 < To make the result more system-independent, the shell output
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10713 is filtered to replace <CR> with <NL> for Macintosh, and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10714 <CR><NL> with <NL> for DOS-like systems.
5277
42bf9264e64e Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5247
diff changeset
10715 To avoid the string being truncated at a NUL, all NUL
42bf9264e64e Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5247
diff changeset
10716 characters are replaced with SOH (0x01).
42bf9264e64e Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5247
diff changeset
10717
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10718 The command executed is constructed using several options:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10719 'shell' 'shellcmdflag' 'shellxquote' {expr} 'shellredir' {tmp} 'shellxquote'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10720 ({tmp} is an automatically generated file name).
18912
ccd16426a1f9 patch 8.2.0017: OS/2 and MS-DOS are still mentioned
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
10721 For Unix, braces are put around {expr} to allow for
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10722 concatenated commands.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10723
794
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
10724 The command will be executed in "cooked" mode, so that a
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
10725 CTRL-C will interrupt the command (on Unix at least).
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
10726
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10727 The resulting error code can be found in |v:shell_error|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10728 This function will fail in |restricted-mode|.
625
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 620
diff changeset
10729
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 620
diff changeset
10730 Note that any wrong value in the options mentioned above may
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 620
diff changeset
10731 make the function fail. It has also been reported to fail
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 620
diff changeset
10732 when using a security agent application.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10733 Unlike ":!cmd" there is no automatic check for changed files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10734 Use |:checktime| to force a check.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10735
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10736 Can also be used as a |method|: >
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10737 :echo GetCmd()->system()
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10738
205
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10739
5808
e5f1f2ea0b4a updated for version 7.4.248
Bram Moolenaar <bram@vim.org>
parents: 5806
diff changeset
10740 systemlist({expr} [, {input}]) *systemlist()*
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10741 Same as |system()|, but returns a |List| with lines (parts of
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10742 output separated by NL) with NULs transformed into NLs. Output
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10743 is the same as |readfile()| will output with {binary} argument
18186
03b854983b14 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18170
diff changeset
10744 set to "b", except that there is no extra empty item when the
03b854983b14 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18170
diff changeset
10745 result ends in a NL.
03b854983b14 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18170
diff changeset
10746 Note that on MS-Windows you may get trailing CR characters.
03b854983b14 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18170
diff changeset
10747
03b854983b14 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18170
diff changeset
10748 To see the difference between "echo hello" and "echo -n hello"
03b854983b14 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18170
diff changeset
10749 use |system()| and |split()|: >
03b854983b14 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18170
diff changeset
10750 echo system('echo hello')->split('\n', 1)
03b854983b14 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18170
diff changeset
10751 <
8577
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
10752 Returns an empty string on error.
5808
e5f1f2ea0b4a updated for version 7.4.248
Bram Moolenaar <bram@vim.org>
parents: 5806
diff changeset
10753
17624
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10754 Can also be used as a |method|: >
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10755 :echo GetCmd()->systemlist()
4c7097a980a5 patch 8.1.1809: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17620
diff changeset
10756
5808
e5f1f2ea0b4a updated for version 7.4.248
Bram Moolenaar <bram@vim.org>
parents: 5806
diff changeset
10757
677
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10758 tabpagebuflist([{arg}]) *tabpagebuflist()*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
10759 The result is a |List|, where each item is the number of the
677
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10760 buffer associated with each window in the current tab page.
9887
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 9881
diff changeset
10761 {arg} specifies the number of the tab page to be used. When
677
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10762 omitted the current tab page is used.
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10763 When {arg} is invalid the number zero is returned.
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10764 To get a list of all buffers in all tabs use this: >
3445
2cfb68fa26cd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3410
diff changeset
10765 let buflist = []
677
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10766 for i in range(tabpagenr('$'))
3445
2cfb68fa26cd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3410
diff changeset
10767 call extend(buflist, tabpagebuflist(i + 1))
677
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10768 endfor
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10769 < Note that a buffer may appear in more than one window.
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10770
18031
8a2fb21c23c0 patch 8.1.2011: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18017
diff changeset
10771 Can also be used as a |method|: >
8a2fb21c23c0 patch 8.1.2011: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18017
diff changeset
10772 GetTabpage()->tabpagebuflist()
677
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10773
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10774 tabpagenr([{arg}]) *tabpagenr()*
674
4b8583e82cb8 updated for version 7.0201
vimboss
parents: 667
diff changeset
10775 The result is a Number, which is the number of the current
4b8583e82cb8 updated for version 7.0201
vimboss
parents: 667
diff changeset
10776 tab page. The first tab page has number 1.
21703
22583b9d4efd patch 8.2.1401: cannot jump to the last used tabpage
Bram Moolenaar <Bram@vim.org>
parents: 21676
diff changeset
10777
22583b9d4efd patch 8.2.1401: cannot jump to the last used tabpage
Bram Moolenaar <Bram@vim.org>
parents: 21676
diff changeset
10778 The optional argument {arg} supports the following values:
22583b9d4efd patch 8.2.1401: cannot jump to the last used tabpage
Bram Moolenaar <Bram@vim.org>
parents: 21676
diff changeset
10779 $ the number of the last tab page (the tab page
22583b9d4efd patch 8.2.1401: cannot jump to the last used tabpage
Bram Moolenaar <Bram@vim.org>
parents: 21676
diff changeset
10780 count).
22583b9d4efd patch 8.2.1401: cannot jump to the last used tabpage
Bram Moolenaar <Bram@vim.org>
parents: 21676
diff changeset
10781 # the number of the last accessed tab page
22583b9d4efd patch 8.2.1401: cannot jump to the last used tabpage
Bram Moolenaar <Bram@vim.org>
parents: 21676
diff changeset
10782 (where |g<Tab>| goes to). if there is no
22583b9d4efd patch 8.2.1401: cannot jump to the last used tabpage
Bram Moolenaar <Bram@vim.org>
parents: 21676
diff changeset
10783 previous tab page 0 is returned.
674
4b8583e82cb8 updated for version 7.0201
vimboss
parents: 667
diff changeset
10784 The number can be used with the |:tab| command.
4b8583e82cb8 updated for version 7.0201
vimboss
parents: 667
diff changeset
10785
4b8583e82cb8 updated for version 7.0201
vimboss
parents: 667
diff changeset
10786
5763
c52a655d927d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5747
diff changeset
10787 tabpagewinnr({tabarg} [, {arg}]) *tabpagewinnr()*
2569
f612f6b0b883 Docs fix for tabpagewinnr(). (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2561
diff changeset
10788 Like |winnr()| but for tab page {tabarg}.
677
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10789 {tabarg} specifies the number of tab page to be used.
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10790 {arg} is used like with |winnr()|:
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10791 - When omitted the current window number is returned. This is
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10792 the window which will be used when going to this tab page.
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10793 - When "$" the number of windows is returned.
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10794 - When "#" the previous window nr is returned.
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10795 Useful examples: >
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10796 tabpagewinnr(1) " current window of tab page 1
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10797 tabpagewinnr(4, '$') " number of windows in tab page 4
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10798 < When {tabarg} is invalid zero is returned.
e649c78407e6 updated for version 7.0202
vimboss
parents: 674
diff changeset
10799
18031
8a2fb21c23c0 patch 8.1.2011: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18017
diff changeset
10800 Can also be used as a |method|: >
8a2fb21c23c0 patch 8.1.2011: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18017
diff changeset
10801 GetTabpage()->tabpagewinnr()
8a2fb21c23c0 patch 8.1.2011: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18017
diff changeset
10802 <
805
497fab3f99d6 updated for version 7.0b01
vimboss
parents: 800
diff changeset
10803 *tagfiles()*
497fab3f99d6 updated for version 7.0b01
vimboss
parents: 800
diff changeset
10804 tagfiles() Returns a |List| with the file names used to search for tags
497fab3f99d6 updated for version 7.0b01
vimboss
parents: 800
diff changeset
10805 for the current buffer. This is the 'tags' option expanded.
497fab3f99d6 updated for version 7.0b01
vimboss
parents: 800
diff changeset
10806
497fab3f99d6 updated for version 7.0b01
vimboss
parents: 800
diff changeset
10807
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
10808 taglist({expr} [, {filename}]) *taglist()*
23164
99ef85ff1af4 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23048
diff changeset
10809 Returns a |List| of tags matching the regular expression {expr}.
11225
d3415ec1cdaf patch 8.0.0499: taglist() does not prioritize tags for a buffer
Christian Brabandt <cb@256bit.org>
parents: 11211
diff changeset
10810
d3415ec1cdaf patch 8.0.0499: taglist() does not prioritize tags for a buffer
Christian Brabandt <cb@256bit.org>
parents: 11211
diff changeset
10811 If {filename} is passed it is used to prioritize the results
d3415ec1cdaf patch 8.0.0499: taglist() does not prioritize tags for a buffer
Christian Brabandt <cb@256bit.org>
parents: 11211
diff changeset
10812 in the same way that |:tselect| does. See |tag-priority|.
d3415ec1cdaf patch 8.0.0499: taglist() does not prioritize tags for a buffer
Christian Brabandt <cb@256bit.org>
parents: 11211
diff changeset
10813 {filename} should be the full path of the file.
d3415ec1cdaf patch 8.0.0499: taglist() does not prioritize tags for a buffer
Christian Brabandt <cb@256bit.org>
parents: 11211
diff changeset
10814
438
59b7b7e99c95 updated for version 7.0113
vimboss
parents: 435
diff changeset
10815 Each list item is a dictionary with at least the following
59b7b7e99c95 updated for version 7.0113
vimboss
parents: 435
diff changeset
10816 entries:
648
9032e4668296 updated for version 7.0189
vimboss
parents: 647
diff changeset
10817 name Name of the tag.
9032e4668296 updated for version 7.0189
vimboss
parents: 647
diff changeset
10818 filename Name of the file where the tag is
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
10819 defined. It is either relative to the
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
10820 current directory or a full path.
205
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10821 cmd Ex command used to locate the tag in
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10822 the file.
648
9032e4668296 updated for version 7.0189
vimboss
parents: 647
diff changeset
10823 kind Type of the tag. The value for this
205
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10824 entry depends on the language specific
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
10825 kind values. Only available when
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
10826 using a tags file generated by
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
10827 Exuberant ctags or hdrtag.
648
9032e4668296 updated for version 7.0189
vimboss
parents: 647
diff changeset
10828 static A file specific tag. Refer to
205
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10829 |static-tag| for more information.
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
10830 More entries may be present, depending on the content of the
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
10831 tags file: access, implementation, inherits and signature.
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
10832 Refer to the ctags documentation for information about these
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
10833 fields. For C code the fields "struct", "class" and "enum"
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
10834 may appear, they give the name of the entity the tag is
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
10835 contained in.
452
01af1008a8d8 updated for version 7.0120
vimboss
parents: 449
diff changeset
10836
11062
1218c5353e2b Runtime file updates.
Christian Brabandt <cb@256bit.org>
parents: 11032
diff changeset
10837 The ex-command "cmd" can be either an ex search pattern, a
216
da182deebec7 updated for version 7.0061
vimboss
parents: 205
diff changeset
10838 line number or a line number followed by a byte number.
205
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10839
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10840 If there are no matching tags, then an empty list is returned.
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10841
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10842 To get an exact tag match, the anchors '^' and '$' should be
4073
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 4051
diff changeset
10843 used in {expr}. This also make the function work faster.
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 4051
diff changeset
10844 Refer to |tag-regexp| for more information about the tag
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 4051
diff changeset
10845 search regular expression pattern.
205
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10846
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10847 Refer to |'tags'| for information about how the tags file is
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10848 located by Vim. Refer to |tags-file-format| for the format of
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10849 the tags file generated by the different ctags tools.
d292c40ca788 updated for version 7.0060
vimboss
parents: 189
diff changeset
10850
18031
8a2fb21c23c0 patch 8.1.2011: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18017
diff changeset
10851 Can also be used as a |method|: >
8a2fb21c23c0 patch 8.1.2011: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18017
diff changeset
10852 GetTagpattern()->taglist()
8a2fb21c23c0 patch 8.1.2011: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18017
diff changeset
10853
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10854 tan({expr}) *tan()*
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
10855 Return the tangent of {expr}, measured in radians, as a |Float|
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10856 in the range [-inf, inf].
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
10857 {expr} must evaluate to a |Float| or a |Number|.
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10858 Examples: >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10859 :echo tan(10)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10860 < 0.648361 >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10861 :echo tan(-4.01)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10862 < -1.181502
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10863
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10864 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10865 Compute()->tan()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10866 <
2570
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2569
diff changeset
10867 {only available when compiled with the |+float| feature}
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10868
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10869
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10870 tanh({expr}) *tanh()*
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
10871 Return the hyperbolic tangent of {expr} as a |Float| in the
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10872 range [-1, 1].
2337
a0f87fc19d1d Better conceal in help. (partly by Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 2320
diff changeset
10873 {expr} must evaluate to a |Float| or a |Number|.
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10874 Examples: >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10875 :echo tanh(0.5)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10876 < 0.462117 >
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10877 :echo tanh(-1)
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10878 < -0.761594
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10879
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10880 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10881 Compute()->tanh()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
10882 <
2570
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2569
diff changeset
10883 {only available when compiled with the |+float| feature}
2206
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10884
a8afba7027ae Add extra floating point functions.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
10885
9108
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
10886 tempname() *tempname()* *temp-file-name*
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
10887 The result is a String, which is the name of a file that
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
10888 doesn't exist. It can be used for a temporary file. The name
9108
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
10889 is different for at least 26 consecutive calls. Example: >
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
10890 :let tmpfile = tempname()
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
10891 :exe "redir > " . tmpfile
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
10892 < For Unix, the file will be in a private directory |tempfile|.
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
10893 For MS-Windows forward slashes are used when the 'shellslash'
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
10894 option is set or when 'shellcmdflag' starts with '-'.
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
10895
17456
e414281d8bb4 patch 8.1.1726: the eval.txt help file is too big
Bram Moolenaar <Bram@vim.org>
parents: 17450
diff changeset
10896
17259
6dbb9b3c53e2 patch 8.1.1629: terminal function help is in the wrong file
Bram Moolenaar <Bram@vim.org>
parents: 17257
diff changeset
10897 term_ functions are documented here: |terminal-function-details|
9108
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
10898
20836
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10899
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10900 terminalprops() *terminalprops()*
23164
99ef85ff1af4 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23048
diff changeset
10901 Returns a |Dictionary| with properties of the terminal that Vim
20836
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10902 detected from the response to |t_RV| request. See
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10903 |v:termresponse| for the response itself. If |v:termresponse|
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10904 is empty most values here will be 'u' for unknown.
22723
5b7ea82bc18f Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22689
diff changeset
10905 cursor_style whether sending |t_RS| works **
5b7ea82bc18f Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22689
diff changeset
10906 cursor_blink_mode whether sending |t_RC| works **
20836
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10907 underline_rgb whether |t_8u| works **
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10908 mouse mouse type supported
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10909
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10910 ** value 'u' for unknown, 'y' for yes, 'n' for no
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10911
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10912 If the |+termresponse| feature is missing then the result is
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10913 an empty dictionary.
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10914
20965
59f93c2d2551 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20889
diff changeset
10915 If "cursor_style" is 'y' then |t_RS| will be sent to request the
20836
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10916 current cursor style.
20965
59f93c2d2551 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20889
diff changeset
10917 If "cursor_blink_mode" is 'y' then |t_RC| will be sent to
20836
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10918 request the cursor blink status.
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10919 "cursor_style" and "cursor_blink_mode" are also set if |t_u7|
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10920 is not empty, Vim will detect the working of sending |t_RS|
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10921 and |t_RC| on startup.
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10922
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10923 When "underline_rgb" is not 'y', then |t_8u| will be made empty.
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10924 This avoids sending it to xterm, which would clear the colors.
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10925
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10926 For "mouse" the value 'u' is unknown
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10927
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10928 Also see:
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10929 - 'ambiwidth' - detected by using |t_u7|.
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10930 - |v:termstyleresp| and |v:termblinkresp| for the response to
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10931 |t_RS| and |t_RC|.
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10932
2616c5a337e0 patch 8.2.0970: terminal properties are not available in Vim script
Bram Moolenaar <Bram@vim.org>
parents: 20786
diff changeset
10933
17571
2704c4e3e20a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17545
diff changeset
10934 test_ functions are documented here: |test-functions-details|
17456
e414281d8bb4 patch 8.1.1726: the eval.txt help file is too big
Bram Moolenaar <Bram@vim.org>
parents: 17450
diff changeset
10935
9108
d319453f62b3 commit https://github.com/vim/vim/commit/574860b5ee9da281c875dad07a607454e135eaee
Christian Brabandt <cb@256bit.org>
parents: 9104
diff changeset
10936
9790
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
10937 *timer_info()*
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
10938 timer_info([{id}])
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
10939 Return a list with information about timers.
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
10940 When {id} is given only information about this timer is
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
10941 returned. When timer {id} does not exist an empty list is
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
10942 returned.
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
10943 When {id} is omitted information about all timers is returned.
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
10944
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
10945 For each timer the information is stored in a |Dictionary| with
9790
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
10946 these items:
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
10947 "id" the timer ID
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
10948 "time" time the timer was started with
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
10949 "remaining" time until the timer fires
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
10950 "repeat" number of times the timer will still fire;
9810
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
10951 -1 means forever
9790
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
10952 "callback" the callback
9810
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
10953 "paused" 1 if the timer is paused, 0 otherwise
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
10954
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
10955 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
10956 GetTimer()->timer_info()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
10957
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
10958 < {only available when compiled with the |+timers| feature}
9810
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
10959
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
10960 timer_pause({timer}, {paused}) *timer_pause()*
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
10961 Pause or unpause a timer. A paused timer does not invoke its
9887
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 9881
diff changeset
10962 callback when its time expires. Unpausing a timer may cause
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 9881
diff changeset
10963 the callback to be invoked almost immediately if enough time
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 9881
diff changeset
10964 has passed.
9810
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
10965
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
10966 Pausing a timer is useful to avoid the callback to be called
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
10967 for a short time.
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
10968
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
10969 If {paused} evaluates to a non-zero Number or a non-empty
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
10970 String, then the timer is paused, otherwise it is unpaused.
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
10971 See |non-zero-arg|.
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
10972
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
10973 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
10974 GetTimer()->timer_pause(1)
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
10975
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
10976 < {only available when compiled with the |+timers| feature}
9790
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
10977
9887
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 9881
diff changeset
10978 *timer_start()* *timer* *timers*
8577
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
10979 timer_start({time}, {callback} [, {options}])
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
10980 Create a timer and return the timer ID.
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
10981
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
10982 {time} is the waiting time in milliseconds. This is the
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
10983 minimum time before invoking the callback. When the system is
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
10984 busy or Vim is not waiting for input the time will be longer.
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
10985
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
10986 {callback} is the function to call. It can be the name of a
10051
46763b01cd9a commit https://github.com/vim/vim/commit/f37506f60f87d52a9e8850e30067645e2b13783c
Christian Brabandt <cb@256bit.org>
parents: 10048
diff changeset
10987 function or a |Funcref|. It is called with one argument, which
8577
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
10988 is the timer ID. The callback is only invoked when Vim is
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
10989 waiting for input.
23305
fab58304f77d Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23164
diff changeset
10990 If you want to show a message look at |popup_notification()|
23466
15fa3923cc49 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23380
diff changeset
10991 to avoid interfering with what the user is doing.
8577
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
10992
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
10993 {options} is a dictionary. Supported entries:
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
10994 "repeat" Number of times to repeat calling the
10153
715d6c5707b8 commit https://github.com/vim/vim/commit/abd468ed0fbcba391e7833feeaa7de3ced841455
Christian Brabandt <cb@256bit.org>
parents: 10140
diff changeset
10995 callback. -1 means forever. When not present
715d6c5707b8 commit https://github.com/vim/vim/commit/abd468ed0fbcba391e7833feeaa7de3ced841455
Christian Brabandt <cb@256bit.org>
parents: 10140
diff changeset
10996 the callback will be called once.
11639
71d7b5ed08a0 patch 8.0.0702: an error in a timer can make Vim unusable
Christian Brabandt <cb@256bit.org>
parents: 11609
diff changeset
10997 If the timer causes an error three times in a
71d7b5ed08a0 patch 8.0.0702: an error in a timer can make Vim unusable
Christian Brabandt <cb@256bit.org>
parents: 11609
diff changeset
10998 row the repeat is cancelled. This avoids that
71d7b5ed08a0 patch 8.0.0702: an error in a timer can make Vim unusable
Christian Brabandt <cb@256bit.org>
parents: 11609
diff changeset
10999 Vim becomes unusable because of all the error
71d7b5ed08a0 patch 8.0.0702: an error in a timer can make Vim unusable
Christian Brabandt <cb@256bit.org>
parents: 11609
diff changeset
11000 messages.
8577
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
11001
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
11002 Example: >
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
11003 func MyHandler(timer)
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
11004 echo 'Handler called'
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
11005 endfunc
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
11006 let timer = timer_start(500, 'MyHandler',
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
11007 \ {'repeat': 3})
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
11008 < This will invoke MyHandler() three times at 500 msec
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
11009 intervals.
9810
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
11010
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11011 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11012 GetMsec()->timer_start(callback)
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11013
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11014 < Not available in the |sandbox|.
8577
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
11015 {only available when compiled with the |+timers| feature}
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
11016
8669
06848fe9c816 commit https://github.com/vim/vim/commit/03602ec28ed25739e88b2c835adb0662d3720bb2
Christian Brabandt <cb@256bit.org>
parents: 8577
diff changeset
11017 timer_stop({timer}) *timer_stop()*
9097
071f9da012fb commit https://github.com/vim/vim/commit/06d2d38ab7564e1f784b1058a4ef4580cd6d1810
Christian Brabandt <cb@256bit.org>
parents: 9076
diff changeset
11018 Stop a timer. The timer callback will no longer be invoked.
071f9da012fb commit https://github.com/vim/vim/commit/06d2d38ab7564e1f784b1058a4ef4580cd6d1810
Christian Brabandt <cb@256bit.org>
parents: 9076
diff changeset
11019 {timer} is an ID returned by timer_start(), thus it must be a
9790
34cc6a101340 commit https://github.com/vim/vim/commit/8e97bd74b5377753597e3d98e7123d8985c7fffd
Christian Brabandt <cb@256bit.org>
parents: 9737
diff changeset
11020 Number. If {timer} does not exist there is no error.
8669
06848fe9c816 commit https://github.com/vim/vim/commit/03602ec28ed25739e88b2c835adb0662d3720bb2
Christian Brabandt <cb@256bit.org>
parents: 8577
diff changeset
11021
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11022 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11023 GetTimer()->timer_stop()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11024
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11025 < {only available when compiled with the |+timers| feature}
9810
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
11026
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
11027 timer_stopall() *timer_stopall()*
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
11028 Stop all timers. The timer callbacks will no longer be
17366
9843fbfa0ee5 patch 8.1.1682: placing a larger number of signs is slow
Bram Moolenaar <Bram@vim.org>
parents: 17292
diff changeset
11029 invoked. Useful if a timer is misbehaving. If there are no
9843fbfa0ee5 patch 8.1.1682: placing a larger number of signs is slow
Bram Moolenaar <Bram@vim.org>
parents: 17292
diff changeset
11030 timers there is no error.
9810
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
11031
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
11032 {only available when compiled with the |+timers| feature}
6a28d0c6f929 commit https://github.com/vim/vim/commit/b73598e2f022a22fec512ea681c70d2775e8fd87
Christian Brabandt <cb@256bit.org>
parents: 9790
diff changeset
11033
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11034 tolower({expr}) *tolower()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11035 The result is a copy of the String given, with all uppercase
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11036 characters turned into lowercase (just like applying |gu| to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11037 the string).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11038
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11039 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11040 GetText()->tolower()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11041
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11042 toupper({expr}) *toupper()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11043 The result is a copy of the String given, with all lowercase
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11044 characters turned into uppercase (just like applying |gU| to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11045 the string).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11046
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11047 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11048 GetText()->toupper()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11049
15
631143ac4a01 updated for version 7.0007
vimboss
parents: 14
diff changeset
11050 tr({src}, {fromstr}, {tostr}) *tr()*
631143ac4a01 updated for version 7.0007
vimboss
parents: 14
diff changeset
11051 The result is a copy of the {src} string with all characters
631143ac4a01 updated for version 7.0007
vimboss
parents: 14
diff changeset
11052 which appear in {fromstr} replaced by the character in that
631143ac4a01 updated for version 7.0007
vimboss
parents: 14
diff changeset
11053 position in the {tostr} string. Thus the first character in
631143ac4a01 updated for version 7.0007
vimboss
parents: 14
diff changeset
11054 {fromstr} is translated into the first character in {tostr}
631143ac4a01 updated for version 7.0007
vimboss
parents: 14
diff changeset
11055 and so on. Exactly like the unix "tr" command.
631143ac4a01 updated for version 7.0007
vimboss
parents: 14
diff changeset
11056 This code also deals with multibyte characters properly.
631143ac4a01 updated for version 7.0007
vimboss
parents: 14
diff changeset
11057
631143ac4a01 updated for version 7.0007
vimboss
parents: 14
diff changeset
11058 Examples: >
631143ac4a01 updated for version 7.0007
vimboss
parents: 14
diff changeset
11059 echo tr("hello there", "ht", "HT")
631143ac4a01 updated for version 7.0007
vimboss
parents: 14
diff changeset
11060 < returns "Hello THere" >
631143ac4a01 updated for version 7.0007
vimboss
parents: 14
diff changeset
11061 echo tr("<blob>", "<>", "{}")
631143ac4a01 updated for version 7.0007
vimboss
parents: 14
diff changeset
11062 < returns "{blob}"
631143ac4a01 updated for version 7.0007
vimboss
parents: 14
diff changeset
11063
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11064 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11065 GetText()->tr(from, to)
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11066
20629
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
11067 trim({text} [, {mask} [, {dir}]]) *trim()*
13513
4064f342bea4 patch 8.0.1630: trimming white space is not that easy
Christian Brabandt <cb@256bit.org>
parents: 13501
diff changeset
11068 Return {text} as a String where any character in {mask} is
20629
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
11069 removed from the beginning and/or end of {text}.
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
11070
13513
4064f342bea4 patch 8.0.1630: trimming white space is not that easy
Christian Brabandt <cb@256bit.org>
parents: 13501
diff changeset
11071 If {mask} is not given, {mask} is all characters up to 0x20,
4064f342bea4 patch 8.0.1630: trimming white space is not that easy
Christian Brabandt <cb@256bit.org>
parents: 13501
diff changeset
11072 which includes Tab, space, NL and CR, plus the non-breaking
4064f342bea4 patch 8.0.1630: trimming white space is not that easy
Christian Brabandt <cb@256bit.org>
parents: 13501
diff changeset
11073 space character 0xa0.
20629
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
11074
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
11075 The optional {dir} argument specifies where to remove the
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
11076 characters:
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
11077 0 remove from the beginning and end of {text}
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
11078 1 remove only at the beginning of {text}
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
11079 2 remove only at the end of {text}
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
11080 When omitted both ends are trimmed.
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
11081
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
11082 This function deals with multibyte characters properly.
13513
4064f342bea4 patch 8.0.1630: trimming white space is not that easy
Christian Brabandt <cb@256bit.org>
parents: 13501
diff changeset
11083
4064f342bea4 patch 8.0.1630: trimming white space is not that easy
Christian Brabandt <cb@256bit.org>
parents: 13501
diff changeset
11084 Examples: >
13563
5923f64c8f5b Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 13551
diff changeset
11085 echo trim(" some text ")
5923f64c8f5b Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 13551
diff changeset
11086 < returns "some text" >
5923f64c8f5b Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 13551
diff changeset
11087 echo trim(" \r\t\t\r RESERVE \t\n\x0B\xA0") . "_TAIL"
13513
4064f342bea4 patch 8.0.1630: trimming white space is not that easy
Christian Brabandt <cb@256bit.org>
parents: 13501
diff changeset
11088 < returns "RESERVE_TAIL" >
13563
5923f64c8f5b Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 13551
diff changeset
11089 echo trim("rm<Xrm<>X>rrm", "rm<>")
20629
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
11090 < returns "Xrm<>X" (characters in the middle are not removed) >
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
11091 echo trim(" vim ", " ", 2)
7b8ac5e49451 patch 8.2.0868: trim() always trims both ends
Bram Moolenaar <Bram@vim.org>
parents: 20627
diff changeset
11092 < returns " vim"
13513
4064f342bea4 patch 8.0.1630: trimming white space is not that easy
Christian Brabandt <cb@256bit.org>
parents: 13501
diff changeset
11093
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11094 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11095 GetText()->trim()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11096
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11097 trunc({expr}) *trunc()*
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
11098 Return the largest integral value with magnitude less than or
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11099 equal to {expr} as a |Float| (truncate towards zero).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11100 {expr} must evaluate to a |Float| or a |Number|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11101 Examples: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11102 echo trunc(1.456)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11103 < 1.0 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11104 echo trunc(-5.456)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11105 < -5.0 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11106 echo trunc(4.0)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11107 < 4.0
17765
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
11108
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
11109 Can also be used as a |method|: >
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
11110 Compute()->trunc()
545119cd5554 patch 8.1.1879: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
11111 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11112 {only available when compiled with the |+float| feature}
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
11113
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
11114 *type()*
9626
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
11115 type({expr}) The result is a Number representing the type of {expr}.
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
11116 Instead of using the number directly, it is better to use the
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
11117 v:t_ variable that has the value:
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
11118 Number: 0 |v:t_number|
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
11119 String: 1 |v:t_string|
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
11120 Funcref: 2 |v:t_func|
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
11121 List: 3 |v:t_list|
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
11122 Dictionary: 4 |v:t_dict|
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
11123 Float: 5 |v:t_float|
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
11124 Boolean: 6 |v:t_bool| (v:false and v:true)
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11125 None: 7 |v:t_none| (v:null and v:none)
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11126 Job: 8 |v:t_job|
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11127 Channel: 9 |v:t_channel|
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11128 Blob: 10 |v:t_blob|
9626
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
11129 For backward compatibility, this method can be used: >
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
11130 :if type(myvar) == type(0)
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
11131 :if type(myvar) == type("")
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
11132 :if type(myvar) == type(function("tr"))
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
11133 :if type(myvar) == type([])
153
19670b05ee32 updated for version 7.0047
vimboss
parents: 148
diff changeset
11134 :if type(myvar) == type({})
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11135 :if type(myvar) == type(0.0)
7742
5f6f35a3cb12 commit https://github.com/vim/vim/commit/705ada1aff27ecd9c47c690df817d043c2ceb5e2
Christian Brabandt <cb@256bit.org>
parents: 7712
diff changeset
11136 :if type(myvar) == type(v:false)
8031
ece323e2b57f commit https://github.com/vim/vim/commit/6463ca229cb9412581419497924c85fcbfc854ab
Christian Brabandt <cb@256bit.org>
parents: 8019
diff changeset
11137 :if type(myvar) == type(v:none)
9626
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
11138 < To check if the v:t_ variables exist use this: >
172131507c85 commit https://github.com/vim/vim/commit/df48fb456fb6bf63d94cad9b302ff01d8ee8d311
Christian Brabandt <cb@256bit.org>
parents: 9587
diff changeset
11139 :if exists('v:t_number')
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11140
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
11141 < Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
11142 mylist->type()
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
11143
23594
d3e064f54890 patch 8.2.2339: cannot get the type of a value as a string
Bram Moolenaar <Bram@vim.org>
parents: 23588
diff changeset
11144
d3e064f54890 patch 8.2.2339: cannot get the type of a value as a string
Bram Moolenaar <Bram@vim.org>
parents: 23588
diff changeset
11145 typename({expr}) *typename()*
d3e064f54890 patch 8.2.2339: cannot get the type of a value as a string
Bram Moolenaar <Bram@vim.org>
parents: 23588
diff changeset
11146 Return a string representation of the type of {expr}.
d3e064f54890 patch 8.2.2339: cannot get the type of a value as a string
Bram Moolenaar <Bram@vim.org>
parents: 23588
diff changeset
11147 Example: >
d3e064f54890 patch 8.2.2339: cannot get the type of a value as a string
Bram Moolenaar <Bram@vim.org>
parents: 23588
diff changeset
11148 echo typename([1, 2, 3])
d3e064f54890 patch 8.2.2339: cannot get the type of a value as a string
Bram Moolenaar <Bram@vim.org>
parents: 23588
diff changeset
11149 list<number>
d3e064f54890 patch 8.2.2339: cannot get the type of a value as a string
Bram Moolenaar <Bram@vim.org>
parents: 23588
diff changeset
11150
d3e064f54890 patch 8.2.2339: cannot get the type of a value as a string
Bram Moolenaar <Bram@vim.org>
parents: 23588
diff changeset
11151
2236
dc2e5ec0500d Added the undofile() function. Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2226
diff changeset
11152 undofile({name}) *undofile()*
dc2e5ec0500d Added the undofile() function. Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2226
diff changeset
11153 Return the name of the undo file that would be used for a file
dc2e5ec0500d Added the undofile() function. Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2226
diff changeset
11154 with name {name} when writing. This uses the 'undodir'
dc2e5ec0500d Added the undofile() function. Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2226
diff changeset
11155 option, finding directories that exist. It does not check if
2250
1bac28a53fae Add the conceal patch from Vince Negri.
Bram Moolenaar <bram@vim.org>
parents: 2249
diff changeset
11156 the undo file exists.
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2236
diff changeset
11157 {name} is always expanded to the full path, since that is what
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2236
diff changeset
11158 is used internally.
3507
8201108e9cf0 More runtime file fixes for 'compatible' mode.
Bram Moolenaar <bram@vim.org>
parents: 3492
diff changeset
11159 If {name} is empty undofile() returns an empty string, since a
8201108e9cf0 More runtime file fixes for 'compatible' mode.
Bram Moolenaar <bram@vim.org>
parents: 3492
diff changeset
11160 buffer without a file name will not write an undo file.
2236
dc2e5ec0500d Added the undofile() function. Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2226
diff changeset
11161 Useful in combination with |:wundo| and |:rundo|.
15378
0d76dd701e49 patch 8.1.0697: ":sign place" requires the buffer argument
Bram Moolenaar <Bram@vim.org>
parents: 15335
diff changeset
11162 When compiled without the |+persistent_undo| option this always
2236
dc2e5ec0500d Added the undofile() function. Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2226
diff changeset
11163 returns an empty string.
dc2e5ec0500d Added the undofile() function. Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2226
diff changeset
11164
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11165 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11166 GetFilename()->undofile()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11167
2280
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11168 undotree() *undotree()*
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11169 Return the current state of the undo tree in a dictionary with
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11170 the following items:
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11171 "seq_last" The highest undo sequence number used.
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11172 "seq_cur" The sequence number of the current position in
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11173 the undo tree. This differs from "seq_last"
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11174 when some changes were undone.
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11175 "time_cur" Time last used for |:earlier| and related
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11176 commands. Use |strftime()| to convert to
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11177 something readable.
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11178 "save_last" Number of the last file write. Zero when no
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11179 write yet.
2281
e41433ea71df Added ":earlier 1f" and ":later 1f".
Bram Moolenaar <bram@vim.org>
parents: 2280
diff changeset
11180 "save_cur" Number of the current position in the undo
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
11181 tree.
2280
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11182 "synced" Non-zero when the last undo block was synced.
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11183 This happens when waiting from input from the
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11184 user. See |undo-blocks|.
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11185 "entries" A list of dictionaries with information about
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11186 undo blocks.
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11187
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11188 The first item in the "entries" list is the oldest undo item.
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
11189 Each List item is a |Dictionary| with these items:
2280
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11190 "seq" Undo sequence number. Same as what appears in
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11191 |:undolist|.
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11192 "time" Timestamp when the change happened. Use
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11193 |strftime()| to convert to something readable.
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11194 "newhead" Only appears in the item that is the last one
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11195 that was added. This marks the last change
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11196 and where further changes will be added.
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11197 "curhead" Only appears in the item that is the last one
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11198 that was undone. This marks the current
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11199 position in the undo tree, the block that will
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11200 be used by a redo command. When nothing was
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11201 undone after the last change this item will
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11202 not appear anywhere.
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11203 "save" Only appears on the last block before a file
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11204 write. The number is the write count. The
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11205 first write has number 1, the last one the
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11206 "save_last" mentioned above.
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11207 "alt" Alternate entry. This is again a List of undo
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11208 blocks. Each item may again have an "alt"
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11209 item.
941ff1cd317a Add file save counter to undo information. Add undotree() function.
Bram Moolenaar <bram@vim.org>
parents: 2252
diff changeset
11210
5747
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
11211 uniq({list} [, {func} [, {dict}]]) *uniq()* *E882*
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
11212 Remove second and succeeding copies of repeated adjacent
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
11213 {list} items in-place. Returns {list}. If you want a list
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
11214 to remain unmodified make a copy first: >
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
11215 :let newlist = uniq(copy(mylist))
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
11216 < The default compare function uses the string representation of
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
11217 each item. For the use of {func} and {dict} see |sort()|.
ddc3f32a4b21 updated for version 7.4.218
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
11218
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
11219 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
11220 mylist->uniq()
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
11221
140
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
11222 values({dict}) *values()*
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
11223 Return a |List| with all the values of {dict}. The |List| is
15571
4af72c724093 patch 8.1.0793: incorrect error messages for functions that take a Blob
Bram Moolenaar <Bram@vim.org>
parents: 15512
diff changeset
11224 in arbitrary order. Also see |items()| and |keys()|.
140
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
11225
17612
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
11226 Can also be used as a |method|: >
e259d11e2900 patch 8.1.1803: all builtin functions are global
Bram Moolenaar <Bram@vim.org>
parents: 17571
diff changeset
11227 mydict->values()
140
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
11228
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11229 virtcol({expr}) *virtcol()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11230 The result is a Number, which is the screen column of the file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11231 position given with {expr}. That is, the last screen position
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11232 occupied by the character at that position, when the screen
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11233 would be of unlimited width. When there is a <Tab> at the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11234 position, the returned Number will be the column at the end of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11235 the <Tab>. For example, for a <Tab> in column 1, with 'ts'
3445
2cfb68fa26cd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3410
diff changeset
11236 set to 8, it returns 8. |conceal| is ignored.
1317
45bae37de037 updated for version 7.1-031
vimboss
parents: 1293
diff changeset
11237 For the byte position use |col()|.
45bae37de037 updated for version 7.1-031
vimboss
parents: 1293
diff changeset
11238 For the use of {expr} see |col()|.
45bae37de037 updated for version 7.1-031
vimboss
parents: 1293
diff changeset
11239 When 'virtualedit' is used {expr} can be [lnum, col, off], where
703
2fae45239fb3 updated for version 7.0212
vimboss
parents: 697
diff changeset
11240 "off" is the offset in screen columns from the start of the
1266
54588e2e8041 updated for version 7.1
vimboss
parents: 1215
diff changeset
11241 character. E.g., a position within a <Tab> or after the last
2965
f2de38a019a2 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
11242 character. When "off" is omitted zero is used.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11243 When Virtual editing is active in the current mode, a position
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11244 beyond the end of the line can be returned. |'virtualedit'|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11245 The accepted positions are:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11246 . the cursor position
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11247 $ the end of the cursor line (the result is the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11248 number of displayed characters in the cursor line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11249 plus one)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11250 'x position of mark x (if the mark is not set, 0 is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11251 returned)
6447
0550be8fc7f6 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6421
diff changeset
11252 v In Visual mode: the start of the Visual area (the
0550be8fc7f6 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6421
diff changeset
11253 cursor is the end). When not in Visual mode
0550be8fc7f6 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6421
diff changeset
11254 returns the cursor position. Differs from |'<| in
0550be8fc7f6 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6421
diff changeset
11255 that it's updated right away.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11256 Note that only marks in the current file can be used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11257 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11258 virtcol(".") with text "foo^Lbar", with cursor on the "^L", returns 5
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11259 virtcol("$") with text "foo^Lbar", returns 9
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11260 virtcol("'t") with text " there", with 't at 'h', returns 6
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
11261 < The first column is 1. 0 is returned for an error.
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
11262 A more advanced example that echoes the maximum length of
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
11263 all lines: >
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
11264 echo max(map(range(1, line('$')), "virtcol([v:val, '$'])"))
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
11265
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11266 < Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11267 GetPos()->virtcol()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11268
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11269
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11270 visualmode([{expr}]) *visualmode()*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11271 The result is a String, which describes the last Visual mode
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
11272 used in the current buffer. Initially it returns an empty
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
11273 string, but once Visual mode has been used, it returns "v",
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
11274 "V", or "<CTRL-V>" (a single CTRL-V character) for
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
11275 character-wise, line-wise, or block-wise Visual mode
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
11276 respectively.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11277 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11278 :exe "normal " . visualmode()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11279 < This enters the same Visual mode as before. It is also useful
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11280 in scripts if you wish to act differently depending on the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11281 Visual mode that was used.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11282 If Visual mode is active, use |mode()| to get the Visual mode
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11283 (e.g., in a |:vmap|).
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11284 If {expr} is supplied and it evaluates to a non-zero Number or
1661
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
11285 a non-empty String, then the Visual mode will be cleared and
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
11286 the old value is returned. See |non-zero-arg|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11287
4151
13170a796134 updated for version 7.3.828
Bram Moolenaar <bram@vim.org>
parents: 4126
diff changeset
11288 wildmenumode() *wildmenumode()*
9422
f93704b11e43 commit https://github.com/vim/vim/commit/e381d3d5e098546854b008e01ca1d28ba1a4a057
Christian Brabandt <cb@256bit.org>
parents: 9416
diff changeset
11289 Returns |TRUE| when the wildmenu is active and |FALSE|
4151
13170a796134 updated for version 7.3.828
Bram Moolenaar <bram@vim.org>
parents: 4126
diff changeset
11290 otherwise. See 'wildmenu' and 'wildmode'.
13170a796134 updated for version 7.3.828
Bram Moolenaar <bram@vim.org>
parents: 4126
diff changeset
11291 This can be used in mappings to handle the 'wildcharm' option
13170a796134 updated for version 7.3.828
Bram Moolenaar <bram@vim.org>
parents: 4126
diff changeset
11292 gracefully. (Makes only sense with |mapmode-c| mappings).
13170a796134 updated for version 7.3.828
Bram Moolenaar <bram@vim.org>
parents: 4126
diff changeset
11293
13170a796134 updated for version 7.3.828
Bram Moolenaar <bram@vim.org>
parents: 4126
diff changeset
11294 For example to make <c-j> work like <down> in wildmode, use: >
13170a796134 updated for version 7.3.828
Bram Moolenaar <bram@vim.org>
parents: 4126
diff changeset
11295 :cnoremap <expr> <C-j> wildmenumode() ? "\<Down>\<Tab>" : "\<c-j>"
13170a796134 updated for version 7.3.828
Bram Moolenaar <bram@vim.org>
parents: 4126
diff changeset
11296 <
13170a796134 updated for version 7.3.828
Bram Moolenaar <bram@vim.org>
parents: 4126
diff changeset
11297 (Note, this needs the 'wildcharm' option set appropriately).
13170a796134 updated for version 7.3.828
Bram Moolenaar <bram@vim.org>
parents: 4126
diff changeset
11298
16833
6699c03347d2 patch 8.1.1418: win_execute() is not implemented yet
Bram Moolenaar <Bram@vim.org>
parents: 16808
diff changeset
11299 win_execute({id}, {command} [, {silent}]) *win_execute()*
6699c03347d2 patch 8.1.1418: win_execute() is not implemented yet
Bram Moolenaar <Bram@vim.org>
parents: 16808
diff changeset
11300 Like `execute()` but in the context of window {id}.
6699c03347d2 patch 8.1.1418: win_execute() is not implemented yet
Bram Moolenaar <Bram@vim.org>
parents: 16808
diff changeset
11301 The window will temporarily be made the current window,
16849
629f3d3b6886 patch 8.1.1426: no test for syntax highlight in popup window
Bram Moolenaar <Bram@vim.org>
parents: 16833
diff changeset
11302 without triggering autocommands. When executing {command}
629f3d3b6886 patch 8.1.1426: no test for syntax highlight in popup window
Bram Moolenaar <Bram@vim.org>
parents: 16833
diff changeset
11303 autocommands will be triggered, this may have unexpected side
629f3d3b6886 patch 8.1.1426: no test for syntax highlight in popup window
Bram Moolenaar <Bram@vim.org>
parents: 16833
diff changeset
11304 effects. Use |:noautocmd| if needed.
16833
6699c03347d2 patch 8.1.1418: win_execute() is not implemented yet
Bram Moolenaar <Bram@vim.org>
parents: 16808
diff changeset
11305 Example: >
16849
629f3d3b6886 patch 8.1.1426: no test for syntax highlight in popup window
Bram Moolenaar <Bram@vim.org>
parents: 16833
diff changeset
11306 call win_execute(winid, 'set syntax=python')
629f3d3b6886 patch 8.1.1426: no test for syntax highlight in popup window
Bram Moolenaar <Bram@vim.org>
parents: 16833
diff changeset
11307 < Doing the same with `setwinvar()` would not trigger
629f3d3b6886 patch 8.1.1426: no test for syntax highlight in popup window
Bram Moolenaar <Bram@vim.org>
parents: 16833
diff changeset
11308 autocommands and not actually show syntax highlighting.
23602
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
11309
16944
d23afa4d8b63 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16930
diff changeset
11310 *E994*
d23afa4d8b63 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16930
diff changeset
11311 Not all commands are allowed in popup windows.
23602
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
11312 When window {id} does not exist then no error is given and
7b3317e959e3 patch 8.2.2343: Vim9: return type of readfile() is any
Bram Moolenaar <Bram@vim.org>
parents: 23594
diff changeset
11313 an empty string is returned.
4151
13170a796134 updated for version 7.3.828
Bram Moolenaar <bram@vim.org>
parents: 4126
diff changeset
11314
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
11315 Can also be used as a |method|, the base is passed as the
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
11316 second argument: >
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11317 GetCommand()->win_execute(winid)
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11318
8536
09041d2fd7d0 commit https://github.com/vim/vim/commit/9cdf86b86f5fdb5a45b682f336846f9d9a9c6f1f
Christian Brabandt <cb@256bit.org>
parents: 8534
diff changeset
11319 win_findbuf({bufnr}) *win_findbuf()*
23164
99ef85ff1af4 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23048
diff changeset
11320 Returns a |List| with |window-ID|s for windows that contain
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
11321 buffer {bufnr}. When there is none the list is empty.
8536
09041d2fd7d0 commit https://github.com/vim/vim/commit/9cdf86b86f5fdb5a45b682f336846f9d9a9c6f1f
Christian Brabandt <cb@256bit.org>
parents: 8534
diff changeset
11322
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11323 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11324 GetBufnr()->win_findbuf()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11325
8534
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11326 win_getid([{win} [, {tab}]]) *win_getid()*
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
11327 Get the |window-ID| for the specified window.
8534
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11328 When {win} is missing use the current window.
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11329 With {win} this is the window number. The top window has
14999
2b30a2b4bde2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 14964
diff changeset
11330 number 1.
8534
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11331 Without {tab} use the current tab, otherwise the tab with
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11332 number {tab}. The first tab has number one.
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11333 Return zero if the window cannot be found.
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11334
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11335 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11336 GetWinnr()->win_getid()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11337
19398
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11338
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11339 win_gettype([{nr}]) *win_gettype()*
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11340 Return the type of the window:
20889
27401f09fe9b patch 8.2.0996: using "aucmdwin" in win_gettype() is not ideal
Bram Moolenaar <Bram@vim.org>
parents: 20879
diff changeset
11341 "autocmd" autocommand window. Temporary window
20879
0ab45b558621 patch 8.2.0991: cannot get window type for autocmd and preview window
Bram Moolenaar <Bram@vim.org>
parents: 20873
diff changeset
11342 used to execute autocommands.
19398
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11343 "popup" popup window |popup|
20879
0ab45b558621 patch 8.2.0991: cannot get window type for autocmd and preview window
Bram Moolenaar <Bram@vim.org>
parents: 20873
diff changeset
11344 "preview" preview window |preview-window|
19398
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11345 "command" command-line window |cmdwin|
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11346 (empty) normal window
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11347 "unknown" window {nr} not found
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11348
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11349 When {nr} is omitted return the type of the current window.
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11350 When {nr} is given return the type of this window by number or
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11351 |window-ID|.
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11352
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11353 Also see the 'buftype' option. When running a terminal in a
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11354 popup window then 'buftype' is "terminal" and win_gettype()
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11355 returns "popup".
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11356
f0033a10b613 patch 8.2.0257: cannot recognize a terminal in a popup window
Bram Moolenaar <Bram@vim.org>
parents: 19384
diff changeset
11357
8534
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11358 win_gotoid({expr}) *win_gotoid()*
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11359 Go to window with ID {expr}. This may also change the current
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11360 tabpage.
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11361 Return 1 if successful, 0 if the window cannot be found.
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11362
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11363 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11364 GetWinid()->win_gotoid()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11365
8876
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 8831
diff changeset
11366 win_id2tabwin({expr}) *win_id2tabwin()*
8534
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11367 Return a list with the tab number and window number of window
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11368 with ID {expr}: [tabnr, winnr].
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11369 Return [0, 0] if the window cannot be found.
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11370
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11371 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11372 GetWinid()->win_id2tabwin()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11373
8534
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11374 win_id2win({expr}) *win_id2win()*
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11375 Return the window number of window with ID {expr}.
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11376 Return 0 if the window cannot be found in the current tabpage.
485d4d8a97f6 commit https://github.com/vim/vim/commit/86edef664efccbfe685906c854b9cdd04e56f2d5
Christian Brabandt <cb@256bit.org>
parents: 8512
diff changeset
11377
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11378 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11379 GetWinid()->win_id2win()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11380
12977
2d817fd289ba patch 8.0.1364: there is no easy way to get the window position
Christian Brabandt <cb@256bit.org>
parents: 12968
diff changeset
11381 win_screenpos({nr}) *win_screenpos()*
2d817fd289ba patch 8.0.1364: there is no easy way to get the window position
Christian Brabandt <cb@256bit.org>
parents: 12968
diff changeset
11382 Return the screen position of window {nr} as a list with two
2d817fd289ba patch 8.0.1364: there is no easy way to get the window position
Christian Brabandt <cb@256bit.org>
parents: 12968
diff changeset
11383 numbers: [row, col]. The first window always has position
14343
7589f103ec11 patch 8.1.0187: getwininfo() and win_screenpos() return different numbers
Christian Brabandt <cb@256bit.org>
parents: 14337
diff changeset
11384 [1, 1], unless there is a tabline, then it is [2, 1].
22171
d4c7b3e9cd17 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22077
diff changeset
11385 {nr} can be the window number or the |window-ID|. Use zero
d4c7b3e9cd17 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22077
diff changeset
11386 for the current window.
12977
2d817fd289ba patch 8.0.1364: there is no easy way to get the window position
Christian Brabandt <cb@256bit.org>
parents: 12968
diff changeset
11387 Return [0, 0] if the window cannot be found in the current
2d817fd289ba patch 8.0.1364: there is no easy way to get the window position
Christian Brabandt <cb@256bit.org>
parents: 12968
diff changeset
11388 tabpage.
2d817fd289ba patch 8.0.1364: there is no easy way to get the window position
Christian Brabandt <cb@256bit.org>
parents: 12968
diff changeset
11389
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11390 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11391 GetWinid()->win_screenpos()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11392 <
18049
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11393 win_splitmove({nr}, {target} [, {options}]) *win_splitmove()*
20965
59f93c2d2551 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20889
diff changeset
11394 Move the window {nr} to a new split of the window {target}.
18049
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11395 This is similar to moving to {target}, creating a new window
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11396 using |:split| but having the same contents as window {nr}, and
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11397 then closing {nr}.
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11398
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11399 Both {nr} and {target} can be window numbers or |window-ID|s.
19099
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19039
diff changeset
11400 Both must be in the current tab page.
18049
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11401
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11402 Returns zero for success, non-zero for failure.
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11403
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
11404 {options} is a |Dictionary| with the following optional entries:
18049
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11405 "vertical" When TRUE, the split is created vertically,
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11406 like with |:vsplit|.
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11407 "rightbelow" When TRUE, the split is made below or to the
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11408 right (if vertical). When FALSE, it is done
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11409 above or to the left (if vertical). When not
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11410 present, the values of 'splitbelow' and
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11411 'splitright' are used.
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11412
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11413 Can also be used as a |method|: >
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11414 GetWinid()->win_splitmove(target)
a9f1656f13c9 patch 8.1.2020: it is not easy to change the window layout
Bram Moolenaar <Bram@vim.org>
parents: 18035
diff changeset
11415 <
19400
bd9069d21c5d patch 8.2.0258: modifyOtherKeys cannot be temporarily disabled
Bram Moolenaar <Bram@vim.org>
parents: 19398
diff changeset
11416
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11417 *winbufnr()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11418 winbufnr({nr}) The result is a Number, which is the number of the buffer
9223
6c4d610fce0a commit https://github.com/vim/vim/commit/888ccac8902cee186fbd47e971881f6d9b19c068
Christian Brabandt <cb@256bit.org>
parents: 9221
diff changeset
11419 associated with window {nr}. {nr} can be the window number or
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
11420 the |window-ID|.
9223
6c4d610fce0a commit https://github.com/vim/vim/commit/888ccac8902cee186fbd47e971881f6d9b19c068
Christian Brabandt <cb@256bit.org>
parents: 9221
diff changeset
11421 When {nr} is zero, the number of the buffer in the current
6c4d610fce0a commit https://github.com/vim/vim/commit/888ccac8902cee186fbd47e971881f6d9b19c068
Christian Brabandt <cb@256bit.org>
parents: 9221
diff changeset
11422 window is returned.
6c4d610fce0a commit https://github.com/vim/vim/commit/888ccac8902cee186fbd47e971881f6d9b19c068
Christian Brabandt <cb@256bit.org>
parents: 9221
diff changeset
11423 When window {nr} doesn't exist, -1 is returned.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11424 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11425 :echo "The file in the current window is " . bufname(winbufnr(0))
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11426 <
17825
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
11427 Can also be used as a |method|: >
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
11428 FindWindow()->winbufnr()->bufname()
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
11429 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11430 *wincol()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11431 wincol() The result is a Number, which is the virtual column of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11432 cursor in the window. This is counting screen cells from the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11433 left side of the window. The leftmost column is one.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11434
18973
bf8eb950df61 patch 8.2.0047: cannot skip tests for specific MS-Windows platform
Bram Moolenaar <Bram@vim.org>
parents: 18972
diff changeset
11435 *windowsversion()*
bf8eb950df61 patch 8.2.0047: cannot skip tests for specific MS-Windows platform
Bram Moolenaar <Bram@vim.org>
parents: 18972
diff changeset
11436 windowsversion()
bf8eb950df61 patch 8.2.0047: cannot skip tests for specific MS-Windows platform
Bram Moolenaar <Bram@vim.org>
parents: 18972
diff changeset
11437 The result is a String. For MS-Windows it indicates the OS
bf8eb950df61 patch 8.2.0047: cannot skip tests for specific MS-Windows platform
Bram Moolenaar <Bram@vim.org>
parents: 18972
diff changeset
11438 version. E.g, Windows 10 is "10.0", Windows 8 is "6.2",
bf8eb950df61 patch 8.2.0047: cannot skip tests for specific MS-Windows platform
Bram Moolenaar <Bram@vim.org>
parents: 18972
diff changeset
11439 Windows XP is "5.1". For non-MS-Windows systems the result is
bf8eb950df61 patch 8.2.0047: cannot skip tests for specific MS-Windows platform
Bram Moolenaar <Bram@vim.org>
parents: 18972
diff changeset
11440 an empty string.
bf8eb950df61 patch 8.2.0047: cannot skip tests for specific MS-Windows platform
Bram Moolenaar <Bram@vim.org>
parents: 18972
diff changeset
11441
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11442 winheight({nr}) *winheight()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11443 The result is a Number, which is the height of window {nr}.
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
11444 {nr} can be the window number or the |window-ID|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11445 When {nr} is zero, the height of the current window is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11446 returned. When window {nr} doesn't exist, -1 is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11447 An existing window always has a height of zero or more.
12499
d91cf2e26ef0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12465
diff changeset
11448 This excludes any window toolbar line.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11449 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11450 :echo "The current window has " . winheight(0) . " lines."
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11451
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11452 < Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11453 GetWinid()->winheight()
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11454 <
14587
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11455 winlayout([{tabnr}]) *winlayout()*
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11456 The result is a nested List containing the layout of windows
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11457 in a tabpage.
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11458
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11459 Without {tabnr} use the current tabpage, otherwise the tabpage
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11460 with number {tabnr}. If the tabpage {tabnr} is not found,
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11461 returns an empty list.
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11462
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11463 For a leaf window, it returns:
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11464 ['leaf', {winid}]
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11465 For horizontally split windows, which form a column, it
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11466 returns:
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11467 ['col', [{nested list of windows}]]
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11468 For vertically split windows, which form a row, it returns:
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11469 ['row', [{nested list of windows}]]
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11470
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11471 Example: >
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11472 " Only one window in the tab page
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11473 :echo winlayout()
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11474 ['leaf', 1000]
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11475 " Two horizontally split windows
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11476 :echo winlayout()
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11477 ['col', [['leaf', 1000], ['leaf', 1001]]]
19646
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
11478 " The second tab page, with three horizontally split
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
11479 " windows, with two vertically split windows in the
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
11480 " middle window
14587
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11481 :echo winlayout(2)
19646
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
11482 ['col', [['leaf', 1002], ['row', [['leaf', 1003],
847a300aa244 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19526
diff changeset
11483 ['leaf', 1001]]], ['leaf', 1000]]]
14587
d33220d3bc27 patch 8.1.0307: there is no good way to get the window layout
Christian Brabandt <cb@256bit.org>
parents: 14519
diff changeset
11484 <
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11485 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11486 GetTabnr()->winlayout()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11487 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11488 *winline()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11489 winline() The result is a Number, which is the screen line of the cursor
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
11490 in the window. This is counting screen lines from the top of
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11491 the window. The first line is one.
531
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
11492 If the cursor was moved the view on the file will be updated
da9142bd190a updated for version 7.0149
vimboss
parents: 530
diff changeset
11493 first, this may cause a scroll.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11494
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11495 *winnr()*
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
11496 winnr([{arg}]) The result is a Number, which is the number of the current
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
11497 window. The top window has number 1.
19303
51bc26d4a393 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19181
diff changeset
11498 Returns zero for a popup window.
16271
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11499
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11500 The optional argument {arg} supports the following values:
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11501 $ the number of the last window (the window
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11502 count).
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11503 # the number of the last accessed window (where
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11504 |CTRL-W_p| goes to). If there is no previous
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11505 window or it is in another tab page 0 is
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11506 returned.
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11507 {N}j the number of the Nth window below the
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11508 current window (where |CTRL-W_j| goes to).
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11509 {N}k the number of the Nth window above the current
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11510 window (where |CTRL-W_k| goes to).
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11511 {N}h the number of the Nth window left of the
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11512 current window (where |CTRL-W_h| goes to).
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11513 {N}l the number of the Nth window right of the
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11514 current window (where |CTRL-W_l| goes to).
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
11515 The number can be used with |CTRL-W_w| and ":wincmd w"
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 19
diff changeset
11516 |:wincmd|.
10734
523cd59d6db0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10730
diff changeset
11517 Also see |tabpagewinnr()| and |win_getid()|.
16271
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11518 Examples: >
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11519 let window_count = winnr('$')
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11520 let prev_window = winnr('#')
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11521 let wnum = winnr('3k')
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11522
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11523 < Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11524 GetWinval()->winnr()
16271
243cdc183ec9 patch 8.1.1140: not easy to find out what neighbors a window has
Bram Moolenaar <Bram@vim.org>
parents: 16267
diff changeset
11525 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11526 *winrestcmd()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11527 winrestcmd() Returns a sequence of |:resize| commands that should restore
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11528 the current window sizes. Only works properly when no windows
712
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11529 are opened or closed and the current window and tab page is
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11530 unchanged.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11531 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11532 :let cmd = winrestcmd()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11533 :call MessWithWindowSizes()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11534 :exe cmd
712
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11535 <
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11536 *winrestview()*
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11537 winrestview({dict})
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11538 Uses the |Dictionary| returned by |winsaveview()| to restore
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11539 the view of the current window.
5940
f6f754304324 updated for version 7.4.311
Bram Moolenaar <bram@vim.org>
parents: 5938
diff changeset
11540 Note: The {dict} does not have to contain all values, that are
f6f754304324 updated for version 7.4.311
Bram Moolenaar <bram@vim.org>
parents: 5938
diff changeset
11541 returned by |winsaveview()|. If values are missing, those
f6f754304324 updated for version 7.4.311
Bram Moolenaar <bram@vim.org>
parents: 5938
diff changeset
11542 settings won't be restored. So you can use: >
f6f754304324 updated for version 7.4.311
Bram Moolenaar <bram@vim.org>
parents: 5938
diff changeset
11543 :call winrestview({'curswant': 4})
f6f754304324 updated for version 7.4.311
Bram Moolenaar <bram@vim.org>
parents: 5938
diff changeset
11544 <
f6f754304324 updated for version 7.4.311
Bram Moolenaar <bram@vim.org>
parents: 5938
diff changeset
11545 This will only set the curswant value (the column the cursor
f6f754304324 updated for version 7.4.311
Bram Moolenaar <bram@vim.org>
parents: 5938
diff changeset
11546 wants to move on vertical movements) of the cursor to column 5
f6f754304324 updated for version 7.4.311
Bram Moolenaar <bram@vim.org>
parents: 5938
diff changeset
11547 (yes, that is 5), while all other settings will remain the
f6f754304324 updated for version 7.4.311
Bram Moolenaar <bram@vim.org>
parents: 5938
diff changeset
11548 same. This is useful, if you set the cursor position manually.
f6f754304324 updated for version 7.4.311
Bram Moolenaar <bram@vim.org>
parents: 5938
diff changeset
11549
712
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11550 If you have changed the values the result is unpredictable.
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11551 If the window size changed the result won't be the same.
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11552
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11553 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11554 GetView()->winrestview()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11555 <
712
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11556 *winsaveview()*
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11557 winsaveview() Returns a |Dictionary| that contains information to restore
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11558 the view of the current window. Use |winrestview()| to
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11559 restore the view.
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11560 This is useful if you have a mapping that jumps around in the
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11561 buffer and you want to go back to the original view.
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11562 This does not save fold information. Use the 'foldenable'
798
95dac6af3b3a updated for version 7.0232
vimboss
parents: 794
diff changeset
11563 option to temporarily switch off folding, so that folds are
6070
32a77cc160d9 Update runtime files. Make matchparen plugin backwards compatible.
Bram Moolenaar <bram@vim.org>
parents: 6051
diff changeset
11564 not opened when moving around. This may have side effects.
712
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11565 The return value includes:
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11566 lnum cursor line number
5940
f6f754304324 updated for version 7.4.311
Bram Moolenaar <bram@vim.org>
parents: 5938
diff changeset
11567 col cursor column (Note: the first column
f6f754304324 updated for version 7.4.311
Bram Moolenaar <bram@vim.org>
parents: 5938
diff changeset
11568 zero, as opposed to what getpos()
f6f754304324 updated for version 7.4.311
Bram Moolenaar <bram@vim.org>
parents: 5938
diff changeset
11569 returns)
712
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11570 coladd cursor column offset for 'virtualedit'
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11571 curswant column for vertical movement
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11572 topline first line in the window
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11573 topfill filler lines, only in diff mode
22723
5b7ea82bc18f Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22689
diff changeset
11574 leftcol first column displayed; only used when
5b7ea82bc18f Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22689
diff changeset
11575 'wrap' is off
712
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11576 skipcol columns skipped
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11577 Note that no option values are saved.
2e887dfa8917 updated for version 7.0214
vimboss
parents: 707
diff changeset
11578
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11579
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11580 winwidth({nr}) *winwidth()*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11581 The result is a Number, which is the width of window {nr}.
9908
2b6654519a7c commit https://github.com/vim/vim/commit/7571d55f7dcc009a375b2124cce2c8b21f361234
Christian Brabandt <cb@256bit.org>
parents: 9904
diff changeset
11582 {nr} can be the window number or the |window-ID|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11583 When {nr} is zero, the width of the current window is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11584 returned. When window {nr} doesn't exist, -1 is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11585 An existing window always has a width of zero or more.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11586 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11587 :echo "The current window has " . winwidth(0) . " columns."
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11588 :if winwidth(0) <= 50
12857
ffdf2e4b5d9a patch 8.0.1305: writefile() never calls fsync()
Christian Brabandt <cb@256bit.org>
parents: 12837
diff changeset
11589 : 50 wincmd |
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11590 :endif
11561
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
11591 < For getting the terminal or screen size, see the 'columns'
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
11592 option.
9389
32e34e574716 commit https://github.com/vim/vim/commit/22fcfad29276bd5f317faf516637dcd491b96a12
Christian Brabandt <cb@256bit.org>
parents: 9344
diff changeset
11593
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11594 Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11595 GetWinid()->winwidth()
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11596
9389
32e34e574716 commit https://github.com/vim/vim/commit/22fcfad29276bd5f317faf516637dcd491b96a12
Christian Brabandt <cb@256bit.org>
parents: 9344
diff changeset
11597
7480
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11598 wordcount() *wordcount()*
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11599 The result is a dictionary of byte/chars/word statistics for
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11600 the current buffer. This is the same info as provided by
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11601 |g_CTRL-G|
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11602 The return value includes:
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11603 bytes Number of bytes in the buffer
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11604 chars Number of chars in the buffer
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11605 words Number of words in the buffer
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11606 cursor_bytes Number of bytes before cursor position
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11607 (not in Visual mode)
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11608 cursor_chars Number of chars before cursor position
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11609 (not in Visual mode)
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11610 cursor_words Number of words before cursor position
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11611 (not in Visual mode)
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11612 visual_bytes Number of bytes visually selected
11561
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
11613 (only in Visual mode)
7480
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11614 visual_chars Number of chars visually selected
11561
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
11615 (only in Visual mode)
12254
8d76a56861ec Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 12252
diff changeset
11616 visual_words Number of words visually selected
11561
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
11617 (only in Visual mode)
7480
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11618
a49163681559 commit https://github.com/vim/vim/commit/ed767a2073ef150971b0439a58e7ee582af6984e
Christian Brabandt <cb@256bit.org>
parents: 7477
diff changeset
11619
158
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
11620 *writefile()*
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
11621 writefile({object}, {fname} [, {flags}])
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
11622 When {object} is a |List| write it to file {fname}. Each list
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
11623 item is separated with a NL. Each list item must be a String
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
11624 or Number.
6341
094a87e76155 updated for version 7.4.503
Bram Moolenaar <bram@vim.org>
parents: 6259
diff changeset
11625 When {flags} contains "b" then binary mode is used: There will
158
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
11626 not be a NL after the last list item. An empty item at the
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
11627 end does cause the last line in the file to end in a NL.
6341
094a87e76155 updated for version 7.4.503
Bram Moolenaar <bram@vim.org>
parents: 6259
diff changeset
11628
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
11629 When {object} is a |Blob| write the bytes to file {fname}
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
11630 unmodified.
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
11631
6341
094a87e76155 updated for version 7.4.503
Bram Moolenaar <bram@vim.org>
parents: 6259
diff changeset
11632 When {flags} contains "a" then append mode is used, lines are
10301
07d2b5a3b7cc commit https://github.com/vim/vim/commit/46fceaaa8d1447a9588736d86eb4908214187b08
Christian Brabandt <cb@256bit.org>
parents: 10275
diff changeset
11633 appended to the file: >
6341
094a87e76155 updated for version 7.4.503
Bram Moolenaar <bram@vim.org>
parents: 6259
diff changeset
11634 :call writefile(["foo"], "event.log", "a")
094a87e76155 updated for version 7.4.503
Bram Moolenaar <bram@vim.org>
parents: 6259
diff changeset
11635 :call writefile(["bar"], "event.log", "a")
12857
ffdf2e4b5d9a patch 8.0.1305: writefile() never calls fsync()
Christian Brabandt <cb@256bit.org>
parents: 12837
diff changeset
11636 <
ffdf2e4b5d9a patch 8.0.1305: writefile() never calls fsync()
Christian Brabandt <cb@256bit.org>
parents: 12837
diff changeset
11637 When {flags} contains "s" then fsync() is called after writing
ffdf2e4b5d9a patch 8.0.1305: writefile() never calls fsync()
Christian Brabandt <cb@256bit.org>
parents: 12837
diff changeset
11638 the file. This flushes the file to disk, if possible. This
ffdf2e4b5d9a patch 8.0.1305: writefile() never calls fsync()
Christian Brabandt <cb@256bit.org>
parents: 12837
diff changeset
11639 takes more time but avoids losing the file if the system
ffdf2e4b5d9a patch 8.0.1305: writefile() never calls fsync()
Christian Brabandt <cb@256bit.org>
parents: 12837
diff changeset
11640 crashes.
13016
e47e70300f30 patch 8.0.1384: not enough quickfix help; confusing winid
Christian Brabandt <cb@256bit.org>
parents: 12977
diff changeset
11641 When {flags} does not contain "S" or "s" then fsync() is
e47e70300f30 patch 8.0.1384: not enough quickfix help; confusing winid
Christian Brabandt <cb@256bit.org>
parents: 12977
diff changeset
11642 called if the 'fsync' option is set.
12857
ffdf2e4b5d9a patch 8.0.1305: writefile() never calls fsync()
Christian Brabandt <cb@256bit.org>
parents: 12837
diff changeset
11643 When {flags} contains "S" then fsync() is not called, even
ffdf2e4b5d9a patch 8.0.1305: writefile() never calls fsync()
Christian Brabandt <cb@256bit.org>
parents: 12837
diff changeset
11644 when 'fsync' is set.
ffdf2e4b5d9a patch 8.0.1305: writefile() never calls fsync()
Christian Brabandt <cb@256bit.org>
parents: 12837
diff changeset
11645
ffdf2e4b5d9a patch 8.0.1305: writefile() never calls fsync()
Christian Brabandt <cb@256bit.org>
parents: 12837
diff changeset
11646 All NL characters are replaced with a NUL character.
158
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
11647 Inserting CR characters needs to be done before passing {list}
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
11648 to writefile().
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
11649 An existing file is overwritten, if possible.
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
11650 When the write fails -1 is returned, otherwise 0. There is an
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
11651 error message if the file can't be created or when writing
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
11652 fails.
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
11653 Also see |readfile()|.
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
11654 To copy a file byte for byte: >
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
11655 :let fl = readfile("foo", "b")
78423945b251 updated for version 7.0048
vimboss
parents: 153
diff changeset
11656 :call writefile(fl, "foocopy", "b")
3214
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
11657
18035
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11658 < Can also be used as a |method|: >
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11659 GetText()->writefile("thefile")
11dca9732a48 patch 8.1.2013: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 18031
diff changeset
11660
3214
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
11661
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
11662 xor({expr}, {expr}) *xor()*
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
11663 Bitwise XOR on the two arguments. The arguments are converted
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
11664 to a number. A List, Dict or Float argument causes an error.
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
11665 Example: >
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
11666 :let bits = xor(bits, 0x80)
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
11667 <
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
11668 Can also be used as a |method|: >
17783
45eca7143d7c patch 8.1.1888: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17765
diff changeset
11669 :let bits = bits->xor(0x80)
3256
ba708ee8d69d Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3237
diff changeset
11670 <
3214
cd145cc2f2c9 updated for version 7.3.377
Bram Moolenaar <bram@vim.org>
parents: 3153
diff changeset
11671
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11672 *feature-list*
19163
63beef1ca62c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19099
diff changeset
11673 There are three types of features:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11674 1. Features that are only supported when they have been enabled when Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11675 was compiled |+feature-list|. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11676 :if has("cindent")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11677 2. Features that are only supported when certain conditions have been met.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11678 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11679 :if has("gui_running")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11680 < *has-patch*
13967
acc62d455f90 Runtime file and translation updates.
Christian Brabandt <cb@256bit.org>
parents: 13963
diff changeset
11681 3. Beyond a certain version or at a certain version and including a specific
acc62d455f90 Runtime file and translation updates.
Christian Brabandt <cb@256bit.org>
parents: 13963
diff changeset
11682 patch. The "patch-7.4.248" feature means that the Vim version is 7.5 or
acc62d455f90 Runtime file and translation updates.
Christian Brabandt <cb@256bit.org>
parents: 13963
diff changeset
11683 later, or it is version 7.4 and patch 248 was included. Example: >
5862
306caa30d83b Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5815
diff changeset
11684 :if has("patch-7.4.248")
13967
acc62d455f90 Runtime file and translation updates.
Christian Brabandt <cb@256bit.org>
parents: 13963
diff changeset
11685 < Note that it's possible for patch 248 to be omitted even though 249 is
acc62d455f90 Runtime file and translation updates.
Christian Brabandt <cb@256bit.org>
parents: 13963
diff changeset
11686 included. Only happens when cherry-picking patches.
acc62d455f90 Runtime file and translation updates.
Christian Brabandt <cb@256bit.org>
parents: 13963
diff changeset
11687 Note that this form only works for patch 7.4.237 and later, before that
acc62d455f90 Runtime file and translation updates.
Christian Brabandt <cb@256bit.org>
parents: 13963
diff changeset
11688 you need to check for the patch and the v:version. Example (checking
acc62d455f90 Runtime file and translation updates.
Christian Brabandt <cb@256bit.org>
parents: 13963
diff changeset
11689 version 6.2.148 or later): >
acc62d455f90 Runtime file and translation updates.
Christian Brabandt <cb@256bit.org>
parents: 13963
diff changeset
11690 :if v:version > 602 || (v:version == 602 && has("patch148"))
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11691
9850
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
11692 Hint: To find out if Vim supports backslashes in a file name (MS-Windows),
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
11693 use: `if exists('+shellslash')`
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
11694
67781bb0a61a commit https://github.com/vim/vim/commit/d823fa910cca43fec3c31c030ee908a14c272640
Christian Brabandt <cb@256bit.org>
parents: 9810
diff changeset
11695
5340
22da5ab9aaa1 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
11696 acl Compiled with |ACL| support.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11697 all_builtin_terms Compiled with all builtin terminals enabled.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11698 amiga Amiga version of Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11699 arabic Compiled with Arabic support |Arabic|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11700 arp Compiled with ARP support (Amiga).
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11701 autocmd Compiled with autocommand support. (always true)
14421
2f7e67dd088c Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14407
diff changeset
11702 autochdir Compiled with support for 'autochdir'
12837
963cdeb42c41 patch 8.0.1295: cannot automatically get a server name in a terminal
Christian Brabandt <cb@256bit.org>
parents: 12785
diff changeset
11703 autoservername Automatically enable |clientserver|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11704 balloon_eval Compiled with |balloon-eval| support.
435
73f016dbb279 updated for version 7.0112
vimboss
parents: 419
diff changeset
11705 balloon_multiline GUI supports multiline balloons.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11706 beos BeOS version of Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11707 browse Compiled with |:browse| support, and browse() will
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11708 work.
3682
11d40fc82f11 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3513
diff changeset
11709 browsefilter Compiled with support for |browsefilter|.
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11710 bsd Compiled on an OS in the BSD family (excluding macOS).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11711 builtin_terms Compiled with some builtin terminals.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11712 byte_offset Compiled with support for 'o' in 'statusline'
19523
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
11713 channel Compiled with support for |channel| and |job|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11714 cindent Compiled with 'cindent' support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11715 clientserver Compiled with remote invocation support |clientserver|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11716 clipboard Compiled with 'clipboard' support.
17680
55704f587945 patch 8.1.1837: popup test fails if clipboard is supported but not working
Bram Moolenaar <Bram@vim.org>
parents: 17676
diff changeset
11717 clipboard_working Compiled with 'clipboard' support and it can be used.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11718 cmdline_compl Compiled with |cmdline-completion| support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11719 cmdline_hist Compiled with |cmdline-history| support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11720 cmdline_info Compiled with 'showcmd' and 'ruler' support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11721 comments Compiled with |'comments'| support.
2681
85c5a72551e2 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2662
diff changeset
11722 compatible Compiled to be very Vi compatible.
15725
a3e2e7948ee4 patch 8.1.0870: Vim doesn't use the new ConPTY support in Windows 10
Bram Moolenaar <Bram@vim.org>
parents: 15711
diff changeset
11723 conpty Platform where |ConPTY| can be used.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11724 cryptv Compiled with encryption support |encryption|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11725 cscope Compiled with |cscope| support.
15729
fe57e4f0eac1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15725
diff changeset
11726 cursorbind Compiled with |'cursorbind'| (always true)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11727 debug Compiled with "DEBUG" defined.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11728 dialog_con Compiled with console dialog support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11729 dialog_gui Compiled with GUI dialog support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11730 diff Compiled with |vimdiff| and 'diff' support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11731 digraphs Compiled with support for digraphs.
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
11732 directx Compiled with support for DirectX and 'renderoptions'.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11733 dnd Compiled with support for the "~ register |quote_~|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11734 ebcdic Compiled on a machine with ebcdic character set.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11735 emacs_tags Compiled with support for Emacs tags.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11736 eval Compiled with expression evaluation support. Always
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11737 true, of course!
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11738 ex_extra |+ex_extra| (always true)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11739 extra_search Compiled with support for |'incsearch'| and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11740 |'hlsearch'|
18790
8dde7ced3344 Update a few runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18732
diff changeset
11741 farsi Support for Farsi was removed |farsi|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11742 file_in_path Compiled with support for |gf| and |<cfile>|
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
11743 filterpipe When 'shelltemp' is off pipes are used for shell
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
11744 read/write/filter commands
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11745 find_in_path Compiled with support for include file searches
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11746 |+find_in_path|.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11747 float Compiled with support for |Float|.
18972
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18928
diff changeset
11748 fname_case Case in file names matters (for Amiga and MS-Windows
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18928
diff changeset
11749 this is not present).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11750 folding Compiled with |folding| support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11751 footer Compiled with GUI footer support. |gui-footer|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11752 fork Compiled to use fork()/exec() instead of system().
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11753 gettext Compiled with message translation |multi-lang|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11754 gui Compiled with GUI enabled.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11755 gui_athena Compiled with Athena GUI.
2681
85c5a72551e2 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2662
diff changeset
11756 gui_gnome Compiled with Gnome support (gui_gtk is also defined).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11757 gui_gtk Compiled with GTK+ GUI (any version).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11758 gui_gtk2 Compiled with GTK+ 2 GUI (gui_gtk is also defined).
8218
3456e2ebebd4 commit https://github.com/vim/vim/commit/9892189d2e7ab94b750f99e6da4cbfc3c8014517
Christian Brabandt <cb@256bit.org>
parents: 8178
diff changeset
11759 gui_gtk3 Compiled with GTK+ 3 GUI (gui_gtk is also defined).
19526
22f0dda71638 patch 8.2.0320: no Haiku support
Bram Moolenaar <Bram@vim.org>
parents: 19523
diff changeset
11760 gui_haiku Compiled with Haiku GUI.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11761 gui_mac Compiled with Macintosh GUI.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11762 gui_motif Compiled with Motif GUI.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11763 gui_photon Compiled with Photon GUI.
2681
85c5a72551e2 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2662
diff changeset
11764 gui_running Vim is running in the GUI, or it will start soon.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11765 gui_win32 Compiled with MS Windows Win32 GUI.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11766 gui_win32s idem, and Win32s system being used (Windows 3.1)
19526
22f0dda71638 patch 8.2.0320: no Haiku support
Bram Moolenaar <Bram@vim.org>
parents: 19523
diff changeset
11767 haiku Haiku version of Vim.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11768 hangul_input Compiled with Hangul input support. |hangul|
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11769 hpux HP-UX version of Vim.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11770 iconv Can use iconv() for conversion.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11771 insert_expand Compiled with support for CTRL-X expansion commands in
17825
ce993ba17adb patch 8.1.1909: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17783
diff changeset
11772 Insert mode. (always true)
19968
1908e92b02fd Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19952
diff changeset
11773 job Compiled with support for |channel| and |job|
20037
f36f10d90378 patch 8.2.0574: ipv6 feature not shown in :version output
Bram Moolenaar <Bram@vim.org>
parents: 19968
diff changeset
11774 ipv6 Compiled with support for IPv6 networking in |channel|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11775 jumplist Compiled with |jumplist| support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11776 keymap Compiled with 'keymap' support.
9723
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
11777 lambda Compiled with |lambda| support.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11778 langmap Compiled with 'langmap' support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11779 libcall Compiled with |libcall()| support.
5995
ef83b423ebf7 updated for version 7.4.338
Bram Moolenaar <bram@vim.org>
parents: 5979
diff changeset
11780 linebreak Compiled with 'linebreak', 'breakat', 'showbreak' and
ef83b423ebf7 updated for version 7.4.338
Bram Moolenaar <bram@vim.org>
parents: 5979
diff changeset
11781 'breakindent' support.
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11782 linux Linux version of Vim.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11783 lispindent Compiled with support for lisp indenting.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11784 listcmds Compiled with commands for the buffer list |:files|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11785 and the argument list |arglist|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11786 localmap Compiled with local mappings and abbr. |:map-local|
2320
966a5609669e Added Lua interfae. (Luis Carvalho)
Bram Moolenaar <bram@vim.org>
parents: 2290
diff changeset
11787 lua Compiled with Lua interface |Lua|.
12716
351cf7c67bbe patch 8.0.1236: Mac features are confusing
Christian Brabandt <cb@256bit.org>
parents: 12632
diff changeset
11788 mac Any Macintosh version of Vim cf. osx
351cf7c67bbe patch 8.0.1236: Mac features are confusing
Christian Brabandt <cb@256bit.org>
parents: 12632
diff changeset
11789 macunix Synonym for osxdarwin
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11790 menu Compiled with support for |:menu|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11791 mksession Compiled with support for |:mksession|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11792 modify_fname Compiled with file name modifiers. |filename-modifiers|
17982
2029737e6a22 patch 8.1.1987: more functions can be used as methods
Bram Moolenaar <Bram@vim.org>
parents: 17976
diff changeset
11793 (always true)
22824
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22770
diff changeset
11794 mouse Compiled with support for mouse.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11795 mouse_dec Compiled with support for Dec terminal mouse.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11796 mouse_gpm Compiled with support for gpm (Linux console mouse)
16527
5412fcd03ecb patch 8.1.1267: cannot check if GPM mouse support is working
Bram Moolenaar <Bram@vim.org>
parents: 16517
diff changeset
11797 mouse_gpm_enabled GPM mouse is working
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11798 mouse_netterm Compiled with support for netterm mouse.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11799 mouse_pterm Compiled with support for qnx pterm mouse.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
11800 mouse_sysmouse Compiled with support for sysmouse (*BSD console mouse)
3750
536aa8b0c934 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3682
diff changeset
11801 mouse_sgr Compiled with support for sgr mouse.
3224
8b8ef1fed009 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3214
diff changeset
11802 mouse_urxvt Compiled with support for urxvt mouse.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11803 mouse_xterm Compiled with support for xterm mouse.
2681
85c5a72551e2 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2662
diff changeset
11804 mouseshape Compiled with support for 'mouseshape'.
15878
314694a2e74a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15790
diff changeset
11805 multi_byte Compiled with support for 'encoding' (always true)
21991
bbca88cd13d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21989
diff changeset
11806 multi_byte_encoding 'encoding' is set to a multibyte encoding.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11807 multi_byte_ime Compiled with support for IME input method.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11808 multi_lang Compiled with support for multiple languages.
14
946da5994c01 updated for version 7.0006
vimboss
parents: 11
diff changeset
11809 mzscheme Compiled with MzScheme interface |mzscheme|.
2681
85c5a72551e2 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2662
diff changeset
11810 netbeans_enabled Compiled with support for |netbeans| and connected.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11811 netbeans_intg Compiled with support for |netbeans|.
9389
32e34e574716 commit https://github.com/vim/vim/commit/22fcfad29276bd5f317faf516637dcd491b96a12
Christian Brabandt <cb@256bit.org>
parents: 9344
diff changeset
11812 num64 Compiled with 64-bit |Number| support.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11813 ole Compiled with OLE automation support for Win32.
12716
351cf7c67bbe patch 8.0.1236: Mac features are confusing
Christian Brabandt <cb@256bit.org>
parents: 12632
diff changeset
11814 osx Compiled for macOS cf. mac
351cf7c67bbe patch 8.0.1236: Mac features are confusing
Christian Brabandt <cb@256bit.org>
parents: 12632
diff changeset
11815 osxdarwin Compiled for macOS, with |mac-darwin-feature|
9076
9305a1251e51 commit https://github.com/vim/vim/commit/91c4937be15b0b743b6bc495df602c1abbff6b87
Christian Brabandt <cb@256bit.org>
parents: 9041
diff changeset
11816 packages Compiled with |packages| support.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11817 path_extra Compiled with up/downwards search in 'path' and 'tags'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11818 perl Compiled with Perl interface.
2214
f8222d1f9a73 Included patch for persistent undo. Lots of changes and added test.
Bram Moolenaar <bram@vim.org>
parents: 2210
diff changeset
11819 persistent_undo Compiled with support for persistent undo history.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11820 postscript Compiled with PostScript file printing.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11821 printer Compiled with |:hardcopy| support.
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
11822 profile Compiled with |:profile| support.
13123
aaead5b4d77d patch 8.0.1436: not enough information about what Python version may work
Christian Brabandt <cb@256bit.org>
parents: 13070
diff changeset
11823 python Python 2.x interface available. |has-python|
aaead5b4d77d patch 8.0.1436: not enough information about what Python version may work
Christian Brabandt <cb@256bit.org>
parents: 13070
diff changeset
11824 python_compiled Compiled with Python 2.x interface. |has-python|
aaead5b4d77d patch 8.0.1436: not enough information about what Python version may work
Christian Brabandt <cb@256bit.org>
parents: 13070
diff changeset
11825 python_dynamic Python 2.x interface is dynamically loaded. |has-python|
aaead5b4d77d patch 8.0.1436: not enough information about what Python version may work
Christian Brabandt <cb@256bit.org>
parents: 13070
diff changeset
11826 python3 Python 3.x interface available. |has-python|
aaead5b4d77d patch 8.0.1436: not enough information about what Python version may work
Christian Brabandt <cb@256bit.org>
parents: 13070
diff changeset
11827 python3_compiled Compiled with Python 3.x interface. |has-python|
aaead5b4d77d patch 8.0.1436: not enough information about what Python version may work
Christian Brabandt <cb@256bit.org>
parents: 13070
diff changeset
11828 python3_dynamic Python 3.x interface is dynamically loaded. |has-python|
19523
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
11829 pythonx Python 2.x and/or 3.x interface available. |python_x|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11830 qnx QNX version of Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11831 quickfix Compiled with |quickfix| support.
857
b933657f7c9d updated for version 7.0g01
vimboss
parents: 856
diff changeset
11832 reltime Compiled with |reltime()| support.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11833 rightleft Compiled with 'rightleft' support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11834 ruby Compiled with Ruby interface |ruby|.
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11835 scrollbind Compiled with 'scrollbind' support. (always true)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11836 showcmd Compiled with 'showcmd' support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11837 signs Compiled with |:sign| support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11838 smartindent Compiled with 'smartindent' support.
17004
353ed7ef78df patch 8.1.1502: cannot play any sound
Bram Moolenaar <Bram@vim.org>
parents: 16996
diff changeset
11839 sound Compiled with sound support, e.g. `sound_playevent()`
2681
85c5a72551e2 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2662
diff changeset
11840 spell Compiled with spell checking support |spell|.
1989
1fbbe04a950f updated for version 7.2-286
vimboss
parents: 1851
diff changeset
11841 startuptime Compiled with |--startuptime| support.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11842 statusline Compiled with support for 'statusline', 'rulerformat'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11843 and special formats of 'titlestring' and 'iconstring'.
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11844 sun SunOS version of Vim.
15512
f0f06837a699 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 15498
diff changeset
11845 sun_workshop Support for Sun |workshop| has been removed.
314
529f887b5cb7 updated for version 7.0082
vimboss
parents: 303
diff changeset
11846 syntax Compiled with syntax highlighting support |syntax|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11847 syntax_items There are active syntax highlighting items for the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11848 current buffer.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11849 system Compiled to use system() instead of fork()/exec().
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11850 tag_binary Compiled with binary searching in tags files
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11851 |tag-binary-search|.
16208
a23c883685cb Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16158
diff changeset
11852 tag_old_static Support for old static tags was removed, see
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11853 |tag-old-static|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11854 tcl Compiled with Tcl interface.
9076
9305a1251e51 commit https://github.com/vim/vim/commit/91c4937be15b0b743b6bc495df602c1abbff6b87
Christian Brabandt <cb@256bit.org>
parents: 9041
diff changeset
11855 termguicolors Compiled with true color in terminal support.
11904
40322e8f07e7 patch 8.0.0832: terminal function arguments are not consistent
Christian Brabandt <cb@256bit.org>
parents: 11882
diff changeset
11856 terminal Compiled with |terminal| support.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11857 terminfo Compiled with terminfo instead of termcap.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11858 termresponse Compiled with support for |t_RV| and |v:termresponse|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11859 textobjects Compiled with support for |text-objects|.
15138
9df130fd5e0d patch 8.1.0579: cannot attach properties to text
Bram Moolenaar <Bram@vim.org>
parents: 15131
diff changeset
11860 textprop Compiled with support for |text-properties|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11861 tgetent Compiled with tgetent support, able to use a termcap
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11862 or terminfo file.
8577
63dc856bd13d commit https://github.com/vim/vim/commit/975b5271eed4fa0500c24a8f37be0b1797cb9db7
Christian Brabandt <cb@256bit.org>
parents: 8538
diff changeset
11863 timers Compiled with |timer_start()| support.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11864 title Compiled with window title support |'title'|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11865 toolbar Compiled with support for |gui-toolbar|.
10404
65e0537a4560 commit https://github.com/vim/vim/commit/2cab0e191055a8145ccd46cd52869fbb9798b971
Christian Brabandt <cb@256bit.org>
parents: 10348
diff changeset
11866 ttyin input is a terminal (tty)
65e0537a4560 commit https://github.com/vim/vim/commit/2cab0e191055a8145ccd46cd52869fbb9798b971
Christian Brabandt <cb@256bit.org>
parents: 10348
diff changeset
11867 ttyout output is a terminal (tty)
12499
d91cf2e26ef0 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12465
diff changeset
11868 unix Unix version of Vim. *+unix*
10895
c391bfbdb452 Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10787
diff changeset
11869 unnamedplus Compiled with support for "unnamedplus" in 'clipboard'
16411
5b5c5daf57de patch 8.1.1210: support for user commands is spread out
Bram Moolenaar <Bram@vim.org>
parents: 16380
diff changeset
11870 user_commands User-defined commands. (always true)
18790
8dde7ced3344 Update a few runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18732
diff changeset
11871 vartabs Compiled with variable tabstop support |'vartabstop'|.
13341
acd7eaa13d2b Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13329
diff changeset
11872 vcon Win32: Virtual console support is working, can use
acd7eaa13d2b Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13329
diff changeset
11873 'termguicolors'. Also see |+vtp|.
2681
85c5a72551e2 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2662
diff changeset
11874 vertsplit Compiled with vertically split windows |:vsplit|.
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11875 (always true)
2581
e8a482a7fa6c Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
11876 vim_starting True while initial source'ing takes place. |startup|
8748
b1a19a2f73f0 commit https://github.com/vim/vim/commit/4f3f668c8486444e53163c29d2fc79bf47eb3c82
Christian Brabandt <cb@256bit.org>
parents: 8738
diff changeset
11877 *vim_starting*
2681
85c5a72551e2 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2662
diff changeset
11878 viminfo Compiled with viminfo support.
16223
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
11879 vimscript-1 Compiled Vim script version 1 support
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
11880 vimscript-2 Compiled Vim script version 2 support
16380
5ad204d8a2f2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16366
diff changeset
11881 vimscript-3 Compiled Vim script version 3 support
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11882 virtualedit Compiled with 'virtualedit' option. (always true)
15424
90c8ff9c19ee patch 8.1.0720: cannot easily change the current quickfx list index
Bram Moolenaar <Bram@vim.org>
parents: 15418
diff changeset
11883 visual Compiled with Visual mode. (always true)
90c8ff9c19ee patch 8.1.0720: cannot easily change the current quickfx list index
Bram Moolenaar <Bram@vim.org>
parents: 15418
diff changeset
11884 visualextra Compiled with extra Visual mode commands. (always
90c8ff9c19ee patch 8.1.0720: cannot easily change the current quickfx list index
Bram Moolenaar <Bram@vim.org>
parents: 15418
diff changeset
11885 true) |blockwise-operators|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11886 vms VMS version of Vim.
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11887 vreplace Compiled with |gR| and |gr| commands. (always true)
13482
9eebe457eb3c Update runtime files. Convert a couple of help files to utf-8.
Christian Brabandt <cb@256bit.org>
parents: 13438
diff changeset
11888 vtp Compiled for vcon support |+vtp| (check vcon to find
13501
a4a559e08798 patch 8.0.1624: options for term_dumpdiff() and term_dumpload() not implemented
Christian Brabandt <cb@256bit.org>
parents: 13482
diff changeset
11889 out if it works in the current console).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11890 wildignore Compiled with 'wildignore' option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11891 wildmenu Compiled with 'wildmenu' option.
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11892 win16 old version for MS-Windows 3.1 (always false)
2698
b6471224d2af Updated runtime files and translations.
Bram Moolenaar <bram@vim.org>
parents: 2681
diff changeset
11893 win32 Win32 version of Vim (MS-Windows 95 and later, 32 or
b6471224d2af Updated runtime files and translations.
Bram Moolenaar <bram@vim.org>
parents: 2681
diff changeset
11894 64 bits)
2681
85c5a72551e2 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2662
diff changeset
11895 win32unix Win32 version of Vim, using Unix files (Cygwin)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11896 win64 Win64 version of Vim (MS-Windows 64 bit).
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11897 win95 Win32 version for MS-Windows 95/98/ME (always false)
2681
85c5a72551e2 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2662
diff changeset
11898 winaltkeys Compiled with 'winaltkeys' option.
85c5a72551e2 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2662
diff changeset
11899 windows Compiled with support for more than one window.
15677
772e72b046a3 patch 8.1.0846: not easy to recognize the system Vim runs on
Bram Moolenaar <Bram@vim.org>
parents: 15615
diff changeset
11900 (always true)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11901 writebackup Compiled with 'writebackup' default on.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11902 xfontset Compiled with X fontset support |xfontset|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11903 xim Compiled with X input method support |xim|.
5340
22da5ab9aaa1 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
11904 xpm Compiled with pixmap support.
22da5ab9aaa1 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
11905 xpm_w32 Compiled with pixmap support for Win32. (Only for
22da5ab9aaa1 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
11906 backward compatibility. Use "xpm" instead.)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11907 xsmp Compiled with X session management support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11908 xsmp_interact Compiled with interactive X session management support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11909 xterm_clipboard Compiled with support for xterm clipboard.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11910 xterm_save Compiled with support for saving and restoring the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11911 xterm screen.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11912 x11 Compiled with X11 support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11913
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11914 *string-match*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11915 Matching a pattern in a String
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11916
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11917 A regexp pattern as explained at |pattern| is normally used to find a match in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11918 the buffer lines. When a pattern is used to find a match in a String, almost
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11919 everything works in the same way. The difference is that a String is handled
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11920 like it is one line. When it contains a "\n" character, this is not seen as a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11921 line break for the pattern. It can be matched with a "\n" in the pattern, or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11922 with ".". Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11923 :let a = "aaaa\nxxxx"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11924 :echo matchstr(a, "..\n..")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11925 aa
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11926 xx
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11927 :echo matchstr(a, "a.x")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11928 a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11929 x
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11930
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11931 Don't forget that "^" will only match at the first character of the String and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11932 "$" at the last character of the string. They don't match after or before a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11933 "\n".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11934
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11935 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11936 5. Defining functions *user-functions*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11937
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11938 New functions can be defined. These can be called just like builtin
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11939 functions. The function executes a sequence of Ex commands. Normal mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11940 commands can be executed with the |:normal| command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11941
19181
94eda51ba9ba patch 8.2.0149: maintaining a Vim9 branch separately is more work
Bram Moolenaar <Bram@vim.org>
parents: 19163
diff changeset
11942 This section is about the legacy functions. For the Vim9 functions, which
94eda51ba9ba patch 8.2.0149: maintaining a Vim9 branch separately is more work
Bram Moolenaar <Bram@vim.org>
parents: 19163
diff changeset
11943 execute much faster, support type checking and more, see |vim9.txt|.
94eda51ba9ba patch 8.2.0149: maintaining a Vim9 branch separately is more work
Bram Moolenaar <Bram@vim.org>
parents: 19163
diff changeset
11944
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11945 The function name must start with an uppercase letter, to avoid confusion with
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11946 builtin functions. To prevent from using the same name in different scripts
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11947 avoid obvious, short names. A good habit is to start the function name with
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11948 the name of the script, e.g., "HTMLcolor()".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11949
504
35cde31bdcbd updated for version 7.0141
vimboss
parents: 502
diff changeset
11950 It's also possible to use curly braces, see |curly-braces-names|. And the
35cde31bdcbd updated for version 7.0141
vimboss
parents: 502
diff changeset
11951 |autoload| facility is useful to define a function only when it's called.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11952
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11953 *local-function*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11954 A function local to a script must start with "s:". A local script function
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11955 can only be called from within the script and from functions, user commands
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11956 and autocommands defined in the script. It is also possible to call the
1698
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
11957 function from a mapping defined in the script, but then |<SID>| must be used
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11958 instead of "s:" when the mapping is expanded outside of the script.
5862
306caa30d83b Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5815
diff changeset
11959 There are only script-local functions, no buffer-local or window-local
306caa30d83b Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5815
diff changeset
11960 functions.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11961
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11962 *:fu* *:function* *E128* *E129* *E123*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11963 :fu[nction] List all functions and their arguments.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11964
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11965 :fu[nction] {name} List function {name}.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
11966 {name} can also be a |Dictionary| entry that is a
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
11967 |Funcref|: >
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
11968 :function dict.init
504
35cde31bdcbd updated for version 7.0141
vimboss
parents: 502
diff changeset
11969
35cde31bdcbd updated for version 7.0141
vimboss
parents: 502
diff changeset
11970 :fu[nction] /{pattern} List functions with a name matching {pattern}.
35cde31bdcbd updated for version 7.0141
vimboss
parents: 502
diff changeset
11971 Example that lists all functions ending with "File": >
35cde31bdcbd updated for version 7.0141
vimboss
parents: 502
diff changeset
11972 :function /File$
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 477
diff changeset
11973 <
6f8b578776ab updated for version 7.0131
vimboss
parents: 477
diff changeset
11974 *:function-verbose*
6f8b578776ab updated for version 7.0131
vimboss
parents: 477
diff changeset
11975 When 'verbose' is non-zero, listing a function will also display where it was
6f8b578776ab updated for version 7.0131
vimboss
parents: 477
diff changeset
11976 last defined. Example: >
6f8b578776ab updated for version 7.0131
vimboss
parents: 477
diff changeset
11977
6f8b578776ab updated for version 7.0131
vimboss
parents: 477
diff changeset
11978 :verbose function SetFileTypeSH
6f8b578776ab updated for version 7.0131
vimboss
parents: 477
diff changeset
11979 function SetFileTypeSH(name)
6f8b578776ab updated for version 7.0131
vimboss
parents: 477
diff changeset
11980 Last set from /usr/share/vim/vim-7.0/filetype.vim
6f8b578776ab updated for version 7.0131
vimboss
parents: 477
diff changeset
11981 <
484
f012c4ed8c38 updated for version 7.0132
vimboss
parents: 482
diff changeset
11982 See |:verbose-cmd| for more information.
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 477
diff changeset
11983
5862
306caa30d83b Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5815
diff changeset
11984 *E124* *E125* *E853* *E884*
9688
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
11985 :fu[nction][!] {name}([arguments]) [range] [abort] [dict] [closure]
12756
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
11986 Define a new function by the name {name}. The body of
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
11987 the function follows in the next lines, until the
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
11988 matching |:endfunction|.
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
11989
12756
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
11990 The name must be made of alphanumeric characters and
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
11991 '_', and must start with a capital or "s:" (see
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
11992 above). Note that using "b:" or "g:" is not allowed.
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
11993 (since patch 7.4.260 E884 is given if the function
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
11994 name has a colon in the name, e.g. for "foo:bar()".
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
11995 Before that patch no error was given).
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
11996
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
11997 {name} can also be a |Dictionary| entry that is a
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
11998 |Funcref|: >
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
11999 :function dict.init(arg)
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
12000 < "dict" must be an existing dictionary. The entry
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12001 "init" is added if it didn't exist yet. Otherwise [!]
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
12002 is required to overwrite an existing function. The
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12003 result is a |Funcref| to a numbered function. The
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12004 function can only be used with a |Funcref| and will be
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12005 deleted if there are no more references to it.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12006 *E127* *E122*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12007 When a function by this name already exists and [!] is
15008
67e3103d6e18 patch 8.1.0515: reloading a script gives errors for existing functions
Bram Moolenaar <Bram@vim.org>
parents: 14999
diff changeset
12008 not used an error message is given. There is one
67e3103d6e18 patch 8.1.0515: reloading a script gives errors for existing functions
Bram Moolenaar <Bram@vim.org>
parents: 14999
diff changeset
12009 exception: When sourcing a script again, a function
67e3103d6e18 patch 8.1.0515: reloading a script gives errors for existing functions
Bram Moolenaar <Bram@vim.org>
parents: 14999
diff changeset
12010 that was previously defined in that script will be
67e3103d6e18 patch 8.1.0515: reloading a script gives errors for existing functions
Bram Moolenaar <Bram@vim.org>
parents: 14999
diff changeset
12011 silently replaced.
67e3103d6e18 patch 8.1.0515: reloading a script gives errors for existing functions
Bram Moolenaar <Bram@vim.org>
parents: 14999
diff changeset
12012 When [!] is used, an existing function is silently
67e3103d6e18 patch 8.1.0515: reloading a script gives errors for existing functions
Bram Moolenaar <Bram@vim.org>
parents: 14999
diff changeset
12013 replaced. Unless it is currently being executed, that
67e3103d6e18 patch 8.1.0515: reloading a script gives errors for existing functions
Bram Moolenaar <Bram@vim.org>
parents: 14999
diff changeset
12014 is an error.
11561
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
12015 NOTE: Use ! wisely. If used without care it can cause
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
12016 an existing function to be replaced unexpectedly,
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
12017 which is hard to debug.
20552
74e3316c1d5a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20522
diff changeset
12018 NOTE: In Vim9 script script-local functions cannot be
74e3316c1d5a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20522
diff changeset
12019 deleted or redefined.
133
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
12020
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
12021 For the {arguments} see |function-argument|.
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
12022
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5596
diff changeset
12023 *:func-range* *a:firstline* *a:lastline*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12024 When the [range] argument is added, the function is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12025 expected to take care of a range itself. The range is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12026 passed as "a:firstline" and "a:lastline". If [range]
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12027 is excluded, ":{range}call" will call the function for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12028 each line in the range, with the cursor on the start
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12029 of each line. See |function-range-example|.
3967
fdb8a9c7bd91 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
12030 The cursor is still moved to the first line of the
fdb8a9c7bd91 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
12031 range, as is the case with all Ex commands.
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5596
diff changeset
12032 *:func-abort*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12033 When the [abort] argument is added, the function will
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12034 abort as soon as an error is detected.
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5596
diff changeset
12035 *:func-dict*
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
12036 When the [dict] argument is added, the function must
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
12037 be invoked through an entry in a |Dictionary|. The
102
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
12038 local variable "self" will then be set to the
0aa0e89bfd5f updated for version 7.0039
vimboss
parents: 99
diff changeset
12039 dictionary. See |Dictionary-function|.
9688
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12040 *:func-closure* *E932*
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12041 When the [closure] argument is added, the function
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12042 can access variables and arguments from the outer
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12043 scope. This is usually called a closure. In this
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12044 example Bar() uses "x" from the scope of Foo(). It
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12045 remains referenced even after Foo() returns: >
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12046 :function! Foo()
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12047 : let x = 0
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12048 : function! Bar() closure
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12049 : let x += 1
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12050 : return x
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12051 : endfunction
9737
35ce559b8553 commit https://github.com/vim/vim/commit/bc8801c9317eb721a2ee91322669f2dd5d136380
Christian Brabandt <cb@256bit.org>
parents: 9723
diff changeset
12052 : return funcref('Bar')
9688
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12053 :endfunction
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12054
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12055 :let F = Foo()
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12056 :echo F()
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12057 < 1 >
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12058 :echo F()
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12059 < 2 >
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12060 :echo F()
2ea935bdd1a1 commit https://github.com/vim/vim/commit/10ce39a0d52272a3dfff2feb8c631529f29e6740
Christian Brabandt <cb@256bit.org>
parents: 9686
diff changeset
12061 < 3
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12062
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
12063 *function-search-undo*
653
5acda076fb0c updated for version 7.0192
vimboss
parents: 650
diff changeset
12064 The last used search pattern and the redo command "."
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
12065 will not be changed by the function. This also
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
12066 implies that the effect of |:nohlsearch| is undone
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
12067 when the function returns.
653
5acda076fb0c updated for version 7.0192
vimboss
parents: 650
diff changeset
12068
11561
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
12069 *:endf* *:endfunction* *E126* *E193* *W22*
11543
57c452316da1 patch 8.0.0654: no warning for text after :endfunction
Christian Brabandt <cb@256bit.org>
parents: 11518
diff changeset
12070 :endf[unction] [argument]
57c452316da1 patch 8.0.0654: no warning for text after :endfunction
Christian Brabandt <cb@256bit.org>
parents: 11518
diff changeset
12071 The end of a function definition. Best is to put it
57c452316da1 patch 8.0.0654: no warning for text after :endfunction
Christian Brabandt <cb@256bit.org>
parents: 11518
diff changeset
12072 on a line by its own, without [argument].
57c452316da1 patch 8.0.0654: no warning for text after :endfunction
Christian Brabandt <cb@256bit.org>
parents: 11518
diff changeset
12073
57c452316da1 patch 8.0.0654: no warning for text after :endfunction
Christian Brabandt <cb@256bit.org>
parents: 11518
diff changeset
12074 [argument] can be:
57c452316da1 patch 8.0.0654: no warning for text after :endfunction
Christian Brabandt <cb@256bit.org>
parents: 11518
diff changeset
12075 | command command to execute next
57c452316da1 patch 8.0.0654: no warning for text after :endfunction
Christian Brabandt <cb@256bit.org>
parents: 11518
diff changeset
12076 \n command command to execute next
57c452316da1 patch 8.0.0654: no warning for text after :endfunction
Christian Brabandt <cb@256bit.org>
parents: 11518
diff changeset
12077 " comment always ignored
11561
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
12078 anything else ignored, warning given when
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
12079 'verbose' is non-zero
11543
57c452316da1 patch 8.0.0654: no warning for text after :endfunction
Christian Brabandt <cb@256bit.org>
parents: 11518
diff changeset
12080 The support for a following command was added in Vim
57c452316da1 patch 8.0.0654: no warning for text after :endfunction
Christian Brabandt <cb@256bit.org>
parents: 11518
diff changeset
12081 8.0.0654, before that any argument was silently
57c452316da1 patch 8.0.0654: no warning for text after :endfunction
Christian Brabandt <cb@256bit.org>
parents: 11518
diff changeset
12082 ignored.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12083
11561
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
12084 To be able to define a function inside an `:execute`
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
12085 command, use line breaks instead of |:bar|: >
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
12086 :exe "func Foo()\necho 'foo'\nendfunc"
7ad79766365a patch 8.0.0663: unexpected error message only when 'verbose' is set
Christian Brabandt <cb@256bit.org>
parents: 11553
diff changeset
12087 <
9723
80ac9cf77c9b commit https://github.com/vim/vim/commit/437bafe4c8a83ed71ee006eda7f54b65a90f0d4c
Christian Brabandt <cb@256bit.org>
parents: 9688
diff changeset
12088 *:delf* *:delfunction* *E130* *E131* *E933*
11543
57c452316da1 patch 8.0.0654: no warning for text after :endfunction
Christian Brabandt <cb@256bit.org>
parents: 11518
diff changeset
12089 :delf[unction][!] {name}
57c452316da1 patch 8.0.0654: no warning for text after :endfunction
Christian Brabandt <cb@256bit.org>
parents: 11518
diff changeset
12090 Delete function {name}.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12091 {name} can also be a |Dictionary| entry that is a
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12092 |Funcref|: >
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12093 :delfunc dict.init
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
12094 < This will remove the "init" entry from "dict". The
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12095 function is deleted if there are no more references to
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12096 it.
11543
57c452316da1 patch 8.0.0654: no warning for text after :endfunction
Christian Brabandt <cb@256bit.org>
parents: 11518
diff changeset
12097 With the ! there is no error if the function does not
57c452316da1 patch 8.0.0654: no warning for text after :endfunction
Christian Brabandt <cb@256bit.org>
parents: 11518
diff changeset
12098 exist.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12099 *:retu* *:return* *E133*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12100 :retu[rn] [expr] Return from a function. When "[expr]" is given, it is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12101 evaluated and returned as the result of the function.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12102 If "[expr]" is not given, the number 0 is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12103 When a function ends without an explicit ":return",
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12104 the number 0 is returned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12105 Note that there is no check for unreachable lines,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12106 thus there is no warning if commands follow ":return".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12107
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12108 If the ":return" is used after a |:try| but before the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12109 matching |:finally| (if present), the commands
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12110 following the ":finally" up to the matching |:endtry|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12111 are executed first. This process applies to all
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12112 nested ":try"s inside the function. The function
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12113 returns at the outermost ":endtry".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12114
133
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
12115 *function-argument* *a:var*
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
12116 An argument can be defined by giving its name. In the function this can then
133
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
12117 be used as "a:name" ("a:" for argument).
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12118 *a:0* *a:1* *a:000* *E740* *...*
133
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
12119 Up to 20 arguments can be given, separated by commas. After the named
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
12120 arguments an argument "..." can be specified, which means that more arguments
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
12121 may optionally be following. In the function the extra arguments can be used
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
12122 as "a:1", "a:2", etc. "a:0" is set to the number of extra arguments (which
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12123 can be 0). "a:000" is set to a |List| that contains these arguments. Note
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12124 that "a:1" is the same as "a:000[0]".
148
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12125 *E742*
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12126 The a: scope and the variables in it cannot be changed, they are fixed.
9527
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
12127 However, if a composite type is used, such as |List| or |Dictionary| , you can
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
12128 change their contents. Thus you can pass a |List| to a function and have the
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
12129 function add an item to it. If you want to make sure the function cannot
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
12130 change a |List| or |Dictionary| use |:lockvar|.
133
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
12131
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
12132 It is also possible to define a function without any arguments. You must
12756
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
12133 still supply the () then.
3b26420fc639 Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents: 12722
diff changeset
12134
13482
9eebe457eb3c Update runtime files. Convert a couple of help files to utf-8.
Christian Brabandt <cb@256bit.org>
parents: 13438
diff changeset
12135 It is allowed to define another function inside a function body.
133
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
12136
16615
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12137 *optional-function-argument*
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12138 You can provide default values for positional named arguments. This makes
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12139 them optional for function calls. When a positional argument is not
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12140 specified at a call, the default expression is used to initialize it.
19968
1908e92b02fd Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19952
diff changeset
12141 This only works for functions declared with `:function` or `:def`, not for
1908e92b02fd Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19952
diff changeset
12142 lambda expressions |expr-lambda|.
16615
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12143
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12144 Example: >
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12145 function Something(key, value = 10)
16648
a7f06505ad39 patch 8.1.1326: no test for listener with partial
Bram Moolenaar <Bram@vim.org>
parents: 16638
diff changeset
12146 echo a:key .. ": " .. a:value
16615
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12147 endfunction
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12148 call Something('empty') "empty: 10"
16648
a7f06505ad39 patch 8.1.1326: no test for listener with partial
Bram Moolenaar <Bram@vim.org>
parents: 16638
diff changeset
12149 call Something('key', 20) "key: 20"
16615
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12150
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12151 The argument default expressions are evaluated at the time of the function
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12152 call, not definition. Thus it is possible to use an expression which is
16808
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16704
diff changeset
12153 invalid the moment the function is defined. The expressions are also only
16615
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12154 evaluated when arguments are not specified during a call.
21499
3a1ed539ae2a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21409
diff changeset
12155 *none-function_argument*
16615
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12156 You can pass |v:none| to use the default expression. Note that this means you
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12157 cannot pass v:none as an ordinary value when an argument has a default
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12158 expression.
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12159
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12160 Example: >
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12161 function Something(a = 10, b = 20, c = 30)
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12162 endfunction
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12163 call Something(1, v:none, 3) " b = 20
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12164 <
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12165 *E989*
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12166 Optional arguments with default expressions must occur after any mandatory
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12167 arguments. You can use "..." after all optional named arguments.
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12168
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12169 It is possible for later argument defaults to refer to prior arguments,
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12170 but not the other way around. They must be prefixed with "a:", as with all
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12171 arguments.
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12172
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12173 Example that works: >
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12174 :function Okay(mandatory, optional = a:mandatory)
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12175 :endfunction
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12176 Example that does NOT work: >
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12177 :function NoGood(first = a:second, second = 10)
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12178 :endfunction
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12179 <
19968
1908e92b02fd Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19952
diff changeset
12180 When not using "...", the number of arguments in a function call must be at
1908e92b02fd Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19952
diff changeset
12181 least equal to the number of mandatory named arguments. When using "...", the
1908e92b02fd Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19952
diff changeset
12182 number of arguments may be larger than the total of mandatory and optional
1908e92b02fd Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19952
diff changeset
12183 arguments.
16615
1a911bd57f11 patch 8.1.1310: named function arguments are never optional
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
12184
133
bcb347a8f934 updated for version 7.0044
vimboss
parents: 123
diff changeset
12185 *local-variables*
9527
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
12186 Inside a function local variables can be used. These will disappear when the
e8b3db8e2d30 commit https://github.com/vim/vim/commit/069c1e7fa9f45a665064f7f2c17da84d6a48f544
Christian Brabandt <cb@256bit.org>
parents: 9464
diff changeset
12187 function returns. Global variables need to be accessed with "g:".
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12188
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12189 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12190 :function Table(title, ...)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12191 : echohl Title
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12192 : echo a:title
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12193 : echohl None
140
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
12194 : echo a:0 . " items:"
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
12195 : for s in a:000
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
12196 : echon ' ' . s
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
12197 : endfor
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12198 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12199
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12200 This function can then be called with: >
140
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
12201 call Table("Table", "line1", "line2")
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 133
diff changeset
12202 call Table("Empty Table")
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12203
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12204 To return more than one value, return a |List|: >
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12205 :function Compute(n1, n2)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12206 : if a:n2 == 0
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12207 : return ["fail", 0]
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12208 : endif
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12209 : return ["ok", a:n1 / a:n2]
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12210 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12211
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12212 This function can then be called with: >
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12213 :let [success, div] = Compute(102, 6)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12214 :if success == "ok"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12215 : echo div
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12216 :endif
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12217 <
786
8f6a426bc1e0 updated for version 7.0229
vimboss
parents: 782
diff changeset
12218 *:cal* *:call* *E107* *E117*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12219 :[range]cal[l] {name}([arguments])
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12220 Call a function. The name of the function and its arguments
16808
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16704
diff changeset
12221 are as specified with `:function`. Up to 20 arguments can be
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12222 used. The returned value is discarded.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12223 Without a range and for functions that accept a range, the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12224 function is called once. When a range is given the cursor is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12225 positioned at the start of the first line before executing the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12226 function.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12227 When a range is given and the function doesn't handle it
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12228 itself, the function is executed for each line in the range,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12229 with the cursor in the first column of that line. The cursor
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12230 is left at the last line (possibly moved by the last function
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
12231 call). The arguments are re-evaluated for each line. Thus
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12232 this works:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12233 *function-range-example* >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12234 :function Mynumber(arg)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12235 : echo line(".") . " " . a:arg
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12236 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12237 :1,5call Mynumber(getline("."))
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12238 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12239 The "a:firstline" and "a:lastline" are defined anyway, they
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12240 can be used to do something different at the start or end of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12241 the range.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12242
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12243 Example of a function that handles the range itself: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12244
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12245 :function Cont() range
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12246 : execute (a:firstline + 1) . "," . a:lastline . 's/^/\t\\ '
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12247 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12248 :4,8call Cont()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12249 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12250 This function inserts the continuation character "\" in front
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12251 of all the lines in the range, except the first one.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12252
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12253 When the function returns a composite value it can be further
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12254 dereferenced, but the range will not be used then. Example: >
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12255 :4,8call GetDict().method()
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12256 < Here GetDict() gets the range but method() does not.
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12257
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12258 *E132*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12259 The recursiveness of user functions is restricted with the |'maxfuncdepth'|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12260 option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12261
17620
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
12262 It is also possible to use `:eval`. It does not support a range, but does
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
12263 allow for method chaining, e.g.: >
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
12264 eval GetList()->Filter()->append('$')
072efa9ca875 patch 8.1.1807: more functions can be used as a method
Bram Moolenaar <Bram@vim.org>
parents: 17612
diff changeset
12265
17667
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
12266 A function can also be called as part of evaluating an expression or when it
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
12267 is used as a method: >
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
12268 let x = GetList()
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
12269 let y = GetList()->Filter()
95c23e180022 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17661
diff changeset
12270
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12271
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12272 AUTOMATICALLY LOADING FUNCTIONS ~
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12273 *autoload-functions*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12274 When using many or large functions, it's possible to automatically define them
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12275 only when they are used. There are two methods: with an autocommand and with
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12276 the "autoload" directory in 'runtimepath'.
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12277
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12278
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12279 Using an autocommand ~
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12280
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
12281 This is introduced in the user manual, section |41.14|.
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
12282
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12283 The autocommand is useful if you have a plugin that is a long Vim script file.
16808
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16704
diff changeset
12284 You can define the autocommand and quickly quit the script with `:finish`.
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
12285 That makes Vim startup faster. The autocommand should then load the same file
16808
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16704
diff changeset
12286 again, setting a variable to skip the `:finish` command.
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12287
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12288 Use the FuncUndefined autocommand event with a pattern that matches the
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12289 function(s) to be defined. Example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12290
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12291 :au FuncUndefined BufNet* source ~/vim/bufnetfuncs.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12292
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12293 The file "~/vim/bufnetfuncs.vim" should then define functions that start with
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12294 "BufNet". Also see |FuncUndefined|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12295
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12296
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12297 Using an autoload script ~
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
12298 *autoload* *E746*
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
12299 This is introduced in the user manual, section |41.15|.
8c60f65311fa updated for version 7.0052
vimboss
parents: 168
diff changeset
12300
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12301 Using a script in the "autoload" directory is simpler, but requires using
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12302 exactly the right file name. A function that can be autoloaded has a name
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12303 like this: >
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12304
270
a20218704019 updated for version 7.0072
vimboss
parents: 258
diff changeset
12305 :call filename#funcname()
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12306
20856
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
12307 These functions are always global, in Vim9 script "g:" needs to be used: >
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
12308 :call g:filename#funcname()
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
12309
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12310 When such a function is called, and it is not defined yet, Vim will search the
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12311 "autoload" directories in 'runtimepath' for a script file called
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12312 "filename.vim". For example "~/.vim/autoload/filename.vim". That file should
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12313 then define the function like this: >
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12314
270
a20218704019 updated for version 7.0072
vimboss
parents: 258
diff changeset
12315 function filename#funcname()
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12316 echo "Done!"
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12317 endfunction
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12318
530
339999b511a0 updated for version 7.0148
vimboss
parents: 523
diff changeset
12319 The file name and the name used before the # in the function must match
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12320 exactly, and the defined function must have the name exactly as it will be
20856
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
12321 called. In Vim9 script the "g:" prefix must be used: >
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
12322 function g:filename#funcname()
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
12323
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
12324 or for a compiled function: >
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
12325 def g:filename#funcname()
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12326
270
a20218704019 updated for version 7.0072
vimboss
parents: 258
diff changeset
12327 It is possible to use subdirectories. Every # in the function name works like
a20218704019 updated for version 7.0072
vimboss
parents: 258
diff changeset
12328 a path separator. Thus when calling a function: >
a20218704019 updated for version 7.0072
vimboss
parents: 258
diff changeset
12329
a20218704019 updated for version 7.0072
vimboss
parents: 258
diff changeset
12330 :call foo#bar#func()
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12331
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12332 Vim will look for the file "autoload/foo/bar.vim" in 'runtimepath'.
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12333
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
12334 This also works when reading a variable that has not been set yet: >
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
12335
270
a20218704019 updated for version 7.0072
vimboss
parents: 258
diff changeset
12336 :let l = foo#bar#lvar
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
12337
557
862863033fdd updated for version 7.0158
vimboss
parents: 555
diff changeset
12338 However, when the autoload script was already loaded it won't be loaded again
862863033fdd updated for version 7.0158
vimboss
parents: 555
diff changeset
12339 for an unknown variable.
862863033fdd updated for version 7.0158
vimboss
parents: 555
diff changeset
12340
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
12341 When assigning a value to such a variable nothing special happens. This can
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
12342 be used to pass settings to the autoload script before it's loaded: >
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
12343
270
a20218704019 updated for version 7.0072
vimboss
parents: 258
diff changeset
12344 :let foo#bar#toggle = 1
a20218704019 updated for version 7.0072
vimboss
parents: 258
diff changeset
12345 :call foo#bar#func()
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
12346
164
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 161
diff changeset
12347 Note that when you make a mistake and call a function that is supposed to be
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 161
diff changeset
12348 defined in an autoload script, but the script doesn't actually define the
22723
5b7ea82bc18f Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22689
diff changeset
12349 function, you will get an error message for the missing function. If you fix
5b7ea82bc18f Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22689
diff changeset
12350 the autoload script it won't be automatically loaded again. Either restart
5b7ea82bc18f Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 22689
diff changeset
12351 Vim or manually source the script.
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
12352
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
12353 Also note that if you have two script files, and one calls a function in the
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
12354 other and vice versa, before the used function is defined, it won't work.
168
4d9eabb1396e updated for version 7.0051
vimboss
parents: 164
diff changeset
12355 Avoid using the autoload functionality at the toplevel.
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 158
diff changeset
12356
794
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
12357 Hint: If you distribute a bunch of scripts you can pack them together with the
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
12358 |vimball| utility. Also read the user manual |distribute-script|.
f19994020dad updated for version 7.0231
vimboss
parents: 790
diff changeset
12359
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12360 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12361 6. Curly braces names *curly-braces-names*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12362
3410
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
12363 In most places where you can use a variable, you can use a "curly braces name"
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
12364 variable. This is a regular variable name with one or more expressions
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
12365 wrapped in braces {} like this: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12366 my_{adjective}_variable
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12367
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12368 When Vim encounters this, it evaluates the expression inside the braces, puts
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12369 that in place of the expression, and re-interprets the whole as a variable
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12370 name. So in the above example, if the variable "adjective" was set to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12371 "noisy", then the reference would be to "my_noisy_variable", whereas if
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12372 "adjective" was set to "quiet", then it would be to "my_quiet_variable".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12373
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12374 One application for this is to create a set of variables governed by an option
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
12375 value. For example, the statement >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12376 echo my_{&background}_message
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12377
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12378 would output the contents of "my_dark_message" or "my_light_message" depending
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12379 on the current value of 'background'.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12380
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12381 You can use multiple brace pairs: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12382 echo my_{adverb}_{adjective}_message
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12383 ..or even nest them: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12384 echo my_{ad{end_of_word}}_message
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12385 where "end_of_word" is either "verb" or "jective".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12386
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12387 However, the expression inside the braces must evaluate to a valid single
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 233
diff changeset
12388 variable name, e.g. this is invalid: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12389 :let foo='a + b'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12390 :echo c{foo}d
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12391 .. since the result of expansion is "ca + bd", which is not a variable name.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12392
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12393 *curly-braces-function-names*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12394 You can call and define functions by an evaluated name in a similar way.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12395 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12396 :let func_end='whizz'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12397 :call my_func_{func_end}(parameter)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12398
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12399 This would call the function "my_func_whizz(parameter)".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12400
3410
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
12401 This does NOT work: >
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
12402 :let i = 3
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
12403 :let @{i} = '' " error
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
12404 :echo @{i} " error
94601b379f38 Updated runtime files. Add Dutch translations.
Bram Moolenaar <bram@vim.org>
parents: 3398
diff changeset
12405
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12406 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12407 7. Commands *expression-commands*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12408
20856
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
12409 Note: in Vim9 script `:let` is used for variable declaration, not assignment.
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
12410 An assignment leaves out the `:let` command. |vim9-declaration|
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
12411
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12412 :let {var-name} = {expr1} *:let* *E18*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12413 Set internal variable {var-name} to the result of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12414 expression {expr1}. The variable will get the type
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12415 from the {expr}. If {var-name} didn't exist yet, it
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12416 is created.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12417
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
12418 :let {var-name}[{idx}] = {expr1} *E689*
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
12419 Set a list item to the result of the expression
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
12420 {expr1}. {var-name} must refer to a list and {idx}
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
12421 must be a valid index in that list. For nested list
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
12422 the index can be repeated.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
12423 This cannot be used to add an item to a |List|.
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
12424 This cannot be used to set a byte in a String. You
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
12425 can do that like this: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
12426 :let var = var[0:2] . 'X' . var[4:]
15454
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
12427 < When {var-name} is a |Blob| then {idx} can be the
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
12428 length of the blob, in which case one byte is
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
12429 appended.
1d2b5c016f17 patch 8.1.0735: cannot handle binary data
Bram Moolenaar <Bram@vim.org>
parents: 15446
diff changeset
12430
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12431 *E711* *E719*
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12432 :let {var-name}[{idx1}:{idx2}] = {expr1} *E708* *E709* *E710*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12433 Set a sequence of items in a |List| to the result of
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12434 the expression {expr1}, which must be a list with the
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
12435 correct number of items.
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
12436 {idx1} can be omitted, zero is used instead.
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
12437 {idx2} can be omitted, meaning the end of the list.
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
12438 When the selected range of items is partly past the
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
12439 end of the list, items will be added.
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
12440
16223
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
12441 *:let+=* *:let-=* *:letstar=*
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
12442 *:let/=* *:let%=* *:let.=* *:let..=* *E734* *E985*
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12443 :let {var} += {expr1} Like ":let {var} = {var} + {expr1}".
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12444 :let {var} -= {expr1} Like ":let {var} = {var} - {expr1}".
15790
05d836c8f1c4 patch 8.1.0902: incomplete set of assignment operators
Bram Moolenaar <Bram@vim.org>
parents: 15774
diff changeset
12445 :let {var} *= {expr1} Like ":let {var} = {var} * {expr1}".
05d836c8f1c4 patch 8.1.0902: incomplete set of assignment operators
Bram Moolenaar <Bram@vim.org>
parents: 15774
diff changeset
12446 :let {var} /= {expr1} Like ":let {var} = {var} / {expr1}".
05d836c8f1c4 patch 8.1.0902: incomplete set of assignment operators
Bram Moolenaar <Bram@vim.org>
parents: 15774
diff changeset
12447 :let {var} %= {expr1} Like ":let {var} = {var} % {expr1}".
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12448 :let {var} .= {expr1} Like ":let {var} = {var} . {expr1}".
16223
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
12449 :let {var} ..= {expr1} Like ":let {var} = {var} .. {expr1}".
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12450 These fail if {var} was not set yet and when the type
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12451 of {var} and {expr1} don't fit the operator.
16223
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
12452 `.=` is not supported with Vim script version 2 and
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
12453 later, see |vimscript-version|.
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12454
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12455
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12456 :let ${env-name} = {expr1} *:let-environment* *:let-$*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12457 Set environment variable {env-name} to the result of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12458 the expression {expr1}. The type is always String.
17758
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
12459
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
12460 On some systems making an environment variable empty
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
12461 causes it to be deleted. Many systems do not make a
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
12462 difference between an environment variable that is not
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
12463 set and an environment variable that is empty.
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17756
diff changeset
12464
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12465 :let ${env-name} .= {expr1}
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12466 Append {expr1} to the environment variable {env-name}.
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12467 If the environment variable didn't exist yet this
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12468 works like "=".
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12469
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12470 :let @{reg-name} = {expr1} *:let-register* *:let-@*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12471 Write the result of the expression {expr1} in register
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12472 {reg-name}. {reg-name} must be a single letter, and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12473 must be the name of a writable register (see
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12474 |registers|). "@@" can be used for the unnamed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12475 register, "@/" for the search pattern.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12476 If the result of {expr1} ends in a <CR> or <NL>, the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12477 register will be linewise, otherwise it will be set to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12478 characterwise.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12479 This can be used to clear the last search pattern: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12480 :let @/ = ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12481 < This is different from searching for an empty string,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12482 that would match everywhere.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12483
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12484 :let @{reg-name} .= {expr1}
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
12485 Append {expr1} to register {reg-name}. If the
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12486 register was empty it's like setting it to {expr1}.
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12487
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12488 :let &{option-name} = {expr1} *:let-option* *:let-&*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12489 Set option {option-name} to the result of the
68
a97c6902ecd9 updated for version 7.0030
vimboss
parents: 55
diff changeset
12490 expression {expr1}. A String or Number value is
a97c6902ecd9 updated for version 7.0030
vimboss
parents: 55
diff changeset
12491 always converted to the type of the option.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12492 For an option local to a window or buffer the effect
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12493 is just like using the |:set| command: both the local
555
a5efb97bc104 updated for version 7.0157
vimboss
parents: 548
diff changeset
12494 value and the global value are changed.
68
a97c6902ecd9 updated for version 7.0030
vimboss
parents: 55
diff changeset
12495 Example: >
a97c6902ecd9 updated for version 7.0030
vimboss
parents: 55
diff changeset
12496 :let &path = &path . ',/usr/local/include'
10895
c391bfbdb452 Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10787
diff changeset
12497 < This also works for terminal codes in the form t_xx.
c391bfbdb452 Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10787
diff changeset
12498 But only for alphanumerical names. Example: >
c391bfbdb452 Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10787
diff changeset
12499 :let &t_k1 = "\<Esc>[234;"
c391bfbdb452 Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10787
diff changeset
12500 < When the code does not exist yet it will be created as
c391bfbdb452 Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10787
diff changeset
12501 a terminal key code, there is no error.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12502
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12503 :let &{option-name} .= {expr1}
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12504 For a string option: Append {expr1} to the value.
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12505 Does not insert a comma like |:set+=|.
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12506
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12507 :let &{option-name} += {expr1}
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12508 :let &{option-name} -= {expr1}
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12509 For a number or boolean option: Add or subtract
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12510 {expr1}.
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12511
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12512 :let &l:{option-name} = {expr1}
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12513 :let &l:{option-name} .= {expr1}
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12514 :let &l:{option-name} += {expr1}
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12515 :let &l:{option-name} -= {expr1}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12516 Like above, but only set the local value of an option
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12517 (if there is one). Works like |:setlocal|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12518
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12519 :let &g:{option-name} = {expr1}
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12520 :let &g:{option-name} .= {expr1}
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12521 :let &g:{option-name} += {expr1}
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12522 :let &g:{option-name} -= {expr1}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12523 Like above, but only set the global value of an option
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12524 (if there is one). Works like |:setglobal|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12525
85
fc244e0a6e7e updated for version 7.0034
vimboss
parents: 82
diff changeset
12526 :let [{name1}, {name2}, ...] = {expr1} *:let-unpack* *E687* *E688*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12527 {expr1} must evaluate to a |List|. The first item in
68
a97c6902ecd9 updated for version 7.0030
vimboss
parents: 55
diff changeset
12528 the list is assigned to {name1}, the second item to
a97c6902ecd9 updated for version 7.0030
vimboss
parents: 55
diff changeset
12529 {name2}, etc.
a97c6902ecd9 updated for version 7.0030
vimboss
parents: 55
diff changeset
12530 The number of names must match the number of items in
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12531 the |List|.
68
a97c6902ecd9 updated for version 7.0030
vimboss
parents: 55
diff changeset
12532 Each name can be one of the items of the ":let"
a97c6902ecd9 updated for version 7.0030
vimboss
parents: 55
diff changeset
12533 command as mentioned above.
a97c6902ecd9 updated for version 7.0030
vimboss
parents: 55
diff changeset
12534 Example: >
a97c6902ecd9 updated for version 7.0030
vimboss
parents: 55
diff changeset
12535 :let [s, item] = GetItem(s)
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12536 < Detail: {expr1} is evaluated first, then the
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12537 assignments are done in sequence. This matters if
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12538 {name2} depends on {name1}. Example: >
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12539 :let x = [0, 1]
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12540 :let i = 0
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12541 :let [i, x[i]] = [1, 2]
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12542 :echo x
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12543 < The result is [0, 2].
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12544
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12545 :let [{name1}, {name2}, ...] .= {expr1}
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12546 :let [{name1}, {name2}, ...] += {expr1}
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12547 :let [{name1}, {name2}, ...] -= {expr1}
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12548 Like above, but append/add/subtract the value for each
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12549 |List| item.
68
a97c6902ecd9 updated for version 7.0030
vimboss
parents: 55
diff changeset
12550
19968
1908e92b02fd Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 19952
diff changeset
12551 :let [{name}, ..., ; {lastname}] = {expr1} *E452*
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12552 Like |:let-unpack| above, but the |List| may have more
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12553 items than there are names. A list of the remaining
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12554 items is assigned to {lastname}. If there are no
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12555 remaining items {lastname} is set to an empty list.
68
a97c6902ecd9 updated for version 7.0030
vimboss
parents: 55
diff changeset
12556 Example: >
a97c6902ecd9 updated for version 7.0030
vimboss
parents: 55
diff changeset
12557 :let [a, b; rest] = ["aval", "bval", 3, 4]
a97c6902ecd9 updated for version 7.0030
vimboss
parents: 55
diff changeset
12558 <
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12559 :let [{name}, ..., ; {lastname}] .= {expr1}
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12560 :let [{name}, ..., ; {lastname}] += {expr1}
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12561 :let [{name}, ..., ; {lastname}] -= {expr1}
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12562 Like above, but append/add/subtract the value for each
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12563 |List| item.
2596
fae782ef63dd Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 2581
diff changeset
12564
17450
509542f1fffb patch 8.1.1723: heredoc assignment has no room for new features
Bram Moolenaar <Bram@vim.org>
parents: 17433
diff changeset
12565 *:let=<<* *:let-heredoc*
509542f1fffb patch 8.1.1723: heredoc assignment has no room for new features
Bram Moolenaar <Bram@vim.org>
parents: 17433
diff changeset
12566 *E990* *E991* *E172* *E221*
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12567 :let {var-name} =<< [trim] {endmarker}
16704
a927fdf9a4b0 patch 8.1.1354: getting a list of text lines is clumsy
Bram Moolenaar <Bram@vim.org>
parents: 16664
diff changeset
12568 text...
a927fdf9a4b0 patch 8.1.1354: getting a list of text lines is clumsy
Bram Moolenaar <Bram@vim.org>
parents: 16664
diff changeset
12569 text...
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12570 {endmarker}
21093
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
12571 Set internal variable {var-name} to a |List|
99a602b27e0e Runtime file updates
Bram Moolenaar <Bram@vim.org>
parents: 20965
diff changeset
12572 containing the lines of text bounded by the string
21608
24cb89db078d patch 8.2.1354: test 59 is old style
Bram Moolenaar <Bram@vim.org>
parents: 21499
diff changeset
12573 {endmarker}. The lines of text is used as a
24cb89db078d patch 8.2.1354: test 59 is old style
Bram Moolenaar <Bram@vim.org>
parents: 21499
diff changeset
12574 |literal-string|.
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12575 {endmarker} must not contain white space.
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12576 {endmarker} cannot start with a lower case character.
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12577 The last line should end only with the {endmarker}
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12578 string without any other character. Watch out for
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12579 white space after {endmarker}!
16704
a927fdf9a4b0 patch 8.1.1354: getting a list of text lines is clumsy
Bram Moolenaar <Bram@vim.org>
parents: 16664
diff changeset
12580
17172
6990c1160ea5 patch 8.1.1585: :let-heredoc does not trim enough
Bram Moolenaar <Bram@vim.org>
parents: 17161
diff changeset
12581 Without "trim" any white space characters in the lines
6990c1160ea5 patch 8.1.1585: :let-heredoc does not trim enough
Bram Moolenaar <Bram@vim.org>
parents: 17161
diff changeset
12582 of text are preserved. If "trim" is specified before
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12583 {endmarker}, then indentation is stripped so you can
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12584 do: >
17172
6990c1160ea5 patch 8.1.1585: :let-heredoc does not trim enough
Bram Moolenaar <Bram@vim.org>
parents: 17161
diff changeset
12585 let text =<< trim END
6990c1160ea5 patch 8.1.1585: :let-heredoc does not trim enough
Bram Moolenaar <Bram@vim.org>
parents: 17161
diff changeset
12586 if ok
6990c1160ea5 patch 8.1.1585: :let-heredoc does not trim enough
Bram Moolenaar <Bram@vim.org>
parents: 17161
diff changeset
12587 echo 'done'
6990c1160ea5 patch 8.1.1585: :let-heredoc does not trim enough
Bram Moolenaar <Bram@vim.org>
parents: 17161
diff changeset
12588 endif
6990c1160ea5 patch 8.1.1585: :let-heredoc does not trim enough
Bram Moolenaar <Bram@vim.org>
parents: 17161
diff changeset
12589 END
6990c1160ea5 patch 8.1.1585: :let-heredoc does not trim enough
Bram Moolenaar <Bram@vim.org>
parents: 17161
diff changeset
12590 < Results in: ["if ok", " echo 'done'", "endif"]
6990c1160ea5 patch 8.1.1585: :let-heredoc does not trim enough
Bram Moolenaar <Bram@vim.org>
parents: 17161
diff changeset
12591 The marker must line up with "let" and the indentation
6990c1160ea5 patch 8.1.1585: :let-heredoc does not trim enough
Bram Moolenaar <Bram@vim.org>
parents: 17161
diff changeset
12592 of the first line is removed from all the text lines.
6990c1160ea5 patch 8.1.1585: :let-heredoc does not trim enough
Bram Moolenaar <Bram@vim.org>
parents: 17161
diff changeset
12593 Specifically: all the leading indentation exactly
6990c1160ea5 patch 8.1.1585: :let-heredoc does not trim enough
Bram Moolenaar <Bram@vim.org>
parents: 17161
diff changeset
12594 matching the leading indentation of the first
6990c1160ea5 patch 8.1.1585: :let-heredoc does not trim enough
Bram Moolenaar <Bram@vim.org>
parents: 17161
diff changeset
12595 non-empty text line is stripped from the input lines.
6990c1160ea5 patch 8.1.1585: :let-heredoc does not trim enough
Bram Moolenaar <Bram@vim.org>
parents: 17161
diff changeset
12596 All leading indentation exactly matching the leading
6990c1160ea5 patch 8.1.1585: :let-heredoc does not trim enough
Bram Moolenaar <Bram@vim.org>
parents: 17161
diff changeset
12597 indentation before `let` is stripped from the line
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12598 containing {endmarker}. Note that the difference
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12599 between space and tab matters here.
16704
a927fdf9a4b0 patch 8.1.1354: getting a list of text lines is clumsy
Bram Moolenaar <Bram@vim.org>
parents: 16664
diff changeset
12600
a927fdf9a4b0 patch 8.1.1354: getting a list of text lines is clumsy
Bram Moolenaar <Bram@vim.org>
parents: 16664
diff changeset
12601 If {var-name} didn't exist yet, it is created.
a927fdf9a4b0 patch 8.1.1354: getting a list of text lines is clumsy
Bram Moolenaar <Bram@vim.org>
parents: 16664
diff changeset
12602 Cannot be followed by another command, but can be
a927fdf9a4b0 patch 8.1.1354: getting a list of text lines is clumsy
Bram Moolenaar <Bram@vim.org>
parents: 16664
diff changeset
12603 followed by a comment.
a927fdf9a4b0 patch 8.1.1354: getting a list of text lines is clumsy
Bram Moolenaar <Bram@vim.org>
parents: 16664
diff changeset
12604
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12605 To avoid line continuation to be applied, consider
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12606 adding 'C' to 'cpoptions': >
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12607 set cpo+=C
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12608 let var =<< END
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12609 \ leading backslash
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12610 END
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12611 set cpo-=C
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12612 <
16704
a927fdf9a4b0 patch 8.1.1354: getting a list of text lines is clumsy
Bram Moolenaar <Bram@vim.org>
parents: 16664
diff changeset
12613 Examples: >
a927fdf9a4b0 patch 8.1.1354: getting a list of text lines is clumsy
Bram Moolenaar <Bram@vim.org>
parents: 16664
diff changeset
12614 let var1 =<< END
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12615 Sample text 1
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12616 Sample text 2
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12617 Sample text 3
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12618 END
16704
a927fdf9a4b0 patch 8.1.1354: getting a list of text lines is clumsy
Bram Moolenaar <Bram@vim.org>
parents: 16664
diff changeset
12619
a927fdf9a4b0 patch 8.1.1354: getting a list of text lines is clumsy
Bram Moolenaar <Bram@vim.org>
parents: 16664
diff changeset
12620 let data =<< trim DATA
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12621 1 2 3 4
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
12622 5 6 7 8
16704
a927fdf9a4b0 patch 8.1.1354: getting a list of text lines is clumsy
Bram Moolenaar <Bram@vim.org>
parents: 16664
diff changeset
12623 DATA
a927fdf9a4b0 patch 8.1.1354: getting a list of text lines is clumsy
Bram Moolenaar <Bram@vim.org>
parents: 16664
diff changeset
12624 <
2596
fae782ef63dd Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 2581
diff changeset
12625 *E121*
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
12626 :let {var-name} .. List the value of variable {var-name}. Multiple
123
f67f8a8d81ba updated for version 7.0043
vimboss
parents: 119
diff changeset
12627 variable names may be given. Special names recognized
f67f8a8d81ba updated for version 7.0043
vimboss
parents: 119
diff changeset
12628 here: *E738*
777
f664cc974a7a updated for version 7.0227
vimboss
parents: 724
diff changeset
12629 g: global variables
f664cc974a7a updated for version 7.0227
vimboss
parents: 724
diff changeset
12630 b: local buffer variables
f664cc974a7a updated for version 7.0227
vimboss
parents: 724
diff changeset
12631 w: local window variables
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
12632 t: local tab page variables
777
f664cc974a7a updated for version 7.0227
vimboss
parents: 724
diff changeset
12633 s: script-local variables
f664cc974a7a updated for version 7.0227
vimboss
parents: 724
diff changeset
12634 l: local function variables
123
f67f8a8d81ba updated for version 7.0043
vimboss
parents: 119
diff changeset
12635 v: Vim variables.
20856
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
12636 This does not work in Vim9 script. |vim9-declaration|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12637
55
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
12638 :let List the values of all variables. The type of the
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
12639 variable is indicated before the value:
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
12640 <nothing> String
225cc00b2eda updated for version 7.0029
vimboss
parents: 37
diff changeset
12641 # Number
856
8cd729851562 updated for version 7.0g
vimboss
parents: 853
diff changeset
12642 * Funcref
20856
83cfa1ef1bf2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 20836
diff changeset
12643 This does not work in Vim9 script. |vim9-declaration|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12644
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12645 :unl[et][!] {name} ... *:unlet* *:unl* *E108* *E795*
148
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12646 Remove the internal variable {name}. Several variable
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12647 names can be given, they are all removed. The name
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12648 may also be a |List| or |Dictionary| item.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12649 With [!] no error message is given for non-existing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12650 variables.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12651 One or more items from a |List| can be removed: >
108
375b1d0f97b0 updated for version 7.0040
vimboss
parents: 102
diff changeset
12652 :unlet list[3] " remove fourth item
375b1d0f97b0 updated for version 7.0040
vimboss
parents: 102
diff changeset
12653 :unlet list[3:] " remove fourth item to last
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12654 < One item from a |Dictionary| can be removed at a time: >
108
375b1d0f97b0 updated for version 7.0040
vimboss
parents: 102
diff changeset
12655 :unlet dict['two']
375b1d0f97b0 updated for version 7.0040
vimboss
parents: 102
diff changeset
12656 :unlet dict.two
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
12657 < This is especially useful to clean up used global
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
12658 variables and script-local variables (these are not
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
12659 deleted when the script ends). Function-local
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
12660 variables are automatically deleted when the function
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1661
diff changeset
12661 ends.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12662
13923
e4d5726e1678 patch 8.0.1832: cannot use :unlet for an environment variable
Christian Brabandt <cb@256bit.org>
parents: 13821
diff changeset
12663 :unl[et] ${env-name} ... *:unlet-environment* *:unlet-$*
e4d5726e1678 patch 8.0.1832: cannot use :unlet for an environment variable
Christian Brabandt <cb@256bit.org>
parents: 13821
diff changeset
12664 Remove environment variable {env-name}.
e4d5726e1678 patch 8.0.1832: cannot use :unlet for an environment variable
Christian Brabandt <cb@256bit.org>
parents: 13821
diff changeset
12665 Can mix {name} and ${env-name} in one :unlet command.
e4d5726e1678 patch 8.0.1832: cannot use :unlet for an environment variable
Christian Brabandt <cb@256bit.org>
parents: 13821
diff changeset
12666 No error message is given for a non-existing
e4d5726e1678 patch 8.0.1832: cannot use :unlet for an environment variable
Christian Brabandt <cb@256bit.org>
parents: 13821
diff changeset
12667 variable, also without !.
e4d5726e1678 patch 8.0.1832: cannot use :unlet for an environment variable
Christian Brabandt <cb@256bit.org>
parents: 13821
diff changeset
12668 If the system does not support deleting an environment
17079
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12669 variable, it is made empty.
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12670
17109
cc5d4b4bae83 patch 8.1.1554: docs and tests for :const can be improved
Bram Moolenaar <Bram@vim.org>
parents: 17085
diff changeset
12671 *:cons* *:const*
17079
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12672 :cons[t] {var-name} = {expr1}
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12673 :cons[t] [{name1}, {name2}, ...] = {expr1}
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12674 :cons[t] [{name}, ..., ; {lastname}] = {expr1}
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12675 :cons[t] {var-name} =<< [trim] {marker}
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12676 text...
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12677 text...
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12678 {marker}
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12679 Similar to |:let|, but additionally lock the variable
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12680 after setting the value. This is the same as locking
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12681 the variable with |:lockvar| just after |:let|, thus: >
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12682 :const x = 1
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12683 < is equivalent to: >
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12684 :let x = 1
21847
fb74a3387694 patch 8.2.1473: items in a list given to :const can still be modified
Bram Moolenaar <Bram@vim.org>
parents: 21825
diff changeset
12685 :lockvar! x
22298
07e48ee8c3bb patch 8.2.1698: cannot lock a variable in legacy Vim script like in Vim9
Bram Moolenaar <Bram@vim.org>
parents: 22232
diff changeset
12686 < NOTE: in Vim9 script `:const` works differently, see
07e48ee8c3bb patch 8.2.1698: cannot lock a variable in legacy Vim script like in Vim9
Bram Moolenaar <Bram@vim.org>
parents: 22232
diff changeset
12687 |vim9-const|
07e48ee8c3bb patch 8.2.1698: cannot lock a variable in legacy Vim script like in Vim9
Bram Moolenaar <Bram@vim.org>
parents: 22232
diff changeset
12688 This is useful if you want to make sure the variable
21847
fb74a3387694 patch 8.2.1473: items in a list given to :const can still be modified
Bram Moolenaar <Bram@vim.org>
parents: 21825
diff changeset
12689 is not modified. If the value is a List or Dictionary
fb74a3387694 patch 8.2.1473: items in a list given to :const can still be modified
Bram Moolenaar <Bram@vim.org>
parents: 21825
diff changeset
12690 literal then the items also cannot be changed: >
fb74a3387694 patch 8.2.1473: items in a list given to :const can still be modified
Bram Moolenaar <Bram@vim.org>
parents: 21825
diff changeset
12691 const ll = [1, 2, 3]
fb74a3387694 patch 8.2.1473: items in a list given to :const can still be modified
Bram Moolenaar <Bram@vim.org>
parents: 21825
diff changeset
12692 let ll[1] = 5 " Error!
fb74a3387694 patch 8.2.1473: items in a list given to :const can still be modified
Bram Moolenaar <Bram@vim.org>
parents: 21825
diff changeset
12693 < Nested references are not locked: >
fb74a3387694 patch 8.2.1473: items in a list given to :const can still be modified
Bram Moolenaar <Bram@vim.org>
parents: 21825
diff changeset
12694 let lvar = ['a']
fb74a3387694 patch 8.2.1473: items in a list given to :const can still be modified
Bram Moolenaar <Bram@vim.org>
parents: 21825
diff changeset
12695 const lconst = [0, lvar]
fb74a3387694 patch 8.2.1473: items in a list given to :const can still be modified
Bram Moolenaar <Bram@vim.org>
parents: 21825
diff changeset
12696 let lconst[0] = 2 " Error!
fb74a3387694 patch 8.2.1473: items in a list given to :const can still be modified
Bram Moolenaar <Bram@vim.org>
parents: 21825
diff changeset
12697 let lconst[1][0] = 'b' " OK
fb74a3387694 patch 8.2.1473: items in a list given to :const can still be modified
Bram Moolenaar <Bram@vim.org>
parents: 21825
diff changeset
12698 < *E995*
17131
be5a5cfc991a patch 8.1.1565: MS-Windows: no sound support
Bram Moolenaar <Bram@vim.org>
parents: 17109
diff changeset
12699 |:const| does not allow to for changing a variable: >
17079
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12700 :let x = 1
00ffed9bbb65 patch 8.1.1539: not easy to define a variable and lock it
Bram Moolenaar <Bram@vim.org>
parents: 17053
diff changeset
12701 :const x = 2 " Error!
17109
cc5d4b4bae83 patch 8.1.1554: docs and tests for :const can be improved
Bram Moolenaar <Bram@vim.org>
parents: 17085
diff changeset
12702 < *E996*
cc5d4b4bae83 patch 8.1.1554: docs and tests for :const can be improved
Bram Moolenaar <Bram@vim.org>
parents: 17085
diff changeset
12703 Note that environment variables, option values and
cc5d4b4bae83 patch 8.1.1554: docs and tests for :const can be improved
Bram Moolenaar <Bram@vim.org>
parents: 17085
diff changeset
12704 register values cannot be used here, since they cannot
cc5d4b4bae83 patch 8.1.1554: docs and tests for :const can be improved
Bram Moolenaar <Bram@vim.org>
parents: 17085
diff changeset
12705 be locked.
cc5d4b4bae83 patch 8.1.1554: docs and tests for :const can be improved
Bram Moolenaar <Bram@vim.org>
parents: 17085
diff changeset
12706
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 17413
diff changeset
12707 :cons[t]
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 17413
diff changeset
12708 :cons[t] {var-name}
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 17413
diff changeset
12709 If no argument is given or only {var-name} is given,
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 17413
diff changeset
12710 the behavior is the same as |:let|.
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 17413
diff changeset
12711
148
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12712 :lockv[ar][!] [depth] {name} ... *:lockvar* *:lockv*
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12713 Lock the internal variable {name}. Locking means that
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12714 it can no longer be changed (until it is unlocked).
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12715 A locked variable can be deleted: >
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12716 :lockvar v
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12717 :let v = 'asdf' " fails!
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12718 :unlet v
10908
6b6abffbdf59 patch 8.0.0343: b:changedtick can be unlocked
Christian Brabandt <cb@256bit.org>
parents: 10895
diff changeset
12719 < *E741* *E940*
148
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12720 If you try to change a locked variable you get an
10908
6b6abffbdf59 patch 8.0.0343: b:changedtick can be unlocked
Christian Brabandt <cb@256bit.org>
parents: 10895
diff changeset
12721 error message: "E741: Value is locked: {name}".
6b6abffbdf59 patch 8.0.0343: b:changedtick can be unlocked
Christian Brabandt <cb@256bit.org>
parents: 10895
diff changeset
12722 If you try to lock or unlock a built-in variable you
6b6abffbdf59 patch 8.0.0343: b:changedtick can be unlocked
Christian Brabandt <cb@256bit.org>
parents: 10895
diff changeset
12723 get an error message: "E940: Cannot lock or unlock
6b6abffbdf59 patch 8.0.0343: b:changedtick can be unlocked
Christian Brabandt <cb@256bit.org>
parents: 10895
diff changeset
12724 variable {name}".
148
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12725
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12726 [depth] is relevant when locking a |List| or
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12727 |Dictionary|. It specifies how deep the locking goes:
22298
07e48ee8c3bb patch 8.2.1698: cannot lock a variable in legacy Vim script like in Vim9
Bram Moolenaar <Bram@vim.org>
parents: 22232
diff changeset
12728 0 Lock the variable {name} but not its
07e48ee8c3bb patch 8.2.1698: cannot lock a variable in legacy Vim script like in Vim9
Bram Moolenaar <Bram@vim.org>
parents: 22232
diff changeset
12729 value.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12730 1 Lock the |List| or |Dictionary| itself,
148
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12731 cannot add or remove items, but can
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12732 still change their values.
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12733 2 Also lock the values, cannot change
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12734 the items. If an item is a |List| or
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12735 |Dictionary|, cannot add or remove
148
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12736 items, but can still change the
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12737 values.
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12738 3 Like 2 but for the |List| /
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12739 |Dictionary| in the |List| /
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12740 |Dictionary|, one level deeper.
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12741 The default [depth] is 2, thus when {name} is a |List|
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12742 or |Dictionary| the values cannot be changed.
22298
07e48ee8c3bb patch 8.2.1698: cannot lock a variable in legacy Vim script like in Vim9
Bram Moolenaar <Bram@vim.org>
parents: 22232
diff changeset
12743
07e48ee8c3bb patch 8.2.1698: cannot lock a variable in legacy Vim script like in Vim9
Bram Moolenaar <Bram@vim.org>
parents: 22232
diff changeset
12744 Example with [depth] 0: >
07e48ee8c3bb patch 8.2.1698: cannot lock a variable in legacy Vim script like in Vim9
Bram Moolenaar <Bram@vim.org>
parents: 22232
diff changeset
12745 let mylist = [1, 2, 3]
07e48ee8c3bb patch 8.2.1698: cannot lock a variable in legacy Vim script like in Vim9
Bram Moolenaar <Bram@vim.org>
parents: 22232
diff changeset
12746 lockvar 0 mylist
07e48ee8c3bb patch 8.2.1698: cannot lock a variable in legacy Vim script like in Vim9
Bram Moolenaar <Bram@vim.org>
parents: 22232
diff changeset
12747 let mylist[0] = 77 " OK
07e48ee8c3bb patch 8.2.1698: cannot lock a variable in legacy Vim script like in Vim9
Bram Moolenaar <Bram@vim.org>
parents: 22232
diff changeset
12748 call add(mylist, 4] " OK
07e48ee8c3bb patch 8.2.1698: cannot lock a variable in legacy Vim script like in Vim9
Bram Moolenaar <Bram@vim.org>
parents: 22232
diff changeset
12749 let mylist = [7, 8, 9] " Error!
07e48ee8c3bb patch 8.2.1698: cannot lock a variable in legacy Vim script like in Vim9
Bram Moolenaar <Bram@vim.org>
parents: 22232
diff changeset
12750 < *E743*
148
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12751 For unlimited depth use [!] and omit [depth].
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12752 However, there is a maximum depth of 100 to catch
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12753 loops.
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12754
685
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12755 Note that when two variables refer to the same |List|
d7e33248b9c8 updated for version 7.0206
vimboss
parents: 681
diff changeset
12756 and you lock one of them, the |List| will also be
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
12757 locked when used through the other variable.
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 818
diff changeset
12758 Example: >
148
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12759 :let l = [0, 1, 2, 3]
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12760 :let cl = l
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12761 :lockvar l
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12762 :let cl[1] = 99 " won't work!
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12763 < You may want to make a copy of a list to avoid this.
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12764 See |deepcopy()|.
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12765
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12766
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12767 :unlo[ckvar][!] [depth] {name} ... *:unlockvar* *:unlo*
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12768 Unlock the internal variable {name}. Does the
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12769 opposite of |:lockvar|.
72aefd4c1e0d updated for version 7.0046
vimboss
parents: 140
diff changeset
12770
16944
d23afa4d8b63 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16930
diff changeset
12771 :if {expr1} *:if* *:end* *:endif* *:en* *E171* *E579* *E580*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12772 :en[dif] Execute the commands until the next matching ":else"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12773 or ":endif" if {expr1} evaluates to non-zero.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12774
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12775 From Vim version 4.5 until 5.0, every Ex command in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12776 between the ":if" and ":endif" is ignored. These two
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12777 commands were just to allow for future expansions in a
7659
07f11de5efca commit https://github.com/vim/vim/commit/85084ef1e999dcf50e8d466106a33bac24a0febb
Christian Brabandt <cb@256bit.org>
parents: 7653
diff changeset
12778 backward compatible way. Nesting was allowed. Note
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12779 that any ":else" or ":elseif" was ignored, the "else"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12780 part was not executed either.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12781
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12782 You can use this to remain compatible with older
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12783 versions: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12784 :if version >= 500
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12785 : version-5-specific-commands
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12786 :endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12787 < The commands still need to be parsed to find the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12788 "endif". Sometimes an older Vim has a problem with a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12789 new command. For example, ":silent" is recognized as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12790 a ":substitute" command. In that case ":execute" can
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12791 avoid problems: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12792 :if version >= 600
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12793 : execute "silent 1,$delete"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12794 :endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12795 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12796 NOTE: The ":append" and ":insert" commands don't work
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12797 properly in between ":if" and ":endif".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12798
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12799 *:else* *:el* *E581* *E583*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12800 :el[se] Execute the commands until the next matching ":else"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12801 or ":endif" if they previously were not being
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12802 executed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12803
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12804 *:elseif* *:elsei* *E582* *E584*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12805 :elsei[f] {expr1} Short for ":else" ":if", with the addition that there
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12806 is no extra ":endif".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12807
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12808 :wh[ile] {expr1} *:while* *:endwhile* *:wh* *:endw*
114
f6e567606d47 updated for version 7.0041
vimboss
parents: 108
diff changeset
12809 *E170* *E585* *E588* *E733*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12810 :endw[hile] Repeat the commands between ":while" and ":endwhile",
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12811 as long as {expr1} evaluates to non-zero.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12812 When an error is detected from a command inside the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12813 loop, execution continues after the "endwhile".
75
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12814 Example: >
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12815 :let lnum = 1
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12816 :while lnum <= line("$")
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12817 :call FixLine(lnum)
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12818 :let lnum = lnum + 1
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12819 :endwhile
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12820 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12821 NOTE: The ":append" and ":insert" commands don't work
99
04f2e519ab18 updated for version 7.0038
vimboss
parents: 95
diff changeset
12822 properly inside a ":while" and ":for" loop.
75
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12823
15615
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12824 :for {var} in {object} *:for* *E690* *E732*
75
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12825 :endfo[r] *:endfo* *:endfor*
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12826 Repeat the commands between ":for" and ":endfor" for
15615
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12827 each item in {object}. {object} can be a |List| or
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12828 a |Blob|. Variable {var} is set to the value of each
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12829 item. When an error is detected for a command inside
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12830 the loop, execution continues after the "endfor".
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12831 Changing {object} inside the loop affects what items
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12832 are used. Make a copy if this is unwanted: >
79
e918d3e340a4 updated for version 7.0032
vimboss
parents: 75
diff changeset
12833 :for item in copy(mylist)
15615
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12834 <
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12835 When {object} is a |List| and not making a copy, Vim
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12836 stores a reference to the next item in the |List|
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12837 before executing the commands with the current item.
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12838 Thus the current item can be removed without effect.
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12839 Removing any later item means it will not be found.
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12840 Thus the following example works (an inefficient way
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12841 to make a |List| empty): >
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
12842 for item in mylist
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
12843 call remove(mylist, 0)
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
12844 endfor
15615
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12845 < Note that reordering the |List| (e.g., with sort() or
87
014ba200db86 updated for version 7.0035
vimboss
parents: 85
diff changeset
12846 reverse()) may have unexpected effects.
75
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12847
15615
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12848 When {object} is a |Blob|, Vim always makes a copy to
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12849 iterate over. Unlike with |List|, modifying the
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12850 |Blob| does not affect the iteration.
536fca2cee19 patch 8.1.0815: dialog for file changed outside of Vim not tested
Bram Moolenaar <Bram@vim.org>
parents: 15579
diff changeset
12851
75
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12852 :for [{var1}, {var2}, ...] in {listlist}
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12853 :endfo[r]
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12854 Like ":for" above, but each item in {listlist} must be
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12855 a list, of which each item is assigned to {var1},
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12856 {var2}, etc. Example: >
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12857 :for [lnum, col] in [[1, 3], [2, 5], [3, 8]]
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12858 :echo getline(lnum)[col]
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12859 :endfor
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12860 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12861 *:continue* *:con* *E586*
75
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12862 :con[tinue] When used inside a ":while" or ":for" loop, jumps back
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12863 to the start of the loop.
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12864 If it is used after a |:try| inside the loop but
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12865 before the matching |:finally| (if present), the
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12866 commands following the ":finally" up to the matching
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12867 |:endtry| are executed first. This process applies to
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12868 all nested ":try"s inside the loop. The outermost
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12869 ":endtry" then jumps back to the start of the loop.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12870
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12871 *:break* *:brea* *E587*
75
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12872 :brea[k] When used inside a ":while" or ":for" loop, skips to
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12873 the command after the matching ":endwhile" or
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12874 ":endfor".
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12875 If it is used after a |:try| inside the loop but
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12876 before the matching |:finally| (if present), the
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12877 commands following the ":finally" up to the matching
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12878 |:endtry| are executed first. This process applies to
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12879 all nested ":try"s inside the loop. The outermost
388f285bda1b updated for version 7.0031
vimboss
parents: 68
diff changeset
12880 ":endtry" then jumps to the command after the loop.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12881
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12882 :try *:try* *:endt* *:endtry* *E600* *E601* *E602*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12883 :endt[ry] Change the error handling for the commands between
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12884 ":try" and ":endtry" including everything being
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12885 executed across ":source" commands, function calls,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12886 or autocommand invocations.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12887
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12888 When an error or interrupt is detected and there is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12889 a |:finally| command following, execution continues
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12890 after the ":finally". Otherwise, or when the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12891 ":endtry" is reached thereafter, the next
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12892 (dynamically) surrounding ":try" is checked for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12893 a corresponding ":finally" etc. Then the script
19523
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
12894 processing is terminated. Whether a function
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
12895 definition has an "abort" argument does not matter.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12896 Example: >
19523
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
12897 try | call Unknown() | finally | echomsg "cleanup" | endtry
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
12898 echomsg "not reached"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12899 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12900 Moreover, an error or interrupt (dynamically) inside
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12901 ":try" and ":endtry" is converted to an exception. It
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12902 can be caught as if it were thrown by a |:throw|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12903 command (see |:catch|). In this case, the script
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12904 processing is not terminated.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12905
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12906 The value "Vim:Interrupt" is used for an interrupt
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12907 exception. An error in a Vim command is converted
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12908 to a value of the form "Vim({command}):{errmsg}",
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12909 other errors are converted to a value of the form
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12910 "Vim:{errmsg}". {command} is the full command name,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12911 and {errmsg} is the message that is displayed if the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12912 error exception is not caught, always beginning with
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12913 the error number.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12914 Examples: >
19523
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
12915 try | sleep 100 | catch /^Vim:Interrupt$/ | endtry
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
12916 try | edit | catch /^Vim(edit):E\d\+/ | echo "error" | endtry
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12917 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12918 *:cat* *:catch* *E603* *E604* *E605*
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
12919 :cat[ch] /{pattern}/ The following commands until the next |:catch|,
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12920 |:finally|, or |:endtry| that belongs to the same
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12921 |:try| as the ":catch" are executed when an exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12922 matching {pattern} is being thrown and has not yet
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12923 been caught by a previous ":catch". Otherwise, these
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12924 commands are skipped.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12925 When {pattern} is omitted all errors are caught.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12926 Examples: >
16019
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
12927 :catch /^Vim:Interrupt$/ " catch interrupts (CTRL-C)
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
12928 :catch /^Vim\%((\a\+)\)\=:E/ " catch all Vim errors
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
12929 :catch /^Vim\%((\a\+)\)\=:/ " catch errors and interrupts
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
12930 :catch /^Vim(write):/ " catch all errors in :write
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
12931 :catch /^Vim\%((\a\+)\)\=:E123:/ " catch error E123
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
12932 :catch /my-exception/ " catch user exception
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
12933 :catch /.*/ " catch everything
096b8ccd855e patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number
Bram Moolenaar <Bram@vim.org>
parents: 15977
diff changeset
12934 :catch " same as /.*/
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12935 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12936 Another character can be used instead of / around the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12937 {pattern}, so long as it does not have a special
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12938 meaning (e.g., '|' or '"') and doesn't occur inside
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12939 {pattern}.
5814
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5808
diff changeset
12940 Information about the exception is available in
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5808
diff changeset
12941 |v:exception|. Also see |throw-variables|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12942 NOTE: It is not reliable to ":catch" the TEXT of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12943 an error message because it may vary in different
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12944 locales.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12945
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12946 *:fina* *:finally* *E606* *E607*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12947 :fina[lly] The following commands until the matching |:endtry|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12948 are executed whenever the part between the matching
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12949 |:try| and the ":finally" is left: either by falling
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12950 through to the ":finally" or by a |:continue|,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12951 |:break|, |:finish|, or |:return|, or by an error or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12952 interrupt or exception (see |:throw|).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12953
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12954 *:th* *:throw* *E608*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12955 :th[row] {expr1} The {expr1} is evaluated and thrown as an exception.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12956 If the ":throw" is used after a |:try| but before the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12957 first corresponding |:catch|, commands are skipped
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12958 until the first ":catch" matching {expr1} is reached.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12959 If there is no such ":catch" or if the ":throw" is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12960 used after a ":catch" but before the |:finally|, the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12961 commands following the ":finally" (if present) up to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12962 the matching |:endtry| are executed. If the ":throw"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12963 is after the ":finally", commands up to the ":endtry"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12964 are skipped. At the ":endtry", this process applies
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12965 again for the next dynamically surrounding ":try"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12966 (which may be found in a calling function or sourcing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12967 script), until a matching ":catch" has been found.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12968 If the exception is not caught, the command processing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12969 is terminated.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12970 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12971 :try | throw "oops" | catch /^oo/ | echo "caught" | endtry
2725
6f63330ec225 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2709
diff changeset
12972 < Note that "catch" may need to be on a separate line
6f63330ec225 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2709
diff changeset
12973 for when an error causes the parsing to skip the whole
6f63330ec225 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2709
diff changeset
12974 line and not see the "|" that separates the commands.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12975
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12976 *:ec* *:echo*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12977 :ec[ho] {expr1} .. Echoes each {expr1}, with a space in between. The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12978 first {expr1} starts on a new line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12979 Also see |:comment|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12980 Use "\n" to start a new line. Use "\r" to move the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12981 cursor to the first column.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12982 Uses the highlighting set by the |:echohl| command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12983 Cannot be followed by a comment.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12984 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12985 :echo "the value of 'shell' is" &shell
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12986 < *:echo-redraw*
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12987 A later redraw may make the message disappear again.
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12988 And since Vim mostly postpones redrawing until it's
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12989 finished with a sequence of commands this happens
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12990 quite often. To avoid that a command from before the
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12991 ":echo" causes a redraw afterwards (redraws are often
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12992 postponed until you type something), force a redraw
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
12993 with the |:redraw| command. Example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12994 :new | redraw | echo "there is a new window"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12995 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12996 *:echon*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12997 :echon {expr1} .. Echoes each {expr1}, without anything added. Also see
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12998 |:comment|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12999 Uses the highlighting set by the |:echohl| command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13000 Cannot be followed by a comment.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13001 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13002 :echon "the value of 'shell' is " &shell
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13003 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13004 Note the difference between using ":echo", which is a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13005 Vim command, and ":!echo", which is an external shell
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13006 command: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13007 :!echo % --> filename
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13008 < The arguments of ":!" are expanded, see |:_%|. >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13009 :!echo "%" --> filename or "filename"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13010 < Like the previous example. Whether you see the double
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13011 quotes or not depends on your 'shell'. >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13012 :echo % --> nothing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13013 < The '%' is an illegal character in an expression. >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13014 :echo "%" --> %
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13015 < This just echoes the '%' character. >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13016 :echo expand("%") --> filename
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13017 < This calls the expand() function to expand the '%'.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13018
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13019 *:echoh* *:echohl*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13020 :echoh[l] {name} Use the highlight group {name} for the following
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13021 |:echo|, |:echon| and |:echomsg| commands. Also used
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13022 for the |input()| prompt. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13023 :echohl WarningMsg | echo "Don't panic!" | echohl None
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13024 < Don't forget to set the group back to "None",
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13025 otherwise all following echo's will be highlighted.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13026
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13027 *:echom* *:echomsg*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13028 :echom[sg] {expr1} .. Echo the expression(s) as a true message, saving the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13029 message in the |message-history|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13030 Spaces are placed between the arguments as with the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13031 |:echo| command. But unprintable characters are
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13032 displayed, not interpreted.
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
13033 The parsing works slightly different from |:echo|,
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
13034 more like |:execute|. All the expressions are first
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
13035 evaluated and concatenated before echoing anything.
15219
dada0b389d4f patch 8.1.0619: :echomsg and :echoerr do not handle List and Dict
Bram Moolenaar <Bram@vim.org>
parents: 15209
diff changeset
13036 If expressions does not evaluate to a Number or
dada0b389d4f patch 8.1.0619: :echomsg and :echoerr do not handle List and Dict
Bram Moolenaar <Bram@vim.org>
parents: 15209
diff changeset
13037 String, string() is used to turn it into a string.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13038 Uses the highlighting set by the |:echohl| command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13039 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13040 :echomsg "It's a Zizzer Zazzer Zuzz, as you can plainly see."
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
13041 < See |:echo-redraw| to avoid the message disappearing
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
13042 when the screen is redrawn.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13043 *:echoe* *:echoerr*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13044 :echoe[rr] {expr1} .. Echo the expression(s) as an error message, saving the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13045 message in the |message-history|. When used in a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13046 script or function the line number will be added.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13047 Spaces are placed between the arguments as with the
15219
dada0b389d4f patch 8.1.0619: :echomsg and :echoerr do not handle List and Dict
Bram Moolenaar <Bram@vim.org>
parents: 15209
diff changeset
13048 |:echomsg| command. When used inside a try conditional,
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13049 the message is raised as an error exception instead
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13050 (see |try-echoerr|).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13051 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13052 :echoerr "This script just failed!"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13053 < If you just want a highlighted message use |:echohl|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13054 And to get a beep: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13055 :exe "normal \<Esc>"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13056 <
18639
cb3163d590a1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18623
diff changeset
13057 *:eval*
cb3163d590a1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18623
diff changeset
13058 :eval {expr} Evaluate {expr} and discard the result. Example: >
cb3163d590a1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18623
diff changeset
13059 :eval Getlist()->Filter()->append('$')
cb3163d590a1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18623
diff changeset
13060
cb3163d590a1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18623
diff changeset
13061 < The expression is supposed to have a side effect,
cb3163d590a1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18623
diff changeset
13062 since the resulting value is not used. In the example
cb3163d590a1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18623
diff changeset
13063 the `append()` call appends the List with text to the
cb3163d590a1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18623
diff changeset
13064 buffer. This is similar to `:call` but works with any
cb3163d590a1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18623
diff changeset
13065 expression.
cb3163d590a1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18623
diff changeset
13066
cb3163d590a1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18623
diff changeset
13067 The command can be shortened to `:ev` or `:eva`, but
cb3163d590a1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18623
diff changeset
13068 these are hard to recognize and therefore not to be
cb3163d590a1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18623
diff changeset
13069 used.
cb3163d590a1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18623
diff changeset
13070
19523
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
13071 The command cannot be followed by "|" and another
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
13072 command, since "|" is seen as part of the expression.
a7a24d06d7ce Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19483
diff changeset
13073
18639
cb3163d590a1 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18623
diff changeset
13074
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13075 *:exe* *:execute*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13076 :exe[cute] {expr1} .. Executes the string that results from the evaluation
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2120
diff changeset
13077 of {expr1} as an Ex command.
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2120
diff changeset
13078 Multiple arguments are concatenated, with a space in
23466
15fa3923cc49 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23380
diff changeset
13079 between. To avoid the extra space use the ".."
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2120
diff changeset
13080 operator to concatenate strings into one argument.
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2120
diff changeset
13081 {expr1} is used as the processed command, command line
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2120
diff changeset
13082 editing keys are not recognized.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13083 Cannot be followed by a comment.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13084 Examples: >
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2120
diff changeset
13085 :execute "buffer" nextbuf
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2120
diff changeset
13086 :execute "normal" count . "w"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13087 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13088 ":execute" can be used to append a command to commands
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13089 that don't accept a '|'. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13090 :execute '!ls' | echo "theend"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13091
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13092 < ":execute" is also a nice way to avoid having to type
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13093 control characters in a Vim script for a ":normal"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13094 command: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13095 :execute "normal ixxx\<Esc>"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13096 < This has an <Esc> character, see |expr-string|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13097
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13098 Be careful to correctly escape special characters in
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13099 file names. The |fnameescape()| function can be used
1661
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
13100 for Vim commands, |shellescape()| for |:!| commands.
5bbc2d6658ad updated for version 7.2a-013
vimboss
parents: 1621
diff changeset
13101 Examples: >
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13102 :execute "e " . fnameescape(filename)
5692
80e5f9584b02 Update runtime files. Add Euphoria syntax files.
Bram Moolenaar <bram@vim.org>
parents: 5690
diff changeset
13103 :execute "!ls " . shellescape(filename, 1)
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13104 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13105 Note: The executed string may be any command-line, but
5763
c52a655d927d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5747
diff changeset
13106 starting or ending "if", "while" and "for" does not
c52a655d927d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5747
diff changeset
13107 always work, because when commands are skipped the
c52a655d927d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5747
diff changeset
13108 ":execute" is not evaluated and Vim loses track of
c52a655d927d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5747
diff changeset
13109 where blocks start and end. Also "break" and
c52a655d927d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5747
diff changeset
13110 "continue" should not be inside ":execute".
c52a655d927d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5747
diff changeset
13111 This example does not work, because the ":execute" is
c52a655d927d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5747
diff changeset
13112 not evaluated and Vim does not see the "while", and
c52a655d927d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5747
diff changeset
13113 gives an error for finding an ":endwhile": >
c52a655d927d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5747
diff changeset
13114 :if 0
c52a655d927d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5747
diff changeset
13115 : execute 'while i > 5'
c52a655d927d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5747
diff changeset
13116 : echo "test"
c52a655d927d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5747
diff changeset
13117 : endwhile
c52a655d927d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5747
diff changeset
13118 :endif
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13119 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13120 It is allowed to have a "while" or "if" command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13121 completely in the executed string: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13122 :execute 'while i < 5 | echo i | let i = i + 1 | endwhile'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13123 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13124
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
13125 *:exe-comment*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13126 ":execute", ":echo" and ":echon" cannot be followed by
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13127 a comment directly, because they see the '"' as the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13128 start of a string. But, you can use '|' followed by a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13129 comment. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13130 :echo "foo" | "this is a comment
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13131
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13132 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13133 8. Exception handling *exception-handling*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13134
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13135 The Vim script language comprises an exception handling feature. This section
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13136 explains how it can be used in a Vim script.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13137
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13138 Exceptions may be raised by Vim on an error or on interrupt, see
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13139 |catch-errors| and |catch-interrupt|. You can also explicitly throw an
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13140 exception by using the ":throw" command, see |throw-catch|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13141
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13142
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13143 TRY CONDITIONALS *try-conditionals*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13144
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13145 Exceptions can be caught or can cause cleanup code to be executed. You can
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13146 use a try conditional to specify catch clauses (that catch exceptions) and/or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13147 a finally clause (to be executed for cleanup).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13148 A try conditional begins with a |:try| command and ends at the matching
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13149 |:endtry| command. In between, you can use a |:catch| command to start
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13150 a catch clause, or a |:finally| command to start a finally clause. There may
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13151 be none or multiple catch clauses, but there is at most one finally clause,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13152 which must not be followed by any catch clauses. The lines before the catch
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13153 clauses and the finally clause is called a try block. >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13154
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13155 :try
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13156 : ...
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13157 : ... TRY BLOCK
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13158 : ...
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13159 :catch /{pattern}/
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13160 : ...
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13161 : ... CATCH CLAUSE
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13162 : ...
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13163 :catch /{pattern}/
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13164 : ...
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13165 : ... CATCH CLAUSE
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13166 : ...
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13167 :finally
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13168 : ...
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13169 : ... FINALLY CLAUSE
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13170 : ...
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13171 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13172
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13173 The try conditional allows to watch code for exceptions and to take the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13174 appropriate actions. Exceptions from the try block may be caught. Exceptions
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13175 from the try block and also the catch clauses may cause cleanup actions.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13176 When no exception is thrown during execution of the try block, the control
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13177 is transferred to the finally clause, if present. After its execution, the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13178 script continues with the line following the ":endtry".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13179 When an exception occurs during execution of the try block, the remaining
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13180 lines in the try block are skipped. The exception is matched against the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13181 patterns specified as arguments to the ":catch" commands. The catch clause
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13182 after the first matching ":catch" is taken, other catch clauses are not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13183 executed. The catch clause ends when the next ":catch", ":finally", or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13184 ":endtry" command is reached - whatever is first. Then, the finally clause
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13185 (if present) is executed. When the ":endtry" is reached, the script execution
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13186 continues in the following line as usual.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13187 When an exception that does not match any of the patterns specified by the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13188 ":catch" commands is thrown in the try block, the exception is not caught by
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13189 that try conditional and none of the catch clauses is executed. Only the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13190 finally clause, if present, is taken. The exception pends during execution of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13191 the finally clause. It is resumed at the ":endtry", so that commands after
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13192 the ":endtry" are not executed and the exception might be caught elsewhere,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13193 see |try-nesting|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13194 When during execution of a catch clause another exception is thrown, the
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
13195 remaining lines in that catch clause are not executed. The new exception is
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13196 not matched against the patterns in any of the ":catch" commands of the same
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13197 try conditional and none of its catch clauses is taken. If there is, however,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13198 a finally clause, it is executed, and the exception pends during its
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13199 execution. The commands following the ":endtry" are not executed. The new
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13200 exception might, however, be caught elsewhere, see |try-nesting|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13201 When during execution of the finally clause (if present) an exception is
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
13202 thrown, the remaining lines in the finally clause are skipped. If the finally
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13203 clause has been taken because of an exception from the try block or one of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13204 catch clauses, the original (pending) exception is discarded. The commands
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13205 following the ":endtry" are not executed, and the exception from the finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13206 clause is propagated and can be caught elsewhere, see |try-nesting|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13207
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13208 The finally clause is also executed, when a ":break" or ":continue" for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13209 a ":while" loop enclosing the complete try conditional is executed from the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13210 try block or a catch clause. Or when a ":return" or ":finish" is executed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13211 from the try block or a catch clause of a try conditional in a function or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13212 sourced script, respectively. The ":break", ":continue", ":return", or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13213 ":finish" pends during execution of the finally clause and is resumed when the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13214 ":endtry" is reached. It is, however, discarded when an exception is thrown
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13215 from the finally clause.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13216 When a ":break" or ":continue" for a ":while" loop enclosing the complete
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13217 try conditional or when a ":return" or ":finish" is encountered in the finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13218 clause, the rest of the finally clause is skipped, and the ":break",
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13219 ":continue", ":return" or ":finish" is executed as usual. If the finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13220 clause has been taken because of an exception or an earlier ":break",
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13221 ":continue", ":return", or ":finish" from the try block or a catch clause,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13222 this pending exception or command is discarded.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13223
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13224 For examples see |throw-catch| and |try-finally|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13225
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13226
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13227 NESTING OF TRY CONDITIONALS *try-nesting*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13228
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13229 Try conditionals can be nested arbitrarily. That is, a complete try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13230 conditional can be put into the try block, a catch clause, or the finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13231 clause of another try conditional. If the inner try conditional does not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13232 catch an exception thrown in its try block or throws a new exception from one
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13233 of its catch clauses or its finally clause, the outer try conditional is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13234 checked according to the rules above. If the inner try conditional is in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13235 try block of the outer try conditional, its catch clauses are checked, but
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
13236 otherwise only the finally clause is executed. It does not matter for
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13237 nesting, whether the inner try conditional is directly contained in the outer
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13238 one, or whether the outer one sources a script or calls a function containing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13239 the inner try conditional.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13240
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13241 When none of the active try conditionals catches an exception, just their
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13242 finally clauses are executed. Thereafter, the script processing terminates.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13243 An error message is displayed in case of an uncaught exception explicitly
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13244 thrown by a ":throw" command. For uncaught error and interrupt exceptions
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13245 implicitly raised by Vim, the error message(s) or interrupt message are shown
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13246 as usual.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13247
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13248 For examples see |throw-catch|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13249
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13250
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13251 EXAMINING EXCEPTION HANDLING CODE *except-examine*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13252
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13253 Exception handling code can get tricky. If you are in doubt what happens, set
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13254 'verbose' to 13 or use the ":13verbose" command modifier when sourcing your
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13255 script file. Then you see when an exception is thrown, discarded, caught, or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13256 finished. When using a verbosity level of at least 14, things pending in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13257 a finally clause are also shown. This information is also given in debug mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13258 (see |debug-scripts|).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13259
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13260
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13261 THROWING AND CATCHING EXCEPTIONS *throw-catch*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13262
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13263 You can throw any number or string as an exception. Use the |:throw| command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13264 and pass the value to be thrown as argument: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13265 :throw 4711
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13266 :throw "string"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13267 < *throw-expression*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13268 You can also specify an expression argument. The expression is then evaluated
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13269 first, and the result is thrown: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13270 :throw 4705 + strlen("string")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13271 :throw strpart("strings", 0, 6)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13272
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13273 An exception might be thrown during evaluation of the argument of the ":throw"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13274 command. Unless it is caught there, the expression evaluation is abandoned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13275 The ":throw" command then does not throw a new exception.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13276 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13277
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13278 :function! Foo(arg)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13279 : try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13280 : throw a:arg
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13281 : catch /foo/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13282 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13283 : return 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13284 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13285 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13286 :function! Bar()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13287 : echo "in Bar"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13288 : return 4710
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13289 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13290 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13291 :throw Foo("arrgh") + Bar()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13292
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13293 This throws "arrgh", and "in Bar" is not displayed since Bar() is not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13294 executed. >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13295 :throw Foo("foo") + Bar()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13296 however displays "in Bar" and throws 4711.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13297
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13298 Any other command that takes an expression as argument might also be
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
13299 abandoned by an (uncaught) exception during the expression evaluation. The
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13300 exception is then propagated to the caller of the command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13301 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13302
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13303 :if Foo("arrgh")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13304 : echo "then"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13305 :else
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13306 : echo "else"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13307 :endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13308
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13309 Here neither of "then" or "else" is displayed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13310
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13311 *catch-order*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13312 Exceptions can be caught by a try conditional with one or more |:catch|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13313 commands, see |try-conditionals|. The values to be caught by each ":catch"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13314 command can be specified as a pattern argument. The subsequent catch clause
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13315 gets executed when a matching exception is caught.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13316 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13317
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13318 :function! Foo(value)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13319 : try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13320 : throw a:value
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13321 : catch /^\d\+$/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13322 : echo "Number thrown"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13323 : catch /.*/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13324 : echo "String thrown"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13325 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13326 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13327 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13328 :call Foo(0x1267)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13329 :call Foo('string')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13330
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13331 The first call to Foo() displays "Number thrown", the second "String thrown".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13332 An exception is matched against the ":catch" commands in the order they are
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13333 specified. Only the first match counts. So you should place the more
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13334 specific ":catch" first. The following order does not make sense: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13335
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13336 : catch /.*/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13337 : echo "String thrown"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13338 : catch /^\d\+$/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13339 : echo "Number thrown"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13340
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13341 The first ":catch" here matches always, so that the second catch clause is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13342 never taken.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13343
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13344 *throw-variables*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13345 If you catch an exception by a general pattern, you may access the exact value
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13346 in the variable |v:exception|: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13347
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13348 : catch /^\d\+$/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13349 : echo "Number thrown. Value is" v:exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13350
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13351 You may also be interested where an exception was thrown. This is stored in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13352 |v:throwpoint|. Note that "v:exception" and "v:throwpoint" are valid for the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13353 exception most recently caught as long it is not finished.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13354 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13355
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13356 :function! Caught()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13357 : if v:exception != ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13358 : echo 'Caught "' . v:exception . '" in ' . v:throwpoint
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13359 : else
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13360 : echo 'Nothing caught'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13361 : endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13362 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13363 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13364 :function! Foo()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13365 : try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13366 : try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13367 : try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13368 : throw 4711
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13369 : finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13370 : call Caught()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13371 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13372 : catch /.*/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13373 : call Caught()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13374 : throw "oops"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13375 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13376 : catch /.*/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13377 : call Caught()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13378 : finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13379 : call Caught()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13380 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13381 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13382 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13383 :call Foo()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13384
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13385 This displays >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13386
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13387 Nothing caught
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13388 Caught "4711" in function Foo, line 4
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13389 Caught "oops" in function Foo, line 10
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13390 Nothing caught
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13391
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13392 A practical example: The following command ":LineNumber" displays the line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13393 number in the script or function where it has been used: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13394
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13395 :function! LineNumber()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13396 : return substitute(v:throwpoint, '.*\D\(\d\+\).*', '\1', "")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13397 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13398 :command! LineNumber try | throw "" | catch | echo LineNumber() | endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13399 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13400 *try-nested*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13401 An exception that is not caught by a try conditional can be caught by
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13402 a surrounding try conditional: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13403
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13404 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13405 : try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13406 : throw "foo"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13407 : catch /foobar/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13408 : echo "foobar"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13409 : finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13410 : echo "inner finally"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13411 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13412 :catch /foo/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13413 : echo "foo"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13414 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13415
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13416 The inner try conditional does not catch the exception, just its finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13417 clause is executed. The exception is then caught by the outer try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13418 conditional. The example displays "inner finally" and then "foo".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13419
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13420 *throw-from-catch*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13421 You can catch an exception and throw a new one to be caught elsewhere from the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13422 catch clause: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13423
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13424 :function! Foo()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13425 : throw "foo"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13426 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13427 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13428 :function! Bar()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13429 : try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13430 : call Foo()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13431 : catch /foo/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13432 : echo "Caught foo, throw bar"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13433 : throw "bar"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13434 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13435 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13436 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13437 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13438 : call Bar()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13439 :catch /.*/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13440 : echo "Caught" v:exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13441 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13442
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13443 This displays "Caught foo, throw bar" and then "Caught bar".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13444
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13445 *rethrow*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13446 There is no real rethrow in the Vim script language, but you may throw
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13447 "v:exception" instead: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13448
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13449 :function! Bar()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13450 : try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13451 : call Foo()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13452 : catch /.*/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13453 : echo "Rethrow" v:exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13454 : throw v:exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13455 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13456 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13457 < *try-echoerr*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13458 Note that this method cannot be used to "rethrow" Vim error or interrupt
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13459 exceptions, because it is not possible to fake Vim internal exceptions.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13460 Trying so causes an error exception. You should throw your own exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13461 denoting the situation. If you want to cause a Vim error exception containing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13462 the original error exception value, you can use the |:echoerr| command: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13463
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13464 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13465 : try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13466 : asdf
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13467 : catch /.*/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13468 : echoerr v:exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13469 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13470 :catch /.*/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13471 : echo v:exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13472 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13473
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13474 This code displays
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13475
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13476 Vim(echoerr):Vim:E492: Not an editor command: asdf ~
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13477
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13478
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13479 CLEANUP CODE *try-finally*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13480
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13481 Scripts often change global settings and restore them at their end. If the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13482 user however interrupts the script by pressing CTRL-C, the settings remain in
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
13483 an inconsistent state. The same may happen to you in the development phase of
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13484 a script when an error occurs or you explicitly throw an exception without
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13485 catching it. You can solve these problems by using a try conditional with
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13486 a finally clause for restoring the settings. Its execution is guaranteed on
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13487 normal control flow, on error, on an explicit ":throw", and on interrupt.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13488 (Note that errors and interrupts from inside the try conditional are converted
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
13489 to exceptions. When not caught, they terminate the script after the finally
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13490 clause has been executed.)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13491 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13492
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13493 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13494 : let s:saved_ts = &ts
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13495 : set ts=17
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13496 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13497 : " Do the hard work here.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13498 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13499 :finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13500 : let &ts = s:saved_ts
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13501 : unlet s:saved_ts
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13502 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13503
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13504 This method should be used locally whenever a function or part of a script
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13505 changes global settings which need to be restored on failure or normal exit of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13506 that function or script part.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13507
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13508 *break-finally*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13509 Cleanup code works also when the try block or a catch clause is left by
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13510 a ":continue", ":break", ":return", or ":finish".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13511 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13512
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13513 :let first = 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13514 :while 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13515 : try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13516 : if first
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13517 : echo "first"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13518 : let first = 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13519 : continue
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13520 : else
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13521 : throw "second"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13522 : endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13523 : catch /.*/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13524 : echo v:exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13525 : break
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13526 : finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13527 : echo "cleanup"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13528 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13529 : echo "still in while"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13530 :endwhile
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13531 :echo "end"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13532
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13533 This displays "first", "cleanup", "second", "cleanup", and "end". >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13534
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13535 :function! Foo()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13536 : try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13537 : return 4711
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13538 : finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13539 : echo "cleanup\n"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13540 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13541 : echo "Foo still active"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13542 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13543 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13544 :echo Foo() "returned by Foo"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13545
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13546 This displays "cleanup" and "4711 returned by Foo". You don't need to add an
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
13547 extra ":return" in the finally clause. (Above all, this would override the
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13548 return value.)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13549
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13550 *except-from-finally*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13551 Using either of ":continue", ":break", ":return", ":finish", or ":throw" in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13552 a finally clause is possible, but not recommended since it abandons the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13553 cleanup actions for the try conditional. But, of course, interrupt and error
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13554 exceptions might get raised from a finally clause.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13555 Example where an error in the finally clause stops an interrupt from
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13556 working correctly: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13557
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13558 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13559 : try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13560 : echo "Press CTRL-C for interrupt"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13561 : while 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13562 : endwhile
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13563 : finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13564 : unlet novar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13565 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13566 :catch /novar/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13567 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13568 :echo "Script still running"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13569 :sleep 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13570
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13571 If you need to put commands that could fail into a finally clause, you should
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13572 think about catching or ignoring the errors in these commands, see
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13573 |catch-errors| and |ignore-errors|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13574
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13575
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13576 CATCHING ERRORS *catch-errors*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13577
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13578 If you want to catch specific errors, you just have to put the code to be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13579 watched in a try block and add a catch clause for the error message. The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13580 presence of the try conditional causes all errors to be converted to an
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13581 exception. No message is displayed and |v:errmsg| is not set then. To find
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13582 the right pattern for the ":catch" command, you have to know how the format of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13583 the error exception is.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13584 Error exceptions have the following format: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13585
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13586 Vim({cmdname}):{errmsg}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13587 or >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13588 Vim:{errmsg}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13589
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13590 {cmdname} is the name of the command that failed; the second form is used when
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
13591 the command name is not known. {errmsg} is the error message usually produced
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13592 when the error occurs outside try conditionals. It always begins with
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13593 a capital "E", followed by a two or three-digit error number, a colon, and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13594 a space.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13595
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13596 Examples:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13597
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13598 The command >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13599 :unlet novar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13600 normally produces the error message >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13601 E108: No such variable: "novar"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13602 which is converted inside try conditionals to an exception >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13603 Vim(unlet):E108: No such variable: "novar"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13604
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13605 The command >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13606 :dwim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13607 normally produces the error message >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13608 E492: Not an editor command: dwim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13609 which is converted inside try conditionals to an exception >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13610 Vim:E492: Not an editor command: dwim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13611
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13612 You can catch all ":unlet" errors by a >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13613 :catch /^Vim(unlet):/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13614 or all errors for misspelled command names by a >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13615 :catch /^Vim:E492:/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13616
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13617 Some error messages may be produced by different commands: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13618 :function nofunc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13619 and >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13620 :delfunction nofunc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13621 both produce the error message >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13622 E128: Function name must start with a capital: nofunc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13623 which is converted inside try conditionals to an exception >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13624 Vim(function):E128: Function name must start with a capital: nofunc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13625 or >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13626 Vim(delfunction):E128: Function name must start with a capital: nofunc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13627 respectively. You can catch the error by its number independently on the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13628 command that caused it if you use the following pattern: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13629 :catch /^Vim(\a\+):E128:/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13630
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13631 Some commands like >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13632 :let x = novar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13633 produce multiple error messages, here: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13634 E121: Undefined variable: novar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13635 E15: Invalid expression: novar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13636 Only the first is used for the exception value, since it is the most specific
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13637 one (see |except-several-errors|). So you can catch it by >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13638 :catch /^Vim(\a\+):E121:/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13639
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13640 You can catch all errors related to the name "nofunc" by >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13641 :catch /\<nofunc\>/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13642
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13643 You can catch all Vim errors in the ":write" and ":read" commands by >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13644 :catch /^Vim(\(write\|read\)):E\d\+:/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13645
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13646 You can catch all Vim errors by the pattern >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13647 :catch /^Vim\((\a\+)\)\=:E\d\+:/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13648 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13649 *catch-text*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13650 NOTE: You should never catch the error message text itself: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13651 :catch /No such variable/
6647
3af822eb4da5 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 6583
diff changeset
13652 only works in the English locale, but not when the user has selected
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13653 a different language by the |:language| command. It is however helpful to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13654 cite the message text in a comment: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13655 :catch /^Vim(\a\+):E108:/ " No such variable
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13656
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13657
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13658 IGNORING ERRORS *ignore-errors*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13659
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13660 You can ignore errors in a specific Vim command by catching them locally: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13661
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13662 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13663 : write
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13664 :catch
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13665 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13666
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13667 But you are strongly recommended NOT to use this simple form, since it could
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13668 catch more than you want. With the ":write" command, some autocommands could
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13669 be executed and cause errors not related to writing, for instance: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13670
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13671 :au BufWritePre * unlet novar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13672
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13673 There could even be such errors you are not responsible for as a script
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13674 writer: a user of your script might have defined such autocommands. You would
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13675 then hide the error from the user.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13676 It is much better to use >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13677
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13678 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13679 : write
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13680 :catch /^Vim(write):/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13681 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13682
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13683 which only catches real write errors. So catch only what you'd like to ignore
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13684 intentionally.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13685
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13686 For a single command that does not cause execution of autocommands, you could
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13687 even suppress the conversion of errors to exceptions by the ":silent!"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13688 command: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13689 :silent! nunmap k
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13690 This works also when a try conditional is active.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13691
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13692
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13693 CATCHING INTERRUPTS *catch-interrupt*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13694
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13695 When there are active try conditionals, an interrupt (CTRL-C) is converted to
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
13696 the exception "Vim:Interrupt". You can catch it like every exception. The
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13697 script is not terminated, then.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13698 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13699
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13700 :function! TASK1()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13701 : sleep 10
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13702 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13703
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13704 :function! TASK2()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13705 : sleep 20
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13706 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13707
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13708 :while 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13709 : let command = input("Type a command: ")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13710 : try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13711 : if command == ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13712 : continue
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13713 : elseif command == "END"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13714 : break
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13715 : elseif command == "TASK1"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13716 : call TASK1()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13717 : elseif command == "TASK2"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13718 : call TASK2()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13719 : else
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13720 : echo "\nIllegal command:" command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13721 : continue
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13722 : endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13723 : catch /^Vim:Interrupt$/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13724 : echo "\nCommand interrupted"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13725 : " Caught the interrupt. Continue with next prompt.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13726 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13727 :endwhile
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13728
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13729 You can interrupt a task here by pressing CTRL-C; the script then asks for
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
13730 a new command. If you press CTRL-C at the prompt, the script is terminated.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13731
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13732 For testing what happens when CTRL-C would be pressed on a specific line in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13733 your script, use the debug mode and execute the |>quit| or |>interrupt|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13734 command on that line. See |debug-scripts|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13735
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13736
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13737 CATCHING ALL *catch-all*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13738
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13739 The commands >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13740
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13741 :catch /.*/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13742 :catch //
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13743 :catch
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13744
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13745 catch everything, error exceptions, interrupt exceptions and exceptions
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13746 explicitly thrown by the |:throw| command. This is useful at the top level of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13747 a script in order to catch unexpected things.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13748 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13749
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13750 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13751 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13752 : " do the hard work here
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13753 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13754 :catch /MyException/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13755 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13756 : " handle known problem
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13757 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13758 :catch /^Vim:Interrupt$/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13759 : echo "Script interrupted"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13760 :catch /.*/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13761 : echo "Internal error (" . v:exception . ")"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13762 : echo " - occurred at " . v:throwpoint
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13763 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13764 :" end of script
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13765
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13766 Note: Catching all might catch more things than you want. Thus, you are
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13767 strongly encouraged to catch only for problems that you can really handle by
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13768 specifying a pattern argument to the ":catch".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13769 Example: Catching all could make it nearly impossible to interrupt a script
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13770 by pressing CTRL-C: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13771
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13772 :while 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13773 : try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13774 : sleep 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13775 : catch
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13776 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13777 :endwhile
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13778
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13779
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13780 EXCEPTIONS AND AUTOCOMMANDS *except-autocmd*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13781
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13782 Exceptions may be used during execution of autocommands. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13783
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13784 :autocmd User x try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13785 :autocmd User x throw "Oops!"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13786 :autocmd User x catch
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13787 :autocmd User x echo v:exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13788 :autocmd User x endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13789 :autocmd User x throw "Arrgh!"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13790 :autocmd User x echo "Should not be displayed"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13791 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13792 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13793 : doautocmd User x
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13794 :catch
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13795 : echo v:exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13796 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13797
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13798 This displays "Oops!" and "Arrgh!".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13799
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13800 *except-autocmd-Pre*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13801 For some commands, autocommands get executed before the main action of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13802 command takes place. If an exception is thrown and not caught in the sequence
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13803 of autocommands, the sequence and the command that caused its execution are
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13804 abandoned and the exception is propagated to the caller of the command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13805 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13806
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13807 :autocmd BufWritePre * throw "FAIL"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13808 :autocmd BufWritePre * echo "Should not be displayed"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13809 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13810 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13811 : write
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13812 :catch
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13813 : echo "Caught:" v:exception "from" v:throwpoint
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13814 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13815
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13816 Here, the ":write" command does not write the file currently being edited (as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13817 you can see by checking 'modified'), since the exception from the BufWritePre
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13818 autocommand abandons the ":write". The exception is then caught and the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13819 script displays: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13820
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13821 Caught: FAIL from BufWrite Auto commands for "*"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13822 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13823 *except-autocmd-Post*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13824 For some commands, autocommands get executed after the main action of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13825 command has taken place. If this main action fails and the command is inside
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13826 an active try conditional, the autocommands are skipped and an error exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13827 is thrown that can be caught by the caller of the command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13828 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13829
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13830 :autocmd BufWritePost * echo "File successfully written!"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13831 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13832 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13833 : write /i/m/p/o/s/s/i/b/l/e
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13834 :catch
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13835 : echo v:exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13836 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13837
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13838 This just displays: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13839
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13840 Vim(write):E212: Can't open file for writing (/i/m/p/o/s/s/i/b/l/e)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13841
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13842 If you really need to execute the autocommands even when the main action
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13843 fails, trigger the event from the catch clause.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13844 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13845
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13846 :autocmd BufWritePre * set noreadonly
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13847 :autocmd BufWritePost * set readonly
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13848 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13849 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13850 : write /i/m/p/o/s/s/i/b/l/e
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13851 :catch
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13852 : doautocmd BufWritePost /i/m/p/o/s/s/i/b/l/e
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13853 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13854 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13855 You can also use ":silent!": >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13856
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13857 :let x = "ok"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13858 :let v:errmsg = ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13859 :autocmd BufWritePost * if v:errmsg != ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13860 :autocmd BufWritePost * let x = "after fail"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13861 :autocmd BufWritePost * endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13862 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13863 : silent! write /i/m/p/o/s/s/i/b/l/e
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13864 :catch
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13865 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13866 :echo x
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13867
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13868 This displays "after fail".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13869
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13870 If the main action of the command does not fail, exceptions from the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13871 autocommands will be catchable by the caller of the command: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13872
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13873 :autocmd BufWritePost * throw ":-("
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13874 :autocmd BufWritePost * echo "Should not be displayed"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13875 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13876 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13877 : write
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13878 :catch
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13879 : echo v:exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13880 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13881 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13882 *except-autocmd-Cmd*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13883 For some commands, the normal action can be replaced by a sequence of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13884 autocommands. Exceptions from that sequence will be catchable by the caller
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13885 of the command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13886 Example: For the ":write" command, the caller cannot know whether the file
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
13887 had actually been written when the exception occurred. You need to tell it in
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13888 some way. >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13889
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13890 :if !exists("cnt")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13891 : let cnt = 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13892 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13893 : autocmd BufWriteCmd * if &modified
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13894 : autocmd BufWriteCmd * let cnt = cnt + 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13895 : autocmd BufWriteCmd * if cnt % 3 == 2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13896 : autocmd BufWriteCmd * throw "BufWriteCmdError"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13897 : autocmd BufWriteCmd * endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13898 : autocmd BufWriteCmd * write | set nomodified
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13899 : autocmd BufWriteCmd * if cnt % 3 == 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13900 : autocmd BufWriteCmd * throw "BufWriteCmdError"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13901 : autocmd BufWriteCmd * endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13902 : autocmd BufWriteCmd * echo "File successfully written!"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13903 : autocmd BufWriteCmd * endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13904 :endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13905 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13906 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13907 : write
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13908 :catch /^BufWriteCmdError$/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13909 : if &modified
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13910 : echo "Error on writing (file contents not changed)"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13911 : else
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13912 : echo "Error after writing"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13913 : endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13914 :catch /^Vim(write):/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13915 : echo "Error on writing"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13916 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13917
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13918 When this script is sourced several times after making changes, it displays
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13919 first >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13920 File successfully written!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13921 then >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13922 Error on writing (file contents not changed)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13923 then >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13924 Error after writing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13925 etc.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13926
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13927 *except-autocmd-ill*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13928 You cannot spread a try conditional over autocommands for different events.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13929 The following code is ill-formed: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13930
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13931 :autocmd BufWritePre * try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13932 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13933 :autocmd BufWritePost * catch
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13934 :autocmd BufWritePost * echo v:exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13935 :autocmd BufWritePost * endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13936 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13937 :write
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13938
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13939
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13940 EXCEPTION HIERARCHIES AND PARAMETERIZED EXCEPTIONS *except-hier-param*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13941
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13942 Some programming languages allow to use hierarchies of exception classes or to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13943 pass additional information with the object of an exception class. You can do
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13944 similar things in Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13945 In order to throw an exception from a hierarchy, just throw the complete
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13946 class name with the components separated by a colon, for instance throw the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13947 string "EXCEPT:MATHERR:OVERFLOW" for an overflow in a mathematical library.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13948 When you want to pass additional information with your exception class, add
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13949 it in parentheses, for instance throw the string "EXCEPT:IO:WRITEERR(myfile)"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13950 for an error when writing "myfile".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13951 With the appropriate patterns in the ":catch" command, you can catch for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13952 base classes or derived classes of your hierarchy. Additional information in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13953 parentheses can be cut out from |v:exception| with the ":substitute" command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13954 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13955
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13956 :function! CheckRange(a, func)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13957 : if a:a < 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13958 : throw "EXCEPT:MATHERR:RANGE(" . a:func . ")"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13959 : endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13960 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13961 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13962 :function! Add(a, b)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13963 : call CheckRange(a:a, "Add")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13964 : call CheckRange(a:b, "Add")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13965 : let c = a:a + a:b
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13966 : if c < 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13967 : throw "EXCEPT:MATHERR:OVERFLOW"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13968 : endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13969 : return c
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13970 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13971 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13972 :function! Div(a, b)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13973 : call CheckRange(a:a, "Div")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13974 : call CheckRange(a:b, "Div")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13975 : if (a:b == 0)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13976 : throw "EXCEPT:MATHERR:ZERODIV"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13977 : endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13978 : return a:a / a:b
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13979 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13980 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13981 :function! Write(file)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13982 : try
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
13983 : execute "write" fnameescape(a:file)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13984 : catch /^Vim(write):/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13985 : throw "EXCEPT:IO(" . getcwd() . ", " . a:file . "):WRITEERR"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13986 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13987 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13988 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13989 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13990 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13991 : " something with arithmetics and I/O
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13992 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13993 :catch /^EXCEPT:MATHERR:RANGE/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13994 : let function = substitute(v:exception, '.*(\(\a\+\)).*', '\1', "")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13995 : echo "Range error in" function
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13996 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13997 :catch /^EXCEPT:MATHERR/ " catches OVERFLOW and ZERODIV
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13998 : echo "Math error"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13999 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14000 :catch /^EXCEPT:IO/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14001 : let dir = substitute(v:exception, '.*(\(.\+\),\s*.\+).*', '\1', "")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14002 : let file = substitute(v:exception, '.*(.\+,\s*\(.\+\)).*', '\1', "")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14003 : if file !~ '^/'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14004 : let file = dir . "/" . file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14005 : endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14006 : echo 'I/O error for "' . file . '"'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14007 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14008 :catch /^EXCEPT/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14009 : echo "Unspecified error"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14010 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14011 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14012
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14013 The exceptions raised by Vim itself (on error or when pressing CTRL-C) use
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14014 a flat hierarchy: they are all in the "Vim" class. You cannot throw yourself
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14015 exceptions with the "Vim" prefix; they are reserved for Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14016 Vim error exceptions are parameterized with the name of the command that
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14017 failed, if known. See |catch-errors|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14018
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14019
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14020 PECULIARITIES
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14021 *except-compat*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14022 The exception handling concept requires that the command sequence causing the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14023 exception is aborted immediately and control is transferred to finally clauses
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14024 and/or a catch clause.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14025
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14026 In the Vim script language there are cases where scripts and functions
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14027 continue after an error: in functions without the "abort" flag or in a command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14028 after ":silent!", control flow goes to the following line, and outside
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14029 functions, control flow goes to the line following the outermost ":endwhile"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14030 or ":endif". On the other hand, errors should be catchable as exceptions
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14031 (thus, requiring the immediate abortion).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14032
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14033 This problem has been solved by converting errors to exceptions and using
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14034 immediate abortion (if not suppressed by ":silent!") only when a try
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
14035 conditional is active. This is no restriction since an (error) exception can
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
14036 be caught only from an active try conditional. If you want an immediate
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14037 termination without catching the error, just use a try conditional without
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14038 catch clause. (You can cause cleanup code being executed before termination
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14039 by specifying a finally clause.)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14040
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14041 When no try conditional is active, the usual abortion and continuation
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14042 behavior is used instead of immediate abortion. This ensures compatibility of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14043 scripts written for Vim 6.1 and earlier.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14044
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14045 However, when sourcing an existing script that does not use exception handling
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14046 commands (or when calling one of its functions) from inside an active try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14047 conditional of a new script, you might change the control flow of the existing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14048 script on error. You get the immediate abortion on error and can catch the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14049 error in the new script. If however the sourced script suppresses error
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14050 messages by using the ":silent!" command (checking for errors by testing
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
14051 |v:errmsg| if appropriate), its execution path is not changed. The error is
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
14052 not converted to an exception. (See |:silent|.) So the only remaining cause
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14053 where this happens is for scripts that don't care about errors and produce
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14054 error messages. You probably won't want to use such code from your new
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14055 scripts.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14056
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14057 *except-syntax-err*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14058 Syntax errors in the exception handling commands are never caught by any of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14059 the ":catch" commands of the try conditional they belong to. Its finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14060 clauses, however, is executed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14061 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14062
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14063 :try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14064 : try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14065 : throw 4711
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14066 : catch /\(/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14067 : echo "in catch with syntax error"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14068 : catch
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14069 : echo "inner catch-all"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14070 : finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14071 : echo "inner finally"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14072 : endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14073 :catch
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14074 : echo 'outer catch-all caught "' . v:exception . '"'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14075 : finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14076 : echo "outer finally"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14077 :endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14078
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14079 This displays: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14080 inner finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14081 outer catch-all caught "Vim(catch):E54: Unmatched \("
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14082 outer finally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14083 The original exception is discarded and an error exception is raised, instead.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14084
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14085 *except-single-line*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14086 The ":try", ":catch", ":finally", and ":endtry" commands can be put on
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14087 a single line, but then syntax errors may make it difficult to recognize the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14088 "catch" line, thus you better avoid this.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14089 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14090 :try | unlet! foo # | catch | endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14091 raises an error exception for the trailing characters after the ":unlet!"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14092 argument, but does not see the ":catch" and ":endtry" commands, so that the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14093 error exception is discarded and the "E488: Trailing characters" message gets
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14094 displayed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14095
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14096 *except-several-errors*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14097 When several errors appear in a single command, the first error message is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14098 usually the most specific one and therefor converted to the error exception.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14099 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14100 echo novar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14101 causes >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14102 E121: Undefined variable: novar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14103 E15: Invalid expression: novar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14104 The value of the error exception inside try conditionals is: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14105 Vim(echo):E121: Undefined variable: novar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14106 < *except-syntax-error*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14107 But when a syntax error is detected after a normal error in the same command,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14108 the syntax error is used for the exception being thrown.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14109 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14110 unlet novar #
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14111 causes >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14112 E108: No such variable: "novar"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14113 E488: Trailing characters
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14114 The value of the error exception inside try conditionals is: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14115 Vim(unlet):E488: Trailing characters
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14116 This is done because the syntax error might change the execution path in a way
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14117 not intended by the user. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14118 try
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14119 try | unlet novar # | catch | echo v:exception | endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14120 catch /.*/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14121 echo "outer catch:" v:exception
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14122 endtry
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14123 This displays "outer catch: Vim(unlet):E488: Trailing characters", and then
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14124 a "E600: Missing :endtry" error message is given, see |except-single-line|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14125
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14126 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14127 9. Examples *eval-examples*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14128
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14129 Printing in Binary ~
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14130 >
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1998
diff changeset
14131 :" The function Nr2Bin() returns the binary string representation of a number.
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14132 :func Nr2Bin(nr)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14133 : let n = a:nr
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14134 : let r = ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14135 : while n
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14136 : let r = '01'[n % 2] . r
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14137 : let n = n / 2
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14138 : endwhile
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14139 : return r
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14140 :endfunc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14141
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14142 :" The function String2Bin() converts each character in a string to a
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14143 :" binary string, separated with dashes.
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14144 :func String2Bin(str)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14145 : let out = ''
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14146 : for ix in range(strlen(a:str))
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14147 : let out = out . '-' . Nr2Bin(char2nr(a:str[ix]))
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14148 : endfor
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14149 : return out[1:]
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14150 :endfunc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14151
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14152 Example of its use: >
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14153 :echo Nr2Bin(32)
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14154 result: "100000" >
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14155 :echo String2Bin("32")
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14156 result: "110011-110010"
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14157
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14158
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14159 Sorting lines ~
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14160
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14161 This example sorts lines with a specific compare function. >
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14162
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14163 :func SortBuffer()
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14164 : let lines = getline(1, '$')
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14165 : call sort(lines, function("Strcmp"))
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14166 : call setline(1, lines)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14167 :endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14168
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14169 As a one-liner: >
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14170 :call setline(1, sort(getline(1, '$'), function("Strcmp")))
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14171
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14172
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14173 scanf() replacement ~
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14174 *sscanf*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14175 There is no sscanf() function in Vim. If you need to extract parts from a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14176 line, you can use matchstr() and substitute() to do it. This example shows
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14177 how to get the file name, line number and column number out of a line like
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14178 "foobar.txt, 123, 45". >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14179 :" Set up the match bit
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14180 :let mx='\(\f\+\),\s*\(\d\+\),\s*\(\d\+\)'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14181 :"get the part matching the whole expression
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14182 :let l = matchstr(line, mx)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14183 :"get each item out of the match
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14184 :let file = substitute(l, mx, '\1', '')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14185 :let lnum = substitute(l, mx, '\2', '')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14186 :let col = substitute(l, mx, '\3', '')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14187
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14188 The input is in the variable "line", the results in the variables "file",
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14189 "lnum" and "col". (idea from Michael Geddes)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14190
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14191
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14192 getting the scriptnames in a Dictionary ~
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14193 *scriptnames-dictionary*
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14194 The |:scriptnames| command can be used to get a list of all script files that
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14195 have been sourced. There is no equivalent function or variable for this
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14196 (because it's rarely needed). In case you need to manipulate the list this
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14197 code can be used: >
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14198 " Get the output of ":scriptnames" in the scriptnames_output variable.
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14199 let scriptnames_output = ''
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14200 redir => scriptnames_output
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14201 silent scriptnames
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14202 redir END
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 12756
diff changeset
14203
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
14204 " Split the output into lines and parse each line. Add an entry to the
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14205 " "scripts" dictionary.
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14206 let scripts = {}
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14207 for line in split(scriptnames_output, "\n")
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14208 " Only do non-blank lines.
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14209 if line =~ '\S'
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14210 " Get the first number in the line.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
14211 let nr = matchstr(line, '\d\+')
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14212 " Get the file name, remove the script number " 123: ".
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
14213 let name = substitute(line, '.\+:\s*', '', '')
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14214 " Add an item to the Dictionary
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1609
diff changeset
14215 let scripts[nr] = name
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14216 endif
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14217 endfor
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14218 unlet scriptnames_output
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14219
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14220 ==============================================================================
16223
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14221 10. Vim script versions *vimscript-version* *vimscript-versions*
16380
5ad204d8a2f2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16366
diff changeset
14222 *scriptversion*
16223
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14223 Over time many features have been added to Vim script. This includes Ex
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14224 commands, functions, variable types, etc. Each individual feature can be
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14225 checked with the |has()| and |exists()| functions.
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14226
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14227 Sometimes old syntax of functionality gets in the way of making Vim better.
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14228 When support is taken away this will break older Vim scripts. To make this
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14229 explicit the |:scriptversion| command can be used. When a Vim script is not
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14230 compatible with older versions of Vim this will give an explicit error,
17026
905e1b154058 patch 8.1.1513: all popup functionality is in functions, except :popupclear
Bram Moolenaar <Bram@vim.org>
parents: 17020
diff changeset
14231 instead of failing in mysterious ways.
905e1b154058 patch 8.1.1513: all popup functionality is in functions, except :popupclear
Bram Moolenaar <Bram@vim.org>
parents: 17020
diff changeset
14232
905e1b154058 patch 8.1.1513: all popup functionality is in functions, except :popupclear
Bram Moolenaar <Bram@vim.org>
parents: 17020
diff changeset
14233 *scriptversion-1* >
16223
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14234 :scriptversion 1
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14235 < This is the original Vim script, same as not using a |:scriptversion|
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14236 command. Can be used to go back to old syntax for a range of lines.
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14237 Test for support with: >
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14238 has('vimscript-1')
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14239
17026
905e1b154058 patch 8.1.1513: all popup functionality is in functions, except :popupclear
Bram Moolenaar <Bram@vim.org>
parents: 17020
diff changeset
14240 < *scriptversion-2* >
16223
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14241 :scriptversion 2
16808
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16704
diff changeset
14242 < String concatenation with "." is not supported, use ".." instead.
16223
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14243 This avoids the ambiguity using "." for Dict member access and
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14244 floating point numbers. Now ".5" means the number 0.5.
17026
905e1b154058 patch 8.1.1513: all popup functionality is in functions, except :popupclear
Bram Moolenaar <Bram@vim.org>
parents: 17020
diff changeset
14245
905e1b154058 patch 8.1.1513: all popup functionality is in functions, except :popupclear
Bram Moolenaar <Bram@vim.org>
parents: 17020
diff changeset
14246 *scriptversion-3* >
16380
5ad204d8a2f2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16366
diff changeset
14247 :scriptversion 3
5ad204d8a2f2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16366
diff changeset
14248 < All |vim-variable|s must be prefixed by "v:". E.g. "version" doesn't
5ad204d8a2f2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16366
diff changeset
14249 work as |v:version| anymore, it can be used as a normal variable.
5ad204d8a2f2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16366
diff changeset
14250 Same for some obvious names as "count" and others.
5ad204d8a2f2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16366
diff changeset
14251
16223
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14252 Test for support with: >
16380
5ad204d8a2f2 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16366
diff changeset
14253 has('vimscript-3')
18080
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
14254 <
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
14255 *scriptversion-4* >
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
14256 :scriptversion 4
20665
6ff992bf4c82 patch 8.2.0886: cannot use octal numbers in scriptversion 4
Bram Moolenaar <Bram@vim.org>
parents: 20649
diff changeset
14257 < Numbers with a leading zero are not recognized as octal. "0o" or "0O"
6ff992bf4c82 patch 8.2.0886: cannot use octal numbers in scriptversion 4
Bram Moolenaar <Bram@vim.org>
parents: 20649
diff changeset
14258 is still recognized as octal. With the
18080
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
14259 previous version you get: >
20665
6ff992bf4c82 patch 8.2.0886: cannot use octal numbers in scriptversion 4
Bram Moolenaar <Bram@vim.org>
parents: 20649
diff changeset
14260 echo 017 " displays 15 (octal)
6ff992bf4c82 patch 8.2.0886: cannot use octal numbers in scriptversion 4
Bram Moolenaar <Bram@vim.org>
parents: 20649
diff changeset
14261 echo 0o17 " displays 15 (octal)
6ff992bf4c82 patch 8.2.0886: cannot use octal numbers in scriptversion 4
Bram Moolenaar <Bram@vim.org>
parents: 20649
diff changeset
14262 echo 018 " displays 18 (decimal)
18080
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
14263 < with script version 4: >
20665
6ff992bf4c82 patch 8.2.0886: cannot use octal numbers in scriptversion 4
Bram Moolenaar <Bram@vim.org>
parents: 20649
diff changeset
14264 echo 017 " displays 17 (decimal)
6ff992bf4c82 patch 8.2.0886: cannot use octal numbers in scriptversion 4
Bram Moolenaar <Bram@vim.org>
parents: 20649
diff changeset
14265 echo 0o17 " displays 15 (octal)
6ff992bf4c82 patch 8.2.0886: cannot use octal numbers in scriptversion 4
Bram Moolenaar <Bram@vim.org>
parents: 20649
diff changeset
14266 echo 018 " displays 18 (decimal)
18080
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
14267 < Also, it is possible to use single quotes inside numbers to make them
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
14268 easier to read: >
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
14269 echo 1'000'000
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
14270 < The quotes must be surrounded by digits.
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
14271
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
14272 Test for support with: >
a6d218f99ff7 patch 8.1.2035: recognizing octal numbers is confusing
Bram Moolenaar <Bram@vim.org>
parents: 18053
diff changeset
14273 has('vimscript-4')
16223
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14274
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14275 ==============================================================================
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14276 11. No +eval feature *no-eval-feature*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14277
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14278 When the |+eval| feature was disabled at compile time, none of the expression
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14279 evaluation commands are available. To prevent this from causing Vim scripts
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14280 to generate all kinds of errors, the ":if" and ":endif" commands are still
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14281 recognized, though the argument of the ":if" and everything between the ":if"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14282 and the matching ":endif" is ignored. Nesting of ":if" blocks is allowed, but
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14283 only if the commands are at the start of the line. The ":else" command is not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14284 recognized.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14285
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14286 Example of how to avoid executing commands when the |+eval| feature is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14287 missing: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14288
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14289 :if 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14290 : echo "Expression evaluation is compiled in"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14291 :else
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14292 : echo "You will _never_ see this message"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14293 :endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14294
16971
e18b1c654d09 Update runtime files - Add typescript syntax and indent.
Bram Moolenaar <Bram@vim.org>
parents: 16944
diff changeset
14295 To execute a command only when the |+eval| feature is disabled can be done in
e18b1c654d09 Update runtime files - Add typescript syntax and indent.
Bram Moolenaar <Bram@vim.org>
parents: 16944
diff changeset
14296 two ways. The simplest is to exit the script (or Vim) prematurely: >
e18b1c654d09 Update runtime files - Add typescript syntax and indent.
Bram Moolenaar <Bram@vim.org>
parents: 16944
diff changeset
14297 if 1
e18b1c654d09 Update runtime files - Add typescript syntax and indent.
Bram Moolenaar <Bram@vim.org>
parents: 16944
diff changeset
14298 echo "commands executed with +eval"
e18b1c654d09 Update runtime files - Add typescript syntax and indent.
Bram Moolenaar <Bram@vim.org>
parents: 16944
diff changeset
14299 finish
e18b1c654d09 Update runtime files - Add typescript syntax and indent.
Bram Moolenaar <Bram@vim.org>
parents: 16944
diff changeset
14300 endif
e18b1c654d09 Update runtime files - Add typescript syntax and indent.
Bram Moolenaar <Bram@vim.org>
parents: 16944
diff changeset
14301 args " command executed without +eval
e18b1c654d09 Update runtime files - Add typescript syntax and indent.
Bram Moolenaar <Bram@vim.org>
parents: 16944
diff changeset
14302
e18b1c654d09 Update runtime files - Add typescript syntax and indent.
Bram Moolenaar <Bram@vim.org>
parents: 16944
diff changeset
14303 If you do not want to abort loading the script you can use a trick, as this
e18b1c654d09 Update runtime files - Add typescript syntax and indent.
Bram Moolenaar <Bram@vim.org>
parents: 16944
diff changeset
14304 example shows: >
11414
c95c5ddc3b0d patch 8.0.0591: changes to eval functionality not documented
Christian Brabandt <cb@256bit.org>
parents: 11407
diff changeset
14305
c95c5ddc3b0d patch 8.0.0591: changes to eval functionality not documented
Christian Brabandt <cb@256bit.org>
parents: 11407
diff changeset
14306 silent! while 0
c95c5ddc3b0d patch 8.0.0591: changes to eval functionality not documented
Christian Brabandt <cb@256bit.org>
parents: 11407
diff changeset
14307 set history=111
c95c5ddc3b0d patch 8.0.0591: changes to eval functionality not documented
Christian Brabandt <cb@256bit.org>
parents: 11407
diff changeset
14308 silent! endwhile
c95c5ddc3b0d patch 8.0.0591: changes to eval functionality not documented
Christian Brabandt <cb@256bit.org>
parents: 11407
diff changeset
14309
c95c5ddc3b0d patch 8.0.0591: changes to eval functionality not documented
Christian Brabandt <cb@256bit.org>
parents: 11407
diff changeset
14310 When the |+eval| feature is available the command is skipped because of the
c95c5ddc3b0d patch 8.0.0591: changes to eval functionality not documented
Christian Brabandt <cb@256bit.org>
parents: 11407
diff changeset
14311 "while 0". Without the |+eval| feature the "while 0" is an error, which is
c95c5ddc3b0d patch 8.0.0591: changes to eval functionality not documented
Christian Brabandt <cb@256bit.org>
parents: 11407
diff changeset
14312 silently ignored, and the command is executed.
11347
4aae8146c21f Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 11313
diff changeset
14313
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14314 ==============================================================================
16223
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14315 12. The sandbox *eval-sandbox* *sandbox* *E48*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14316
2350
06feaf4fe36a Rename some "python3" symbols to "py3", as the command name.
Bram Moolenaar <bram@vim.org>
parents: 2345
diff changeset
14317 The 'foldexpr', 'formatexpr', 'includeexpr', 'indentexpr', 'statusline' and
06feaf4fe36a Rename some "python3" symbols to "py3", as the command name.
Bram Moolenaar <bram@vim.org>
parents: 2345
diff changeset
14318 'foldtext' options may be evaluated in a sandbox. This means that you are
06feaf4fe36a Rename some "python3" symbols to "py3", as the command name.
Bram Moolenaar <bram@vim.org>
parents: 2345
diff changeset
14319 protected from these expressions having nasty side effects. This gives some
06feaf4fe36a Rename some "python3" symbols to "py3", as the command name.
Bram Moolenaar <bram@vim.org>
parents: 2345
diff changeset
14320 safety for when these options are set from a modeline. It is also used when
06feaf4fe36a Rename some "python3" symbols to "py3", as the command name.
Bram Moolenaar <bram@vim.org>
parents: 2345
diff changeset
14321 the command from a tags file is executed and for CTRL-R = in the command line.
29
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
14322 The sandbox is also used for the |:sandbox| command.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14323
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14324 These items are not allowed in the sandbox:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14325 - changing the buffer text
14347
723487cd7876 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14343
diff changeset
14326 - defining or changing mapping, autocommands, user commands
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14327 - setting certain options (see |option-summary|)
1156
9cec4e0b792a updated for version 7.1a
vimboss
parents: 1104
diff changeset
14328 - setting certain v: variables (see |v:var|) *E794*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14329 - executing a shell command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14330 - reading or writing a file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14331 - jumping to another buffer or editing a file
625
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 620
diff changeset
14332 - executing Python, Perl, etc. commands
29
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
14333 This is not guaranteed 100% secure, but it should block most attacks.
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
14334
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
14335 *:san* *:sandbox*
401
4a1ead01d30b updated for version 7.0105
vimboss
parents: 395
diff changeset
14336 :san[dbox] {cmd} Execute {cmd} in the sandbox. Useful to evaluate an
29
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
14337 option that may have been set from a modeline, e.g.
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
14338 'foldexpr'.
ac33b7c03fac updated for version 7.0018
vimboss
parents: 26
diff changeset
14339
634
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14340 *sandbox-option*
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14341 A few options contain an expression. When this expression is evaluated it may
790
c8680debe1cc updated for version 7.0230
vimboss
parents: 786
diff changeset
14342 have to be done in the sandbox to avoid a security risk. But the sandbox is
634
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14343 restrictive, thus this only happens when the option was set from an insecure
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14344 location. Insecure in this context are:
843
9f279ebda751 updated for version 7.0f01
vimboss
parents: 842
diff changeset
14345 - sourcing a .vimrc or .exrc in the current directory
634
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14346 - while executing in the sandbox
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14347 - value coming from a modeline
14347
723487cd7876 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14343
diff changeset
14348 - executing a function that was defined in the sandbox
634
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14349
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14350 Note that when in the sandbox and saving an option value and restoring it, the
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14351 option will still be marked as it was set in the sandbox.
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14352
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14353 ==============================================================================
16223
abb67309c1ca patch 8.1.1116: cannot enforce a Vim script style
Bram Moolenaar <Bram@vim.org>
parents: 16219
diff changeset
14354 13. Textlock *textlock*
634
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14355
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14356 In a few situations it is not allowed to change the text in the buffer, jump
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14357 to another window and some other things that might confuse or break what Vim
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14358 is currently doing. This mostly applies to things that happen when Vim is
9877
7da89d9c744b commit https://github.com/vim/vim/commit/58b853460add42098ab08017df9e030fb14fd34b
Christian Brabandt <cb@256bit.org>
parents: 9861
diff changeset
14359 actually doing something else. For example, evaluating the 'balloonexpr' may
634
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14360 happen any moment the mouse cursor is resting at some position.
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14361
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14362 This is not allowed when the textlock is active:
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14363 - changing the buffer text
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14364 - jumping to another buffer or window
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14365 - editing another file
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14366 - closing a window or quitting Vim
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14367 - etc.
1c586ee8dd45 updated for version 7.0183
vimboss
parents: 626
diff changeset
14368
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14369
14421
2f7e67dd088c Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14407
diff changeset
14370 vim:tw=78:ts=8:noet:ft=help:norl: