1- *eval.txt* For Vim version 7.4. Last change: 2016 Aug 16
1+ *eval.txt* For Vim version 7.4. Last change: 2016 Aug 18
22
33
44 VIM REFERENCE MANUAL by Bram Moolenaar
@@ -43,7 +43,7 @@ There are nine types of variables:
4343Number A 32 or 64 bit signed number. | expr-number | *Number*
4444 64-bit Numbers are available only when compiled with the
4545 | +num64 | feature.
46- Examples: -123 0x10 0177
46+ Examples: -123 0x10 0177 0b1011
4747
4848Float A floating point number. | floating-point-format | *Float*
4949 {only when compiled with the | +float | feature}
@@ -1038,9 +1038,10 @@ When expr8 is a |Funcref| type variable, invoke the function it refers to.
10381038number
10391039------
10401040number number constant *expr-number*
1041- *hex-number* *octal-number*
1041+ *hex-number* *octal-number* *binary -number*
10421042
1043- Decimal, Hexadecimal (starting with 0x or 0X), or Octal (starting with 0).
1043+ Decimal, Hexadecimal (starting with 0x or 0X), Binary (starting with 0b or 0B)
1044+ and Octal (starting with 0).
10441045
10451046 *floating-point-format*
10461047Floating point numbers can be written in two forms:
@@ -1446,8 +1447,8 @@ v:beval_winnr The number of the window, over which the mouse pointer is. Only
14461447 window gets a number).
14471448
14481449 *v:beval_winid* *beval_winid-variable*
1449- v:beval_winid The window ID of the window, over which the mouse pointer is.
1450- Otherwise like v:beval_winnr.
1450+ v:beval_winid The | window-ID | of the window, over which the mouse pointer
1451+ is. Otherwise like v:beval_winnr.
14511452
14521453 *v:char* *char-variable*
14531454v:char Argument for evaluating 'formatexpr' and used for the typed
@@ -1945,7 +1946,8 @@ v:windowid When any X11 based GUI is running or when running in a
19451946 When an MS-Windows GUI is running this will be set to the
19461947 window handle.
19471948 Otherwise the value is zero.
1948- Note: for windows inside Vim use | winnr() | or | win_getid() | .
1949+ Note: for windows inside Vim use | winnr() | or | win_getid() | ,
1950+ see | window-ID | .
19491951
19501952==============================================================================
195119534. Builtin Functions *functions*
@@ -2462,7 +2464,7 @@ arglistid([{winnr} [, {tabnr}]])
24622464 With {winnr} only use this window in the current tab page.
24632465 With {winnr} and {tabnr} use the window in the specified tab
24642466 page.
2465- {winnr} can be the window number or the window ID .
2467+ {winnr} can be the window number or the | window-ID | .
24662468
24672469 *argv()*
24682470argv([{nr} ]) The result is the {nr} th file in the argument list of the
@@ -2708,7 +2710,7 @@ bufnr({expr} [, {create}])
27082710 Obsolete name for bufnr("$"): last_buffer_nr().
27092711
27102712bufwinid({expr} ) *bufwinid()*
2711- The result is a Number, which is the window ID of the first
2713+ The result is a Number, which is the | window-ID | of the first
27122714 window associated with buffer {expr} . For the use of {expr} ,
27132715 see | bufname() | above. If buffer {expr} doesn't exist or
27142716 there is no such window, -1 is returned. Example: >
@@ -3116,7 +3118,7 @@ ch_setoptions({handle}, {options}) *ch_setoptions()*
31163118 lost.
31173119
31183120 These options cannot be changed:
3119- "waittime" only applies to " ch_open()|
3121+ "waittime" only applies to | ch_open() |
31203122
31213123ch_status({handle} ) *ch_status()*
31223124 Return the status of {handle} :
@@ -4020,7 +4022,7 @@ getbufinfo([{dict}])
40204022 lnum line number
40214023 name sign name
40224024 variables dictionary of buffer local variables.
4023- windows list of window IDs with this buffer
4025+ windows list of | window-ID | s with this buffer
40244026
40254027 Examples: >
40264028 for buf in getbufinfo()
@@ -4283,7 +4285,7 @@ getcwd([{winnr} [, {tabnr}]])
42834285 in the current tab page.
42844286 With {winnr} and {tabnr} return the local current directory of
42854287 the window in the specified tab page.
4286- {winnr} can be the window number or the window ID .
4288+ {winnr} can be the window number or the | window-ID | .
42874289 Return an empty string if the arguments are invalid.
42884290
42894291getfsize({fname} ) *getfsize()*
@@ -4380,7 +4382,7 @@ getline({lnum} [, {end}])
43804382
43814383getloclist({nr} [, {what} ]) *getloclist()*
43824384 Returns a list with all the entries in the location list for
4383- window {nr} . {nr} can be the window number or the window ID .
4385+ window {nr} . {nr} can be the window number or the | window-ID | .
43844386 When {nr} is zero the current window is used.
43854387
43864388 For a location list window, the displayed location list is
@@ -4456,7 +4458,7 @@ getqflist([{what}]) *getqflist()*
44564458 type type of the error, 'E', '1', etc.
44574459 valid | TRUE | : recognized error message
44584460
4459- When there is no error list or it's empty an empty list is
4461+ When there is no error list or it's empty, an empty list is
44604462 returned. Quickfix list entries with non-existing buffer
44614463 number are returned with "bufnr" set to zero.
44624464
@@ -4471,8 +4473,8 @@ getqflist([{what}]) *getqflist()*
44714473 returns only the items listed in {what} as a dictionary. The
44724474 following string items are supported in {what} :
44734475 nr get information for this quickfix list
4474- title get list title
4475- winid get window id (if opened)
4476+ title get the list title
4477+ winid get the | window-ID | (if opened)
44764478 all all of the above quickfix properties
44774479 Non-string items in {what} are ignored.
44784480 If "nr" is not present then the current quickfix list is used.
@@ -4482,7 +4484,7 @@ getqflist([{what}]) *getqflist()*
44824484 The returned dictionary contains the following entries:
44834485 nr quickfix list number
44844486 title quickfix list title text
4485- winid quickfix window id (if opened)
4487+ winid quickfix | window-ID | (if opened)
44864488
44874489 Examples: >
44884490 :echo getqflist({'all': 1})
@@ -4529,9 +4531,9 @@ gettabinfo([{arg}]) *gettabinfo()*
45294531 empty List is returned.
45304532
45314533 Each List item is a Dictionary with the following entries:
4532- nr tab page number.
4534+ tabnr tab page number.
45334535 variables dictionary of tabpage local variables.
4534- windows List of window IDs in the tag page.
4536+ windows List of | window-ID | s in the tag page.
45354537
45364538gettabvar({tabnr} , {varname} [, {def} ]) *gettabvar()*
45374539 Get the value of a tab-local variable {varname} in tab page
@@ -4553,7 +4555,7 @@ gettabwinvar({tabnr}, {winnr}, {varname} [, {def}]) *gettabwinvar()*
45534555 Note that {varname} must be the name without "w:".
45544556 Tabs are numbered starting with one. For the current tabpage
45554557 use | getwinvar() | .
4556- {winnr} can be the window number or the window ID .
4558+ {winnr} can be the window number or the | window-ID | .
45574559 When {winnr} is zero the current window is used.
45584560 This also works for a global option, buffer-local option and
45594561 window-local option, but it doesn't work for a global variable
@@ -4581,22 +4583,22 @@ getwininfo([{winid}]) *getwininfo()*
45814583 is returned. If the window does not exist the result is an
45824584 empty list.
45834585
4584- Without an information about all the windows in all the tab
4585- pages is returned.
4586+ Without {winid} information about all the windows in all the
4587+ tab pages is returned.
45864588
45874589 Each List item is a Dictionary with the following entries:
4588- bufnum number of buffer in the window
4590+ bufnr number of buffer in the window
45894591 height window height
45904592 loclist 1 if showing a location list
45914593 {only with the +quickfix feature}
4592- nr window number
45934594 options dictionary of window local options
45944595 quickfix 1 if quickfix or location list window
45954596 {only with the +quickfix feature}
4596- tpnr tab page number
4597+ tabnr tab page number
45974598 variables dictionary of window local variables
45984599 width window width
4599- winid window ID
4600+ winid | window-ID |
4601+ winnr window number
46004602
46014603getwinvar({winnr} , {varname} [, {def} ]) *getwinvar()*
46024604 Like | gettabwinvar() | for the current tabpage.
@@ -4704,7 +4706,7 @@ haslocaldir([{winnr} [, {tabnr}]]) *haslocaldir()*
47044706 With {winnr} use this window in the current tab page.
47054707 With {winnr} and {tabnr} use the window in the specified tab
47064708 page.
4707- {winnr} can be the window number or the window ID .
4709+ {winnr} can be the window number or the | window-ID | .
47084710 Return 0 if the arguments are invalid.
47094711
47104712hasmapto({what} [, {mode} [, {abbr} ]]) *hasmapto()*
@@ -5994,6 +5996,9 @@ printf({fmt}, {expr1} ...) *printf()*
59945996 s The text of the String argument is used. If a
59955997 precision is specified, no more bytes than the number
59965998 specified are used.
5999+ If the argument is not a String type, it is
6000+ automatically converted to text with the same format
6001+ as ":echo".
59976002 *printf-S*
59986003 S The text of the String argument is used. If a
59996004 precision is specified, no more display cells than the
@@ -6671,7 +6676,7 @@ setline({lnum}, {text}) *setline()*
66716676
66726677setloclist({nr} , {list} [, {action} [, {what} ]]) *setloclist()*
66736678 Create or replace or add to the location list for window {nr} .
6674- {nr} can be the window number or the window ID .
6679+ {nr} can be the window number or the | window-ID | .
66756680 When {nr} is zero the current window is used.
66766681
66776682 For a location list window, the displayed location list is
@@ -6859,7 +6864,7 @@ settabwinvar({tabnr}, {winnr}, {varname}, {val}) *settabwinvar()*
68596864 {val} .
68606865 Tabs are numbered starting with one. For the current tabpage
68616866 use | setwinvar() | .
6862- {winnr} can be the window number or the window ID .
6867+ {winnr} can be the window number or the | window-ID | .
68636868 When {winnr} is zero the current window is used.
68646869 This also works for a global or local buffer option, but it
68656870 doesn't work for a global or local buffer variable.
@@ -7967,11 +7972,11 @@ wildmenumode() *wildmenumode()*
79677972
79687973
79697974win_findbuf({bufnr} ) *win_findbuf()*
7970- Returns a list with window IDs for windows that contain buffer
7971- {bufnr} . When there is none the list is empty.
7975+ Returns a list with | window-ID | s for windows that contain
7976+ buffer {bufnr} . When there is none the list is empty.
79727977
79737978win_getid([{win} [, {tab} ]]) *win_getid()*
7974- Get the window ID for the specified window.
7979+ Get the | window-ID | for the specified window.
79757980 When {win} is missing use the current window.
79767981 With {win} this is the window number. The top window has
79777982 number 1.
@@ -7996,7 +8001,7 @@ win_id2win({expr}) *win_id2win()*
79968001 *winbufnr()*
79978002winbufnr({nr} ) The result is a Number, which is the number of the buffer
79988003 associated with window {nr} . {nr} can be the window number or
7999- the window ID .
8004+ the | window-ID | .
80008005 When {nr} is zero, the number of the buffer in the current
80018006 window is returned.
80028007 When window {nr} doesn't exist, -1 is returned.
@@ -8010,7 +8015,7 @@ wincol() The result is a Number, which is the virtual column of the
80108015
80118016winheight({nr} ) *winheight()*
80128017 The result is a Number, which is the height of window {nr} .
8013- {nr} can be the window number or the window ID .
8018+ {nr} can be the window number or the | window-ID | .
80148019 When {nr} is zero, the height of the current window is
80158020 returned. When window {nr} doesn't exist, -1 is returned.
80168021 An existing window always has a height of zero or more.
@@ -8090,7 +8095,7 @@ winsaveview() Returns a |Dictionary| that contains information to restore
80908095
80918096winwidth({nr} ) *winwidth()*
80928097 The result is a Number, which is the width of window {nr} .
8093- {nr} can be the window number or the window ID .
8098+ {nr} can be the window number or the | window-ID | .
80948099 When {nr} is zero, the width of the current window is
80958100 returned. When window {nr} doesn't exist, -1 is returned.
80968101 An existing window always has a width of zero or more.
0 commit comments