Improve ingo#gui#position#Get()

Merge branch 'feature/getwinpos'

README.md

@@ -214,6 +214,9 @@ HISTORY
 - ingo#regexp#comments#CommentToExpression(): BUG: The $ anchor was mistakenly
   escaped, but the pattern is (normal) magic; special comment characters (like
   "\*") are not properly escaped.
+- CHG: Minor: ingo#gui#position#Get() swap the first two returned elements (so
+  it's X-Y, too) and return numbers for elements 3 and 4. This shouldn't
+  matter to clients as the format is unspecified.
 
 ##### 1.044   08-Apr-2022
 - Add ingo#cursor#IsBeyondEndOfLine() variant of ingo#cursor#IsAtEndOfLine().
@@ -1282,7 +1285,7 @@ HISTORY
 - Started development of shared autoload functionality.
 
 ------------------------------------------------------------------------------
-Copyright: (C) 2009-2022 Ingo Karkat -
+Copyright: (C) 2009-2023 Ingo Karkat -
 Contains URL encoding / decoding algorithms written by Tim Pope. -
 The [VIM LICENSE](http://vimdoc.sourceforge.net/htmldoc/uganda.html#license) applies to this plugin.
 

autoload/ingo/gui/position.vim

@@ -2,19 +2,22 @@
 "
 " DEPENDENCIES:
 "
-" Copyright: (C) 2013 Ingo Karkat
+" Copyright: (C) 2013-2023 Ingo Karkat
 "   The VIM LICENSE applies to this script; see ':help copyright'.
 "
 " Maintainer:	Ingo Karkat <ingo@karkat.de>
-"
-" REVISION	DATE		REMARKS
-"   1.011.001	19-Jul-2013	file creation
 
-function! ingo#gui#position#Get()
-    redir => l:winpos
-	silent! winpos
-    redir END
-    return [&lines, &columns, matchstr(l:winpos, '\CX \zs-\?\d\+'), matchstr(l:winpos, '\CY \zs-\?\d\+')]
-endfunction
+if exists('*getwinpos')
+    function! ingo#gui#position#Get() abort
+	return [&columns, &lines] + getwinpos()
+    endfunction
+else
+    function! ingo#gui#position#Get() abort
+	redir => l:winpos
+	    silent! winpos
+	redir END
+	return [&columns, &lines, str2nr(matchstr(l:winpos, '\CX \zs-\?\d\+')), str2nr(matchstr(l:winpos, '\CY \zs-\?\d\+'))]
+    endfunction
+endif
 
 " vim: set ts=8 sts=4 sw=4 noexpandtab ff=unix fdm=syntax :

doc/ingo-library.txt

@@ -229,6 +229,9 @@ HISTORY							*ingo-library-history*
 - ingo#regexp#comments#CommentToExpression(): BUG: The $ anchor was mistakenly
   escaped, but the pattern is (normal) magic; special comment characters (like
   "*") are not properly escaped.
+- CHG: Minor: ingo#gui#position#Get() swap the first two returned elements (so
+  it's X-Y, too) and return numbers for elements 3 and 4. This shouldn't
+  matter to clients as the format is unspecified.
 
 1.044	08-Apr-2022
 - Add ingo#cursor#IsBeyondEndOfLine() variant of ingo#cursor#IsAtEndOfLine().
@@ -1297,7 +1300,7 @@ First published version as separate shared library.
 Started development of shared autoload functionality.
 
 ==============================================================================
-Copyright: (C) 2009-2022 Ingo Karkat
+Copyright: (C) 2009-2023 Ingo Karkat
 Contains URL encoding / decoding algorithms written by Tim Pope.
 The VIM LICENSE applies to this plugin; see |copyright|.