Lines Matching refs:list
11 3. Using more than one list of errors |quickfix-error-lists|
32 In Vim the quickfix commands are used more generally to find a list of
47 Each quickfix list has a unique identifier called the quickfix ID and this
49 used to get the identifier assigned to a list. There is also a quickfix list
53 *location-list* *E776*
54 A location list is a window-local quickfix list. You get one after commands
56 location list instead of a quickfix list as the corresponding `:vimgrep`,
58 *location-list-file-window*
59 A location list is associated with a window and each window can have a
60 separate location list. A location list can be associated with only one
61 window. The location list is independent of the quickfix list.
63 When a window with a location list is split, the new window gets a copy of the
64 location list. When there are no longer any references to a location list,
65 the location list is destroyed.
68 Every quickfix and location list has a read-only changedtick variable that
69 tracks the total number of changes made to the list. Every time the quickfix
70 list is modified, this count is incremented. This can be used to perform an
71 action only when the list has changed. The |getqflist()| and |getloclist()|
75 The following quickfix commands can be used. The location list commands are
81 location list command, it will be aborted.
84 If the current quickfix or location list was changed by an |autocommand| while
85 processing a quickfix or location list command, it will be aborted.
103 :ll[!] [nr] Same as ":cc", except the location list for the
104 :[nr]ll[!] current window is used instead of the quickfix list.
107 :[count]cn[ext][!] Display the [count] next error in the list that
113 :[count]lne[xt][!] Same as ":cnext", except the location list for the
114 current window is used instead of the quickfix list.
117 :[count]cp[revious][!] Display the [count] previous error in the list that
125 list for the current window is used instead of the
126 quickfix list.
133 list are sorted by their buffer number and line
140 :[count]lab[ove] Same as ":cabove", except the location list for the
141 current window is used instead of the quickfix list.
148 list are sorted by their buffer number and line
155 :[count]lbel[ow] Same as ":cbelow", except the location list for the
156 current window is used instead of the quickfix list.
163 entries in a quickfix list are sorted by their buffer,
169 :[count]lbe[fore] Same as ":cbefore", except the location list for the
170 current window is used instead of the quickfix list.
177 entries in a quickfix list are sorted by their buffer,
183 :[count]laf[ter] Same as ":cafter", except the location list for the
184 current window is used instead of the quickfix list.
188 the list that includes a file name. If there are no
194 :[count]lnf[ile][!] Same as ":cnfile", except the location list for the
195 current window is used instead of the quickfix list.
199 the list that includes a file name. If there are no
207 list for the current window is used instead of the
208 quickfix list.
215 :lr[ewind][!] [nr] Same as ":crewind", except the location list for the
216 current window is used instead of the quickfix list.
229 :lla[st][!] [nr] Same as ":clast", except the location list for the
230 current window is used instead of the quickfix list.
259 :lf[ile][!] [errorfile] Same as ":cfile", except the location list for the
260 current window is used instead of the quickfix list.
262 the location list.
274 Same as ":cgetfile", except the location list for the
275 current window is used instead of the quickfix list.
279 errorfile to the current quickfix list. If a quickfix
280 list is not present, then a new list is created.
286 :laddf[ile] [errorfile] Same as ":caddfile", except the location list for the
287 current window is used instead of the quickfix list.
290 :cb[uffer][!] [bufnr] Read the error list from the current buffer.
299 :lb[uffer][!] [bufnr] Same as ":cbuffer", except the location list for the
300 current window is used instead of the quickfix list.
303 :cgetb[uffer] [bufnr] Read the error list from the current buffer. Just
307 :lgetb[uffer] [bufnr] Same as ":cgetbuffer", except the location list for
309 list.
312 :cad[dbuffer] [bufnr] Read the error list from the current buffer and add
313 the errors to the current quickfix list. If a
314 quickfix list is not present, then a new list is
318 :laddb[uffer] [bufnr] Same as ":caddbuffer", except the location list for
320 list.
323 :cex[pr][!] {expr} Create a quickfix list using the result of {expr} and
328 quickfix list.
329 If {expr} is a List, then each String item in the list
330 is processed and added to the quickfix list. Non
338 :lex[pr][!] {expr} Same as |:cexpr|, except the location list for the
339 current window is used instead of the quickfix list.
342 :cgete[xpr] {expr} Create a quickfix list using the result of {expr}.
346 :lgete[xpr] {expr} Same as |:cgetexpr|, except the location list for the
347 current window is used instead of the quickfix list.
351 current quickfix list. If a quickfix list is not
352 present, then a new list is created. The current
359 :lad[dexpr] {expr} Same as ":caddexpr", except the location list for the
360 current window is used instead of the quickfix list.
393 Same as ":clist", except the location list for the
394 current window is used instead of the quickfix list.
397 List all the entries in the location list for the
426 Every quickfix and location list has a title. By default the title is set to
427 the command that created the list. The |getqflist()| and |getloclist()|
428 functions can be used to get the title of a quickfix and a location list
430 modify the title of a quickfix and location list respectively. Examples: >
437 When you jump to a quickfix/location list entry using any of the quickfix
440 quickfix/location list can be obtained using the getqflist()/getloclist()
446 For a new quickfix list, the first entry is selected and the index is 1. Any
447 entry in any quickfix/location list can be set as the currently selected entry
454 You can get the number of entries (size) in a quickfix and a location list
460 Any Vim type can be associated as a context with a quickfix or location list.
462 context with a quickfix and a location list respectively. The |getqflist()|
464 quickfix and a location list respectively. This is useful for a Vim plugin
477 You can parse a list of lines using 'errorformat' without creating or
478 modifying a quickfix list using the |getqflist()| function. Examples: >
481 This returns a dictionary where the 'items' key contains the list of quickfix
489 :cdo[!] {cmd} Execute {cmd} in each valid entry in the quickfix list.
503 Only valid entries in the quickfix list are used.
516 :cfdo[!] {cmd} Execute {cmd} in each file in the quickfix list.
526 :ld[o][!] {cmd} Execute {cmd} in each valid entry in the location list
534 < Only valid entries in the location list are used.
538 :lfdo[!] {cmd} Execute {cmd} in each file in the location list for
550 If you have too many entries in a quickfix list, you can use the cfilter
555 Then you can use the following commands to filter a quickfix/location list: >
560 The |:Cfilter| command creates a new quickfix list from the entries matching
561 {pat} in the current quickfix list. {pat} is a Vim |regular-expression|
569 location list.
575 :cope[n] [height] Open a window to show the current list of errors.
591 quickfix list. This can be used to compose a custom
598 location list, this buffer is wiped out when the
599 location list is removed.
602 :lop[en] [height] Open a window to show the location list for the
603 current window. Works only when the location list for
612 :lcl[ose] Close the window showing the location list for the
622 location list for the current window.
633 location list for the current window.
674 Note: When adding to an existing quickfix list the autocommand are not
677 Note: Making changes in the quickfix window has no effect on the list of
682 list.
684 *location-list-window*
685 The location list window displays the entries in a location list. When you
686 open a location list window, it is created below the current window and
687 displays the location list for the current window. The location list window
689 location list window open at a time. When you use a location list command in
690 this window, the displayed location list is used.
692 When you select a file from the location list window, the following steps are
695 1. If a window with the location list displayed in the location list window is
703 In all of the above cases, if the location list for the selected window is not
704 yet set, then it is set to the location list displayed in the location list
709 window ID of the quickfix window and location list window respectively (if
716 attributes of a quickfix and location list respectively. Some examples for
719 " get the title of the current quickfix list
722 " get the identifier of the current quickfix list
725 " get the identifier of the fourth quickfix list in the stack
728 " check whether a quickfix list with a specific identifier exists
731 " get the index of the current quickfix list in the stack
734 " get the items of a quickfix list specified by an identifier
737 " get the number of entries in a quickfix list specified by an id
740 " get the context of the third quickfix list in the stack
746 " get the number of times the current quickfix list is changed
749 " get the current entry in a quickfix list specified by an identifier
752 " get all the quickfix list attributes using an identifier
755 " parse text from a List of lines and return a quickfix list
759 " parse text using a custom 'efm' and return a quickfix list
762 " get the quickfix list window id
765 " get the quickfix list window buffer number
768 " get the context of the current location list
771 " get the location list window id of the third window
774 " get the location list window buffer number of the third window
777 " get the file window id of a location list window (winnr: 4)
782 attributes of a quickfix and location list respectively. Some examples for
785 " create an empty quickfix list with a title and a context
790 " set the title of the current quickfix list
793 " change the current entry in the list specified by an identifier
796 " set the context of a quickfix list specified by an identifier
799 " create a new quickfix list from a command output
802 " parse text using a custom efm and add to a particular quickfix list
806 " add items to the quickfix list specified by an identifier
811 " empty a quickfix list specified by an identifier
817 " set the title of the fourth quickfix list
820 " create a new quickfix list at the end of the stack
824 " create a new location list from a command output
827 " replace the location list entries for the third window
831 3. Using more than one list of errors *quickfix-error-lists*
833 So far has been assumed that there is only one list of errors. Actually the
834 ten last used lists are remembered. When starting a new list, the previous
839 :col[der] [count] Go to older error list. When [count] is given, do
841 list, an error message is given.
844 :lol[der] [count] Same as `:colder`, except use the location list for
845 the current window instead of the quickfix list.
848 :cnew[er] [count] Go to newer error list. When [count] is given, do
850 list, an error message is given.
853 :lnew[er] [count] Same as `:cnewer`, except use the location list for
854 the current window instead of the quickfix list.
857 :[count]chi[story] Show the list of error lists. The current list is
859 error list 1 of 3; 43 errors ~
860 > error list 2 of 3; 0 errors ~
861 error list 3 of 3; 15 errors ~
864 list is made the current list. Example: >
865 " Make the 4th quickfix list current
869 :[count]lhi[story] Show the list of location lists, otherwise like
872 When adding a new error list, it becomes the current list.
875 list, one newer list is overwritten. This is especially useful if you are
879 To get the number of lists in the quickfix and location list stack, you can
880 use the |getqflist()| and |getloclist()| functions respectively with the list
884 To get the number of the current list in the stack: >
918 Same as ":make", except the location list for the
919 current window is used instead of the quickfix list.
938 The placeholder "$*" can be used for the argument list in {makeprg} if the
1013 the error list to the matches. Files matching
1032 match. With 'j' only the quickfix list is
1073 Same as ":vimgrep", except the location list for the
1074 current window is used instead of the quickfix list.
1079 Just like ":vimgrep", but instead of making a new list
1081 list.
1086 Same as ":vimgrepadd", except the location list for
1088 list.
1109 :lgr[ep][!] [arguments] Same as ":grep", except the location list for the
1110 current window is used instead of the quickfix list.
1114 Just like ":grep", but instead of making a new list of
1115 errors the matches are appended to the current list.
1119 < The first command makes a new error list which is
1124 An example that uses the argument list and avoids
1137 Same as ":grepadd", except the location list for the
1138 current window is used instead of the quickfix list.
1194 You use ":cn" to go along the list of matches and add the argument. At one
1209 list of branches. ":colder" goes back to the previous level. You can mix
1212 need to write down a "todo" list.
1360 The 'errorformat' option specifies a list of formats that are recognized. The
1950 list window is:
1968 list window. The dict argument will have the following fields:
1970 quickfix set to 1 when called for a quickfix list and 0 when called for
1971 a location list.
1972 winid for a location list, set to the id of the window with the
1973 location list. For a quickfix list, set to 0. Can be used in
1974 getloclist() to get the location list entry.
1975 id quickfix or location list identifier
1982 the quickfix list identifier "id". For a location list, getloclist() function
1983 can be used with the 'winid' argument. If an empty list is returned, then the
1985 list is an empty string, then the default format is used to display the
1988 If a quickfix or location list specific customization is needed, then the
1989 'quickfixtextfunc' attribute of the list can be set using the |setqflist()| or
1992 The example below displays the list of old files (|v:oldfiles|) in a quickfix
1997 " create a quickfix list from v:oldfiles