comparison runtime/doc/eval.txt @ 20965:59f93c2d2551

Update runtime files Commit: https://github.com/vim/vim/commit/73fef33014dbf21fc59e7e47fb091117868d82fb Author: Bram Moolenaar <Bram@vim.org> Date: Sun Jun 21 22:12:03 2020 +0200 Update runtime files
author Bram Moolenaar <Bram@vim.org>
date Sun, 21 Jun 2020 22:15:04 +0200
parents 27401f09fe9b
children 99a602b27e0e
comparison
equal deleted inserted replaced
20964:be672fa6d129 20965:59f93c2d2551
1 *eval.txt* For Vim version 8.2. Last change: 2020 Jun 14 1 *eval.txt* For Vim version 8.2. Last change: 2020 Jun 17
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
3665 "thesaurus" Thesaurus |i_CTRL-X_CTRL-T| 3665 "thesaurus" Thesaurus |i_CTRL-X_CTRL-T|
3666 "cmdline" Vim Command line |i_CTRL-X_CTRL-V| 3666 "cmdline" Vim Command line |i_CTRL-X_CTRL-V|
3667 "function" User defined completion |i_CTRL-X_CTRL-U| 3667 "function" User defined completion |i_CTRL-X_CTRL-U|
3668 "omni" Omni completion |i_CTRL-X_CTRL-O| 3668 "omni" Omni completion |i_CTRL-X_CTRL-O|
3669 "spell" Spelling suggestions |i_CTRL-X_s| 3669 "spell" Spelling suggestions |i_CTRL-X_s|
3670 "eval" |complete()| completion 3670 "eval" |complete()| completion
3671 "unknown" Other internal modes 3671 "unknown" Other internal modes
3672 3672
3673 If the optional {what} list argument is supplied, then only 3673 If the optional {what} list argument is supplied, then only
3674 the items listed in {what} are returned. Unsupported items in 3674 the items listed in {what} are returned. Unsupported items in
3675 {what} are silently ignored. 3675 {what} are silently ignored.
4534 Flatten {list} up to {maxdepth} levels. Without {maxdepth} 4534 Flatten {list} up to {maxdepth} levels. Without {maxdepth}
4535 the result is a |List| without nesting, as if {maxdepth} is 4535 the result is a |List| without nesting, as if {maxdepth} is
4536 a very large number. 4536 a very large number.
4537 The {list} is changed in place, make a copy first if you do 4537 The {list} is changed in place, make a copy first if you do
4538 not want that. 4538 not want that.
4539 *E900* 4539 *E900*
4540 {maxdepth} means how deep in nested lists changes are made. 4540 {maxdepth} means how deep in nested lists changes are made.
4541 {list} is not modified when {maxdepth} is 0. 4541 {list} is not modified when {maxdepth} is 0.
4542 {maxdepth} must be positive number. 4542 {maxdepth} must be positive number.
4543 4543
4544 If there is an error the number zero is returned. 4544 If there is an error the number zero is returned.
5161 function function name 5161 function function name
5162 help help subjects 5162 help help subjects
5163 highlight highlight groups 5163 highlight highlight groups
5164 history :history suboptions 5164 history :history suboptions
5165 locale locale names (as output of locale -a) 5165 locale locale names (as output of locale -a)
5166 mapclear buffer argument 5166 mapclear buffer argument
5167 mapping mapping name 5167 mapping mapping name
5168 menu menus 5168 menu menus
5169 messages |:messages| suboptions 5169 messages |:messages| suboptions
5170 option options 5170 option options
5171 packadd optional package |pack-add| names 5171 packadd optional package |pack-add| names
5187 are returned. The 'wildignorecase' option always applies. 5187 are returned. The 'wildignorecase' option always applies.
5188 5188
5189 If {type} is "cmdline", then the |cmdline-completion| result is 5189 If {type} is "cmdline", then the |cmdline-completion| result is
5190 returned. For example, to complete the possible values after 5190 returned. For example, to complete the possible values after
5191 a ":call" command: > 5191 a ":call" command: >
5192 echo getcompletion('call ', 'cmdline') 5192 echo getcompletion('call ', 'cmdline')
5193 < 5193 <
5194 If there are no matches, an empty list is returned. An 5194 If there are no matches, an empty list is returned. An
5195 invalid value for {type} produces an error. 5195 invalid value for {type} produces an error.
5196 5196
5197 Can also be used as a |method|: > 5197 Can also be used as a |method|: >
5768 5768
5769 getwininfo([{winid}]) *getwininfo()* 5769 getwininfo([{winid}]) *getwininfo()*
5770 Returns information about windows as a List with Dictionaries. 5770 Returns information about windows as a List with Dictionaries.
5771 5771
5772 If {winid} is given Information about the window with that ID 5772 If {winid} is given Information about the window with that ID
5773 is returned. If the window does not exist the result is an 5773 is returned, as a List with one item. If the window does not
5774 empty list. 5774 exist the result is an empty list.
5775 5775
5776 Without {winid} information about all the windows in all the 5776 Without {winid} information about all the windows in all the
5777 tab pages is returned. 5777 tab pages is returned.
5778 5778
5779 Each List item is a Dictionary with the following entries: 5779 Each List item is a Dictionary with the following entries:
8604 return printf(' /%s [?/??]', @/) 8604 return printf(' /%s [?/??]', @/)
8605 elseif result.incomplete ==# 2 " max count exceeded 8605 elseif result.incomplete ==# 2 " max count exceeded
8606 if result.total > result.maxcount && 8606 if result.total > result.maxcount &&
8607 \ result.current > result.maxcount 8607 \ result.current > result.maxcount
8608 return printf(' /%s [>%d/>%d]', @/, 8608 return printf(' /%s [>%d/>%d]', @/,
8609 \ result.current, result.total) 8609 \ result.current, result.total)
8610 elseif result.total > result.maxcount 8610 elseif result.total > result.maxcount
8611 return printf(' /%s [%d/>%d]', @/, 8611 return printf(' /%s [%d/>%d]', @/,
8612 \ result.current, result.total) 8612 \ result.current, result.total)
8613 endif 8613 endif
8614 endif 8614 endif
8615 return printf(' /%s [%d/%d]', @/, 8615 return printf(' /%s [%d/%d]', @/,
8616 \ result.current, result.total) 8616 \ result.current, result.total)
8617 endfunction 8617 endfunction
8618 let &statusline .= '%{LastSearchCount()}' 8618 let &statusline .= '%{LastSearchCount()}'
8619 8619
8620 " Or if you want to show the count only when 8620 " Or if you want to show the count only when
8621 " 'hlsearch' was on 8621 " 'hlsearch' was on
9384 Simplify the file name as much as possible without changing 9384 Simplify the file name as much as possible without changing
9385 the meaning. Shortcuts (on MS-Windows) or symbolic links (on 9385 the meaning. Shortcuts (on MS-Windows) or symbolic links (on
9386 Unix) are not resolved. If the first path component in 9386 Unix) are not resolved. If the first path component in
9387 {filename} designates the current directory, this will be 9387 {filename} designates the current directory, this will be
9388 valid for the result as well. A trailing path separator is 9388 valid for the result as well. A trailing path separator is
9389 not removed either. 9389 not removed either. On Unix "//path" is unchanged, but
9390 "///path" is simplified to "/path" (this follows the Posix
9391 standard).
9390 Example: > 9392 Example: >
9391 simplify("./dir/.././/file/") == "./file/" 9393 simplify("./dir/.././/file/") == "./file/"
9392 < Note: The combination "dir/.." is only removed if "dir" is 9394 < Note: The combination "dir/.." is only removed if "dir" is
9393 a searchable directory or does not exist. On Unix, it is also 9395 a searchable directory or does not exist. On Unix, it is also
9394 removed when "dir" is a symbolic link within the same 9396 removed when "dir" is a symbolic link within the same
9694 These characters indicate the state, generally indicating that 9696 These characters indicate the state, generally indicating that
9695 something is busy: 9697 something is busy:
9696 m halfway a mapping, :normal command, feedkeys() or 9698 m halfway a mapping, :normal command, feedkeys() or
9697 stuffed command 9699 stuffed command
9698 o operator pending or waiting for a command argument, 9700 o operator pending or waiting for a command argument,
9699 e.g. after |f| 9701 e.g. after |f|
9700 a Insert mode autocomplete active 9702 a Insert mode autocomplete active
9701 x executing an autocommand 9703 x executing an autocommand
9702 w blocked on waiting, e.g. ch_evalexpr(), ch_read() and 9704 w blocked on waiting, e.g. ch_evalexpr(), ch_read() and
9703 ch_readraw() when reading json. 9705 ch_readraw() when reading json.
9704 S not triggering SafeState or SafeStateAgain 9706 S not triggering SafeState or SafeStateAgain
10448 ** value 'u' for unknown, 'y' for yes, 'n' for no 10450 ** value 'u' for unknown, 'y' for yes, 'n' for no
10449 10451
10450 If the |+termresponse| feature is missing then the result is 10452 If the |+termresponse| feature is missing then the result is
10451 an empty dictionary. 10453 an empty dictionary.
10452 10454
10453 If "cursor_style" is 'y' then |t_RS| will be send to request the 10455 If "cursor_style" is 'y' then |t_RS| will be sent to request the
10454 current cursor style. 10456 current cursor style.
10455 If "cursor_blink_mode" is 'y' then |t_RC| will be send to 10457 If "cursor_blink_mode" is 'y' then |t_RC| will be sent to
10456 request the cursor blink status. 10458 request the cursor blink status.
10457 "cursor_style" and "cursor_blink_mode" are also set if |t_u7| 10459 "cursor_style" and "cursor_blink_mode" are also set if |t_u7|
10458 is not empty, Vim will detect the working of sending |t_RS| 10460 is not empty, Vim will detect the working of sending |t_RS|
10459 and |t_RC| on startup. 10461 and |t_RC| on startup.
10460 10462
10914 10916
10915 Can also be used as a |method|: > 10917 Can also be used as a |method|: >
10916 GetWinid()->win_screenpos() 10918 GetWinid()->win_screenpos()
10917 < 10919 <
10918 win_splitmove({nr}, {target} [, {options}]) *win_splitmove()* 10920 win_splitmove({nr}, {target} [, {options}]) *win_splitmove()*
10919 Move the window {nr} to a new split of the window {target}. 10921 Move the window {nr} to a new split of the window {target}.
10920 This is similar to moving to {target}, creating a new window 10922 This is similar to moving to {target}, creating a new window
10921 using |:split| but having the same contents as window {nr}, and 10923 using |:split| but having the same contents as window {nr}, and
10922 then closing {nr}. 10924 then closing {nr}.
10923 10925
10924 Both {nr} and {target} can be window numbers or |window-ID|s. 10926 Both {nr} and {target} can be window numbers or |window-ID|s.