Mercurial > vim

comparison runtime/doc/eval.txt @ 16019:096b8ccd855e v8.1.1015

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number commit https://github.com/vim/vim/commit/647e24ba3dbf7ff448aa471b1a659a18267ae056 Author: Bram Moolenaar <Bram@vim.org> Date: Sun Mar 17 16:39:46 2019 +0100 patch 8.1.1015: quickfix buffer shows up in list, can't get buffer number Problem: Quickfix buffer shows up in list, can't get buffer number. Solution: Make the quickfix buffer unlisted when the quickfix window is closed. get the quickfix buffer number with getqflist(). (Yegappan Lakshmanan, closes #4113)
author Bram Moolenaar <Bram@vim.org>
date Sun, 17 Mar 2019 16:45:11 +0100
parents 7fbdceabad64
children d13aa9c5a1d1
comparison
equal deleted inserted replaced
16018:aa208549a80b 16019:096b8ccd855e
1 *eval.txt* For Vim version 8.1. Last change: 2019 Feb 22 1 *eval.txt* For Vim version 8.1. Last change: 2019 Mar 02
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
3536 Only to be used by the function specified with the 3536 Only to be used by the function specified with the
3537 'completefunc' option. 3537 'completefunc' option.
3538 3538
3539 *confirm()* 3539 *confirm()*
3540 confirm({msg} [, {choices} [, {default} [, {type}]]]) 3540 confirm({msg} [, {choices} [, {default} [, {type}]]])
3541 Confirm() offers the user a dialog, from which a choice can be 3541 confirm() offers the user a dialog, from which a choice can be
3542 made. It returns the number of the choice. For the first 3542 made. It returns the number of the choice. For the first
3543 choice this is 1. 3543 choice this is 1.
3544 Note: confirm() is only supported when compiled with dialog 3544 Note: confirm() is only supported when compiled with dialog
3545 support, see |+dialog_con| and |+dialog_gui|. 3545 support, see |+dialog_con| and |+dialog_gui|.
3546 3546
4059 Names for non-existing files are included. The "**" item can 4059 Names for non-existing files are included. The "**" item can
4060 be used to search in a directory tree. For example, to find 4060 be used to search in a directory tree. For example, to find
4061 all "README" files in the current directory and below: > 4061 all "README" files in the current directory and below: >
4062 :echo expand("**/README") 4062 :echo expand("**/README")
4063 < 4063 <
4064 Expand() can also be used to expand variables and environment 4064 expand() can also be used to expand variables and environment
4065 variables that are only known in a shell. But this can be 4065 variables that are only known in a shell. But this can be
4066 slow, because a shell may be used to do the expansion. See 4066 slow, because a shell may be used to do the expansion. See
4067 |expr-env-expand|. 4067 |expr-env-expand|.
4068 The expanded variable is still handled like a list of file 4068 The expanded variable is still handled like a list of file
4069 names. When an environment variable cannot be expanded, it is 4069 names. When an environment variable cannot be expanded, it is
4962 returned. Otherwise, same as |getqflist()|. 4962 returned. Otherwise, same as |getqflist()|.
4963 4963
4964 If the optional {what} dictionary argument is supplied, then 4964 If the optional {what} dictionary argument is supplied, then
4965 returns the items listed in {what} as a dictionary. Refer to 4965 returns the items listed in {what} as a dictionary. Refer to
4966 |getqflist()| for the supported items in {what}. 4966 |getqflist()| for the supported items in {what}.
4967 If {what} contains 'filewinid', then returns the id of the 4967
4968 window used to display files from the location list. This 4968 In addition to the items supported by |getqflist()| in {what},
4969 field is applicable only when called from a location list 4969 the following item is supported by |getloclist()|:
4970 window. See |location-list-file-window| for more details. 4970
4971 filewinid id of the window used to display files
4972 from the location list. This field is
4973 applicable only when called from a
4974 location list window. See
4975 |location-list-file-window| for more
4976 details.
4971 4977
4972 getmatches() *getmatches()* 4978 getmatches() *getmatches()*
4973 Returns a |List| with all matches previously defined by 4979 Returns a |List| with all matches previously defined by
4974 |matchadd()| and the |:match| commands. |getmatches()| is 4980 |matchadd()| and the |:match| commands. |getmatches()| is
4975 useful in combination with |setmatches()|, as |setmatches()| 4981 useful in combination with |setmatches()|, as |setmatches()|
5067 accepted. The current quickfix list is not 5073 accepted. The current quickfix list is not
5068 modified. See |quickfix-parse|. 5074 modified. See |quickfix-parse|.
5069 nr get information for this quickfix list; zero 5075 nr get information for this quickfix list; zero
5070 means the current quickfix list and "$" means 5076 means the current quickfix list and "$" means
5071 the last quickfix list 5077 the last quickfix list
5078 qfbufnr number of the buffer displayed in the quickfix
5079 window. Returns 0 if the quickfix buffer is
5080 not present. See |quickfix-buffer|.
5072 size number of entries in the quickfix list 5081 size number of entries in the quickfix list
5073 title get the list title |quickfix-title| 5082 title get the list title |quickfix-title|
5074 winid get the quickfix |window-ID| 5083 winid get the quickfix |window-ID|
5075 all all of the above quickfix properties 5084 all all of the above quickfix properties
5076 Non-string items in {what} are ignored. To get the value of a 5085 Non-string items in {what} are ignored. To get the value of a
5095 idx index of the current entry in the list. If not 5104 idx index of the current entry in the list. If not
5096 present, set to 0. 5105 present, set to 0.
5097 items quickfix list entries. If not present, set to 5106 items quickfix list entries. If not present, set to
5098 an empty list. 5107 an empty list.
5099 nr quickfix list number. If not present, set to 0 5108 nr quickfix list number. If not present, set to 0
5109 qfbufnr number of the buffer displayed in the quickfix
5110 window. If not present, set to 0.
5100 size number of entries in the quickfix list. If not 5111 size number of entries in the quickfix list. If not
5101 present, set to 0. 5112 present, set to 0.
5102 title quickfix list title text. If not present, set 5113 title quickfix list title text. If not present, set
5103 to "". 5114 to "".
5104 winid quickfix |window-ID|. If not present, set to 0 5115 winid quickfix |window-ID|. If not present, set to 0
11201 matching {pattern} is being thrown and has not yet 11212 matching {pattern} is being thrown and has not yet
11202 been caught by a previous ":catch". Otherwise, these 11213 been caught by a previous ":catch". Otherwise, these
11203 commands are skipped. 11214 commands are skipped.
11204 When {pattern} is omitted all errors are caught. 11215 When {pattern} is omitted all errors are caught.
11205 Examples: > 11216 Examples: >
11206 :catch /^Vim:Interrupt$/ " catch interrupts (CTRL-C) 11217 :catch /^Vim:Interrupt$/ " catch interrupts (CTRL-C)
11207 :catch /^Vim\%((\a\+)\)\=:E/ " catch all Vim errors 11218 :catch /^Vim\%((\a\+)\)\=:E/ " catch all Vim errors
11208 :catch /^Vim\%((\a\+)\)\=:/ " catch errors and interrupts 11219 :catch /^Vim\%((\a\+)\)\=:/ " catch errors and interrupts
11209 :catch /^Vim(write):/ " catch all errors in :write 11220 :catch /^Vim(write):/ " catch all errors in :write
11210 :catch /^Vim\%((\a\+)\)\=:E123/ " catch error E123 11221 :catch /^Vim\%((\a\+)\)\=:E123:/ " catch error E123
11211 :catch /my-exception/ " catch user exception 11222 :catch /my-exception/ " catch user exception
11212 :catch /.*/ " catch everything 11223 :catch /.*/ " catch everything
11213 :catch " same as /.*/ 11224 :catch " same as /.*/
11214 < 11225 <
11215 Another character can be used instead of / around the 11226 Another character can be used instead of / around the
11216 {pattern}, so long as it does not have a special 11227 {pattern}, so long as it does not have a special
11217 meaning (e.g., '|' or '"') and doesn't occur inside 11228 meaning (e.g., '|' or '"') and doesn't occur inside
11218 {pattern}. 11229 {pattern}.