comparison runtime/doc/eval.txt @ 831:f24a95dae8ee

updated for version 7.0d05
author vimboss
date Sat, 15 Apr 2006 20:25:09 +0000
parents dc8197342755
children 5117153003bd
comparison
equal deleted inserted replaced
830:927afe5f3c9d 831:f24a95dae8ee
1 *eval.txt* For Vim version 7.0d. Last change: 2006 Apr 14 1 *eval.txt* For Vim version 7.0d. Last change: 2006 Apr 15
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
1595 getloclist({nr}) List list of location list items 1595 getloclist({nr}) List list of location list items
1596 getpos( {expr}) List position of cursor, mark, etc. 1596 getpos( {expr}) List position of cursor, mark, etc.
1597 getqflist() List list of quickfix items 1597 getqflist() List list of quickfix items
1598 getreg( [{regname} [, 1]]) String contents of register 1598 getreg( [{regname} [, 1]]) String contents of register
1599 getregtype( [{regname}]) String type of register 1599 getregtype( [{regname}]) String type of register
1600 gettabwinvar( {tabnr}, {winnr}, {name})
1601 any {name} in {winnr} in tab page {tabnr}
1600 getwinposx() Number X coord in pixels of GUI Vim window 1602 getwinposx() Number X coord in pixels of GUI Vim window
1601 getwinposy() Number Y coord in pixels of GUI Vim window 1603 getwinposy() Number Y coord in pixels of GUI Vim window
1602 getwinvar( {nr}, {varname}) any variable {varname} in window {nr} 1604 getwinvar( {nr}, {varname}) any variable {varname} in window {nr}
1603 glob( {expr}) String expand file wildcards in {expr} 1605 glob( {expr}) String expand file wildcards in {expr}
1604 globpath( {path}, {expr}) String do glob({expr}) for all dirs in {path} 1606 globpath( {path}, {expr}) String do glob({expr}) for all dirs in {path}
1700 setloclist( {nr}, {list}[, {action}]) 1702 setloclist( {nr}, {list}[, {action}])
1701 Number modify location list using {list} 1703 Number modify location list using {list}
1702 setpos( {expr}, {list}) none set the {expr} position to {list} 1704 setpos( {expr}, {list}) none set the {expr} position to {list}
1703 setqflist( {list}[, {action}]) Number modify quickfix list using {list} 1705 setqflist( {list}[, {action}]) Number modify quickfix list using {list}
1704 setreg( {n}, {v}[, {opt}]) Number set register to value and type 1706 setreg( {n}, {v}[, {opt}]) Number set register to value and type
1707 settabwinvar( {tabnr}, {winnr}, {varname}, {val}) set {varname} in window
1708 {winnr} in tab page {tabnr} to {val}
1705 setwinvar( {nr}, {varname}, {val}) set {varname} in window {nr} to {val} 1709 setwinvar( {nr}, {varname}, {val}) set {varname} in window {nr} to {val}
1706 simplify( {filename}) String simplify filename as much as possible 1710 simplify( {filename}) String simplify filename as much as possible
1707 sort( {list} [, {func}]) List sort {list}, using {func} to compare 1711 sort( {list} [, {func}]) List sort {list}, using {func} to compare
1708 soundfold( {word}) String sound-fold {word} 1712 soundfold( {word}) String sound-fold {word}
1709 spellbadword() String badly spelled word at cursor 1713 spellbadword() String badly spelled word at cursor
2863 "<CTRL-V>{width}" for |blockwise-visual| text 2867 "<CTRL-V>{width}" for |blockwise-visual| text
2864 0 for an empty or unknown register 2868 0 for an empty or unknown register
2865 <CTRL-V> is one character with value 0x16. 2869 <CTRL-V> is one character with value 0x16.
2866 If {regname} is not specified, |v:register| is used. 2870 If {regname} is not specified, |v:register| is used.
2867 2871
2872 gettabwinvar({tabnr}, {winnr}, {varname}) *gettabwinvar()*
2873 Get the value of an option or local window variable {varname}
2874 in window {winnr} in tab page {tabnr}.
2875 Tabs are numbered starting with one. For the current tabpage
2876 use |getwinvar()|.
2877 When {winnr} is zero the current window is used.
2878 This also works for a global option, buffer-local option and
2879 window-local option, but it doesn't work for a global variable
2880 or buffer-local variable.
2881 Note that the name without "w:" must be used.
2882 Examples: >
2883 :let list_is_on = gettabwinvar(1, 2, '&list')
2884 :echo "myvar = " . gettabwinvar(3, 1, 'myvar')
2885
2868 *getwinposx()* 2886 *getwinposx()*
2869 getwinposx() The result is a Number, which is the X coordinate in pixels of 2887 getwinposx() The result is a Number, which is the X coordinate in pixels of
2870 the left hand side of the GUI Vim window. The result will be 2888 the left hand side of the GUI Vim window. The result will be
2871 -1 if the information is not available. 2889 -1 if the information is not available.
2872 2890
2873 *getwinposy()* 2891 *getwinposy()*
2874 getwinposy() The result is a Number, which is the Y coordinate in pixels of 2892 getwinposy() The result is a Number, which is the Y coordinate in pixels of
2875 the top of the GUI Vim window. The result will be -1 if the 2893 the top of the GUI Vim window. The result will be -1 if the
2876 information is not available. 2894 information is not available.
2877 2895
2878 getwinvar({nr}, {varname}) *getwinvar()* 2896 getwinvar({winnr}, {varname}) *getwinvar()*
2879 The result is the value of option or local window variable 2897 Like |gettabwinvar()| for the current tabpage.
2880 {varname} in window {nr}. When {nr} is zero the current
2881 window is used.
2882 This also works for a global option, buffer-local option and
2883 window-local option, but it doesn't work for a global variable
2884 or buffer-local variable.
2885 Note that the name without "w:" must be used.
2886 Examples: > 2898 Examples: >
2887 :let list_is_on = getwinvar(2, '&list') 2899 :let list_is_on = getwinvar(2, '&list')
2888 :echo "myvar = " . getwinvar(1, 'myvar') 2900 :echo "myvar = " . getwinvar(1, 'myvar')
2889 < 2901 <
2890 *glob()* 2902 *glob()*
4357 4369
4358 < You can also change the type of a register by appending 4370 < You can also change the type of a register by appending
4359 nothing: > 4371 nothing: >
4360 :call setreg('a', '', 'al') 4372 :call setreg('a', '', 'al')
4361 4373
4362 setwinvar({nr}, {varname}, {val}) *setwinvar()* 4374 settabwinvar({tabnr}, {winnr}, {varname}, {val}) *settabwinvar()*
4363 Set option or local variable {varname} in window {nr} to 4375 Set option or local variable {varname} in window {winnr} to
4364 {val}. When {nr} is zero the current window is used. 4376 {val}.
4377 Tabs are numbered starting with one. For the current tabpage
4378 use |setwinvar()|.
4379 When {winnr} is zero the current window is used.
4365 This also works for a global or local buffer option, but it 4380 This also works for a global or local buffer option, but it
4366 doesn't work for a global or local buffer variable. 4381 doesn't work for a global or local buffer variable.
4367 For a local buffer option the global value is unchanged. 4382 For a local buffer option the global value is unchanged.
4368 Note that the variable name without "w:" must be used. 4383 Note that the variable name without "w:" must be used.
4384 Vim briefly goes to the tab page {tabnr}, this may trigger
4385 TabLeave and TabEnter autocommands.
4386 Examples: >
4387 :call settabwinvar(1, 1, "&list", 0)
4388 :call settabwinvar(3, 2, "myvar", "foobar")
4389 < This function is not available in the |sandbox|.
4390
4391 setwinvar({nr}, {varname}, {val}) *setwinvar()*
4392 Like |settabwinvar()| for the current tab page.
4369 Examples: > 4393 Examples: >
4370 :call setwinvar(1, "&list", 0) 4394 :call setwinvar(1, "&list", 0)
4371 :call setwinvar(2, "myvar", "foobar") 4395 :call setwinvar(2, "myvar", "foobar")
4372 < This function is not available in the |sandbox|.
4373 4396
4374 simplify({filename}) *simplify()* 4397 simplify({filename}) *simplify()*
4375 Simplify the file name as much as possible without changing 4398 Simplify the file name as much as possible without changing
4376 the meaning. Shortcuts (on MS-Windows) or symbolic links (on 4399 the meaning. Shortcuts (on MS-Windows) or symbolic links (on
4377 Unix) are not resolved. If the first path component in 4400 Unix) are not resolved. If the first path component in