diff runtime/doc/eval.txt @ 9219:7363f5cc4cb8 v7.4.1893

commit https://github.com/vim/vim/commit/b3619a90eae2702553ff9494ecc4c9b20c13c224 Author: Bram Moolenaar <Bram@vim.org> Date: Sat Jun 4 17:58:52 2016 +0200 patch 7.4.1893 Problem: Cannot easily get the window ID for a buffer. Solution: Add bufwinid().
author Christian Brabandt <cb@256bit.org>
date Sat, 04 Jun 2016 18:00:08 +0200
parents 7350959e53c3
children 17fa362f10be
line wrap: on
line diff
--- a/runtime/doc/eval.txt
+++ b/runtime/doc/eval.txt
@@ -1862,6 +1862,7 @@ buflisted({expr})		Number	TRUE if buffer
 bufloaded({expr})		Number	TRUE if buffer {expr} is loaded
 bufname({expr})			String	Name of the buffer {expr}
 bufnr({expr} [, {create}])	Number	Number of the buffer {expr}
+bufwinid({expr})		Number	window ID of buffer {expr}
 bufwinnr({expr})		Number	window number of buffer {expr}
 byte2line({byte})		Number	line number at byte count {byte}
 byteidx({expr}, {nr})		Number	byte index of {nr}'th char in {expr}
@@ -2557,6 +2558,16 @@ bufnr({expr} [, {create}])
 							*last_buffer_nr()*
 		Obsolete name for bufnr("$"): last_buffer_nr().
 
+bufwinid({expr})					*bufwinid()*
+		The result is a Number, which is the window ID of the first
+		window associated with buffer {expr}.  For the use of {expr},
+		see |bufname()| above.	If buffer {expr} doesn't exist or
+		there is no such window, -1 is returned.  Example: >
+
+	echo "A window containing buffer 1 is " . (bufwinid(1))
+<
+		Only deals with the current tab page.
+
 bufwinnr({expr})					*bufwinnr()*
 		The result is a Number, which is the number of the first
 		window associated with buffer {expr}.  For the use of {expr},