Mercurial > vim
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. |