Mercurial > vim

comparison runtime/doc/eval.txt @ 19523:a7a24d06d7ce

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update runtime files. Commit: https://github.com/vim/vim/commit/bc93cebb692f47488d66f078d1728031e9be35e7 Author: Bram Moolenaar <Bram@vim.org> Date: Wed Feb 26 13:36:21 2020 +0100 Update runtime files.
author Bram Moolenaar <Bram@vim.org>
date Wed, 26 Feb 2020 13:45:05 +0100
parents 0d3dcb4476ba
children 22f0dda71638
comparison
equal deleted inserted replaced
19522:4671eb759450 19523:a7a24d06d7ce
1 *eval.txt* For Vim version 8.2. Last change: 2020 Feb 14 1 *eval.txt* For Vim version 8.2. Last change: 2020 Feb 22
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
1990 That is so that eval() can parse the string back to the same 1990 That is so that eval() can parse the string back to the same
1991 value. Read-only. 1991 value. Read-only.
1992 1992
1993 *v:numbersize* *numbersize-variable* 1993 *v:numbersize* *numbersize-variable*
1994 v:numbersize Number of bits in a Number. This is normally 64, but on some 1994 v:numbersize Number of bits in a Number. This is normally 64, but on some
1995 systems it my be 32. 1995 systems it may be 32.
1996 1996
1997 *v:oldfiles* *oldfiles-variable* 1997 *v:oldfiles* *oldfiles-variable*
1998 v:oldfiles List of file names that is loaded from the |viminfo| file on 1998 v:oldfiles List of file names that is loaded from the |viminfo| file on
1999 startup. These are the files that Vim remembers marks for. 1999 startup. These are the files that Vim remembers marks for.
2000 The length of the List is limited by the ' argument of the 2000 The length of the List is limited by the ' argument of the
6910 6910
6911 See |pattern| for the patterns that are accepted. 6911 See |pattern| for the patterns that are accepted.
6912 The 'ignorecase' option is used to set the ignore-caseness of 6912 The 'ignorecase' option is used to set the ignore-caseness of
6913 the pattern. 'smartcase' is NOT used. The matching is always 6913 the pattern. 'smartcase' is NOT used. The matching is always
6914 done like 'magic' is set and 'cpoptions' is empty. 6914 done like 'magic' is set and 'cpoptions' is empty.
6915 Note that a match at the start is preferred, thus when the
6916 pattern is using "*" (any number of matches) it tends to find
6917 zero matches at the start instead of a number of matches
6918 further down in the text.
6915 6919
6916 Can also be used as a |method|: > 6920 Can also be used as a |method|: >
6917 GetList()->match('word') 6921 GetList()->match('word')
6918 < 6922 <
6919 *matchadd()* *E798* *E799* *E801* *E957* 6923 *matchadd()* *E798* *E799* *E801* *E957*
10713 work. 10717 work.
10714 browsefilter Compiled with support for |browsefilter|. 10718 browsefilter Compiled with support for |browsefilter|.
10715 bsd Compiled on an OS in the BSD family (excluding macOS). 10719 bsd Compiled on an OS in the BSD family (excluding macOS).
10716 builtin_terms Compiled with some builtin terminals. 10720 builtin_terms Compiled with some builtin terminals.
10717 byte_offset Compiled with support for 'o' in 'statusline' 10721 byte_offset Compiled with support for 'o' in 'statusline'
10722 channel Compiled with support for |channel| and |job|
10718 cindent Compiled with 'cindent' support. 10723 cindent Compiled with 'cindent' support.
10719 clientserver Compiled with remote invocation support |clientserver|. 10724 clientserver Compiled with remote invocation support |clientserver|.
10720 clipboard Compiled with 'clipboard' support. 10725 clipboard Compiled with 'clipboard' support.
10721 clipboard_working Compiled with 'clipboard' support and it can be used. 10726 clipboard_working Compiled with 'clipboard' support and it can be used.
10722 cmdline_compl Compiled with |cmdline-completion| support. 10727 cmdline_compl Compiled with |cmdline-completion| support.
10824 python_compiled Compiled with Python 2.x interface. |has-python| 10829 python_compiled Compiled with Python 2.x interface. |has-python|
10825 python_dynamic Python 2.x interface is dynamically loaded. |has-python| 10830 python_dynamic Python 2.x interface is dynamically loaded. |has-python|
10826 python3 Python 3.x interface available. |has-python| 10831 python3 Python 3.x interface available. |has-python|
10827 python3_compiled Compiled with Python 3.x interface. |has-python| 10832 python3_compiled Compiled with Python 3.x interface. |has-python|
10828 python3_dynamic Python 3.x interface is dynamically loaded. |has-python| 10833 python3_dynamic Python 3.x interface is dynamically loaded. |has-python|
10829 pythonx Compiled with |python_x| interface. |has-pythonx| 10834 pythonx Python 2.x and/or 3.x interface available. |python_x|
10830 qnx QNX version of Vim. 10835 qnx QNX version of Vim.
10831 quickfix Compiled with |quickfix| support. 10836 quickfix Compiled with |quickfix| support.
10832 reltime Compiled with |reltime()| support. 10837 reltime Compiled with |reltime()| support.
10833 rightleft Compiled with 'rightleft' support. 10838 rightleft Compiled with 'rightleft' support.
10834 ruby Compiled with Ruby interface |ruby|. 10839 ruby Compiled with Ruby interface |ruby|.
11852 a |:finally| command following, execution continues 11857 a |:finally| command following, execution continues
11853 after the ":finally". Otherwise, or when the 11858 after the ":finally". Otherwise, or when the
11854 ":endtry" is reached thereafter, the next 11859 ":endtry" is reached thereafter, the next
11855 (dynamically) surrounding ":try" is checked for 11860 (dynamically) surrounding ":try" is checked for
11856 a corresponding ":finally" etc. Then the script 11861 a corresponding ":finally" etc. Then the script
11857 processing is terminated. (Whether a function 11862 processing is terminated. Whether a function
11858 definition has an "abort" argument does not matter.) 11863 definition has an "abort" argument does not matter.
11859 Example: > 11864 Example: >
11860 :try | edit too much | finally | echo "cleanup" | endtry 11865 try | call Unknown() | finally | echomsg "cleanup" | endtry
11861 :echo "impossible" " not reached, script terminated above 11866 echomsg "not reached"
11862 < 11867 <
11863 Moreover, an error or interrupt (dynamically) inside 11868 Moreover, an error or interrupt (dynamically) inside
11864 ":try" and ":endtry" is converted to an exception. It 11869 ":try" and ":endtry" is converted to an exception. It
11865 can be caught as if it were thrown by a |:throw| 11870 can be caught as if it were thrown by a |:throw|
11866 command (see |:catch|). In this case, the script 11871 command (see |:catch|). In this case, the script
11873 "Vim:{errmsg}". {command} is the full command name, 11878 "Vim:{errmsg}". {command} is the full command name,
11874 and {errmsg} is the message that is displayed if the 11879 and {errmsg} is the message that is displayed if the
11875 error exception is not caught, always beginning with 11880 error exception is not caught, always beginning with
11876 the error number. 11881 the error number.
11877 Examples: > 11882 Examples: >
11878 :try | sleep 100 | catch /^Vim:Interrupt$/ | endtry 11883 try | sleep 100 | catch /^Vim:Interrupt$/ | endtry
11879 :try | edit | catch /^Vim(edit):E\d\+/ | echo "error" | endtry 11884 try | edit | catch /^Vim(edit):E\d\+/ | echo "error" | endtry
11880 < 11885 <
11881 *:cat* *:catch* *E603* *E604* *E605* 11886 *:cat* *:catch* *E603* *E604* *E605*
11882 :cat[ch] /{pattern}/ The following commands until the next |:catch|, 11887 :cat[ch] /{pattern}/ The following commands until the next |:catch|,
11883 |:finally|, or |:endtry| that belongs to the same 11888 |:finally|, or |:endtry| that belongs to the same
11884 |:try| as the ":catch" are executed when an exception 11889 |:try| as the ":catch" are executed when an exception
12028 expression. 12033 expression.
12029 12034
12030 The command can be shortened to `:ev` or `:eva`, but 12035 The command can be shortened to `:ev` or `:eva`, but
12031 these are hard to recognize and therefore not to be 12036 these are hard to recognize and therefore not to be
12032 used. 12037 used.
12038
12039 The command cannot be followed by "|" and another
12040 command, since "|" is seen as part of the expression.
12033 12041
12034 12042
12035 *:exe* *:execute* 12043 *:exe* *:execute*
12036 :exe[cute] {expr1} .. Executes the string that results from the evaluation 12044 :exe[cute] {expr1} .. Executes the string that results from the evaluation
12037 of {expr1} as an Ex command. 12045 of {expr1} as an Ex command.